BizCity Twin Plugin Standard v2.0

📖 Canonical guide for developing plugins that integrate with BizCity Twin Core ecosystem.

Unified architecture for Intent Providers, Automation, Studio integration, SSE streaming, and API gateway contracts.

📋 Quick Navigation

Overview
Core Principles
Layer 1: Touch Bar & Agent Profile
Layer 2: Intent Provider
Layer 3: Studio Provider
SSE Stream Mode
Plugin Registry
API Gateway
Implementation Checklist
Legacy Integration

⚠️ Documentation Not Found

The PLUGIN-TWIN-STANDARD.md file could not be located at:
/home/vibeyeuc/huongnguyen.vibeyeu.com.vn/wp-content/plugins/bizcity-twin-ai/PLUGIN-TWIN-STANDARD.md

?> Plugin Twin Standard

Plugin Twin Standard

Unified contract for BizCity plugin ecosystem: slash shortcuts, provider metadata, SSE, studio/automation, and API gateway bridge.

Shortcut Contract

All quick prompt clicks must produce slash command with tool_name and plugin_slug.

Provider Contract

Providers must declare featured, supports_studio, supports_automation, and main_tool.

Gateway Ready

Each tool should expose optional gateway_contract to map API bridge and HIL points.

1. postMessage Standard

window.parent.postMessage({
  type: 'bizcity_agent_command',
  source: 'bizcity-tool-content',
  plugin_slug: 'bizcity-tool-content',
  tool_name: 'write_article',
  text: '/write_article Viết bài về dinh dưỡng'
}, '*');

Rule: if text has no leading slash and tool_name exists, receiver prepends /{tool_name}.

2. Capability Metadata

'capabilities' => [
  'featured' => true,
  'supports_studio' => true,
  'supports_automation' => true,
  'supports_sse' => true,
  'main_tool' => 'write_article',
  'hil_required' => false,
],

3. Required Coverage

Intent Provider Automation Provider Studio Provider BizChat Menu SSE Trace Context Resolver Gateway Contract

Declare stable tool schema and output envelope.
Use mode-aware context from $slots['_meta']['_context'].
Emit trace events: begin, steps, end/fail.
Register menu through unified BizChat hook only.

4. Canonical Source

Detailed specification is maintained in bizcity-twin-ai/PLUGIN-TWIN-STANDARD.md.