Superseded

Platform Component ↔ Service ↔ Agent Map

Status: Superseded implementation snapshot. Do not use as architecture authority.
The grounded replacement is
PLATFORM_CONTROL_SURFACE_MAPPING.md, subordinate to
INTEGRATEWISE_ARCHITECTURE.md.

Historical wire map for the IntegrateWise control plane and workbench surfaces.
UI surfaces live in apps/platform. Reusable microfrontend components live in packages/platform-mfe.
Canonical backend services live in services/. Runtime agents live in services/iw-agent-runtime.
Route, API, service, and agent statements below are retained as dated lineage and may be planned rather than implemented.

Legend

Column	Meaning
Surface	A user-facing page or control-plane view.
Component	Primary React component / folder that owns the view.
API Routes	`apps/platform/app/api/v1/*` routes the surface should call (or already calls).
Service Bindings	Cloudflare Worker services the route proxies to.
Agent	`services/iw-agent-runtime` Durable Object that participates in the surface's work.
Spine Entity	Adaptive Spine canonical entity type the surface primarily projects.

1. Workspace / Workbench Surfaces

Operational surfaces the user interacts with inside the Workbench shell.

Surface	Route(s)	Component	API Routes	Service Bindings	Agent	Spine Entity
Overview / Home	`/`	`app/(shell)/page.tsx`	`/api/v1/workspace/discovery`	`workflow`, `gateway`	`TwinAgent`	`TimelineEvent`, `Capability`
My Work	`/my-work`	`app/(shell)/my-work/page.tsx`	`/api/v1/tasks/*` (planned)	`task-management`	`CoworkerAgent`	`Task`
Communications	`/communications`	`app/(shell)/communications/page.tsx`	`/api/v1/signals/*` (planned)	`signals`, `hermes`	`TwinAgent`	`TimelineEvent`
Workbench	`/workbench`	`app/(shell)/workbench/page.tsx`, `components/workbench/*`	`/api/v1/spine?type=schema`, `/api/v1/capabilities/*`	`spine`, `workflow`, `intelligence`	`TwinAgent`, `SchemaAgent`	`Schema`, `Capability`
Network Catalog	`/network`	`app/(shell)/network/page.tsx`, `components/network/*`	`/api/v1/marketplace/connectors`, `/api/v1/connectors`	`integration-management-mcp`, `provider-management-mcp`	`DiscoveryAgent`	`Connector`, `Connection`
MCP Pool	`/network/mcp`	`app/(shell)/network/mcp/page.tsx`, `components/network/mcp-hub.tsx`	`/api/v1/connectors/mcp-pool`	`mcp-pool`	`DiscoveryAgent`	`Capability`
Marketplace	`/marketplace`	`app/(shell)/marketplace/page.tsx`, `components/connectors/connector-catalog.tsx`	`GET /api/v1/workspace/marketplace-items?kind=*`, `POST /api/v1/workspace/marketplace-items`	`workflow`, `marketplace-installation`	`DiscoveryAgent`	`Connector`, `Capability`
Governance	`/governance`	`app/(shell)/governance/page.tsx`, `components/governance/*`	`/api/v1/workspace/governance/*` (planned)	`workflow`, `hermes`	`TriageAgent`, `TwinAgent`	`TimelineEvent`
Approvals	`/approvals`	`app/(shell)/approvals/page.tsx`, `components/approvals/*`	`/api/v1/workspace/approvals/*` (planned)	`workflow`	`TriageAgent`, `TwinAgent`	`TimelineEvent`
Connectors	`/connectors`	`app/(shell)/connectors/page.tsx`, `components/connectors/*`	`/api/v1/connections/*`, `/api/v1/connections/[provider]`	`connector`, `provider-management-mcp`	`DiscoveryAgent`	`Connection`, `Connector`
Agents	`/agents`	`app/(shell)/agents/page.tsx`	`/api/v1/agents/*` (planned)	`agent-registry`, `iw-agent-runtime`	`TwinAgent`, `CoworkerAgent`, `DiscoveryAgent`, `SchemaAgent`, `TriageAgent`, `AdaptiveAutotunerAgent`	`Capability`
Settings	`/settings`	`app/(shell)/settings/page.tsx`, `components/settings/*`	`/api/v1/auth/session`, `/api/v1/keys/*`	`tenants`, `admin`, `billing`	`TwinAgent`	—

2. Platform Control Plane Surfaces

New /control/[surface] admin views. These are operator-grade surfaces for the Platform Control Plane.

Surface ID	Page	Console Component	API Routes	Service Bindings	Agent	Notes
`overview`	`/control/overview`	`PlatformConsole`	`/api/v1/workspace/bootstrap`, `/api/v1/workspace/discovery`	`workflow`, `gateway`	`TwinAgent`	Aggregate KPIs across all surfaces.
`connectors`	`/control/connectors`	`PlatformConsole`	`/api/v1/connections/*`, `/api/v1/marketplace/connectors`	`connector`, `integration-management-mcp`, `provider-management-mcp`	`DiscoveryAgent`	Installed + available connectors.
`marketplace`	`/control/marketplace`	`PlatformConsole`	`GET /api/v1/workspace/marketplace-items`, `POST /api/v1/workspace/marketplace-items`	`workflow`, `marketplace-installation`	`DiscoveryAgent`	Browse and publish packs / MCPs / plugins / connectors.
`mcp-servers`	`/control/mcp-servers`	`PlatformConsole`	`/api/v1/connectors/mcp-pool`, `/api/v1/capabilities`	`mcp-pool`, `integration-management-mcp`	`DiscoveryAgent`	Tenant MCP pool registry.
`agents`	`/control/agents`	`PlatformConsole`	`/api/v1/agents/*` (planned)	`agent-registry`, `iw-agent-runtime`	`TwinAgent`, `CoworkerAgent`, `DiscoveryAgent`, `SchemaAgent`, `TriageAgent`, `AdaptiveAutotunerAgent`	Surface all 6 agent types per `CONTEXT_TRANSFER_PLATFORM_UI.md`.
`pipelines`	`/control/pipelines`	`PlatformConsole`	`/api/v1/pipelines/*` (planned)	`pipeline`, `loader`, `store`	`AdaptiveAutotunerAgent`	ETL and sync pipelines.
`automations`	`/control/automations`	`PlatformConsole`	`/api/v1/workflows/*` (planned)	`workflow`, `task-management`	`CoworkerAgent`	Repeatable workflows.
`observability`	`/control/observability`	`PlatformConsole`	`/api/v1/telemetry/*` (planned)	`telemetry`, `signals`	`AdaptiveAutotunerAgent`	Health, metrics, logs.
`governance`	`/control/governance`	`PlatformConsole`	`/api/v1/workspace/governance/*` (planned)	`workflow`, `hermes`	`TriageAgent`, `TwinAgent`	Proposals, approvals, audit.
`settings`	`/control/settings`	`PlatformConsole`	`/api/v1/auth/session`, `/api/v1/keys/*`	`tenants`, `admin`	`TwinAgent`	Tenant schema, policies, API keys.
`organizations`	`/control/organizations`	`PlatformConsole`	`/api/v1/tenants/*` (planned)	`tenants`, `billing`	`TwinAgent`	Workspace switching, plans, members.
`users`	`/control/users`	`PlatformConsole`	`/api/v1/auth/users/*` (planned)	`tenants`, `admin`	`TwinAgent`	Members, roles, invitations.

3. Runtime Agents

All agents live in services/iw-agent-runtime and are exposed via /agents/:name/* through routeAgentRequest.

Agent	Primary Responsibility	Surfaces That Use It	Pipeline Stage
TwinAgent	Silent, non-authoritative cognitive participant; proposes, explains, requests approval.	All user surfaces	`THINK` / `APPROVE`
DiscoveryAgent	Discover hosts, tools, schemas, connectors, MCP servers, capabilities.	Network, Marketplace, Connectors, Agents	`LOAD` / `NORMALIZE`
SchemaAgent	Generate, migrate, validate tenant schemas and field mappings.	Workbench, Agents	`NORMALIZE` / `STORE`
TriageAgent	Route signals/intents; enforce governance gate before execution or writes.	Governance, Approvals, Pipelines	`THINK` → `APPROVE`
CoworkerAgent	Execute assigned tasks and actions under human approval.	My Work, Automations, Agents	`ACT`
AdaptiveAutotunerAgent	Tune parameters, resource allocation, execution strategies from metrics.	Observability, Pipelines, Agents	`REPEAT`

4. Key Backend Services

Service	Capability Domain	Primary Consumers
`gateway`	Ingress, auth routing, request validation	All surfaces
`workflow`	Workspace bootstrap, marketplace publication, HITL flows, approvals	Overview, Marketplace, Governance, Approvals
`pipeline`	Canonical write pipeline, Spine writer	Workbench, Pipelines
`integration-management-mcp`	Connectors, schemas, sync, webhooks	Network, Connectors, MCP servers
`provider-management-mcp`	OAuth apps, provider adapters, connections	Network, Connectors, Settings
`task-management`	Task scheduling, assignment, execution	My Work, Automations
`mcp-pool`	MCP registry, resolver, health, versioning	Network / MCP, Agents
`iw-agent-runtime`	Durable Object agents (Twin, Discovery, Schema, Triage, Coworker, AdaptiveAutotuner)	All surfaces
`agent-registry`	Agent metadata, discovery, lifecycle	Agents surface
`spine`	Read-side catalog and projection cache	Workbench, Network
`tenant`	Tenant membership, roles, invitations	Settings, Organizations, Users
`billing`	Plans, subscriptions, usage	Organizations, Settings
`hermes`	Sync event routing	Governance, Communications, Pipelines
`signals`	Signal ingestion, alerting	Communications, Observability
`telemetry`	Metrics, logs, traces	Observability

5. Frozen Pipeline Reference

LOAD → NORMALIZE → STORE → THINK → APPROVE → ACT → REPEAT
                          ↑                 ↑
                   Store in Spine    Approve Twin's Action
                   Ask your Twin     Assign your Twin

Agents participate only at THINK, APPROVE, ACT, REPEAT.
No agent writes directly to the Neon canonical DB. Write intent flows: UI → gateway → TriageAgent/workflow → pipeline → canonical store.
UI surfaces are projections over the Adaptive Spine, not direct DB consumers.

6. Next-Wire Targets (priority order)

Marketplace surface — wire /control/marketplace to GET /api/v1/workspace/marketplace-items?kind=*.
Overview surface — wire /control/overview to /api/v1/workspace/bootstrap and /api/v1/workspace/discovery.
Agents surface — add /api/v1/agents/* proxy and render the 6 runtime agents from iw-agent-runtime.
Governance surface — attach approval queue endpoints through workflow.
Connectors surface — proxy to integration-management-mcp and provider-management-mcp.