@a5c-ai/genty-runtime 5.1.1-staging.5e92128884d3

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Resources module — budget, concurrency, and timeout management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceManagerImpl = exports.TimeoutCascade = exports.ConcurrencyLimitError = exports.ConcurrencyGuard = exports.BudgetExceededError = exports.BudgetTracker = void 0;
+// Budget tracking
+var budget_tracker_1 = require("./budget-tracker");
+Object.defineProperty(exports, "BudgetTracker", { enumerable: true, get: function () { return budget_tracker_1.BudgetTracker; } });
+Object.defineProperty(exports, "BudgetExceededError", { enumerable: true, get: function () { return budget_tracker_1.BudgetExceededError; } });
+// Concurrency
+var concurrency_guard_1 = require("./concurrency-guard");
+Object.defineProperty(exports, "ConcurrencyGuard", { enumerable: true, get: function () { return concurrency_guard_1.ConcurrencyGuard; } });
+Object.defineProperty(exports, "ConcurrencyLimitError", { enumerable: true, get: function () { return concurrency_guard_1.ConcurrencyLimitError; } });
+// Timeout cascade
+var timeout_cascade_1 = require("./timeout-cascade");
+Object.defineProperty(exports, "TimeoutCascade", { enumerable: true, get: function () { return timeout_cascade_1.TimeoutCascade; } });
+// Unified manager
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "ResourceManagerImpl", { enumerable: true, get: function () { return manager_1.ResourceManagerImpl; } });

package/dist/resources/manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Unified resource manager that composes budget trackers, a concurrency
+ * guard, and a timeout cascade into the `ResourceManager` interface.
+ */
+import type { BudgetKind, CostBudget, ResourceManager, ResourceAdmissionDecision, ResourceAdmissionRequest, ResourceSnapshot, ResourceWarningCallback, TokenBudget } from "./types";
+import type { ExecutionPolicy, ResourceAdmission } from "../execution";
+import { ConcurrencyGuard } from "./concurrency-guard";
+import { TimeoutCascade } from "./timeout-cascade";
+/** Options for constructing a `ResourceManagerImpl`. */
+export interface ResourceManagerOptions {
+    /** Token budget limit. */
+    tokenLimit: number;
+    /** Cost budget limit. */
+    costLimit: number;
+    /** ISO 4217 currency code for cost budget. Defaults to "USD". */
+    costCurrency?: string;
+    /** Warning threshold percentage (0–100) for both budgets. */
+    warningThresholdPercent?: number;
+    /** Concurrency limits. */
+    concurrency?: {
+        maxParallelEffects?: number;
+        maxParallelRuns?: number;
+        maxParallelSessions?: number;
+    };
+}
+export declare class ResourceManagerImpl implements ResourceManager {
+    private readonly _tokenBudget;
+    private readonly _costBudget;
+    private readonly _costCurrency;
+    private readonly _warningThresholdPercent;
+    /** Concurrency guard for parallel effects. */
+    readonly effects: ConcurrencyGuard;
+    /** Concurrency guard for parallel runs. */
+    readonly runs: ConcurrencyGuard;
+    /** Concurrency guard for parallel sessions. */
+    readonly sessions: ConcurrencyGuard;
+    /** Timeout cascade for run / iteration / effect timeouts. */
+    readonly timeouts: TimeoutCascade;
+    private readonly _warningCallbacks;
+    constructor(options: ResourceManagerOptions);
+    checkBudget(kind: BudgetKind): TokenBudget | CostBudget;
+    consume(kind: BudgetKind, amount: number): void;
+    admit(request: ResourceAdmissionRequest): ResourceAdmissionDecision;
+    release(kind: BudgetKind, amount: number): void;
+    getSnapshot(): ResourceSnapshot;
+    onWarning(callback: ResourceWarningCallback): void;
+    admitExecutionPolicy(policy: ExecutionPolicy): ResourceAdmission;
+    private _trackerFor;
+    private _snapshot;
+    private _fireWarning;
+}
+//# sourceMappingURL=manager.d.ts.map

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,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGvE,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,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,yBAAyB;IAqCnE,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;IAIlD,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB;IAMhE,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,YAAY;CAerB"}

package/dist/resources/manager.js

@@ -0,0 +1,150 @@
+"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 execution_1 = require("../execution");
+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);
+    }
+    admit(request) {
+        const tokens = request.tokens ?? 0;
+        const cost = request.cost ?? 0;
+        if (tokens < 0 || cost < 0) {
+            return {
+                allowed: false,
+                reason: "Resource admission amounts must be non-negative",
+                snapshot: this.getSnapshot(),
+            };
+        }
+        const tokenBudget = this._tokenBudget.check();
+        if (tokens > tokenBudget.remaining) {
+            return {
+                allowed: false,
+                reason: `tokens budget exceeded: requested ${tokens}, remaining ${tokenBudget.remaining}`,
+                snapshot: this.getSnapshot(),
+            };
+        }
+        const costBudget = this._costBudget.check();
+        if (cost > costBudget.remaining) {
+            return {
+                allowed: false,
+                reason: `cost budget exceeded: requested ${cost}, remaining ${costBudget.remaining}`,
+                snapshot: this.getSnapshot(),
+            };
+        }
+        if (tokens > 0)
+            this._tokenBudget.consume(tokens);
+        if (cost > 0)
+            this._costBudget.consume(cost);
+        return {
+            allowed: true,
+            snapshot: this.getSnapshot(),
+        };
+    }
+    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);
+    }
+    admitExecutionPolicy(policy) {
+        return (0, execution_1.admitExecutionPolicy)(policy);
+    }
+    // -- 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,130 @@
+/**
+ * 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;
+export interface ResourceAdmissionRequest {
+    readonly tokens?: number;
+    readonly cost?: number;
+}
+export interface ResourceAdmissionDecision {
+    readonly allowed: boolean;
+    readonly reason?: string;
+    readonly snapshot: ResourceSnapshot;
+}
+/** 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;
+    /**
+     * Atomically check and reserve resources before dispatching new work.
+     *
+     * A denied decision must not mutate budget state.
+     */
+    admit(request: ResourceAdmissionRequest): ResourceAdmissionDecision;
+    /**
+     * 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;
+    /**
+     * Admit OS execution limits into the resource layer.
+     *
+     * This records the policy seam for executors. ResourceManager does not apply
+     * kernel limits directly; concrete executors translate accepted limits.
+     */
+    admitExecutionPolicy(policy: import("../execution").ExecutionPolicy): import("../execution").ResourceAdmission;
+}
+//# 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":"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"}

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