Full specification

The full protocol specification and architecture are maintained in the repository as Markdown.

​

SPEC.md

SPEC.md covers:

• Design goals (protocol composability, deterministic execution, least-privilege, hierarchical orchestration, progressive context hydration)
• Core concepts (Context, Orchestrator, Executors)
• Runtime behavior: orchestrator vs executor, data flow, what is shared
• Shared input/output model
• Executor types (agent, tool, human)
• Nested orchestration
• Mounts (seed, focus, deep) and Ref objects
• Policies and protocols
• Orchestration strategies (single, sequential, delegate, swarm)
• Triggers, schemas, context inputs/outputs
• Security model

Use it as the authoritative protocol document when implementing runtimes or tooling.

​

Host system configuration

Machine- and project-local ecp.config.yaml (system config) is specified in the same document: Host system configuration (ecp.config.yaml). It covers the version field, the split between configure sections and the security mirror, MCP tool plugins, and A2A endpoint shape. The annotated example is config/ecp.config.example.yaml.

​

ARCHITECTURE.md

ARCHITECTURE.md documents plugin registration and architecture decisions.

​

Schema and types

• JSON Schema: packages/spec/dist/ecp-context.schema.json (generate with npm run generate:schema)
• TypeScript types: packages/spec/src/types/ecp.ts (single source of truth)

See Schema reference for details.

​

Repository