@a5c-ai/agent-platform 5.0.1-staging.016f0b0e8119

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,63 @@
+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", "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", "./mcp/transport", "./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 platform helpers such as daemon lifecycle, interaction UX, cost reporting, and observability helpers.", "Contain operational support changes so user-facing workflows can be validated without reopening every runtime concern."];
+    readonly directories: ["daemon", "interaction", "observability", "cost"];
+    readonly packageExports: ["./daemon", "./interaction", "./observability", "./cost"];
+    readonly validationCommands: ["npm run build --workspace=@a5c-ai/agent-platform", "npm run test --workspace=@a5c-ai/agent-platform"];
+}, {
+    readonly id: "platform-capabilities";
+    readonly owner: "platform-core";
+    readonly visibility: "public";
+    readonly responsibilities: ["Own L6 platform capabilities: skill routing, process recommendation, and plugin sandboxing.", "Keep capability implementations grouped under one review boundary."];
+    readonly directories: ["skills", "processes", "plugins"];
+    readonly packageExports: ["./skills", "./processes", "./plugins"];
+    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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0HkB,CAAC;AAE5D,wBAAgB,kCAAkC,IAAI,MAAM,EAAE,CAE7D;AAED,wBAAgB,gCAAgC,IAAI,MAAM,EAAE,CAE3D"}

package/dist/seams/contract.js

@@ -0,0 +1,138 @@
+"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",
+            "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",
+            "./mcp/transport",
+            "./anycli",
+        ],
+        validationCommands: [...exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS],
+    },
+    {
+        id: "operator-surfaces",
+        owner: "runtime-operations",
+        visibility: "public",
+        responsibilities: [
+            "Own operator-facing platform helpers such as daemon lifecycle, interaction UX, cost reporting, and observability helpers.",
+            "Contain operational support changes so user-facing workflows can be validated without reopening every runtime concern.",
+        ],
+        directories: [
+            "daemon",
+            "interaction",
+            "observability",
+            "cost",
+        ],
+        packageExports: [
+            "./daemon",
+            "./interaction",
+            "./observability",
+            "./cost",
+        ],
+        validationCommands: [...exports.BABYSITTER_AGENT_SEAM_VALIDATION_COMMANDS],
+    },
+    {
+        id: "platform-capabilities",
+        owner: "platform-core",
+        visibility: "public",
+        responsibilities: [
+            "Own L6 platform capabilities: skill routing, process recommendation, and plugin sandboxing.",
+            "Keep capability implementations grouped under one review boundary.",
+        ],
+        directories: [
+            "skills",
+            "processes",
+            "plugins",
+        ],
+        packageExports: [
+            "./skills",
+            "./processes",
+            "./plugins",
+        ],
+        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,99 @@
+"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",
+            "./cost",
+            "./daemon",
+            "./governance",
+            "./harness",
+            "./interaction",
+            "./mcp/transport",
+            "./observability",
+            "./package.json",
+            "./plugins",
+            "./processes",
+            "./runtime",
+            "./seams",
+            "./session",
+            "./skills",
+            "./storage",
+            "./tasks",
+        ]);
+        (0, vitest_1.expect)((0, contract_1.listBabysitterAgentPublicExports)().sort()).toEqual([
+            "./anycli",
+            "./api",
+            "./cost",
+            "./daemon",
+            "./governance",
+            "./harness",
+            "./interaction",
+            "./mcp/transport",
+            "./observability",
+            "./plugins",
+            "./processes",
+            "./runtime",
+            "./seams",
+            "./session",
+            "./skills",
+            "./storage",
+            "./tasks",
+        ]);
+    });
+    (0, vitest_1.test)("does not publish product 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).toBeUndefined();
+    });
+    (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"}

package/dist/session/context.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionContextPath = getSessionContextPath;
+exports.getSessionContext = getSessionContext;
+exports.updateSessionContext = updateSessionContext;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+/**
+ * Get the file path for a session's context JSON file.
+ */
+function getSessionContextPath(stateDir, sessionId) {
+    return `${stateDir}/${sessionId}.context.json`;
+}
+const EMPTY_CONTEXT = {
+    notes: [],
+    sharedKnowledge: {},
+    worktree: undefined,
+};
+/**
+ * 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.
+ */
+async function getSessionContext(stateDir, sessionId) {
+    const filePath = getSessionContextPath(stateDir, sessionId);
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return { ...EMPTY_CONTEXT, sharedKnowledge: {} };
+        }
+        // Unexpected FS error — return empty rather than crash
+        return { ...EMPTY_CONTEXT, sharedKnowledge: {} };
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            notes: Array.isArray(data.notes) ? data.notes : [],
+            sharedKnowledge: data.sharedKnowledge && typeof data.sharedKnowledge === 'object'
+                ? data.sharedKnowledge
+                : {},
+            worktree: data.worktree && typeof data.worktree === 'object'
+                ? data.worktree
+                : undefined,
+        };
+    }
+    catch {
+        // Corrupt JSON — return empty context rather than crash
+        return { ...EMPTY_CONTEXT, sharedKnowledge: {} };
+    }
+}
+/**
+ * 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.
+ */
+async function updateSessionContext(stateDir, sessionId, updates) {
+    const existing = await getSessionContext(stateDir, sessionId);
+    const merged = {
+        notes: updates.notes ? [...existing.notes, ...updates.notes] : existing.notes,
+        sharedKnowledge: updates.sharedKnowledge
+            ? { ...existing.sharedKnowledge, ...updates.sharedKnowledge }
+            : existing.sharedKnowledge,
+        worktree: updates.worktree ? { ...(existing.worktree ?? {}), ...updates.worktree } : existing.worktree,
+    };
+    const filePath = getSessionContextPath(stateDir, sessionId);
+    const dir = path.dirname(filePath);
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    await node_fs_1.promises.writeFile(tempPath, JSON.stringify(merged), 'utf8');
+    await node_fs_1.promises.rename(tempPath, filePath);
+    return merged;
+}

package/dist/session/continuityState.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GAP-PERF-008: Structured Continuity State.
+ *
+ * Structured state that persists across session compaction. Captures
+ * key decisions, current phase, and working context for seamless
+ * resume after context compression.
+ */
+export interface ContinuityPhase {
+    name: string;
+    startedAt: string;
+    description: string;
+}
+export interface ContinuityDecision {
+    key: string;
+    value: string;
+    rationale?: string;
+    madeAt: string;
+    runId?: string;
+}
+export interface ContinuityWorkingContext {
+    focus: string;
+    blockers: string[];
+    nextSteps: string[];
+}
+export interface ContinuityState {
+    schemaVersion: string;
+    updatedAt: string;
+    currentPhase: ContinuityPhase | null;
+    decisions: ContinuityDecision[];
+    workingContext: ContinuityWorkingContext;
+}
+export declare const CONTINUITY_STATE_SCHEMA_VERSION = "2026.01.continuity-state-v1";
+export declare function getContinuityStatePath(stateDir: string, sessionId: string): string;
+export declare function getContinuityState(stateDir: string, sessionId: string): Promise<ContinuityState>;
+export declare function setCurrentPhase(stateDir: string, sessionId: string, phase: Omit<ContinuityPhase, "startedAt">): Promise<void>;
+export declare function upsertDecision(stateDir: string, sessionId: string, decision: Omit<ContinuityDecision, "madeAt">): Promise<void>;
+export declare function updateWorkingContext(stateDir: string, sessionId: string, updates: Partial<ContinuityWorkingContext>): Promise<void>;
+export declare function buildContinuityResumePrompt(stateDir: string, sessionId: string): Promise<string>;
+//# sourceMappingURL=continuityState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"continuityState.d.ts","sourceRoot":"","sources":["../../src/session/continuityState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,cAAc,EAAE,wBAAwB,CAAC;CAC1C;AAMD,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAiD7E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAEtG;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CA2BjB"}