@a5c-ai/agent-runtime 5.0.1-staging.04ca6ab00d21

package/dist/resources/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/resources/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMnD,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0BAA0B;IAC1B,WAAW,CAAC,EAAE;QACZ,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAMD,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAElD,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;gBAEvD,OAAO,EAAE,sBAAsB;IAwB3C,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU;IAIvD,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/C,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/C,WAAW,IAAI,gBAAgB;IAa/B,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAMlD,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,YAAY;CAerB"}

package/dist/resources/manager.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Unified resource manager that composes budget trackers, a concurrency
+ * guard, and a timeout cascade into the `ResourceManager` interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceManagerImpl = void 0;
+const budget_tracker_1 = require("./budget-tracker");
+const concurrency_guard_1 = require("./concurrency-guard");
+const timeout_cascade_1 = require("./timeout-cascade");
+// ---------------------------------------------------------------------------
+// ResourceManagerImpl
+// ---------------------------------------------------------------------------
+class ResourceManagerImpl {
+    _tokenBudget;
+    _costBudget;
+    _costCurrency;
+    _warningThresholdPercent;
+    /** Concurrency guard for parallel effects. */
+    effects;
+    /** Concurrency guard for parallel runs. */
+    runs;
+    /** Concurrency guard for parallel sessions. */
+    sessions;
+    /** Timeout cascade for run / iteration / effect timeouts. */
+    timeouts;
+    _warningCallbacks = [];
+    constructor(options) {
+        this._tokenBudget = new budget_tracker_1.BudgetTracker(options.tokenLimit);
+        this._costBudget = new budget_tracker_1.BudgetTracker(options.costLimit);
+        this._costCurrency = options.costCurrency ?? "USD";
+        this._warningThresholdPercent = options.warningThresholdPercent ?? 80;
+        const cc = options.concurrency ?? {};
+        this.effects = new concurrency_guard_1.ConcurrencyGuard(cc.maxParallelEffects ?? 8);
+        this.runs = new concurrency_guard_1.ConcurrencyGuard(cc.maxParallelRuns ?? 4);
+        this.sessions = new concurrency_guard_1.ConcurrencyGuard(cc.maxParallelSessions ?? 4);
+        this.timeouts = new timeout_cascade_1.TimeoutCascade();
+        // Wire up threshold warnings.
+        this._tokenBudget.onThreshold(this._warningThresholdPercent, () => {
+            this._fireWarning("tokens");
+        });
+        this._costBudget.onThreshold(this._warningThresholdPercent, () => {
+            this._fireWarning("cost");
+        });
+    }
+    // -- ResourceManager interface --------------------------------------------
+    checkBudget(kind) {
+        return this._snapshot(kind);
+    }
+    consume(kind, amount) {
+        this._trackerFor(kind).consume(amount);
+    }
+    release(kind, amount) {
+        this._trackerFor(kind).release(amount);
+    }
+    getSnapshot() {
+        return {
+            tokens: this._snapshot("tokens"),
+            cost: this._snapshot("cost"),
+            concurrency: {
+                maxParallelEffects: this.effects.active,
+                maxParallelRuns: this.runs.active,
+                maxParallelSessions: this.sessions.active,
+            },
+            timestamp: new Date().toISOString(),
+        };
+    }
+    onWarning(callback) {
+        this._warningCallbacks.push(callback);
+    }
+    // -- Helpers --------------------------------------------------------------
+    _trackerFor(kind) {
+        return kind === "tokens" ? this._tokenBudget : this._costBudget;
+    }
+    _snapshot(kind) {
+        const tracker = this._trackerFor(kind);
+        if (kind === "tokens") {
+            const snap = {
+                limit: tracker.limit,
+                used: tracker.used,
+                remaining: tracker.remaining,
+                warningThreshold: this._warningThresholdPercent / 100,
+            };
+            return snap;
+        }
+        const snap = {
+            limit: tracker.limit,
+            used: tracker.used,
+            remaining: tracker.remaining,
+            currency: this._costCurrency,
+        };
+        return snap;
+    }
+    _fireWarning(kind) {
+        const budget = this._snapshot(kind);
+        const warning = {
+            kind,
+            budget,
+            timestamp: new Date().toISOString(),
+        };
+        for (const cb of this._warningCallbacks) {
+            try {
+                cb(warning);
+            }
+            catch {
+                // Swallow subscriber errors to avoid breaking the manager.
+            }
+        }
+    }
+}
+exports.ResourceManagerImpl = ResourceManagerImpl;

package/dist/resources/timeout-cascade.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Nested timeout management with cascading abort signals.
+ *
+ * Manages timeouts at three levels: run -> iteration -> effect.
+ * When a parent timeout fires (or is cleared), all children are
+ * automatically aborted.
+ */
+/** Handle returned by each `create*Timeout` method. */
+export interface TimeoutHandle {
+    /** AbortSignal that fires when the timeout elapses or is cancelled. */
+    readonly signal: AbortSignal;
+    /** Manually clear the timeout and abort any children. */
+    clear(): void;
+}
+export declare class TimeoutCascade {
+    private _run;
+    private _iteration;
+    /**
+     * Create a run-level timeout.
+     *
+     * Clears any existing run (and its children) before creating a new one.
+     */
+    createRunTimeout(ms: number): TimeoutHandle;
+    /**
+     * Create an iteration-level timeout nested under the current run.
+     *
+     * Clears any existing iteration (and its effect children) first.
+     *
+     * @throws {Error} if no run timeout is active.
+     */
+    createIterationTimeout(ms: number): TimeoutHandle;
+    /**
+     * Create an effect-level timeout nested under the current iteration.
+     *
+     * @throws {Error} if no iteration timeout is active.
+     */
+    createEffectTimeout(ms: number): TimeoutHandle;
+    /**
+     * Tear down all active timeouts (run, iteration, and effects).
+     */
+    clearAll(): void;
+    /**
+     * Create a new `TimeoutNode`, register it as a child of `parent` (if any),
+     * and set up parent-abort cascading.
+     */
+    private _createNode;
+    /** Abort a node and all of its children recursively. */
+    private _abortNode;
+    /** Clear a node: abort it and all descendants. */
+    private _clearNode;
+    /** Remove a child from a parent's children array. */
+    private _removeChild;
+    /** Create a public `TimeoutHandle` for a node. */
+    private _handleFor;
+}
+//# sourceMappingURL=timeout-cascade.d.ts.map

package/dist/resources/timeout-cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-cascade.d.ts","sourceRoot":"","sources":["../../src/resources/timeout-cascade.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,yDAAyD;IACzD,KAAK,IAAI,IAAI,CAAC;CACf;AAgBD,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,UAAU,CAA0B;IAI5C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAY3C;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAiBjD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAW9C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAUhB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAwCnB,wDAAwD;IACxD,OAAO,CAAC,UAAU;IAclB,kDAAkD;IAClD,OAAO,CAAC,UAAU;IAIlB,qDAAqD;IACrD,OAAO,CAAC,YAAY;IAOpB,kDAAkD;IAClD,OAAO,CAAC,UAAU;CAQnB"}

package/dist/resources/timeout-cascade.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Nested timeout management with cascading abort signals.
+ *
+ * Manages timeouts at three levels: run -> iteration -> effect.
+ * When a parent timeout fires (or is cleared), all children are
+ * automatically aborted.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutCascade = void 0;
+// ---------------------------------------------------------------------------
+// TimeoutCascade
+// ---------------------------------------------------------------------------
+class TimeoutCascade {
+    _run;
+    _iteration;
+    // -- Factory methods ------------------------------------------------------
+    /**
+     * Create a run-level timeout.
+     *
+     * Clears any existing run (and its children) before creating a new one.
+     */
+    createRunTimeout(ms) {
+        // Tear down any previous run hierarchy.
+        if (this._run) {
+            this._clearNode(this._run);
+        }
+        this._run = this._createNode(ms, undefined);
+        this._iteration = undefined; // Children belong to previous run.
+        return this._handleFor(this._run);
+    }
+    /**
+     * Create an iteration-level timeout nested under the current run.
+     *
+     * Clears any existing iteration (and its effect children) first.
+     *
+     * @throws {Error} if no run timeout is active.
+     */
+    createIterationTimeout(ms) {
+        if (!this._run) {
+            throw new Error("Cannot create iteration timeout: no run timeout is active");
+        }
+        // Tear down previous iteration.
+        if (this._iteration) {
+            this._removeChild(this._run, this._iteration);
+            this._clearNode(this._iteration);
+        }
+        this._iteration = this._createNode(ms, this._run);
+        return this._handleFor(this._iteration);
+    }
+    /**
+     * Create an effect-level timeout nested under the current iteration.
+     *
+     * @throws {Error} if no iteration timeout is active.
+     */
+    createEffectTimeout(ms) {
+        if (!this._iteration) {
+            throw new Error("Cannot create effect timeout: no iteration timeout is active");
+        }
+        const node = this._createNode(ms, this._iteration);
+        return this._handleFor(node);
+    }
+    /**
+     * Tear down all active timeouts (run, iteration, and effects).
+     */
+    clearAll() {
+        if (this._run) {
+            this._clearNode(this._run);
+            this._run = undefined;
+            this._iteration = undefined;
+        }
+    }
+    // -- Internals ------------------------------------------------------------
+    /**
+     * Create a new `TimeoutNode`, register it as a child of `parent` (if any),
+     * and set up parent-abort cascading.
+     */
+    _createNode(ms, parent) {
+        const controller = new AbortController();
+        const node = {
+            controller,
+            timer: undefined,
+            children: [],
+        };
+        // Schedule the timeout.
+        node.timer = setTimeout(() => {
+            node.timer = undefined;
+            this._abortNode(node);
+        }, ms);
+        // If the parent is already aborted, abort immediately.
+        if (parent) {
+            if (parent.controller.signal.aborted) {
+                clearTimeout(node.timer);
+                node.timer = undefined;
+                controller.abort(parent.controller.signal.reason);
+            }
+            else {
+                parent.children.push(node);
+                // Listen for parent abort to cascade.
+                const onParentAbort = () => {
+                    this._abortNode(node);
+                };
+                parent.controller.signal.addEventListener("abort", onParentAbort, {
+                    once: true,
+                });
+            }
+        }
+        return node;
+    }
+    /** Abort a node and all of its children recursively. */
+    _abortNode(node) {
+        if (node.timer !== undefined) {
+            clearTimeout(node.timer);
+            node.timer = undefined;
+        }
+        if (!node.controller.signal.aborted) {
+            node.controller.abort(new Error("Timeout elapsed"));
+        }
+        for (const child of node.children) {
+            this._abortNode(child);
+        }
+        node.children.length = 0;
+    }
+    /** Clear a node: abort it and all descendants. */
+    _clearNode(node) {
+        this._abortNode(node);
+    }
+    /** Remove a child from a parent's children array. */
+    _removeChild(parent, child) {
+        const idx = parent.children.indexOf(child);
+        if (idx !== -1) {
+            parent.children.splice(idx, 1);
+        }
+    }
+    /** Create a public `TimeoutHandle` for a node. */
+    _handleFor(node) {
+        return {
+            signal: node.controller.signal,
+            clear: () => {
+                this._clearNode(node);
+            },
+        };
+    }
+}
+exports.TimeoutCascade = TimeoutCascade;

package/dist/resources/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Resource management interfaces for Babysitter Agent Runtime.
+ *
+ * Covers budget tracking (tokens, cost), concurrency limits, timeouts,
+ * and a unified resource manager. Interface-only stubs; implementations
+ * will follow in issue #217.
+ */
+/** Token consumption budget for a run or session. */
+export interface TokenBudget {
+    /** Maximum allowed tokens. */
+    readonly limit: number;
+    /** Tokens consumed so far. */
+    readonly used: number;
+    /** Tokens remaining (`limit - used`). */
+    readonly remaining: number;
+    /** Optional threshold (0-1) at which a warning callback fires. */
+    readonly warningThreshold?: number;
+}
+/** Monetary cost budget for a run or session. */
+export interface CostBudget {
+    /** Maximum allowed cost. */
+    readonly limit: number;
+    /** Cost consumed so far. */
+    readonly used: number;
+    /** Cost remaining (`limit - used`). */
+    readonly remaining: number;
+    /** ISO 4217 currency code; defaults to "USD". */
+    readonly currency?: string;
+}
+/** Hard caps on parallel work within a single orchestration scope. */
+export interface ConcurrencyLimits {
+    /** Maximum effects that may execute in parallel. */
+    readonly maxParallelEffects: number;
+    /** Maximum babysitter runs that may execute in parallel. */
+    readonly maxParallelRuns: number;
+    /** Maximum Claude Code sessions that may execute in parallel. */
+    readonly maxParallelSessions: number;
+}
+/** Timeout configuration at various granularity levels. */
+export interface TimeoutConfig {
+    /** Maximum wall-clock duration for a single effect (ms). */
+    readonly perEffect?: number;
+    /** Maximum wall-clock duration for a single iteration (ms). */
+    readonly perIteration?: number;
+    /** Maximum wall-clock duration for an entire run (ms). */
+    readonly perRun?: number;
+    /** Policy applied when a timeout fires (e.g. "cancel", "warn", "escalate"). */
+    readonly escalationPolicy?: string;
+}
+/** Point-in-time snapshot of all tracked resource dimensions. */
+export interface ResourceSnapshot {
+    /** Current token budget state. */
+    readonly tokens: TokenBudget;
+    /** Current cost budget state. */
+    readonly cost: CostBudget;
+    /** Current concurrency utilisation (used counts, not limits). */
+    readonly concurrency: ConcurrencyLimits;
+    /** ISO-8601 timestamp when this snapshot was captured. */
+    readonly timestamp: string;
+}
+/** Discriminator for the type of budget being queried or mutated. */
+export type BudgetKind = "tokens" | "cost";
+/** Payload delivered to resource-warning subscribers. */
+export interface ResourceWarning {
+    /** Which budget triggered the warning. */
+    readonly kind: BudgetKind;
+    /** The budget state at the time of the warning. */
+    readonly budget: TokenBudget | CostBudget;
+    /** ISO-8601 timestamp of the warning. */
+    readonly timestamp: string;
+}
+/** Callback signature for resource warning notifications. */
+export type ResourceWarningCallback = (warning: ResourceWarning) => void;
+/** Unified resource manager for budget enforcement and reporting. */
+export interface ResourceManager {
+    /**
+     * Check the current budget state for a given kind.
+     *
+     * @param kind - "tokens" or "cost".
+     * @returns The corresponding budget snapshot.
+     */
+    checkBudget(kind: BudgetKind): TokenBudget | CostBudget;
+    /**
+     * Record consumption against a budget.
+     *
+     * @param kind - Which budget to charge.
+     * @param amount - Units to consume.
+     */
+    consume(kind: BudgetKind, amount: number): void;
+    /**
+     * Release previously consumed units back into a budget (e.g. on rollback).
+     *
+     * @param kind - Which budget to credit.
+     * @param amount - Units to release.
+     */
+    release(kind: BudgetKind, amount: number): void;
+    /**
+     * Capture a point-in-time snapshot of all resource dimensions.
+     */
+    getSnapshot(): ResourceSnapshot;
+    /**
+     * Register a callback that fires when any budget crosses its warning threshold.
+     *
+     * @param callback - Function invoked with the warning payload.
+     */
+    onWarning(callback: ResourceWarningCallback): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAMD,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAMD,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAM3C,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;IAC1C,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;AAMzE,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IAExD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,WAAW,IAAI,gBAAgB,CAAC;IAEhC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACpD"}

package/dist/resources/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Resource management interfaces for Babysitter Agent Runtime.
+ *
+ * Covers budget tracking (tokens, cost), concurrency limits, timeouts,
+ * and a unified resource manager. Interface-only stubs; implementations
+ * will follow in issue #217.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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"}