@orion-agents/orion-code 0.1.3 → 0.1.4-2

package/dist/runtime/subagents/presets.d.ts

@@ -7,7 +7,7 @@
  * `subtask` capability - this is enforced structurally, not by prompt alone.
  */
 import type { SubagentRole } from './types';
-import type { OpenHorseTool } from '../../framework/tool';
+import type { OrionCodeTool } from '../../framework/tool';
 /** Read-only investigation tools available to children in v0.2.20. */
 export declare const READ_ONLY_INVESTIGATION_TOOLS: readonly ["read_file", "list_files", "glob", "grep", "batch_read"];
 /**
@@ -37,7 +37,7 @@ export declare function systemPromptForRole(role: SubagentRole): string;
  * Returns the names the child may receive; the caller is responsible for
  * resolving them to tool definitions.
  */
-export declare function filterToolsForRole(availableToolNames: readonly string[], role: SubagentRole, _runtimeTools?: readonly OpenHorseTool[]): string[];
+export declare function filterToolsForRole(availableToolNames: readonly string[], role: SubagentRole, _runtimeTools?: readonly OrionCodeTool[]): string[];
 /** Assert a filtered tool list contains no forbidden tool. Used by the runner. */
 export declare function assertNoForbiddenTools(toolNames: readonly string[]): void;
 //# sourceMappingURL=presets.d.ts.map

package/dist/runtime/subagents/provider-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-gate.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/provider-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAI3F,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;IAClE,4EAA4E;IAC5E,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,wDAAwD;AACxD,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAUD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoD;IAClF,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAkC;gBAE3C,OAAO,EAAE,mBAAmB;IAWxC,8DAA8D;IAC9D,YAAY,IAAI,OAAO;IAIvB,kDAAkD;IAClD,mBAAmB,IAAI,MAAM;IAI7B;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAYzC;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,mDAAmD;IACnD,WAAW,IAAI,MAAM;IAIrB;;;;;;;;;;OAUG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgClD,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAKf;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}
+{"version":3,"file":"provider-gate.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/provider-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;IAClE,4EAA4E;IAC5E,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,wDAAwD;AACxD,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAUD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoD;IAClF,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAkC;gBAE3C,OAAO,EAAE,mBAAmB;IAWxC,8DAA8D;IAC9D,YAAY,IAAI,OAAO;IAIvB,kDAAkD;IAClD,mBAAmB,IAAI,MAAM;IAI7B;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAYzC;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,mDAAmD;IACnD,WAAW,IAAI,MAAM;IAIrB;;;;;;;;;;OAUG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgClD,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAKf;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/runtime/subagents/provider-gate.js

@@ -24,7 +24,6 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SubagentProviderGate = exports.AcquireAbortedError = void 0;
-const NULL_PROVIDER_GATE = null;
 /** Thrown when an acquire is aborted via its signal. */
 class AcquireAbortedError extends Error {
     constructor() {

package/dist/runtime/subagents/provider-gate.js.map

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

package/dist/runtime/subagents/research-artifact.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Research artifact persistence, resume, and Goal integration (v0.1.4, P1-R5).
+ *
+ * - Packet + source metadata are saved atomically under a CAS (compare-and-swap)
+ *   token so a concurrent / active-Goal overwrite without the current token is
+ *   rejected.
+ * - Scope isolation: project / session / Goal are part of the storage key, so a
+ *   packet can never leak across project/session boundaries.
+ * - resume derives completed/partial/failed WITHOUT replaying any external side
+ *   effect (no network, no fetch) - it only reads the stored packet.
+ * - clear/repair/cleanup preserve the original packet + prior CAS tokens for
+ *   traceability; old schema versions fail closed (never silently migrated).
+ *
+ * Persistence is injected (default: in-memory map) so the logic is testable
+ * without disk.
+ */
+import { type ResearchPacket } from './research-types';
+export interface ResearchScope {
+    projectPath: string;
+    sessionId: string;
+    goalId?: string;
+    /** Optional packet discriminator when several research tasks share a Goal. */
+    packetId?: string;
+}
+export interface ArtifactRecord {
+    version: number;
+    /** CAS token = content hash of the stored packet at write time. */
+    casToken: string;
+    packet: ResearchPacket;
+    storedAt: string;
+    /** Prior CAS tokens, oldest first, kept for traceability. */
+    previousTokens: string[];
+}
+export interface ResearchArtifactStore {
+    read(scopeKey: string): ArtifactRecord | null;
+    /** Legacy unconditional write. Prefer writeIfCas for all read/modify/write paths. */
+    write(scopeKey: string, record: ArtifactRecord): void;
+    /**
+     * Atomically write only when the durable record still has `expectedCurrentToken`.
+     * `null` means the scope must still be absent. Implementations that predate this
+     * method remain source-compatible, but cannot provide cross-process CAS.
+     */
+    writeIfCas?(scopeKey: string, expectedCurrentToken: string | null, record: ArtifactRecord): boolean;
+}
+/** Default in-memory store (test seam; production can back this with session storage). */
+export declare function createMemoryArtifactStore(): ResearchArtifactStore;
+export declare function scopeKey(scope: ResearchScope): string;
+/**
+ * Durable project-scoped store used by the runtime integration.
+ *
+ * Each packet has a deterministic filename derived from its full scope. Writes
+ * use a sibling temporary file plus rename so a killed process cannot leave a
+ * partially-written JSON record that looks resumable.
+ */
+export declare function createFileArtifactStore(projectPath: string): ResearchArtifactStore;
+export type ResearchResumeState = 'completed' | 'partial' | 'failed';
+export declare class CasMismatchError extends Error {
+    scopeKey: string;
+    expected: string;
+    actual: string;
+    constructor(scopeKey: string, expected: string, actual: string);
+}
+export declare class UnsupportedSchemaError extends Error {
+    version: number;
+    constructor(version: number);
+}
+export interface SaveOptions {
+    /**
+     * When set, the write only succeeds if the existing record's CAS token matches.
+     * Omitting it for a goal-scoped packet triggers a CasMismatchError (an active
+     * Goal's packet must be updated via explicit resume with the current token).
+     */
+    expectedToken?: string;
+    /** Stamp used instead of the wall clock (deterministic tests). */
+    now?: () => Date;
+}
+export interface SaveResult {
+    version: number;
+    casToken: string;
+}
+/**
+ * Atomically save (or update) a research packet under its scope. Enforces CAS so
+ * concurrent / active-Goal overwrites are rejected unless the caller holds the
+ * current token. Returns the new version + token.
+ */
+export declare function saveResearchPacket(store: ResearchArtifactStore, packet: ResearchPacket, scope: ResearchScope, opts?: SaveOptions): SaveResult;
+/**
+ * Load a packet. Fails closed on old/unsupported schema versions (never migrates
+ * silently). Returns null when nothing is stored for the scope.
+ */
+export declare function loadResearchPacket(store: ResearchArtifactStore, scope: ResearchScope): ResearchPacket | null;
+/**
+ * Resume the research state from a stored packet WITHOUT replaying external side
+ * effects. Pure derivation: completed when there are usable sources and no
+ * failures/conflicts, partial when there are failures/conflicts but some progress,
+ * failed only when there is nothing usable.
+ */
+export declare function resumeResearchState(packet: ResearchPacket): ResearchResumeState;
+/** Get the prior CAS tokens for a scope (traceability after clear/repair). */
+export declare function artifactHistory(store: ResearchArtifactStore, scope: ResearchScope): string[];
+//# sourceMappingURL=research-artifact.d.ts.map

package/dist/runtime/subagents/research-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-artifact.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/research-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAC9C,qFAAqF;IACrF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACtD;;;;OAIG;IACH,UAAU,CAAC,CACT,QAAQ,EAAE,MAAM,EAChB,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;CACZ;AAMD,0FAA0F;AAC1F,wBAAgB,yBAAyB,IAAI,qBAAqB,CAiBjE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAErD;AA0BD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CAyBlF;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErE,qBAAa,gBAAiB,SAAQ,KAAK;IAEhC,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;gBAFd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;CAKxB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC5B,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAInC;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,WAAgB,GACrB,UAAU,CAkCZ;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,aAAa,GACnB,cAAc,GAAG,IAAI,CAOvB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAW/E;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAE5F"}

package/dist/runtime/subagents/research-artifact.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Research artifact persistence, resume, and Goal integration (v0.1.4, P1-R5).
+ *
+ * - Packet + source metadata are saved atomically under a CAS (compare-and-swap)
+ *   token so a concurrent / active-Goal overwrite without the current token is
+ *   rejected.
+ * - Scope isolation: project / session / Goal are part of the storage key, so a
+ *   packet can never leak across project/session boundaries.
+ * - resume derives completed/partial/failed WITHOUT replaying any external side
+ *   effect (no network, no fetch) - it only reads the stored packet.
+ * - clear/repair/cleanup preserve the original packet + prior CAS tokens for
+ *   traceability; old schema versions fail closed (never silently migrated).
+ *
+ * Persistence is injected (default: in-memory map) so the logic is testable
+ * without disk.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnsupportedSchemaError = exports.CasMismatchError = void 0;
+exports.createMemoryArtifactStore = createMemoryArtifactStore;
+exports.scopeKey = scopeKey;
+exports.createFileArtifactStore = createFileArtifactStore;
+exports.saveResearchPacket = saveResearchPacket;
+exports.loadResearchPacket = loadResearchPacket;
+exports.resumeResearchState = resumeResearchState;
+exports.artifactHistory = artifactHistory;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const atomic_write_1 = require("../../services/atomic-write");
+const config_dir_1 = require("../../services/config-dir");
+const file_lock_1 = require("../../services/file-lock");
+const research_contract_1 = require("./research-contract");
+const research_types_1 = require("./research-types");
+function cloneRecord(record) {
+    return JSON.parse(JSON.stringify(record));
+}
+/** Default in-memory store (test seam; production can back this with session storage). */
+function createMemoryArtifactStore() {
+    const map = new Map();
+    return {
+        read: key => {
+            const record = map.get(key);
+            return record ? cloneRecord(record) : null;
+        },
+        write: (key, rec) => {
+            map.set(key, cloneRecord(rec));
+        },
+        writeIfCas: (key, expectedCurrentToken, rec) => {
+            const actual = map.get(key)?.casToken ?? null;
+            if (actual !== expectedCurrentToken)
+                return false;
+            map.set(key, cloneRecord(rec));
+            return true;
+        },
+    };
+}
+function scopeKey(scope) {
+    return `${scope.projectPath}::${scope.sessionId}::${scope.goalId ?? '-'}::${scope.packetId ?? '-'}`;
+}
+function readArtifactRecord(file) {
+    if (!(0, fs_1.existsSync)(file))
+        return null;
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+        if (!parsed ||
+            typeof parsed.version !== 'number' ||
+            typeof parsed.casToken !== 'string' ||
+            !parsed.packet ||
+            typeof parsed.storedAt !== 'string' ||
+            !Array.isArray(parsed.previousTokens)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function writeArtifactRecord(file, record) {
+    (0, atomic_write_1.atomicWriteFileSync)(file, `${JSON.stringify(record)}\n`, { mode: 0o600 });
+}
+/**
+ * Durable project-scoped store used by the runtime integration.
+ *
+ * Each packet has a deterministic filename derived from its full scope. Writes
+ * use a sibling temporary file plus rename so a killed process cannot leave a
+ * partially-written JSON record that looks resumable.
+ */
+function createFileArtifactStore(projectPath) {
+    const artifactDir = (0, config_dir_1.getProjectArtifactsDir)(projectPath);
+    const fileFor = (key) => {
+        const digest = (0, crypto_1.createHash)('sha256').update(key).digest('hex');
+        return (0, path_1.join)(artifactDir, `research-${digest}.json`);
+    };
+    return {
+        read: key => readArtifactRecord(fileFor(key)),
+        write: (key, record) => {
+            (0, fs_1.mkdirSync)(artifactDir, { recursive: true, mode: 0o700 });
+            const file = fileFor(key);
+            (0, file_lock_1.withFileLockSync)(file, () => writeArtifactRecord(file, record));
+        },
+        writeIfCas: (key, expectedCurrentToken, record) => {
+            (0, fs_1.mkdirSync)(artifactDir, { recursive: true, mode: 0o700 });
+            const file = fileFor(key);
+            return (0, file_lock_1.withFileLockSync)(file, () => {
+                const actual = readArtifactRecord(file)?.casToken ?? null;
+                if (actual !== expectedCurrentToken)
+                    return false;
+                writeArtifactRecord(file, record);
+                return true;
+            });
+        },
+    };
+}
+class CasMismatchError extends Error {
+    constructor(scopeKey, expected, actual) {
+        super(`CAS mismatch for ${scopeKey}: expected ${expected}, found ${actual}`);
+        this.scopeKey = scopeKey;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'CasMismatchError';
+    }
+}
+exports.CasMismatchError = CasMismatchError;
+class UnsupportedSchemaError extends Error {
+    constructor(version) {
+        super(`unsupported research schema version ${version}`);
+        this.version = version;
+        this.name = 'UnsupportedSchemaError';
+    }
+}
+exports.UnsupportedSchemaError = UnsupportedSchemaError;
+/**
+ * Atomically save (or update) a research packet under its scope. Enforces CAS so
+ * concurrent / active-Goal overwrites are rejected unless the caller holds the
+ * current token. Returns the new version + token.
+ */
+function saveResearchPacket(store, packet, scope, opts = {}) {
+    const key = scopeKey(scope);
+    const now = opts.now ?? (() => new Date());
+    const casToken = (0, research_contract_1.hashPacket)(packet);
+    const existing = store.read(key);
+    if (opts.expectedToken !== undefined && !existing) {
+        throw new CasMismatchError(key, opts.expectedToken, '<missing>');
+    }
+    if (scope.goalId && existing && opts.expectedToken === undefined) {
+        // An active Goal's packet must be updated with an explicit token (resume),
+        // never blindly overwritten.
+        throw new CasMismatchError(key, existing.casToken, casToken);
+    }
+    if (existing && opts.expectedToken !== undefined && opts.expectedToken !== existing.casToken) {
+        throw new CasMismatchError(key, opts.expectedToken, existing.casToken);
+    }
+    const version = (existing?.version ?? 0) + 1;
+    const previousTokens = existing ? [...existing.previousTokens, existing.casToken] : [];
+    const record = { version, casToken, packet, storedAt: now().toISOString(), previousTokens };
+    const expectedCurrentToken = existing?.casToken ?? null;
+    if (store.writeIfCas) {
+        const written = store.writeIfCas(key, expectedCurrentToken, record);
+        if (!written) {
+            const actual = store.read(key)?.casToken ?? '<missing>';
+            throw new CasMismatchError(key, expectedCurrentToken ?? '<missing>', actual);
+        }
+    }
+    else {
+        // Backward compatibility for injected legacy stores. Built-in memory/file
+        // stores always take the atomic path above.
+        store.write(key, record);
+    }
+    return { version, casToken };
+}
+/**
+ * Load a packet. Fails closed on old/unsupported schema versions (never migrates
+ * silently). Returns null when nothing is stored for the scope.
+ */
+function loadResearchPacket(store, scope) {
+    const rec = store.read(scopeKey(scope));
+    if (!rec)
+        return null;
+    if (rec.packet.schemaVersion !== research_types_1.RESEARCH_SCHEMA_VERSION) {
+        throw new UnsupportedSchemaError(rec.packet.schemaVersion);
+    }
+    return rec.packet;
+}
+/**
+ * Resume the research state from a stored packet WITHOUT replaying external side
+ * effects. Pure derivation: completed when there are usable sources and no
+ * failures/conflicts, partial when there are failures/conflicts but some progress,
+ * failed only when there is nothing usable.
+ */
+function resumeResearchState(packet) {
+    if (packet.schemaVersion !== research_types_1.RESEARCH_SCHEMA_VERSION)
+        throw new UnsupportedSchemaError(packet.schemaVersion);
+    if (packet.sources.length === 0)
+        return 'failed';
+    // Only a fully retrieved source set can resume as completed. Partial and
+    // stale evidence must remain visible after restart instead of being silently
+    // upgraded (#108); failed/blocked retain the existing partial semantics.
+    const hasIncompleteSources = packet.sources.some(s => s.status !== 'retrieved');
+    const hasConflict = packet.risks.some(r => /conflict/i.test(r));
+    if (hasIncompleteSources || hasConflict)
+        return 'partial';
+    return 'completed';
+}
+/** Get the prior CAS tokens for a scope (traceability after clear/repair). */
+function artifactHistory(store, scope) {
+    return store.read(scopeKey(scope))?.previousTokens ?? [];
+}
+//# sourceMappingURL=research-artifact.js.map

package/dist/runtime/subagents/research-artifact.js.map

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

package/dist/runtime/subagents/research-citation.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Citation, conflict, and evidence-candidate resolution (v0.1.4, P0-R3).
+ *
+ * Turns a `ResearchPacket` (with its claims + sources) into:
+ *  - resolved claim->source bindings (reference-integrity validated),
+ *  - same-URL multi-version dedupe (older revisions marked `stale` on hash drift),
+ *  - conflict records for contradictory sources (never auto-picked),
+ *  - a verification classification per claim,
+ *  - evidence candidates (only rule-compliant claims; research vs execution kept
+ *    distinct so a web summary can never stand in for test/build/file facts),
+ *  - a completion audit that stays `partial`/`unmet` for claims that have sources
+ *    but no independent verification.
+ *
+ * This module is pure (no IO) so it is fully testable without network or disk.
+ */
+import type { ResearchPacket } from './research-types';
+/** Normalize a URL for dedupe: drop fragment + trailing slash, lowercase host. */
+export declare function urlKey(url: string | undefined): string;
+export type BindingStatus = 'bound' | 'dangling' | 'stale_only' | 'conflicted';
+export interface ClaimBinding {
+    claimId: string;
+    /** Resolved, non-stale source ids actually backing the claim. */
+    sourceIds: string[];
+    /** All source ids referenced by the claim (including stale/blocked). */
+    referencedSourceIds: string[];
+    status: BindingStatus;
+}
+export interface ConflictRecord {
+    claimId: string;
+    sourceIds: string[];
+    reason: string;
+}
+export interface EvidenceCandidate {
+    claimId: string;
+    /** 'research' = external/web source; 'execution' = file/verification fact. */
+    kind: 'research' | 'execution';
+    basis: 'file' | 'external';
+    summary: string;
+}
+export interface CompletionAudit {
+    status: 'met' | 'partial' | 'unmet';
+    /** Claims that have sources but no independent verification. */
+    unverifiedClaimIds: string[];
+    notes: string[];
+}
+export interface CitationResolution {
+    packetId: string;
+    bindings: ClaimBinding[];
+    conflicts: ConflictRecord[];
+    staleSourceIds: string[];
+    evidenceCandidates: EvidenceCandidate[];
+    audit: CompletionAudit;
+}
+/**
+ * Resolve citations for a packet.
+ *
+ * Reference integrity: a claim binding to an unknown source id is flagged
+ * `dangling` (and downgraded to `unverified`). Dedupe: sources sharing a
+ * canonical URL key are collapsed; the newest by `retrievedAt` wins and older
+ * revisions with a different content hash are marked `stale`. Conflict: a claim
+ * backed by both a `retrieved` source and a `failed`/`blocked` source (or two
+ * sources explicitly flagged contradictory) yields a conflict record and is
+ * never silently resolved in the model-favorable direction.
+ */
+export declare function resolveCitations(packet: ResearchPacket): CitationResolution;
+//# sourceMappingURL=research-citation.d.ts.map

package/dist/runtime/subagents/research-citation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-citation.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/research-citation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAiB,cAAc,EAAgC,MAAM,kBAAkB,CAAC;AAEpG,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYtD;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,CAsG3E"}

package/dist/runtime/subagents/research-citation.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Citation, conflict, and evidence-candidate resolution (v0.1.4, P0-R3).
+ *
+ * Turns a `ResearchPacket` (with its claims + sources) into:
+ *  - resolved claim->source bindings (reference-integrity validated),
+ *  - same-URL multi-version dedupe (older revisions marked `stale` on hash drift),
+ *  - conflict records for contradictory sources (never auto-picked),
+ *  - a verification classification per claim,
+ *  - evidence candidates (only rule-compliant claims; research vs execution kept
+ *    distinct so a web summary can never stand in for test/build/file facts),
+ *  - a completion audit that stays `partial`/`unmet` for claims that have sources
+ *    but no independent verification.
+ *
+ * This module is pure (no IO) so it is fully testable without network or disk.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.urlKey = urlKey;
+exports.resolveCitations = resolveCitations;
+/** Normalize a URL for dedupe: drop fragment + trailing slash, lowercase host. */
+function urlKey(url) {
+    if (!url)
+        return '';
+    try {
+        const u = new URL(url);
+        const host = u.host.toLowerCase();
+        let path = u.pathname;
+        if (path.length > 1 && path.endsWith('/'))
+            path = path.slice(0, -1);
+        const query = u.search;
+        return `${u.protocol}//${host}${path}${query}`;
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Resolve citations for a packet.
+ *
+ * Reference integrity: a claim binding to an unknown source id is flagged
+ * `dangling` (and downgraded to `unverified`). Dedupe: sources sharing a
+ * canonical URL key are collapsed; the newest by `retrievedAt` wins and older
+ * revisions with a different content hash are marked `stale`. Conflict: a claim
+ * backed by both a `retrieved` source and a `failed`/`blocked` source (or two
+ * sources explicitly flagged contradictory) yields a conflict record and is
+ * never silently resolved in the model-favorable direction.
+ */
+function resolveCitations(packet) {
+    const sourceIds = new Set(packet.sources.map(s => s.id));
+    const byId = new Map(packet.sources.map(s => [s.id, s]));
+    // --- dedupe same-URL multi-version -> stale ---
+    const staleSourceIds = [];
+    const groups = new Map();
+    for (const s of packet.sources) {
+        const key = urlKey(s.canonicalUrl);
+        if (!key)
+            continue;
+        const arr = groups.get(key) ?? [];
+        arr.push(s);
+        groups.set(key, arr);
+    }
+    for (const [, group] of groups) {
+        if (group.length < 2)
+            continue;
+        // newest by retrievedAt wins; older ones with a different hash become stale.
+        const sorted = [...group].sort((a, b) => b.retrievedAt.localeCompare(a.retrievedAt));
+        const winner = sorted[0];
+        for (let i = 1; i < sorted.length; i++) {
+            const s = sorted[i];
+            if (s.contentHash && winner.contentHash && s.contentHash !== winner.contentHash) {
+                staleSourceIds.push(s.id);
+                s.status = 'stale';
+            }
+        }
+    }
+    const staleSet = new Set(staleSourceIds);
+    const bindings = [];
+    const conflicts = [];
+    const evidenceCandidates = [];
+    for (const claim of packet.claims) {
+        const referenced = claim.sourceIds.filter(id => sourceIds.has(id));
+        const danglingRefs = claim.sourceIds.filter(id => !sourceIds.has(id));
+        const active = referenced.filter(id => !staleSet.has(id));
+        const activeSources = active.map(id => byId.get(id)).filter(Boolean);
+        const hasRetrieved = activeSources.some(s => s.status === 'retrieved');
+        const hasFailed = activeSources.some(s => s.status === 'failed' || s.status === 'blocked');
+        let status;
+        if (danglingRefs.length > 0 && referenced.length === 0) {
+            status = 'dangling';
+        }
+        else if (hasRetrieved && hasFailed) {
+            status = 'conflicted';
+        }
+        else if (active.length === 0 && referenced.length > 0) {
+            status = 'stale_only';
+        }
+        else {
+            status = 'bound';
+        }
+        if (status === 'conflicted') {
+            conflicts.push({
+                claimId: claim.id,
+                sourceIds: active,
+                reason: 'claim backed by both a retrieved source and a failed/blocked source',
+            });
+        }
+        bindings.push({
+            claimId: claim.id,
+            sourceIds: active,
+            referencedSourceIds: referenced,
+            status,
+        });
+        // Verification classification: conflicted -> contradicted.
+        const verification = status === 'conflicted'
+            ? 'contradicted'
+            : classifyVerification(claim, hasRetrieved, activeSources);
+        claim.verification = verification;
+        // Evidence candidate: only rule-compliant claims.
+        if ((verification === 'observed' || verification === 'partially_observed') &&
+            claim.evidenceKind !== 'inference' &&
+            status !== 'conflicted') {
+            const primary = activeSources.find(s => s.status === 'retrieved');
+            const isFile = primary?.kind === 'file';
+            evidenceCandidates.push({
+                claimId: claim.id,
+                kind: isFile ? 'execution' : 'research',
+                basis: isFile ? 'file' : 'external',
+                summary: claim.text,
+            });
+        }
+    }
+    const audit = auditCompletion(packet, bindings);
+    return {
+        packetId: packet.packetId,
+        bindings,
+        conflicts,
+        staleSourceIds,
+        evidenceCandidates,
+        audit,
+    };
+}
+function classifyVerification(claim, hasRetrieved, activeSources) {
+    if (claim.evidenceKind === 'inference')
+        return 'unverified';
+    if (!hasRetrieved)
+        return 'unverified';
+    const onlyExcerpt = activeSources.every(s => !!s.excerpt && s.excerpt.length < 4000 && !s.contentHash);
+    return onlyExcerpt ? 'partially_observed' : 'observed';
+}
+/**
+ * Completion audit. The key invariant (plan exit condition): a claim that HAS
+ * sources but no independent verification must keep the audit `partial`/`unmet`
+ * - never `met`. We therefore treat any claim with referenced sources whose
+ * verification is not `observed` as unverified for audit purposes.
+ */
+function auditCompletion(packet, bindings) {
+    const notes = [];
+    const unverifiedClaimIds = [];
+    for (const claim of packet.claims) {
+        const binding = bindings.find(b => b.claimId === claim.id);
+        const hasSources = (binding?.referencedSourceIds.length ?? 0) > 0;
+        const independentlyVerified = claim.verification === 'observed';
+        if (!independentlyVerified) {
+            if (hasSources) {
+                unverifiedClaimIds.push(claim.id);
+                notes.push(`claim ${claim.id} has sources but no independent verification (stays partial)`);
+            }
+            else {
+                unverifiedClaimIds.push(claim.id);
+            }
+        }
+    }
+    let status;
+    if (unverifiedClaimIds.length === 0) {
+        status = 'met';
+    }
+    else if (packet.claims.some(c => (bindings.find(b => b.claimId === c.id)?.referencedSourceIds.length ?? 0) > 0)) {
+        status = 'partial';
+    }
+    else {
+        status = 'unmet';
+    }
+    return { status, unverifiedClaimIds, notes };
+}
+//# sourceMappingURL=research-citation.js.map