@claudexor/daemon 1.0.0 → 2.1.2

package/dist/interactions.js

@@ -1,28 +1,122 @@
-import { InteractionAnswerSet as InteractionAnswerSetSchema } from "@claudexor/schema";
-/**
- * Daemon-side registry of questions waiting for the user (waiting_on_user).
- *
- * The orchestrator's RunInput.onInteraction is wired to `register()`, which
- * parks the attempt's promise here; control-api lists pending entries for the
- * UI and delivers answers via `answer()`. The orchestrator owns the timeout —
- * entries self-expire here only as hygiene so a timed-out question cannot be
- * answered into a session that already moved on.
- */
-export class InteractionRegistry {
+import { ControlPendingInteraction as PendingInteractionSchema, InteractionAnswerSet as InteractionAnswerSetSchema, } from "@claudexor/schema";
+const REQUESTED = "interaction.requested";
+const RESOLVED = "interaction.resolved";
+/** Journal-backed authority for pending interaction projections. */
+export class InteractionStore {
+    journal;
     pending = new Map();
-    /**
-     * Entries are keyed by (runId, interactionId): interaction ids originate
-     * from the harness's native request ids, which only need to be unique
-     * within one session — two concurrent runs may legally collide.
-     */
-    key(runId, interactionId) {
-        return `${runId}\u0000${interactionId}`;
-    }
-    register(ctx) {
+    resolved = new Set();
+    constructor(journal) {
+        this.journal = journal;
+        this.replay();
+        this.interruptAfterRestart();
+    }
+    request(ctx) {
+        const value = PendingInteractionSchema.parse({
+            interactionId: ctx.request.interaction_id,
+            runId: ctx.runId,
+            attemptId: ctx.attemptId,
+            harnessId: ctx.harnessId,
+            sourceTool: ctx.request.source_tool,
+            questions: ctx.request.questions,
+            requestedAt: ctx.requestedAt,
+            timeoutAt: ctx.timeoutAt,
+        });
+        const key = interactionKey(value.runId, value.interactionId);
+        if (this.pending.has(key) || this.resolved.has(key)) {
+            throw new Error(`duplicate interaction '${value.interactionId}' for run '${value.runId}'`);
+        }
+        this.journal.append(REQUESTED, value);
+        this.pending.set(key, value);
+        return value;
+    }
+    resolve(runId, interactionId, terminal) {
+        const key = interactionKey(runId, interactionId);
+        if (this.resolved.has(key))
+            return "already_resolved";
+        if (!this.pending.has(key))
+            return "not_found";
+        this.commitResolution({ runId, interactionIds: [interactionId], terminal });
+        return "resolved";
+    }
+    resolveRun(runId, terminal) {
+        const interactionIds = this.pendingForRun(runId).map((value) => value.interactionId);
+        if (interactionIds.length > 0)
+            this.commitResolution({ runId, interactionIds, terminal });
+        return interactionIds;
+    }
+    status(runId, interactionId) {
+        const key = interactionKey(runId, interactionId);
+        if (this.pending.has(key))
+            return "pending";
+        return this.resolved.has(key) ? "resolved" : "missing";
+    }
+    pendingForRun(runId) {
+        return [...this.pending.values()].filter((value) => value.runId === runId);
+    }
+    validateProjection() {
+        for (const value of this.pending.values())
+            PendingInteractionSchema.parse(value);
+        for (const key of this.pending.keys()) {
+            if (this.resolved.has(key))
+                throw new Error("interaction is both pending and resolved");
+        }
+    }
+    replay() {
+        for (const record of this.journal.records()) {
+            if (record.type === REQUESTED) {
+                const value = PendingInteractionSchema.parse(record.payload);
+                const key = interactionKey(value.runId, value.interactionId);
+                if (this.pending.has(key) || this.resolved.has(key)) {
+                    throw new Error("duplicate interaction request history");
+                }
+                this.pending.set(key, value);
+            }
+            else if (record.type === RESOLVED) {
+                this.applyResolution(parseResolution(record.payload));
+            }
+        }
+        this.validateProjection();
+    }
+    interruptAfterRestart() {
+        const byRun = new Map();
+        for (const value of this.pending.values()) {
+            const ids = byRun.get(value.runId) ?? [];
+            ids.push(value.interactionId);
+            byRun.set(value.runId, ids);
+        }
+        for (const [runId, interactionIds] of byRun) {
+            this.commitResolution({ runId, interactionIds, terminal: "interrupted" });
+        }
+    }
+    commitResolution(value) {
+        const parsed = parseResolution(value);
+        this.journal.append(RESOLVED, parsed);
+        this.applyResolution(parsed);
+    }
+    applyResolution(value) {
+        for (const interactionId of value.interactionIds) {
+            const key = interactionKey(value.runId, interactionId);
+            if (!this.pending.delete(key))
+                throw new Error("interaction resolution precedes request");
+            this.resolved.add(key);
+        }
+    }
+}
+/** Live answer bridge; durable state remains owned by InteractionStore. */
+export class InteractionRegistry {
+    stores;
+    live = new Map();
+    constructor(stores) {
+        this.stores = stores;
+    }
+    register(ctx, params) {
         this.prune();
+        const store = this.stores.forRequest(params);
+        store.request(ctx);
         return new Promise((resolve) => {
-            this.pending.set(this.key(ctx.runId, ctx.request.interaction_id), {
-                ctx,
+            this.live.set(interactionKey(ctx.runId, ctx.request.interaction_id), {
+                store,
                 resolve,
                 expiresAtMs: Date.parse(ctx.timeoutAt) || Date.now() + 900_000,
             });
@@ -30,52 +124,85 @@ export class InteractionRegistry {
     }
     answer(runId, interactionId, rawAnswers) {
         this.prune();
-        const entry = this.pending.get(this.key(runId, interactionId));
-        if (!entry)
-            return { status: "not_found", message: `no pending interaction '${interactionId}' for run '${runId}'` };
         const parsed = InteractionAnswerSetSchema.safeParse(rawAnswers);
-        if (!parsed.success)
+        if (!parsed.success) {
             return { status: "rejected", message: parsed.error.issues[0]?.message ?? "invalid answers" };
-        this.pending.delete(this.key(runId, interactionId));
-        entry.resolve(parsed.data);
+        }
+        const store = this.stores
+            .all()
+            .find((candidate) => candidate.status(runId, interactionId) !== "missing");
+        if (!store)
+            return { status: "not_found", message: missingMessage(runId, interactionId) };
+        const status = store.resolve(runId, interactionId, "answered");
+        if (status !== "resolved") {
+            return {
+                status: status === "already_resolved" ? "already_resolved" : "not_found",
+                message: status === "not_found" ? missingMessage(runId, interactionId) : undefined,
+            };
+        }
+        const key = interactionKey(runId, interactionId);
+        const entry = this.live.get(key);
+        this.live.delete(key);
+        entry?.resolve(parsed.data);
         return { status: "delivered" };
     }
-    /** Resolve-and-drop every pending question of a run that reached a terminal
-     * (cancel/failed/succeeded): a dead run must not advertise waiting_on_user
-     * for up to the interaction timeout. Resolving null mirrors the
-     * orchestrator's own decline path. */
     dropForRun(runId) {
-        for (const [id, entry] of this.pending) {
-            if (entry.ctx.runId === runId) {
-                this.pending.delete(id);
-                entry.resolve(null);
-            }
+        for (const store of this.stores.all())
+            store.resolveRun(runId, "run_terminal");
+        for (const [key, entry] of this.live) {
+            if (!key.startsWith(`${runId}\u0000`))
+                continue;
+            this.live.delete(key);
+            entry.resolve(null);
         }
     }
     pendingForRun(runId) {
         this.prune();
-        return [...this.pending.values()]
-            .filter((e) => e.ctx.runId === runId)
-            .map((e) => ({
-            interactionId: e.ctx.request.interaction_id,
-            runId: e.ctx.runId,
-            attemptId: e.ctx.attemptId,
-            harnessId: e.ctx.harnessId,
-            sourceTool: e.ctx.request.source_tool,
-            questions: e.ctx.request.questions,
-            requestedAt: e.ctx.requestedAt,
-            timeoutAt: e.ctx.timeoutAt,
-        }));
-    }
-    /** Drop expired entries (the orchestrator already declined them). */
+        return this.stores.all().flatMap((store) => store.pendingForRun(runId));
+    }
     prune() {
         const now = Date.now();
-        for (const [id, entry] of this.pending) {
-            if (entry.expiresAtMs <= now) {
-                this.pending.delete(id);
-                entry.resolve(null);
-            }
+        for (const [key, entry] of this.live) {
+            if (entry.expiresAtMs > now)
+                continue;
+            const split = key.indexOf("\u0000");
+            const runId = key.slice(0, split);
+            const interactionId = key.slice(split + 1);
+            entry.store.resolve(runId, interactionId, "timeout");
+            this.live.delete(key);
+            entry.resolve(null);
         }
     }
 }
+export function interactionProjection() {
+    return {
+        name: "interactions",
+        create: (journal) => new InteractionStore(journal),
+        validate: (store) => store.validateProjection(),
+    };
+}
+function interactionKey(runId, interactionId) {
+    return `${runId}\u0000${interactionId}`;
+}
+function parseResolution(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("invalid interaction resolution");
+    const input = value;
+    const terminals = ["answered", "timeout", "run_terminal", "interrupted"];
+    if (typeof input.runId !== "string" ||
+        !Array.isArray(input.interactionIds) ||
+        input.interactionIds.length === 0 ||
+        input.interactionIds.some((id) => typeof id !== "string" || !id) ||
+        !terminals.includes(input.terminal)) {
+        throw new Error("invalid interaction resolution");
+    }
+    return {
+        runId: input.runId,
+        interactionIds: [...input.interactionIds],
+        terminal: input.terminal,
+    };
+}
+function missingMessage(runId, interactionId) {
+    return `no pending interaction '${interactionId}' for run '${runId}'`;
+}
 //# sourceMappingURL=interactions.js.map

package/dist/interactions.js.map

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

package/dist/journal-events.d.ts

@@ -0,0 +1,4 @@
+import { DurableJournal, type JournalRecoveryState } from "@claudexor/journal";
+import type { ControlJournalEvent } from "@claudexor/schema";
+export declare function journalEvents(journal: DurableJournal | null, recovery: JournalRecoveryState, afterCursor?: string): ControlJournalEvent[];
+//# sourceMappingURL=journal-events.d.ts.map

package/dist/journal-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-events.d.ts","sourceRoot":"","sources":["../src/journal-events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,GAAG,IAAI,EAC9B,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,mBAAmB,EAAE,CAsBvB"}

package/dist/journal-events.js

@@ -0,0 +1,23 @@
+import { JournalRecoveryRequiredError, } from "@claudexor/journal";
+export function journalEvents(journal, recovery, afterCursor) {
+    if (!journal || recovery.status === "recovery_required") {
+        throw new JournalRecoveryRequiredError(recovery.status === "recovery_required"
+            ? recovery
+            : {
+                status: "recovery_required",
+                location: { kind: "byte", byteOffset: 0 },
+                reason: "journal partition is unavailable",
+                discardedTailBytes: 0,
+            });
+    }
+    const afterSeq = afterCursor ? journal.sequenceAfter(afterCursor) : 0;
+    return journal.records(afterSeq).map((record) => ({
+        schemaVersion: 1,
+        cursor: journal.cursorAt(record.seq),
+        partition: record.partition,
+        type: record.type,
+        observedAt: record.time,
+        payload: record.payload,
+    }));
+}
+//# sourceMappingURL=journal-events.js.map

package/dist/journal-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-events.js","sourceRoot":"","sources":["../src/journal-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,4BAA4B,GAE7B,MAAM,oBAAoB,CAAC;AAG5B,MAAM,UAAU,aAAa,CAC3B,OAA8B,EAC9B,QAA8B,EAC9B,WAAoB;IAEpB,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACxD,MAAM,IAAI,4BAA4B,CACpC,QAAQ,CAAC,MAAM,KAAK,mBAAmB;YACrC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC;gBACE,MAAM,EAAE,mBAAmB;gBAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE;gBACzC,MAAM,EAAE,kCAAkC;gBAC1C,kBAAkB,EAAE,CAAC;aACtB,CACN,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChD,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/journal-manager.d.ts

@@ -0,0 +1,72 @@
+import { type ControlJournalExportReceipt, type ControlJournalInspection, type ControlJournalQuarantineReceipt, type ControlJournalQuarantineRequest, type ControlJournalValidation } from "@claudexor/schema";
+import type { JournalProjectionDescriptor, JournalProjectionSlot } from "./journal-projection.js";
+export type { JournalProjectionDescriptor, JournalProjectionSlot } from "./journal-projection.js";
+export type JournalQuarantineRequest = ControlJournalQuarantineRequest & {
+    idempotencyKey: string;
+};
+type JournalManagerFault = "afterQuarantineRename" | "afterQuarantineReceipt";
+export interface JournalManagerOptions {
+    partition?: string;
+    now?: () => Date;
+    faults?: Partial<Record<JournalManagerFault, () => void>>;
+}
+export declare class JournalManager {
+    readonly rootDir: string;
+    readonly partition: string;
+    readonly journalRoot: string;
+    readonly partitionDir: string;
+    private readonly operationsDir;
+    private readonly quarantineDir;
+    private readonly artifactPrefix;
+    private readonly now;
+    private readonly faults;
+    private readonly registrations;
+    private journal;
+    private recovery;
+    private generationValue;
+    private started;
+    private closed;
+    constructor(rootDir: string, options?: JournalManagerOptions);
+    registerProjection<T>(descriptor: JournalProjectionDescriptor<T>): JournalProjectionSlot<T>;
+    start(): ControlJournalInspection;
+    inspect(): ControlJournalInspection;
+    ready(): boolean;
+    validate(): ControlJournalValidation;
+    events(afterCursor?: string): {
+        type: string;
+        cursor: string;
+        observedAt: string;
+        schemaVersion: 1;
+        partition: string;
+        payload?: unknown;
+    }[];
+    exportRecovery(): ControlJournalExportReceipt;
+    preflightQuarantine(input: JournalQuarantineRequest): {
+        disposition: string;
+        receipt: {
+            schemaVersion: 1;
+            completedAt: string;
+            partition: string;
+            operationId: string;
+            previousFingerprint: string;
+            quarantineArtifactId: string;
+            quarantinePath: string;
+            newEpoch: string;
+        };
+    } | {
+        disposition: string;
+        receipt: null;
+    };
+    quarantineAndStartFresh(input: JournalQuarantineRequest): ControlJournalQuarantineReceipt;
+    close(): void;
+    private openGeneration;
+    private resume;
+    private completeFromReceipt;
+    private reconcilePrepared;
+    private inspection;
+    private enterRecovery;
+    private clearSlots;
+    private assertStarted;
+    private assertOpen;
+}
+//# sourceMappingURL=journal-manager.d.ts.map

package/dist/journal-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-manager.d.ts","sourceRoot":"","sources":["../src/journal-manager.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAC;AAiB3B,OAAO,KAAK,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAClG,YAAY,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAElG,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,GAAG;IACvE,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAkBF,KAAK,mBAAmB,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;CAC3D;AAED,qBAAa,cAAc;IAiBvB,QAAQ,CAAC,OAAO,EAAE,MAAM;IAhB1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6C;IAC3E,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAoE;IACpF,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAGZ,OAAO,EAAE,MAAM,EACxB,OAAO,GAAE,qBAA0B;IAcrC,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,2BAA2B,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAW3F,KAAK,IAAI,wBAAwB;IASjC,OAAO,IAAI,wBAAwB;IASnC,KAAK,IAAI,OAAO;IAShB,QAAQ,IAAI,wBAAwB;IA6BpC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM;;;;;;;;IAK3B,cAAc,IAAI,2BAA2B;IAmD7C,mBAAmB,CAAC,KAAK,EAAE,wBAAwB;;;;;;;;;;;;;;;;IA8BnD,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,+BAA+B;IA+BzF,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,MAAM;IAsDd,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,UAAU;CAGnB"}