@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.0

package/dist/stores/batch-registry.js

@@ -0,0 +1,171 @@
+export function isTerminal(s) {
+    return s === 'complete' || s === 'failed' || s === 'expired';
+}
+export class InvalidBatchStateError extends Error {
+    currentState;
+    constructor(currentState) {
+        super(`invalid_batch_state: currently ${currentState}`);
+        this.currentState = currentState;
+        this.name = 'InvalidBatchStateError';
+    }
+}
+export class BatchRegistry {
+    map = new Map();
+    options;
+    deps;
+    constructor(options = {}, deps = {}) {
+        this.options = {
+            batchTtlMs: options.batchTtlMs ?? 60 * 60 * 1000,
+            max: options.max ?? 200,
+        };
+        this.deps = deps;
+    }
+    register(input) {
+        if (!input.runningHeadlineSnapshot) {
+            const N = input.tasksTotal ?? 1;
+            input.runningHeadlineSnapshot = {
+                prefix: '',
+                statsClause: '',
+                dispatchedAt: Date.now(),
+                fallback: `0/${N} queued`,
+            };
+        }
+        const entry = input;
+        this.map.set(entry.batchId, entry);
+        if (this.deps.contextBlockStore) {
+            for (const bid of entry.blockIds) {
+                this.deps.contextBlockStore.pin(bid);
+            }
+        }
+    }
+    get(batchId) {
+        return this.map.get(batchId);
+    }
+    updateRunningHeadlineSnapshot(batchId, snapshot) {
+        const entry = this.map.get(batchId);
+        if (!entry)
+            return;
+        if (isTerminal(entry.state))
+            return;
+        entry.runningHeadlineSnapshot = snapshot;
+    }
+    delete(batchId) {
+        return this.map.delete(batchId);
+    }
+    recordTerminalBlock(batchId, taskIndex, blockId) {
+        const entry = this.map.get(batchId);
+        if (!entry)
+            throw new Error(`unknown batchId: ${batchId}`);
+        if (!entry.terminalBlockIds)
+            entry.terminalBlockIds = new Map();
+        entry.terminalBlockIds.set(taskIndex, blockId);
+    }
+    getTerminalBlock(batchId, taskIndex) {
+        return this.map.get(batchId)?.terminalBlockIds?.get(taskIndex);
+    }
+    size() {
+        return this.map.size;
+    }
+    entries() {
+        return this.map.values();
+    }
+    complete(batchId, result) {
+        const entry = this.map.get(batchId);
+        if (!entry)
+            return;
+        if (isTerminal(entry.state))
+            return; // idempotent
+        entry.state = 'complete';
+        entry.result = result;
+        entry.stateChangedAt = Date.now();
+        this.release(entry);
+    }
+    fail(batchId, error) {
+        const entry = this.map.get(batchId);
+        if (!entry)
+            return;
+        if (isTerminal(entry.state))
+            return; // idempotent
+        entry.state = 'failed';
+        entry.error = error;
+        entry.stateChangedAt = Date.now();
+        this.release(entry);
+    }
+    runExpirySweep() {
+        const now = Date.now();
+        const toDelete = [];
+        for (const entry of this.map.values()) {
+            if (entry.state === 'expired') {
+                // second-pass: delete entries that were already marked expired
+                toDelete.push(entry.batchId);
+            }
+            else if ((entry.state === 'complete' || entry.state === 'failed') &&
+                now - entry.stateChangedAt > this.options.batchTtlMs) {
+                // first-pass: transition terminal entries to expired
+                entry.state = 'expired';
+                entry.expiredAt = now;
+                entry.stateChangedAt = now;
+                this.release(entry);
+            }
+        }
+        for (const batchId of toDelete) {
+            this.map.delete(batchId);
+        }
+    }
+    /** Two-step retention: time-window prune (expired + stale terminal entries), then LRU prune to max.
+     *
+     * Step 1 expired branch relies on runExpirySweep() having already called release()
+     * during the transition into expired — so no release call here. */
+    prune() {
+        const now = Date.now();
+        // Step 1: time-window prune — drop expired entries and stale terminal entries
+        for (const [key, entry] of this.map) {
+            if (entry.state === 'expired') {
+                // release() was already called by runExpirySweep() during the complete/failed → expired transition
+                this.map.delete(key);
+            }
+            else if ((entry.state === 'complete' || entry.state === 'failed') &&
+                now - entry.stateChangedAt > this.options.batchTtlMs) {
+                this.release(entry);
+                this.map.delete(key);
+            }
+        }
+        // Step 2: LRU prune to max (Map iteration order = insertion order;
+        // oldest entries at head are evicted first)
+        while (this.map.size > this.options.max) {
+            const oldest = this.map.keys().next().value;
+            if (oldest === undefined)
+                break;
+            const entry = this.map.get(oldest);
+            if (entry)
+                this.release(entry);
+            this.map.delete(oldest);
+        }
+    }
+    countActiveForProject(cwd) {
+        let count = 0;
+        for (const entry of this.map.values()) {
+            if (entry.projectCwd === cwd && !isTerminal(entry.state)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    release(entry) {
+        entry.runningHeadlineSnapshot = { prefix: '', statsClause: '', dispatchedAt: 0, fallback: '' };
+        entry.tasksTotal = undefined;
+        entry.tasksStarted = undefined;
+        entry.tasksCompleted = undefined;
+        entry.lastHeartbeatAt = undefined;
+        entry.running = undefined;
+        if (entry.blocksReleased)
+            return;
+        if (this.deps.contextBlockStore) {
+            for (const bid of entry.blockIds) {
+                this.deps.contextBlockStore.unpin(bid);
+            }
+        }
+        entry.blocksReleased = true;
+    }
+}
+//# sourceMappingURL=batch-registry.js.map

package/dist/stores/batch-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-registry.js","sourceRoot":"","sources":["../../src/stores/batch-registry.ts"],"names":[],"mappings":"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"}

package/dist/stores/context-block-tool.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Metadata describing a successful `register(...)` call. The orchestrator
+ * and MCP tool surfaces return this to the caller so they can reference
+ * the stored block later (by id) and independently verify its content
+ * (via sha256).
+ */
+export interface RegisteredBlock {
+    id: string;
+    lengthChars: number;
+    sha256: string;
+}
+/**
+ * Minimal store contract for reusable context blocks.
+ *
+ * The intent is to let a caller register a large brief once, then reference
+ * it by id from many subsequent dispatches without re-transmitting the
+ * content on every call. See `expandContextBlocks` for the resolution
+ * step that turns `TaskSpec.contextBlockIds` into prompt text.
+ */
+export interface ContextBlockStore {
+    /** Store `content` under an explicit id (idempotent replace) or a new
+     *  UUID. Returns the id, length, and sha256 hash. */
+    register(content: string, opts?: {
+        id?: string;
+    }): RegisteredBlock;
+    /** Fetch content by id. Returns `undefined` if the id is unknown or
+     *  the entry has expired. Touches the LRU access time on success. */
+    get(id: string): string | undefined;
+    /** Delete an entry. Returns `true` if the entry existed. */
+    delete(id: string): boolean;
+    /** Walk entries and evict those past the idle TTL. Returns count evicted. */
+    runIdleSweep(now: number, idleTtlMs: number): number;
+}
+/**
+ * Thrown by `expandContextBlocks` when a task references a block id that
+ * cannot be resolved against the store (missing, expired, or evicted).
+ * Callers are expected to surface this to the user so they can re-register
+ * the block and retry.
+ */
+export declare class ContextBlockNotFoundError extends Error {
+    readonly id: string;
+    constructor(id: string);
+}
+export interface InMemoryContextBlockStoreOptions {
+    /** Idle TTL in milliseconds. Defaults to 24 hours; resets on `get()`. */
+    ttlMs?: number;
+    /** Max number of entries before LRU eviction. Defaults to 500. */
+    maxEntries?: number;
+}
+/**
+ * In-memory implementation with two bounds:
+ *   1. A TTL (time-to-live) from `addedAtMs` — checked lazily on `get`.
+ *   2. An LRU cap on entry count — enforced eagerly after every `register`.
+ *
+ * Both bounds are intentional: the TTL prevents stale briefs from lingering
+ * after a long-running session; the LRU cap prevents memory growth from a
+ * chatty caller that never explicitly deletes anything. The eviction loop
+ * is O(n) per insertion but `n <= maxEntries` (defaults to 100), so we
+ * keep the implementation simple.
+ *
+ * `Date.now()` is read directly (not through a clock abstraction) so tests
+ * can drive time forward with Vitest's fake timers.
+ */
+export declare class InMemoryContextBlockStore implements ContextBlockStore {
+    private entries;
+    private _ttlMs;
+    private maxEntries;
+    private tick;
+    constructor(opts?: InMemoryContextBlockStoreOptions);
+    register(content: string, opts?: {
+        id?: string;
+    }): RegisteredBlock;
+    get(id: string): string | undefined;
+    delete(id: string): boolean;
+    /** Increment the pin (reference) count for an entry. Pinned entries are
+     *  skipped during LRU eviction. No-op if the entry is unknown. */
+    pin(id: string): void;
+    /** Decrement the pin count for an entry. No-op if the entry is unknown or
+     *  the count is already zero. */
+    unpin(id: string): void;
+    /** Walk entries and evict those past the idle TTL. Returns count evicted.
+     *  An entry is considered idle when `now - addedAtMs > idleTtlMs`. */
+    runIdleSweep(now: number, idleTtlMs: number): number;
+    /** Return the current pin count for an entry, or 0 if unknown. */
+    refcount(id: string): number;
+    /** Idle TTL (ms) this store was configured with. */
+    get ttlMs(): number;
+    get size(): number;
+    clear(): void;
+    private evictIfOverBound;
+}
+//# sourceMappingURL=context-block-tool.d.ts.map

package/dist/stores/context-block-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-block-tool.d.ts","sourceRoot":"","sources":["../../src/stores/context-block-tool.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;yDACqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC;IACnE;yEACqE;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,6EAA6E;IAC7E,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACtD;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM;CAQvC;AAiBD,MAAM,WAAW,gCAAgC;IAC/C,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAK;gBAEL,IAAI,GAAE,gCAAqC;IAKvD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe;IAmBtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAenC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;sEACkE;IAClE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKrB;qCACiC;IACjC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKvB;0EACsE;IACtE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAYpD,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI5B,oDAAoD;IACpD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/stores/context-block-tool.js

@@ -0,0 +1,137 @@
+import { createHash, randomUUID } from 'node:crypto';
+/**
+ * Thrown by `expandContextBlocks` when a task references a block id that
+ * cannot be resolved against the store (missing, expired, or evicted).
+ * Callers are expected to surface this to the user so they can re-register
+ * the block and retry.
+ */
+export class ContextBlockNotFoundError extends Error {
+    id;
+    constructor(id) {
+        super(`Context block "${id}" is unknown or expired. ` +
+            `Retry without contextBlockIds for a full (non-delta) run, ` +
+            `or re-register the content via register_context_block and retry with the new ID.`);
+        this.id = id;
+        this.name = 'ContextBlockNotFoundError';
+    }
+}
+/**
+ * In-memory implementation with two bounds:
+ *   1. A TTL (time-to-live) from `addedAtMs` — checked lazily on `get`.
+ *   2. An LRU cap on entry count — enforced eagerly after every `register`.
+ *
+ * Both bounds are intentional: the TTL prevents stale briefs from lingering
+ * after a long-running session; the LRU cap prevents memory growth from a
+ * chatty caller that never explicitly deletes anything. The eviction loop
+ * is O(n) per insertion but `n <= maxEntries` (defaults to 100), so we
+ * keep the implementation simple.
+ *
+ * `Date.now()` is read directly (not through a clock abstraction) so tests
+ * can drive time forward with Vitest's fake timers.
+ */
+export class InMemoryContextBlockStore {
+    entries = new Map();
+    _ttlMs;
+    maxEntries;
+    tick = 0;
+    constructor(opts = {}) {
+        this._ttlMs = opts.ttlMs ?? 24 * 60 * 60 * 1000;
+        this.maxEntries = opts.maxEntries ?? 500;
+    }
+    register(content, opts = {}) {
+        const id = opts.id ?? randomUUID();
+        const byteSize = Buffer.byteLength(content, 'utf8');
+        const SIZE_WARN_BYTES = 10 * 1024 * 1024;
+        if (byteSize > SIZE_WARN_BYTES) {
+            process.stderr.write(`[mma] WARN context-block ${id} is ${(byteSize / 1024 / 1024).toFixed(1)} MiB (>10 MiB)\n`);
+        }
+        const now = Date.now();
+        this.entries.set(id, { content, addedAtMs: now, lastAccessTick: ++this.tick, pinCount: 0 });
+        this.evictIfOverBound();
+        return {
+            id,
+            lengthChars: content.length,
+            sha256: createHash('sha256').update(content).digest('hex'),
+        };
+    }
+    get(id) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            return undefined;
+        const now = Date.now();
+        if (now - entry.addedAtMs > this._ttlMs) {
+            // Expired — do not revive
+            this.entries.delete(id);
+            return undefined;
+        }
+        // LRU-refresh: extend TTL on access
+        entry.addedAtMs = now;
+        entry.lastAccessTick = ++this.tick;
+        return entry.content;
+    }
+    delete(id) {
+        return this.entries.delete(id);
+    }
+    /** Increment the pin (reference) count for an entry. Pinned entries are
+     *  skipped during LRU eviction. No-op if the entry is unknown. */
+    pin(id) {
+        const entry = this.entries.get(id);
+        if (entry)
+            entry.pinCount += 1;
+    }
+    /** Decrement the pin count for an entry. No-op if the entry is unknown or
+     *  the count is already zero. */
+    unpin(id) {
+        const entry = this.entries.get(id);
+        if (entry && entry.pinCount > 0)
+            entry.pinCount -= 1;
+    }
+    /** Walk entries and evict those past the idle TTL. Returns count evicted.
+     *  An entry is considered idle when `now - addedAtMs > idleTtlMs`. */
+    runIdleSweep(now, idleTtlMs) {
+        let evicted = 0;
+        for (const [id, entry] of this.entries) {
+            if (entry.pinCount > 0)
+                continue;
+            if (now - entry.addedAtMs > idleTtlMs) {
+                this.entries.delete(id);
+                evicted++;
+            }
+        }
+        return evicted;
+    }
+    /** Return the current pin count for an entry, or 0 if unknown. */
+    refcount(id) {
+        return this.entries.get(id)?.pinCount ?? 0;
+    }
+    /** Idle TTL (ms) this store was configured with. */
+    get ttlMs() {
+        return this._ttlMs;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    clear() {
+        this.entries.clear();
+    }
+    evictIfOverBound() {
+        while (this.entries.size > this.maxEntries) {
+            let oldestId;
+            let oldestTick = Infinity;
+            for (const [id, entry] of this.entries) {
+                // Skip pinned entries — they are held by active BatchRegistry entries
+                if (entry.pinCount > 0)
+                    continue;
+                if (entry.lastAccessTick < oldestTick) {
+                    oldestTick = entry.lastAccessTick;
+                    oldestId = id;
+                }
+            }
+            if (oldestId)
+                this.entries.delete(oldestId);
+            else
+                break; // all entries pinned — cannot evict
+        }
+    }
+}
+//# sourceMappingURL=context-block-tool.js.map

package/dist/stores/context-block-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-block-tool.js","sourceRoot":"","sources":["../../src/stores/context-block-tool.ts"],"names":[],"mappings":"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"}

package/dist/stores/expand-context-blocks.d.ts

@@ -0,0 +1,20 @@
+import { type ContextBlockStore } from './context-block-tool.js';
+import type { TaskSpec } from '../types.js';
+/**
+ * Expands a task's `contextBlockIds` against a `ContextBlockStore`,
+ * returning a NEW `TaskSpec` whose `prompt` has the resolved blocks
+ * prepended (in the order they appear in `contextBlockIds`) with
+ * `SEPARATOR` between each block and before the original prompt.
+ *
+ * The returned task has `contextBlockIds` removed so downstream code
+ * cannot accidentally double-expand.
+ *
+ * If the task has no `contextBlockIds` (or the array is empty), or if
+ * no store is provided, the task is returned unchanged — the caller
+ * does not have to special-case the no-op path.
+ *
+ * Throws `ContextBlockNotFoundError` synchronously on the first missing
+ * id so the caller gets a clear error pointing to the offending block.
+ */
+export declare function expandContextBlocks(task: TaskSpec, store: ContextBlockStore | undefined): TaskSpec;
+//# sourceMappingURL=expand-context-blocks.d.ts.map

package/dist/stores/expand-context-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-context-blocks.d.ts","sourceRoot":"","sources":["../../src/stores/expand-context-blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU5C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,iBAAiB,GAAG,SAAS,GACnC,QAAQ,CAoBV"}

package/dist/stores/expand-context-blocks.js

@@ -0,0 +1,46 @@
+import { ContextBlockNotFoundError } from './context-block-tool.js';
+/**
+ * Separator inserted between resolved blocks and between the last block
+ * and the original prompt. Exact string is load-bearing — tests assert on
+ * it, and the hash inputs in `onInitialRequest` depend on the rendered
+ * prompt being byte-stable across dispatches.
+ */
+const SEPARATOR = '\n\n---\n\n';
+/**
+ * Expands a task's `contextBlockIds` against a `ContextBlockStore`,
+ * returning a NEW `TaskSpec` whose `prompt` has the resolved blocks
+ * prepended (in the order they appear in `contextBlockIds`) with
+ * `SEPARATOR` between each block and before the original prompt.
+ *
+ * The returned task has `contextBlockIds` removed so downstream code
+ * cannot accidentally double-expand.
+ *
+ * If the task has no `contextBlockIds` (or the array is empty), or if
+ * no store is provided, the task is returned unchanged — the caller
+ * does not have to special-case the no-op path.
+ *
+ * Throws `ContextBlockNotFoundError` synchronously on the first missing
+ * id so the caller gets a clear error pointing to the offending block.
+ */
+export function expandContextBlocks(task, store) {
+    if (!task.contextBlockIds || task.contextBlockIds.length === 0)
+        return task;
+    if (!store)
+        return task;
+    const blocks = [];
+    for (const id of task.contextBlockIds) {
+        const content = store.get(id);
+        if (content === undefined) {
+            throw new ContextBlockNotFoundError(id);
+        }
+        blocks.push(content);
+    }
+    const expanded = blocks.join(SEPARATOR) + SEPARATOR + task.prompt;
+    // Strip contextBlockIds from the returned task so a second pass through
+    // expandContextBlocks is a no-op (defence in depth against double-
+    // expansion if runtime-plumbing calls it twice).
+    const { contextBlockIds, ...rest } = task;
+    void contextBlockIds;
+    return { ...rest, prompt: expanded };
+}
+//# sourceMappingURL=expand-context-blocks.js.map

package/dist/stores/expand-context-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-context-blocks.js","sourceRoot":"","sources":["../../src/stores/expand-context-blocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAA0B,MAAM,yBAAyB,CAAC;AAG5F;;;;;GAKG;AACH,MAAM,SAAS,GAAG,aAAa,CAAC;AAEhC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAc,EACd,KAAoC;IAEpC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IAClE,wEAAwE;IACxE,mEAAmE;IACnE,iDAAiD;IACjD,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC1C,KAAK,eAAe,CAAC;IACrB,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC"}

package/dist/stores/index.d.ts

@@ -0,0 +1,4 @@
+export * from './project-context-registry.js';
+export * from './batch-registry.js';
+export * from './context-block-tool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAEA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/stores/index.js

@@ -0,0 +1,5 @@
+// stores/index.ts — public surface barrel; per architecture.md:262-275.
+export * from './project-context-registry.js';
+export * from './batch-registry.js';
+export * from './context-block-tool.js';
+//# sourceMappingURL=index.js.map

package/dist/stores/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/stores/project-context-registry.d.ts

@@ -0,0 +1,17 @@
+import { InMemoryContextBlockStore } from './context-block-tool.js';
+import { BatchCache } from './batch-cache.js';
+export interface ProjectContext {
+    readonly cwd: string;
+    readonly contextBlocks: InMemoryContextBlockStore;
+    /** Per-project terminal-only retention index; authoritative live-batch lookup is via BatchRegistry.countActiveForProject(cwd). */
+    readonly batchCache: BatchCache;
+    readonly createdAt: number;
+    /** Wall-clock ms of last activity on this project context (HTTP request, session attach/detach). */
+    lastActivityAt: number;
+    /** HTTP requests currently in-flight for this cwd. */
+    activeRequests: number;
+    readonly activeSessions: Set<string>;
+    pendingReservations: number;
+}
+export declare function createProjectContext(cwd: string): ProjectContext;
+//# sourceMappingURL=project-context-registry.d.ts.map

package/dist/stores/project-context-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-registry.d.ts","sourceRoot":"","sources":["../../src/stores/project-context-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;IAClD,kIAAkI;IAClI,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oGAAoG;IACpG,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAYhE"}

package/dist/stores/project-context-registry.js

@@ -0,0 +1,16 @@
+import { InMemoryContextBlockStore } from './context-block-tool.js';
+import { BatchCache } from './batch-cache.js';
+export function createProjectContext(cwd) {
+    const now = Date.now();
+    return {
+        cwd,
+        contextBlocks: new InMemoryContextBlockStore(),
+        batchCache: new BatchCache(),
+        createdAt: now,
+        lastActivityAt: now,
+        activeSessions: new Set(),
+        activeRequests: 0,
+        pendingReservations: 0,
+    };
+}
+//# sourceMappingURL=project-context-registry.js.map

package/dist/stores/project-context-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-registry.js","sourceRoot":"","sources":["../../src/stores/project-context-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiB9C,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,GAAG;QACH,aAAa,EAAE,IAAI,yBAAyB,EAAE;QAC9C,UAAU,EAAE,IAAI,UAAU,EAAE;QAC5B,SAAS,EAAE,GAAG;QACd,cAAc,EAAE,GAAG;QACnB,cAAc,EAAE,IAAI,GAAG,EAAU;QACjC,cAAc,EAAE,CAAC;QACjB,mBAAmB,EAAE,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/tool-surface/discover.d.ts

@@ -0,0 +1,27 @@
+import type { Client } from './manifest.js';
+export declare const SUPPORTED_SKILLS: readonly ["multi-model-agent", "mma-delegate", "mma-audit", "mma-review", "mma-verify", "mma-debug", "mma-execute-plan", "mma-retry", "mma-context-blocks", "mma-investigate", "mma-explore"];
+/** Thrown when a skill's SKILL.md cannot be read from the bundled skills directory. */
+export declare class SkillNotFoundError extends Error {
+    readonly code: "skill_not_found";
+    constructor(skillName: string, checkedPath: string);
+}
+/**
+ * Return the absolute path to the skills root directory. Production: the
+ * bundled `packages/server/src/skills/` (or its dist mirror). Tests pass
+ * a fixture path explicitly.
+ */
+export declare function getSkillsRoot(skillsRoot?: string): string;
+/**
+ * Read the content of a skill's SKILL.md file. Returns null if the file
+ * does not exist; propagates other I/O errors so callers can distinguish
+ * "skill not found" from "can't access skill".
+ */
+export declare function readSkillContent(skillName: string, skillsRoot?: string): string | null;
+/**
+ * Return the per-client install directories where skills are written as
+ * subdirectories. Only includes clients that use the per-skill directory
+ * model (claude-code and codex). Gemini and Cursor bundle skills into a
+ * single file/extension and are not included.
+ */
+export declare function discoverPerClientInstallDirs(homeDir?: string): Partial<Record<Client, string>>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/tool-surface/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/tool-surface/discover.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,eAAO,MAAM,gBAAgB,+LAYnB,CAAC;AAEX,uFAAuF;AACvF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;gBAC/B,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAOnD;AAwBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQtF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAM9F"}