@esankhan3/anvil-agent-core 0.1.0

package/dist/agent/session/session.js

@@ -0,0 +1,327 @@
+/**
+ * `AgentProcess` — one logical agent.
+ *
+ * Owns the spawn → resume → resume → done lifecycle for a single agent. Pipes
+ * adapter events through to its own EventEmitter surface so consumers (the
+ * dashboard's WebSocket layer; cli's await-result loop) wire once and
+ * survive multiple resume calls.
+ */
+import { EventEmitter } from 'node:events';
+import { randomBytes } from 'node:crypto';
+import { context as otelContext, trace, SpanStatusCode, } from '@opentelemetry/api';
+import { buildAdapterRequest } from './adapter.js';
+import { getTracer } from '../../telemetry/tracer.js';
+// ── Tunables ────────────────────────────────────────────────────────────
+/** Cap in-memory output to 500KB, keeping the tail. */
+const MAX_OUTPUT_BYTES = 500 * 1024;
+/** Cap in-memory activities to 500 entries. */
+const MAX_ACTIVITIES = 500;
+/** Grace window after a 0-exit before treating the session as failed-empty. */
+const POST_EXIT_GRACE_MS = 500;
+/** "Empty exit" detector window — runs shorter than this with no output → error. */
+const EMPTY_EXIT_THRESHOLD_MS = 5000;
+export class AgentProcess extends EventEmitter {
+    id;
+    spec;
+    sessionId;
+    adapter = null;
+    state;
+    factory;
+    now;
+    setTimeoutImpl;
+    /** Parent span covering the agent's whole lifetime — initial run +
+     *  every resume. Each adapter.run() span becomes a child via
+     *  AsyncLocalStorage propagation when start()/sendInput run inside
+     *  `sessionContext`. */
+    sessionSpan = null;
+    sessionContext = null;
+    sessionEnded = false;
+    constructor(spec, opts) {
+        super();
+        this.spec = spec;
+        this.factory = opts.adapterFactory;
+        this.now = opts.now ?? Date.now;
+        this.setTimeoutImpl = opts.setTimeoutImpl ?? ((fn, ms) => { setTimeout(fn, ms); });
+        this.sessionId = opts.id ?? generateSessionId();
+        this.id = this.sessionId;
+        this.state = createPendingState(spec, this.id);
+    }
+    // ── Typed event helpers ──────────────────────────────────────────────
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────────
+    /** Start the process. Spawns the underlying adapter and begins streaming. */
+    start() {
+        this.openSessionSpan();
+        const req = buildAdapterRequest(this.spec, this.sessionId);
+        // Run the factory inside the session-span's context so any setAttribute
+        // calls inside `defaultAdapterFactory` (e.g. `anvil.skills.activated.*`,
+        // `anvil.mcp.*` from Phase 6) land on the session span. Without the
+        // wrapper the factory runs with no active span and the attrs go nowhere.
+        const adapter = this.runWithSessionContext(() => this.factory(req));
+        if (typeof this.spec.maxOutputTokens === 'number'
+            && this.spec.maxOutputTokens > 0
+            && typeof adapter.setMaxOutputTokens === 'function') {
+            adapter.setMaxOutputTokens(this.spec.maxOutputTokens);
+        }
+        this.adapter = adapter;
+        this.wireAdapter(adapter);
+        // Run the adapter inside the session-span's context so every
+        // adapter.run() span becomes a child of the session.
+        this.runWithSessionContext(() => adapter.start());
+        this.state.status = 'running';
+        this.state.startedAt = this.now();
+    }
+    /**
+     * Send input to a running process — spawns a NEW adapter with `resume:
+     * true` and the same `sessionId`, re-wires events through this process.
+     */
+    sendInput(text) {
+        // Show user message in output stream
+        const userChunk = `\n\n> User: ${text}\n\n`;
+        appendOutput(this.state, userChunk);
+        this.emit('content', userChunk);
+        // Update agent status back to running
+        this.state.status = 'running';
+        this.state.finishedAt = null;
+        const req = buildAdapterRequest({ ...this.spec, prompt: text }, this.sessionId, 
+        // No cwdOverride — Claude's session storage is keyed by cwd, so a
+        // resume MUST use the same working directory as the original spawn.
+        // Forcing process.cwd() here breaks `claude --resume <id>` with
+        // "No conversation found" whenever the dashboard's cwd differs
+        // from the project workspace it spawned the agent in.
+        { resume: true });
+        const resumeAdapter = this.factory(req);
+        if (typeof this.spec.maxOutputTokens === 'number'
+            && this.spec.maxOutputTokens > 0
+            && typeof resumeAdapter.setMaxOutputTokens === 'function') {
+            resumeAdapter.setMaxOutputTokens(this.spec.maxOutputTokens);
+        }
+        this.adapter = resumeAdapter;
+        this.wireAdapter(resumeAdapter);
+        // Resume runs inside the same session span as the initial start —
+        // both adapter calls are children of one trace, so a multi-turn
+        // session shows up as a single waterfall.
+        this.runWithSessionContext(() => resumeAdapter.start());
+    }
+    /** Kill the underlying adapter and mark the process as `killed`. */
+    kill(signal) {
+        if (this.adapter) {
+            try {
+                this.adapter.kill(signal);
+            }
+            catch { /* already dead */ }
+        }
+        this.state.status = 'killed';
+        this.state.finishedAt = this.now();
+        this.closeSessionSpan('killed');
+    }
+    // ── State queries ────────────────────────────────────────────────────
+    /** Read-only snapshot of the process's runtime state. */
+    getState() {
+        return this.state;
+    }
+    get status() {
+        return this.state.status;
+    }
+    get cost() {
+        return this.state.cost;
+    }
+    get activities() {
+        return this.state.activities;
+    }
+    get output() {
+        return this.state.output;
+    }
+    // ── Internals ────────────────────────────────────────────────────────
+    /** Open a `anvil.agent.session` span scoped to this AgentProcess. Idempotent
+     *  — once opened, lives until kill() / done / error. */
+    openSessionSpan() {
+        if (this.sessionSpan)
+            return;
+        const tracer = getTracer();
+        this.sessionSpan = tracer.startSpan('anvil.agent.session', {
+            attributes: {
+                'anvil.agent.id': this.id,
+                'anvil.agent.name': this.spec.name,
+                'anvil.persona': this.spec.persona,
+                'anvil.project': this.spec.project,
+                'anvil.stage': this.spec.stage,
+                'anvil.session.session_id': this.sessionId,
+                'anvil.run.id': this.spec.runId ?? '',
+                'gen_ai.system': 'anvil',
+                'gen_ai.request.model': this.spec.model,
+            },
+        });
+        this.sessionContext = trace.setSpan(otelContext.active(), this.sessionSpan);
+    }
+    /** End the session span exactly once. Idempotent. */
+    closeSessionSpan(outcome) {
+        if (this.sessionEnded || !this.sessionSpan)
+            return;
+        this.sessionEnded = true;
+        this.sessionSpan.setAttribute('anvil.agent.outcome', outcome);
+        if (outcome === 'error' || outcome === 'killed') {
+            this.sessionSpan.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: outcome === 'killed' ? 'agent killed' : 'agent errored',
+            });
+        }
+        else {
+            this.sessionSpan.setStatus({ code: SpanStatusCode.OK });
+        }
+        this.sessionSpan.end();
+        this.sessionSpan = null;
+        this.sessionContext = null;
+    }
+    /** Run a callback inside the session span's context. Adapter calls made
+     *  inside this run with active context propagated via AsyncLocalStorage,
+     *  so every gen_ai.invoke + tool span lands as a child of the session. */
+    runWithSessionContext(fn) {
+        if (!this.sessionContext)
+            return fn();
+        return otelContext.with(this.sessionContext, fn);
+    }
+    wireAdapter(adapter) {
+        adapter.on('content', (chunk) => {
+            appendOutput(this.state, chunk);
+            this.emit('content', chunk);
+        });
+        adapter.on('activity', (activity) => {
+            pushActivity(this.state, activity);
+            this.emit('activity', activity);
+        });
+        adapter.on('result', (data) => {
+            this.state.status = 'done';
+            this.state.finishedAt = this.now();
+            this.state.sessionId = data.sessionId;
+            // Accumulate cost across resume calls — same semantics as dashboard
+            // (cost.stopReason prefers the freshly reported value).
+            this.state.cost = accumulateCost(this.state.cost, data.cost);
+            if (data.result) {
+                appendOutput(this.state, data.result);
+            }
+            // Stamp the running aggregate cost on the session span so a single
+            // trace shows total token / USD spend without re-summing children.
+            if (this.sessionSpan) {
+                this.sessionSpan.setAttribute('anvil.agent.total_cost_usd', this.state.cost.totalUsd);
+                this.sessionSpan.setAttribute('anvil.agent.total_input_tokens', this.state.cost.inputTokens);
+                this.sessionSpan.setAttribute('anvil.agent.total_output_tokens', this.state.cost.outputTokens);
+                this.sessionSpan.setAttribute('anvil.agent.total_cache_read_tokens', this.state.cost.cacheReadTokens);
+            }
+            this.emit('result', data);
+            this.closeSessionSpan('done');
+        });
+        adapter.on('error-output', (text) => {
+            if (!this.state.error)
+                this.state.error = '';
+            this.state.error += text;
+            this.emit('error-output', text);
+        });
+        adapter.on('exit', (code) => {
+            // Don't override `done` or `killed` terminal states.
+            if (this.state.status === 'done' || this.state.status === 'killed') {
+                this.emit('exit', code);
+                return;
+            }
+            if (code !== null && code !== 0) {
+                this.state.status = 'error';
+                this.state.finishedAt = this.now();
+                if (!this.state.error) {
+                    this.state.error = `Process exited with code ${code}`;
+                }
+                this.emit('exit', code);
+                this.closeSessionSpan('error');
+                return;
+            }
+            // Code 0 but no result — wait briefly for late events, else flag
+            // empty-output runs as an error (matches dashboard semantics).
+            this.setTimeoutImpl(() => {
+                if (this.state.status !== 'running')
+                    return;
+                const elapsed = this.now() - (this.state.startedAt ?? this.now());
+                if (elapsed < EMPTY_EXIT_THRESHOLD_MS
+                    && !this.state.output.trim()
+                    && this.state.cost.totalUsd === 0) {
+                    this.state.status = 'error';
+                    this.state.finishedAt = this.now();
+                    this.state.error = this.state.error
+                        || 'Agent exited immediately with no output. Check workspace directory and adapter configuration.';
+                    this.emit('exit', code);
+                    this.closeSessionSpan('error');
+                }
+                else {
+                    this.state.status = 'done';
+                    this.state.finishedAt = this.now();
+                    this.emit('exit', code);
+                    this.closeSessionSpan('done');
+                }
+            }, POST_EXIT_GRACE_MS);
+        });
+    }
+}
+// ── Factories + helpers (exported for cross-file reuse) ─────────────────
+export function createPendingState(spec, id) {
+    return {
+        id,
+        name: spec.name,
+        persona: spec.persona,
+        sessionId: id,
+        model: spec.model,
+        status: 'pending',
+        cost: emptyCost(),
+        output: '',
+        activities: [],
+        startedAt: null,
+        finishedAt: null,
+        error: null,
+    };
+}
+export function emptyCost() {
+    return {
+        totalUsd: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheReadTokens: 0,
+        cacheWriteTokens: 0,
+        durationMs: 0,
+    };
+}
+export function appendOutput(state, chunk) {
+    state.output += chunk;
+    if (state.output.length > MAX_OUTPUT_BYTES) {
+        state.output = state.output.slice(-MAX_OUTPUT_BYTES);
+    }
+}
+export function pushActivity(state, activity) {
+    state.activities.push(activity);
+    if (state.activities.length > MAX_ACTIVITIES) {
+        state.activities = state.activities.slice(-MAX_ACTIVITIES);
+    }
+}
+export function accumulateCost(prev, next) {
+    return {
+        totalUsd: prev.totalUsd + next.totalUsd,
+        inputTokens: prev.inputTokens + next.inputTokens,
+        outputTokens: prev.outputTokens + next.outputTokens,
+        cacheReadTokens: prev.cacheReadTokens + next.cacheReadTokens,
+        cacheWriteTokens: prev.cacheWriteTokens + next.cacheWriteTokens,
+        durationMs: prev.durationMs + next.durationMs,
+        stopReason: next.stopReason ?? prev.stopReason,
+    };
+}
+/**
+ * Generate a UUID v4. Claude CLI requires a valid v4 for `--session-id`.
+ */
+export function generateSessionId() {
+    const bytes = randomBytes(16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+}
+//# sourceMappingURL=session.js.map

package/dist/agent/session/session.js.map

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

package/dist/agent/session/types.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Type surface for `@esankhan3/anvil-agent-core`'s agent-lifecycle layer.
+ *
+ * `AgentProcess` (one logical agent, EventEmitter, supports `sendInput` for
+ * resume) and `AgentManager` (Map<id, AgentProcess>) are the canonical
+ * agent-runtime types — agent-core is the source of truth. Dashboard and
+ * cli both consume these directly without aliasing.
+ *
+ * History: an earlier extract phase shipped a single-shot `AgentManager`
+ * class at `agent/agent-manager.ts` that never got wired up. The current
+ * stateful surface lifted dashboard's pre-Phase-4 `AgentManager` into this
+ * package and reclaimed the canonical name. See
+ * `AGENT-MANAGER-CONSOLIDATION-ADR.md`.
+ */
+/**
+ * The 5-state lifecycle a single agent passes through.
+ *
+ * - `pending` — created but not yet started (rare; only between `spawn()`
+ *   call and constructor return).
+ * - `running` — adapter process is live; can be killed or sent input.
+ * - `done` — adapter exited cleanly with a final result.
+ * - `error` — adapter failed with a typed error.
+ * - `killed` — caller invoked `kill()` while the adapter was running.
+ */
+export type AgentStatus = 'pending' | 'running' | 'done' | 'error' | 'killed';
+/**
+ * One activity event emitted by an adapter — tool use, thinking block, or
+ * a text-only completion segment. Dashboard surfaces these in the UI; cli
+ * ignores them.
+ */
+export interface AgentActivity {
+    id: string;
+    kind: 'tool_use' | 'thinking' | 'text' | 'tool_result';
+    tool?: string;
+    summary: string;
+    content?: string;
+    timestamp: number;
+}
+/**
+ * Cost / usage block — populated when the adapter reports its `usage` event.
+ * `agent-core/types.ts:InvokeUsage` is the *streaming* analog (token counts
+ * only); `CostInfo` adds USD + durationMs + the provider-side `stopReason`
+ * so callers can detect output truncation.
+ */
+export interface CostInfo {
+    totalUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    durationMs: number;
+    /** Provider stop reason — `'max_tokens'` indicates output truncation. */
+    stopReason?: string;
+}
+/**
+ * Snapshot of one agent's state. Returned by `AgentManager.getAgent(id)`
+ * and `AgentProcess.getState()`. The `output` field is the running text
+ * accumulator (capped at 500KB, tail-kept).
+ */
+export interface AgentState {
+    id: string;
+    name: string;
+    persona: string;
+    sessionId: string;
+    model: string;
+    status: AgentStatus;
+    cost: CostInfo;
+    output: string;
+    activities: AgentActivity[];
+    startedAt: number | null;
+    finishedAt: number | null;
+    error: string | null;
+}
+/**
+ * The canonical agent-launch shape. Passed to `AgentManager.spawn()`.
+ */
+export interface SpawnConfig {
+    /** Display name — appears in dashboard UI and logs. */
+    name: string;
+    /** Persona id — drives prompt-template selection (e.g. `'engineer'`). */
+    persona: string;
+    /** Project key — used for cost grouping + checkpoint cache namespacing. */
+    project: string;
+    /** Pipeline stage name (e.g. `'clarify'`, `'build'`). */
+    stage: string;
+    /** User-side prompt the agent runs against. */
+    prompt: string;
+    /** Model id (e.g. `'claude-3-5-sonnet'`, `'gpt-4'`). */
+    model: string;
+    /** Working directory for the adapter process. */
+    cwd: string;
+    /** Optional system prompt prefix injected before the user prompt. */
+    projectPrompt?: string;
+    permissionMode?: string;
+    disallowedTools?: string[];
+    allowedTools?: string[];
+    /** Output-token ceiling, forwarded to adapters whose
+     *  `capabilities.maxOutputTokens === true`. */
+    maxOutputTokens?: number;
+    /** Pipeline runId — groups cost/checkpoint records. */
+    runId?: string;
+    /** Stable cross-retry id for the checkpoint cache. Defaults to `runId`. */
+    runFamily?: string;
+    /** Restart policy on subprocess crash. cli sets `{ maxAttempts: 2 }` by
+     *  default; dashboard sets `{ maxAttempts: 0 }` (no auto-restart). */
+    restart?: {
+        maxAttempts: number;
+    };
+    /** Per-call timeout in ms. `0` = no timeout (dashboard default). cli
+     *  sets it from per-stage defaults. */
+    timeoutMs?: number;
+    /** Override the binary used to spawn the adapter. Defaults to
+     *  `ANVIL_AGENT_CMD` env / `'claude'`. Used by tests. */
+    binaryPath?: string;
+    /** Escape hatch for arbitrary CLI args. cli uses; dashboard never sets. */
+    args?: string[];
+    /**
+     * Workspace root for skills + MCP discovery. Distinct from `cwd` (the
+     * subprocess working directory) so tests can run with cwd === '/tmp'
+     * while loading skills from the repo root. When undefined, skills + MCP
+     * are skipped (back-compat with existing spawn sites).
+     *
+     * Per AGENT-PROCESS-CONSOLIDATION-ADR §C4.
+     */
+    workspaceDir?: string;
+}
+/**
+ * Events emitted by a single `AgentProcess`. 5-event surface piped through
+ * from the underlying `AgentAdapter`.
+ */
+export interface AgentProcessEvents {
+    content: (text: string) => void;
+    activity: (activity: AgentActivity) => void;
+    result: (data: {
+        result: string;
+        cost: CostInfo;
+        sessionId: string;
+    }) => void;
+    'error-output': (text: string) => void;
+    exit: (code: number | null) => void;
+}
+/**
+ * Events emitted by `AgentManager`. 4-event registry-level surface (the
+ * dashboard's WebSocket layer subscribes to these to broadcast to clients).
+ */
+export interface AgentManagerEvents {
+    'agent-output': (data: {
+        agentId: string;
+        chunk: string;
+    }) => void;
+    'agent-activity': (data: {
+        agentId: string;
+        activity: AgentActivity;
+    }) => void;
+    'agent-done': (data: {
+        agent: AgentState;
+    }) => void;
+    'agent-error': (data: {
+        agentId: string;
+        error: string;
+    }) => void;
+}
+/**
+ * Cost hook — invoked after every agent result so a ledger (dashboard's
+ * `CostLedger` and/or agent-core's `SpendLedger`) can record token usage
+ * and trigger breach flows. Fire-and-forget; hook impls must never throw
+ * back into the manager.
+ */
+export interface AgentCostHook {
+    (info: {
+        runId?: string;
+        project?: string;
+        stage?: string;
+        agent: string;
+        persona: string;
+        model: string;
+        tokensIn: number;
+        tokensOut: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        usd: number;
+    }): void | Promise<void>;
+}
+/**
+ * Checkpoint hook — consulted BEFORE spawning. If it returns a cached
+ * output, the manager synthesizes a done-event and skips the spawn.
+ */
+export interface AgentCheckpointHook {
+    lookup(input: {
+        project: string;
+        stage: string;
+        persona: string;
+        model: string;
+        prompt: string;
+        runFamily?: string;
+    }): {
+        hit: true;
+        output: string;
+        cost?: CostInfo;
+    } | {
+        hit: false;
+    };
+    record?(input: {
+        project: string;
+        stage: string;
+        persona: string;
+        model: string;
+        prompt: string;
+        runFamily?: string;
+        output: string;
+        cost: CostInfo;
+    }): void;
+}
+/**
+ * Thrown when `AgentProcess.sendInput()` is called against an adapter whose
+ * `LanguageModel.capabilities.sessionResume === false`.
+ */
+export declare class SessionResumeNotSupportedError extends Error {
+    readonly provider: string;
+    readonly model: string;
+    constructor(provider: string, model: string);
+}
+/**
+ * Thrown when `AgentManager` can't find an agent by id (e.g. `kill('unknown')`).
+ */
+export declare class AgentNotFoundError extends Error {
+    readonly agentId: string;
+    constructor(agentId: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/session/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/session/types.js

@@ -0,0 +1,44 @@
+/**
+ * Type surface for `@esankhan3/anvil-agent-core`'s agent-lifecycle layer.
+ *
+ * `AgentProcess` (one logical agent, EventEmitter, supports `sendInput` for
+ * resume) and `AgentManager` (Map<id, AgentProcess>) are the canonical
+ * agent-runtime types — agent-core is the source of truth. Dashboard and
+ * cli both consume these directly without aliasing.
+ *
+ * History: an earlier extract phase shipped a single-shot `AgentManager`
+ * class at `agent/agent-manager.ts` that never got wired up. The current
+ * stateful surface lifted dashboard's pre-Phase-4 `AgentManager` into this
+ * package and reclaimed the canonical name. See
+ * `AGENT-MANAGER-CONSOLIDATION-ADR.md`.
+ */
+// ────────────────────────────────────────────────────────────────────────────
+// Errors
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Thrown when `AgentProcess.sendInput()` is called against an adapter whose
+ * `LanguageModel.capabilities.sessionResume === false`.
+ */
+export class SessionResumeNotSupportedError extends Error {
+    provider;
+    model;
+    constructor(provider, model) {
+        super(`Adapter '${provider}' (model '${model}') does not support session resume — ` +
+            `cannot sendInput on an existing AgentProcess.`);
+        this.name = 'SessionResumeNotSupportedError';
+        this.provider = provider;
+        this.model = model;
+    }
+}
+/**
+ * Thrown when `AgentManager` can't find an agent by id (e.g. `kill('unknown')`).
+ */
+export class AgentNotFoundError extends Error {
+    agentId;
+    constructor(agentId) {
+        super(`Agent ${agentId} not found`);
+        this.name = 'AgentNotFoundError';
+        this.agentId = agentId;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/agent/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/session/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiNH,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAC9C,QAAQ,CAAS;IACjB,KAAK,CAAS;IACvB,YAAY,QAAgB,EAAE,KAAa;QACzC,KAAK,CACH,YAAY,QAAQ,aAAa,KAAK,uCAAuC;YAC3E,+CAA+C,CAClD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,OAAO,CAAS;IACzB,YAAY,OAAe;QACzB,KAAK,CAAC,SAAS,OAAO,YAAY,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/checkpoint/__tests__/blob-store.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for BlobStore — content-addressed blob storage.
+ */
+export {};
+//# sourceMappingURL=blob-store.test.d.ts.map

package/dist/checkpoint/__tests__/blob-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.test.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/__tests__/blob-store.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}