{
  "id": "page:docs-v6-spec-and-roadmap-agent-mux-integration",
  "_kind": "Page",
  "_file": "wiki/docs/v6-spec-and-roadmap/agent-mux-integration.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/v6-spec-and-roadmap/agent-mux-integration.md",
    "sourceKind": "repo-docs",
    "title": "Agent-Mux Repository Integration",
    "displayName": "Agent-Mux Repository Integration",
    "slug": "docs/v6-spec-and-roadmap/agent-mux-integration",
    "articlePath": "wiki/docs/v6-spec-and-roadmap/agent-mux-integration.md",
    "article": "\n# Agent-Mux Repository Integration\n\n→ [Documentation Index](README.md) | Related: [Unified Stack Architecture](unified-stack-architecture.md) | [Package Specifications](package-specs.md)\n\n## Integration Overview\n\n`agent-mux` is already part of this monorepo under `packages/agent-mux/*`. The V6 task is not to speculate about a future migration from a separate checkout. The V6 task is to describe how the dispatch layer, orchestration layer, hook normalization layer, and plugin packaging surfaces fit together now.\n\n## Current Repository Reality\n\nThe integrated `agent-mux` package family includes:\n\n### Core Infrastructure\n\n- **`@a5c-ai/agent-mux-core`** - Core types, client, and stream engine\n- **`@a5c-ai/agent-mux-adapters`** - Built-in harness adapters\n- **`@a5c-ai/agent-mux-cli`** - `amux` command-line interface\n- **`@a5c-ai/agent-mux`** - Main SDK package and dispatch surface\n- **`@a5c-ai/agent-mux-gateway`** - Gateway services for remote and browser-facing surfaces\n\n### User Interfaces\n\n- **`@a5c-ai/agent-mux-ui`** - Shared UI foundation\n- **`@a5c-ai/agent-mux-webui`** - Browser interface\n- **`@a5c-ai/agent-mux-tui`** - Terminal interface\n\n### Platform-Specific Applications\n\n- **`@a5c-ai/agent-mux-mobile-ios-app`**\n- **`@a5c-ai/agent-mux-mobile-android-app`**\n- **`@a5c-ai/agent-mux-tv-androidtv-app`**\n- **`@a5c-ai/agent-mux-tv-appletv-app`**\n- **`@a5c-ai/agent-mux-watch-watchos-app`**\n- **`@a5c-ai/agent-mux-watch-wearos-app`**\n\n### Supporting Services\n\n- **`@a5c-ai/agent-mux-observability`**\n- **`@a5c-ai/agent-mux-harness-mock`**\n- **`@a5c-ai/amux-proxy`**\n\n## How Agent-Mux Fits Into The Stack\n\nAgent-mux is the dispatch layer, not the orchestration core.\n\n- Babysitter owns runs, replay, effect lifecycles, process execution, and CLI orchestration.\n- agent-mux owns harness-facing adapter behavior, normalized event streams, invocation modes, and agent-running APIs.\n- `hooks-mux` normalizes hook payloads across harnesses.\n- `agent-plugins-mux` compiles the unified plugin authoring surface into harness-specific bundles.\n- `breakpoints-mux` handles routed human approval and response flows when those are needed.\n\nThis means the integration is already a package-and-boundary question inside one repository, not a cross-repo migration plan.\n\n## Normative V6 Position\n\nV6 currently commits to:\n\n- documenting the actual responsibility split between Babysitter and agent-mux,\n- using the current package layout as the source of truth,\n- improving naming, validation, and docs around the existing seams,\n- avoiding claims that a deeper runtime/platform/application decomposition is already decided.\n\nV6 does not currently commit to forcing agent-mux into a new package hierarchy just because those names are possible to imagine.\n\n## Integration Points That Matter Today\n\n### 1. Package Workspaces\n\nThe monorepo root includes:\n\n- `packages/*`\n- `packages/agent-mux/*`\n- `packages/hooks-mux/*`\n\nThat workspace layout is already evidence that agent-mux is part of the repo's current operating model.\n\n### 2. Orchestration To Dispatch Boundary\n\nThe main integration seam is:\n\n- Babysitter tells the system what work to do and in what order.\n- agent-mux knows how to execute harness-facing agent work consistently.\n\n### 3. Hooks And Plugin Distribution\n\nThe plugin and hook story spans multiple packages:\n\n- `plugins/babysitter-unified/` is the canonical plugin authoring surface.\n- `packages/agent-plugins-mux` is the compiler for harness-specific outputs.\n- `packages/hooks-mux/*` normalizes hook contracts across harnesses.\n- per-harness plugin bundles remain the real installation surfaces users consume.\n\nFor V6, this package set is the concrete delivery path for metaplugins on legacy non-Babysitter agents. The metaplugin itself is the higher-order capability being expressed across plugin and hook surfaces; `agent-plugins-mux` only compiles the concrete outputs that carry it. The intended examples are memory systems, governance or policy engines, and discipline-enforcement layers. The `babysitter-unified` plugin family fits here as a first-party unified plugin source and deployment surface, not as the definition of metaplugins.\n\n### 4. UI And Surface Consumption\n\nThe agent-mux UI, TUI, mobile, TV, and watch packages are downstream consumers of the dispatch layer. They are part of the stack, but they do not redefine the architectural center of V6.\n\n## Deferred Questions\n\nThese may still become important later, but V6 does not treat them as settled:\n\n- whether any deeper package split is justified inside `babysitter-agent`,\n- whether some agent-mux support subsystems should be promoted into stronger standalone boundaries,\n- whether future naming should formalize a larger runtime/platform/application vocabulary.\n\n## Practical Reading Order\n\nFor the current integrated story, read:\n\n1. [Unified Stack Architecture](unified-stack-architecture.md)\n2. [Package Specifications](package-specs.md)\n3. [docs/agent-mux/README](https://github.com/a5c-ai/babysitter/blob/main/docs/agent-mux/README.md)\n4. `packages/agent-mux/README.md`\n\n---\n\n**Related Documents**: [Unified Stack Architecture](unified-stack-architecture.md) | [Package Specifications](package-specs.md) | [Stack Guide](stack-guide.md)\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-v6-spec-and-roadmap",
      "to": "page:docs-v6-spec-and-roadmap-agent-mux-integration",
      "kind": "contains_page"
    }
  ]
}