@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/prompts/commandTemplates.js

@@ -0,0 +1,238 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderCommandTemplate = renderCommandTemplate;
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const COMMAND_TEMPLATE_CONTEXT = {
+    harness: "harness-command-template",
+    harnessLabel: "Harness Command Template",
+    interactive: undefined,
+    capabilities: [],
+    platform: process.platform,
+    pluginRootVar: "",
+    loopControlTerm: "",
+    sessionBindingFlags: "",
+    hookDriven: false,
+    interactiveToolName: "",
+    sessionEnvVars: "",
+    resumeFlags: "",
+    sdkVersionExpr: "",
+    hasIntentFidelityChecks: false,
+    hasNonNegotiables: false,
+    cliSetupSnippet: "",
+    iterateFlags: "",
+};
+const ANYCLI_TEMPLATE = `[ANYCLI MODE] Dynamic service integration agent for any external service
+
+Target service: {{serviceName}}
+Scope: {{scope}}
+{{#mcpMode}}MCP mode: enabled (transport: {{transport}}){{/mcpMode}}
+{{^mcpMode}}Mode: ad-hoc execution{{/mcpMode}}
+{{#authFile}}Auth file: {{authFile}}{{/authFile}}
+{{#userPrompt}}User request: {{userPrompt}}{{/userPrompt}}
+
+You are a service integration agent. You handle EVERYTHING dynamically: researching the service, figuring out authentication, writing code, and generating MCP servers. There are no pre-built templates or hardcoded patterns -- you discover and create everything at runtime based on what you learn about the service.
+
+---
+
+## Phase 1: Service Discovery
+
+**Goal:** Learn everything about **{{serviceName}}** and build a service definition.
+
+### 1a. Check Cache
+
+Check \`~/.a5c/anycli/cache/{{serviceName}}/cache.json\` for an existing cache entry.
+
+If found, inspect \`definition\`, \`modules\`, and \`metadata.createdAt\`. You decide whether the cache is fresh enough to use. If the definition covers the requested scope (\`{{scope}}\`), skip to Phase 3 or 4.
+
+### 1b. Research the Service
+
+If no usable cache exists, research **{{serviceName}}** thoroughly:
+
+1. **Web search** for official API documentation, OpenAPI/Swagger specs, developer guides.
+2. **Identify**: base URL(s), API versioning scheme, authentication methods (specific to THIS service -- not generic patterns), rate limits, pagination style, error response format.
+3. **Check** for existing CLI tools, SDKs (npm/pip/etc.), or MCP servers that already integrate with this service.
+4. **Filter by scope**: \`{{scope}}\` -- if \`*\`, cover all major endpoint groups. If comma-separated, focus on those specific areas.
+
+### 1c. Build the Definition
+
+Construct a service definition object with whatever structure makes sense for **{{serviceName}}**. There is no rigid schema -- include the fields that are relevant:
+
+- \`name\`, \`apiBaseUrl\`, \`displayName\`, \`description\`
+- Authentication details specific to this service
+- Endpoint groups filtered by scope
+- Any service-specific metadata (rate limits, pagination, versioning, etc.)
+
+---
+
+## Phase 2: Auth Resolution
+
+**Goal:** Figure out what credentials **{{serviceName}}** needs and find them.
+
+This is entirely service-specific. Do NOT use generic patterns like \`SERVICE_API_KEY\`. Instead:
+
+1. **Read the service docs** to understand what auth method(s) it supports (API keys, OAuth2, bearer tokens, basic auth, etc.) and what the credentials look like.
+{{#authFile}}
+2. **Check the auth file** at \`{{authFile}}\` for credentials. Parse it as \`.env\` or JSON format.
+{{/authFile}}
+{{^authFile}}
+2. **No auth file provided**, skip to next step.
+{{/authFile}}
+3. **Check environment variables** using the naming conventions that are standard for THIS specific service. For example: \`GITHUB_TOKEN\` for GitHub, \`STRIPE_API_KEY\` for Stripe, \`OPENAI_API_KEY\` for OpenAI -- whatever the service's own docs and ecosystem use.
+4. **Check workspace \`.env\`** file for the same service-specific variable names.
+5. **If credentials are missing**, report exactly what is needed, where to get it (with links to the service's credential/API key page if known), and what env var name to use.
+
+**Security:** Never log or hardcode credentials. Generated code must read credentials from environment variables at runtime.
+
+---
+
+## Phase 3: Code Generation
+
+**Goal:** Write utility modules (\`.mjs\` files) based on what you learned about **{{serviceName}}**.
+
+You decide the module structure, function signatures, and types based on the service's actual API. General guidelines:
+
+- **HTTP client**: Use \`fetch()\` only -- zero external dependencies. Include auth headers, retries on 429/5xx, and the service's pagination pattern.
+- **Scope modules**: One file per scope group with async functions for each endpoint. Full JSDoc.
+- **Barrel export**: An \`index.mjs\` re-exporting everything.
+- **No hardcoded credentials**: Read from env vars at runtime.
+
+Write all modules to \`~/.a5c/anycli/cache/{{serviceName}}/modules/\`.
+
+---
+
+{{#mcpMode}}
+## Phase 4: MCP Server Generation
+
+**Goal:** Write and start a complete MCP server for **{{serviceName}}**.
+
+Write a self-contained \`mcp-server.mjs\` file from scratch using \`@modelcontextprotocol/sdk\` patterns:
+
+- Import \`McpServer\` from \`@modelcontextprotocol/sdk/server/mcp.js\`
+- Import the appropriate transport for \`{{transport}}\`:
+  - \`stdio\`: \`StdioServerTransport\` from \`.../server/stdio.js\`
+  - \`http-sse\`: \`SSEServerTransport\` from \`.../server/sse.js\`
+- Register MCP tools based on the scope modules you generated
+- Each tool: descriptive name (\`{{serviceName}}_<action>\`), JSON Schema input, handler that calls the scope module functions
+- Graceful shutdown on SIGINT/SIGTERM
+
+Save to \`~/.a5c/anycli/cache/{{serviceName}}/mcp-server.mjs\` and start it.
+
+Output MCP client config for the user:
+\`\`\`json
+{ "name": "{{serviceName}}-anycli", "transport": "{{transport}}",
+  "command": "node", "args": ["~/.a5c/anycli/cache/{{serviceName}}/mcp-server.mjs"] }
+\`\`\`
+{{/mcpMode}}
+
+{{^mcpMode}}
+## Phase 4: Ad-hoc Execution
+
+**Goal:** Fulfill the user's request using the generated modules.
+
+{{#userPrompt}}
+### Execute request:
+> {{userPrompt}}
+
+1. Determine which API calls are needed.
+2. Import the generated modules from \`~/.a5c/anycli/cache/{{serviceName}}/modules/\`.
+3. Execute operations in logical order, chaining multi-step calls as needed.
+4. Present results clearly: tables for lists, formatted JSON for objects, summaries for aggregations.
+{{/userPrompt}}
+
+{{^userPrompt}}
+### Interactive discovery:
+No specific request provided. List the generated modules and their exported functions with descriptions and parameters. Suggest common use cases for **{{serviceName}}** and ask the user what they want to do.
+{{/userPrompt}}
+{{/mcpMode}}
+
+---
+
+## Phase 5: Caching
+
+**Goal:** Save everything to \`~/.a5c/anycli/cache/{{serviceName}}/cache.json\` for reuse.
+
+Write a single cache entry with this structure:
+\`\`\`json
+{
+  "service": "{{serviceName}}",
+  "definition": { "...your service definition from Phase 1..." },
+  "modules": { "filename.mjs": "...file content..." },
+  "metadata": {
+    "createdAt": "<ISO timestamp>",
+    "sdkVersion": "<version>",
+    "definitionHash": "<hash of the definition>"
+  }
+}
+\`\`\`
+
+The harness package provides \`readServiceCache\`, \`writeServiceCache\`, \`invalidateServiceCache\`, and \`listCachedServices\` functions in \`@a5c-ai/agent-platform\` (anycli module) for this purpose.
+
+---
+
+## Phase 6: Verification
+
+1. **Syntax check**: \`node --check\` on each generated \`.mjs\` file.
+2. **Import check**: Dynamic import of \`modules/index.mjs\` to verify exports.
+3. **Smoke test**: If auth is available, make one lightweight API call (health endpoint or list with limit=1).
+{{#mcpMode}}
+4. **MCP validation**: Verify the server module loads and tool count matches expectations.
+{{/mcpMode}}
+
+---
+
+## Error Handling
+
+- **Unknown service**: Report, suggest alternative names or provide a base URL. Stop.
+- **Missing credentials**: Report what was tried, provide setup instructions with the correct env var names for this service. Stop.
+- **Rate limiting**: Wait if reset < 60s, otherwise report partial results.
+- **Network errors**: Report endpoint URL and error. Suggest checking connectivity.
+- **Security invariant**: Never include credentials in output, errors, logs, or generated comments.
+
+---
+
+## Output Format
+
+\`\`\`
+==============================================
+  ANYCLI SERVICE INTEGRATION REPORT
+  Service: {{serviceName}}    Scope: {{scope}}
+==============================================
+
+OVERALL STATUS: <READY | PARTIAL | FAILED>
+
+| #  | Phase              | Status |
+|----|--------------------|--------|
+| 1  | Service Discovery  | <s>    |
+| 2  | Auth Resolution    | <s>    |
+| 3  | Code Generation    | <s>    |
+| 4  | Execution          | <s>    |
+| 5  | Caching            | <s>    |
+| 6  | Verification       | <s>    |
+
+Cache: ~/.a5c/anycli/cache/{{serviceName}}/
+Modules: <list>    Endpoints: <count>    Auth: <method> (<source>)
+{{#mcpMode}}
+MCP server: ~/.a5c/anycli/cache/{{serviceName}}/mcp-server.mjs
+Transport: {{transport}}
+{{/mcpMode}}
+\`\`\`
+
+**Status:** READY = all phases passed. PARTIAL = warnings but no failures. FAILED = any phase failed.
+{{#mcpMode}}
+Include MCP connection instructions for the user's harness.
+{{/mcpMode}}
+{{^mcpMode}}
+{{#userPrompt}}
+Include execution results prominently before the phase summary.
+{{/userPrompt}}
+{{/mcpMode}}
+`;
+function renderAnycliTemplate(extras) {
+    return (0, babysitter_sdk_1.renderTemplateString)(ANYCLI_TEMPLATE, COMMAND_TEMPLATE_CONTEXT, extras);
+}
+function renderCommandTemplate(templateName, extras) {
+    if (templateName === "anycli") {
+        return renderAnycliTemplate(extras);
+    }
+    return (0, babysitter_sdk_1.renderCommandTemplate)(templateName, extras);
+}

package/dist/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export { createRun, orchestrateIteration, commitEffectResult, commitEffectCancellation, createReplayEngine, createProcessContext, withProcessContext, getActiveProcessContext, requireProcessContext, STATE_CACHE_SCHEMA_VERSION, createStateCacheSnapshot, journalHeadsEqual, normalizeJournalHead, normalizeSnapshot, readStateCache, rebuildStateCache, writeStateCache, hashInvocationKey, EffectRequestedError, EffectPendingError, EffectCancelledError, ParallelPendingError, RunFailedError, replaySchemaVersion, } from "@a5c-ai/babysitter-sdk";
+export type { OrchestrateOptions, IterationResult, EffectAction, CommitEffectResultOptions, CommitEffectResultArtifacts, ProcessContext, DefinedTask, CreateRunOptions, CreateRunResult, ReplayEngine, CreateReplayEngineOptions, StateCacheSnapshot, StateCacheJournalHead, DerivedEffectSummary, } from "@a5c-ai/babysitter-sdk";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,2BAA2B,EAC3B,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaySchemaVersion = exports.RunFailedError = exports.ParallelPendingError = exports.EffectCancelledError = exports.EffectPendingError = exports.EffectRequestedError = exports.hashInvocationKey = exports.writeStateCache = exports.rebuildStateCache = exports.readStateCache = exports.normalizeSnapshot = exports.normalizeJournalHead = exports.journalHeadsEqual = exports.createStateCacheSnapshot = exports.STATE_CACHE_SCHEMA_VERSION = exports.requireProcessContext = exports.getActiveProcessContext = exports.withProcessContext = exports.createProcessContext = exports.createReplayEngine = exports.commitEffectCancellation = exports.commitEffectResult = exports.orchestrateIteration = exports.createRun = void 0;
+var babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+Object.defineProperty(exports, "createRun", { enumerable: true, get: function () { return babysitter_sdk_1.createRun; } });
+Object.defineProperty(exports, "orchestrateIteration", { enumerable: true, get: function () { return babysitter_sdk_1.orchestrateIteration; } });
+Object.defineProperty(exports, "commitEffectResult", { enumerable: true, get: function () { return babysitter_sdk_1.commitEffectResult; } });
+Object.defineProperty(exports, "commitEffectCancellation", { enumerable: true, get: function () { return babysitter_sdk_1.commitEffectCancellation; } });
+Object.defineProperty(exports, "createReplayEngine", { enumerable: true, get: function () { return babysitter_sdk_1.createReplayEngine; } });
+Object.defineProperty(exports, "createProcessContext", { enumerable: true, get: function () { return babysitter_sdk_1.createProcessContext; } });
+Object.defineProperty(exports, "withProcessContext", { enumerable: true, get: function () { return babysitter_sdk_1.withProcessContext; } });
+Object.defineProperty(exports, "getActiveProcessContext", { enumerable: true, get: function () { return babysitter_sdk_1.getActiveProcessContext; } });
+Object.defineProperty(exports, "requireProcessContext", { enumerable: true, get: function () { return babysitter_sdk_1.requireProcessContext; } });
+Object.defineProperty(exports, "STATE_CACHE_SCHEMA_VERSION", { enumerable: true, get: function () { return babysitter_sdk_1.STATE_CACHE_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "createStateCacheSnapshot", { enumerable: true, get: function () { return babysitter_sdk_1.createStateCacheSnapshot; } });
+Object.defineProperty(exports, "journalHeadsEqual", { enumerable: true, get: function () { return babysitter_sdk_1.journalHeadsEqual; } });
+Object.defineProperty(exports, "normalizeJournalHead", { enumerable: true, get: function () { return babysitter_sdk_1.normalizeJournalHead; } });
+Object.defineProperty(exports, "normalizeSnapshot", { enumerable: true, get: function () { return babysitter_sdk_1.normalizeSnapshot; } });
+Object.defineProperty(exports, "readStateCache", { enumerable: true, get: function () { return babysitter_sdk_1.readStateCache; } });
+Object.defineProperty(exports, "rebuildStateCache", { enumerable: true, get: function () { return babysitter_sdk_1.rebuildStateCache; } });
+Object.defineProperty(exports, "writeStateCache", { enumerable: true, get: function () { return babysitter_sdk_1.writeStateCache; } });
+Object.defineProperty(exports, "hashInvocationKey", { enumerable: true, get: function () { return babysitter_sdk_1.hashInvocationKey; } });
+Object.defineProperty(exports, "EffectRequestedError", { enumerable: true, get: function () { return babysitter_sdk_1.EffectRequestedError; } });
+Object.defineProperty(exports, "EffectPendingError", { enumerable: true, get: function () { return babysitter_sdk_1.EffectPendingError; } });
+Object.defineProperty(exports, "EffectCancelledError", { enumerable: true, get: function () { return babysitter_sdk_1.EffectCancelledError; } });
+Object.defineProperty(exports, "ParallelPendingError", { enumerable: true, get: function () { return babysitter_sdk_1.ParallelPendingError; } });
+Object.defineProperty(exports, "RunFailedError", { enumerable: true, get: function () { return babysitter_sdk_1.RunFailedError; } });
+Object.defineProperty(exports, "replaySchemaVersion", { enumerable: true, get: function () { return babysitter_sdk_1.replaySchemaVersion; } });

package/dist/seams/contract.d.ts

@@ -0,0 +1,55 @@
+export type BabysitterAgentSeamVisibility = "public" | "internal";
+export interface BabysitterAgentSeamContract {
+    id: string;
+    owner: string;
+    visibility: BabysitterAgentSeamVisibility;
+    responsibilities: string[];
+    directories: string[];
+    packageExports: string[];
+    validationCommands: string[];
+}
+export declare const BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS: readonly ["npm run build --workspace=@a5c-ai/agent-platform", "npm run test --workspace=@a5c-ai/agent-platform"];
+export declare const babysitterAgentSeamContracts: readonly [{
+    readonly id: "runtime-foundation";
+    readonly owner: "runtime-core";
+    readonly visibility: "public";
+    readonly responsibilities: ["Own orchestration/runtime helpers that remain aligned with the SDK replay model.", "Own persisted run state, session continuity, task artifacts, and prompt/compression helpers used by runtime flows.", "Provide the default leaf seam to validate before proposing any extraction of runtime internals."];
+    readonly directories: ["runtime", "session", "storage", "tasks", "prompts", "compression"];
+    readonly packageExports: ["./runtime", "./session", "./storage", "./tasks"];
+    readonly validationCommands: ["npm run build --workspace=@a5c-ai/agent-platform", "npm run test --workspace=@a5c-ai/agent-platform"];
+}, {
+    readonly id: "governance-control";
+    readonly owner: "governance-control";
+    readonly visibility: "public";
+    readonly responsibilities: ["Own policy, authority, posture, and breakpoint decision logic.", "Keep human-approval flows and governance enforcement aligned before any package split is attempted."];
+    readonly directories: ["governance", "breakpoints"];
+    readonly packageExports: ["./governance"];
+    readonly validationCommands: ["npm run build --workspace=@a5c-ai/agent-platform", "npm run test --workspace=@a5c-ai/agent-platform"];
+}, {
+    readonly id: "integration-bridges";
+    readonly owner: "harness-integration";
+    readonly visibility: "public";
+    readonly responsibilities: ["Own harness invocation, agent-core integration, MCP transport/client glue, and API-facing orchestration adapters.", "Keep external integration surfaces grouped under one review boundary until a narrower runtime seam proves real."];
+    readonly directories: ["harness", "mcp", "api", "anycli"];
+    readonly packageExports: ["./harness", "./api", "./anycli"];
+    readonly validationCommands: ["npm run build --workspace=@a5c-ai/agent-platform", "npm run test --workspace=@a5c-ai/agent-platform"];
+}, {
+    readonly id: "operator-surfaces";
+    readonly owner: "runtime-operations";
+    readonly visibility: "public";
+    readonly responsibilities: ["Own operator-facing surfaces such as the CLI, daemon lifecycle, interaction UX, cost reporting, and observability helpers.", "Contain operational changes so user-facing workflows can be validated without reopening every runtime concern."];
+    readonly directories: ["cli", "daemon", "interaction", "observability", "cost"];
+    readonly packageExports: ["./cli", "./daemon", "./interaction", "./observability", "./cost"];
+    readonly validationCommands: ["npm run build --workspace=@a5c-ai/agent-platform", "npm run test --workspace=@a5c-ai/agent-platform"];
+}, {
+    readonly id: "seam-contract";
+    readonly owner: "v6-architecture";
+    readonly visibility: "public";
+    readonly responsibilities: ["Own the executable manifest that assigns every top-level src domain to a slice.", "Prevent new package-level domains from appearing without an explicit owner, visibility, and validation gate."];
+    readonly directories: ["seams"];
+    readonly packageExports: ["./seams"];
+    readonly validationCommands: ["npm run build --workspace=@a5c-ai/agent-platform", "npm run test --workspace=@a5c-ai/agent-platform"];
+}];
+export declare function listBabysitterAgentSeamDirectories(): string[];
+export declare function listBabysitterAgentPublicExports(): string[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/seams/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/seams/contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElE,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,6BAA6B,CAAC;IAC1C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,yCAAyC,kHAG5C,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwGkB,CAAC;AAE5D,wBAAgB,kCAAkC,IAAI,MAAM,EAAE,CAE7D;AAED,wBAAgB,gCAAgC,IAAI,MAAM,EAAE,CAE3D"}

package/dist/seams/contract.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.babysitterAgentSeamContracts = exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS = void 0;
+exports.listBabysitterAgentSeamDirectories = listBabysitterAgentSeamDirectories;
+exports.listBabysitterAgentPublicExports = listBabysitterAgentPublicExports;
+exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS = [
+    "npm run build --workspace=@a5c-ai/agent-platform",
+    "npm run test --workspace=@a5c-ai/agent-platform",
+];
+exports.babysitterAgentSeamContracts = [
+    {
+        id: "runtime-foundation",
+        owner: "runtime-core",
+        visibility: "public",
+        responsibilities: [
+            "Own orchestration/runtime helpers that remain aligned with the SDK replay model.",
+            "Own persisted run state, session continuity, task artifacts, and prompt/compression helpers used by runtime flows.",
+            "Provide the default leaf seam to validate before proposing any extraction of runtime internals.",
+        ],
+        directories: [
+            "runtime",
+            "session",
+            "storage",
+            "tasks",
+            "prompts",
+            "compression",
+        ],
+        packageExports: [
+            "./runtime",
+            "./session",
+            "./storage",
+            "./tasks",
+        ],
+        validationCommands: [...exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS],
+    },
+    {
+        id: "governance-control",
+        owner: "governance-control",
+        visibility: "public",
+        responsibilities: [
+            "Own policy, authority, posture, and breakpoint decision logic.",
+            "Keep human-approval flows and governance enforcement aligned before any package split is attempted.",
+        ],
+        directories: [
+            "governance",
+            "breakpoints",
+        ],
+        packageExports: [
+            "./governance",
+        ],
+        validationCommands: [...exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS],
+    },
+    {
+        id: "integration-bridges",
+        owner: "harness-integration",
+        visibility: "public",
+        responsibilities: [
+            "Own harness invocation, agent-core integration, MCP transport/client glue, and API-facing orchestration adapters.",
+            "Keep external integration surfaces grouped under one review boundary until a narrower runtime seam proves real.",
+        ],
+        directories: [
+            "harness",
+            "mcp",
+            "api",
+            "anycli",
+        ],
+        packageExports: [
+            "./harness",
+            "./api",
+            "./anycli",
+        ],
+        validationCommands: [...exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS],
+    },
+    {
+        id: "operator-surfaces",
+        owner: "runtime-operations",
+        visibility: "public",
+        responsibilities: [
+            "Own operator-facing surfaces such as the CLI, daemon lifecycle, interaction UX, cost reporting, and observability helpers.",
+            "Contain operational changes so user-facing workflows can be validated without reopening every runtime concern.",
+        ],
+        directories: [
+            "cli",
+            "daemon",
+            "interaction",
+            "observability",
+            "cost",
+        ],
+        packageExports: [
+            "./cli",
+            "./daemon",
+            "./interaction",
+            "./observability",
+            "./cost",
+        ],
+        validationCommands: [...exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS],
+    },
+    {
+        id: "seam-contract",
+        owner: "v6-architecture",
+        visibility: "public",
+        responsibilities: [
+            "Own the executable manifest that assigns every top-level src domain to a slice.",
+            "Prevent new package-level domains from appearing without an explicit owner, visibility, and validation gate.",
+        ],
+        directories: [
+            "seams",
+        ],
+        packageExports: [
+            "./seams",
+        ],
+        validationCommands: [...exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS],
+    },
+];
+function listBabysitterAgentSeamDirectories() {
+    return exports.babysitterAgentSeamContracts.flatMap((contract) => contract.directories);
+}
+function listBabysitterAgentPublicExports() {
+    return exports.babysitterAgentSeamContracts.flatMap((contract) => contract.packageExports);
+}

package/dist/seams/contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.test.d.ts.map

package/dist/seams/contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.test.d.ts","sourceRoot":"","sources":["../../src/seams/contract.test.ts"],"names":[],"mappings":""}

package/dist/seams/contract.test.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const contract_1 = require("./contract");
+const packageRoot = node_path_1.default.resolve(__dirname, "..", "..");
+const srcRoot = node_path_1.default.join(packageRoot, "src");
+const currentStateDocPath = node_path_1.default.resolve(packageRoot, "..", "..", "docs", "v6-spec-and-roadmap", "current-state.md");
+const seamAdrPath = node_path_1.default.resolve(packageRoot, "..", "..", "docs", "v6-spec-and-roadmap", "decisions", "ADR-001-agent-platform-seam-contract.md");
+(0, vitest_1.describe)("agent-platform seam contract", () => {
+    (0, vitest_1.test)("assigns every top-level src directory to exactly one seam", async () => {
+        const topLevelEntries = await node_fs_1.promises.readdir(srcRoot, { withFileTypes: true });
+        const topLevelDirectories = topLevelEntries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort();
+        (0, vitest_1.expect)((0, contract_1.listBabysitterAgentSeamDirectories)().sort()).toEqual(topLevelDirectories);
+    });
+    (0, vitest_1.test)("documents public subpath exports for every public seam", async () => {
+        const packageJson = JSON.parse(await node_fs_1.promises.readFile(node_path_1.default.join(packageRoot, "package.json"), "utf8"));
+        const exportedSubpaths = Object.keys(packageJson.exports ?? {}).sort();
+        (0, vitest_1.expect)(exportedSubpaths).toEqual([
+            ".",
+            "./anycli",
+            "./api",
+            "./cli",
+            "./cost",
+            "./daemon",
+            "./governance",
+            "./harness",
+            "./interaction",
+            "./observability",
+            "./package.json",
+            "./runtime",
+            "./seams",
+            "./session",
+            "./storage",
+            "./tasks",
+        ]);
+        (0, vitest_1.expect)((0, contract_1.listBabysitterAgentPublicExports)().sort()).toEqual([
+            "./anycli",
+            "./api",
+            "./cli",
+            "./cost",
+            "./daemon",
+            "./governance",
+            "./harness",
+            "./interaction",
+            "./observability",
+            "./runtime",
+            "./seams",
+            "./session",
+            "./storage",
+            "./tasks",
+        ]);
+    });
+    (0, vitest_1.test)("publishes both runtime CLI entrypoint aliases", async () => {
+        const packageJson = JSON.parse(await node_fs_1.promises.readFile(node_path_1.default.join(packageRoot, "package.json"), "utf8"));
+        (0, vitest_1.expect)(packageJson.bin).toEqual({
+            "agent-platform": "dist/cli/main.js",
+            "babysitter-harness": "dist/cli/main.js",
+        });
+    });
+    (0, vitest_1.test)("keeps the validation gate stable for every seam", () => {
+        (0, vitest_1.expect)(contract_1.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS).toEqual([
+            "npm run build --workspace=@a5c-ai/agent-platform",
+            "npm run test --workspace=@a5c-ai/agent-platform",
+        ]);
+        for (const contract of contract_1.babysitterAgentSeamContracts) {
+            (0, vitest_1.expect)(contract.validationCommands).toEqual([
+                "npm run build --workspace=@a5c-ai/agent-platform",
+                "npm run test --workspace=@a5c-ai/agent-platform",
+            ]);
+        }
+    });
+    (0, vitest_1.test)("anchors the seam contract in the V6 current-state doc", async () => {
+        const currentStateDoc = await node_fs_1.promises.readFile(currentStateDocPath, "utf8");
+        (0, vitest_1.expect)(currentStateDoc).toContain("`packages/agent-platform/src/seams/contract.ts`");
+        (0, vitest_1.expect)(currentStateDoc).toContain("`runtime-foundation`");
+        (0, vitest_1.expect)(currentStateDoc).toContain("`governance-control`");
+        (0, vitest_1.expect)(currentStateDoc).toContain("`integration-bridges`");
+        (0, vitest_1.expect)(currentStateDoc).toContain("`operator-surfaces`");
+        (0, vitest_1.expect)(currentStateDoc).toContain("`npm run verify:v6:seams`");
+    });
+    (0, vitest_1.test)("keeps the accepted ADR aligned with the seam validation command", async () => {
+        const seamAdr = await node_fs_1.promises.readFile(seamAdrPath, "utf8");
+        (0, vitest_1.expect)(seamAdr).toContain("# ADR-001: Agent-Platform Seam Contract As The First Executable V6 Slice");
+        (0, vitest_1.expect)(seamAdr).toContain("`packages/agent-platform/src/seams/contract.ts`");
+        (0, vitest_1.expect)(seamAdr).toContain("npm run verify:v6:seams");
+        (0, vitest_1.expect)(seamAdr).toContain("`@a5c-ai/agent-platform`");
+    });
+});

package/dist/seams/index.d.ts

@@ -0,0 +1,3 @@
+export { BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS, babysitterAgentSeamContracts, listBabysitterAgentPublicExports, listBabysitterAgentSeamDirectories, } from "./contract";
+export type { BabysitterAgentSeamContract, BabysitterAgentSeamVisibility, } from "./contract";
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seams/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yCAAyC,EACzC,4BAA4B,EAC5B,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

package/dist/seams/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listBabysitterAgentSeamDirectories = exports.listBabysitterAgentPublicExports = exports.babysitterAgentSeamContracts = exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS = void 0;
+var contract_1 = require("./contract");
+Object.defineProperty(exports, "BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS", { enumerable: true, get: function () { return contract_1.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS; } });
+Object.defineProperty(exports, "babysitterAgentSeamContracts", { enumerable: true, get: function () { return contract_1.babysitterAgentSeamContracts; } });
+Object.defineProperty(exports, "listBabysitterAgentPublicExports", { enumerable: true, get: function () { return contract_1.listBabysitterAgentPublicExports; } });
+Object.defineProperty(exports, "listBabysitterAgentSeamDirectories", { enumerable: true, get: function () { return contract_1.listBabysitterAgentSeamDirectories; } });

package/dist/session/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Session context persistence for cross-run knowledge sharing (GAP-SESSION-001).
+ * Stores accumulated notes and shared knowledge as a JSON file alongside the session state file.
+ */
+import type { SessionContext } from './types';
+/**
+ * Get the file path for a session's context JSON file.
+ */
+export declare function getSessionContextPath(stateDir: string, sessionId: string): string;
+/**
+ * Read session context from disk.
+ * Returns empty context if the file does not exist.
+ * Logs a warning and returns empty context if the file is corrupt.
+ */
+export declare function getSessionContext(stateDir: string, sessionId: string): Promise<SessionContext>;
+/**
+ * Update session context by merging new data with existing context.
+ * Notes are appended; sharedKnowledge keys are merged (newer values win).
+ * Uses atomic temp-file + rename pattern to prevent partial writes.
+ */
+export declare function updateSessionContext(stateDir: string, sessionId: string, updates: Partial<SessionContext>): Promise<SessionContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/session/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/session/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAQD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA4BpG;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,CAoBzB"}