@claudexor/daemon 1.0.1 → 2.1.2

package/dist/run-events.js

@@ -0,0 +1,29 @@
+import { RunEvent } from "@claudexor/schema";
+const RECORDED = "run.event";
+/** Writes typed run events into their owning global/project journal partition. */
+export class RunEventStore {
+    journal;
+    constructor(journal) {
+        this.journal = journal;
+        this.validateProjection();
+    }
+    record(value) {
+        const event = RunEvent.parse(value);
+        this.journal.append(RECORDED, event);
+        return event;
+    }
+    validateProjection() {
+        for (const entry of this.journal.records()) {
+            if (entry.type === RECORDED)
+                RunEvent.parse(entry.payload);
+        }
+    }
+}
+export function runEventProjection() {
+    return {
+        name: "run-events",
+        create: (journal) => new RunEventStore(journal),
+        validate: (store) => store.validateProjection(),
+    };
+}
+//# sourceMappingURL=run-events.js.map

package/dist/run-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-events.js","sourceRoot":"","sources":["../src/run-events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAkC,MAAM,mBAAmB,CAAC;AAE7E,MAAM,QAAQ,GAAG,WAAW,CAAC;AAE7B,kFAAkF;AAClF,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAClD,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,KAAoB;QACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB;QAChB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,CAAC,OAAuB,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC;QAC/D,QAAQ,EAAE,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE;KAC/D,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -1,7 +1,6 @@
-/** Context the daemon supplies to the runner so a job can be observed and cancelled. */
+import { type CommandAuthority } from "./command-authority.js";
 export interface RunContext {
     signal: AbortSignal;
-    /** Called by the runner once the run id/dir are known (lets a client tail events.jsonl). */
     onRunStart: (info: {
         runId: string;
         taskId: string;
@@ -13,24 +12,28 @@ export interface DaemonOptions {
     socketPath: string;
     token: string;
     runner: RunnerFn;
-    /** Max concurrently-running jobs (parallel projects/runs). Default 4. */
     maxConcurrent?: number;
-    /** Optional JSON file to persist the job registry across restarts (durable run list). */
-    persistPath?: string;
-    /** Max retained terminal jobs (older ones are pruned to bound memory/disk). Default 500. */
+    commands: CommandAuthority;
     maxHistory?: number;
+    idempotencyRetentionMs?: number;
+    now?: () => Date;
     /** Called when a job reaches a terminal state (any path) with its runId —
      * used to drop pending interactions so a dead run never advertises
      * waiting_on_user. */
-    onRunTerminal?: (runId: string) => void;
+    onRunTerminal?: (runId: string, threadId?: string) => void;
     /** Called when a job that carried a pre-created thread turn (params.turnId)
      * settles failure-shaped WITHOUT ever binding a run — i.e. the refusal
      * happened before the run materialized (trust gate, preflight validation).
      * The observer persists the reason on the turn so it is never a silent
      * orphan bubble. `code` is the typed throw's machine code (null if none). */
     onTurnEnqueueFailed?: (turnId: string, error: string, code: string | null) => void;
+    /** Composition-root shutdown hook. When present, RPC shutdown must drain
+     * every daemon-owned subsystem, not only this socket queue. */
+    onShutdownRequested?: () => Promise<void>;
+    /** Test-only barriers around command authority acquisition. */
+    startupBarrier?: (barrier: "before_registry_load" | "after_registry_load") => void | Promise<void>;
 }
-export declare const JOB_STATES: readonly ["queued", "running", "blocked", "succeeded", "no_op", "ungated", "review_not_run", "failed", "cancelled", "interrupted", "exhausted", "not_converged", "stuck_no_progress"];
+export declare const JOB_STATES: readonly ["queued", "running", "blocked", "succeeded", "no_op", "ungated", "review_not_run", "failed", "cancelled", "interrupted_unknown", "cost_unverifiable", "exhausted_overshoot", "exhausted", "not_converged", "stuck_no_progress"];
 export type JobState = (typeof JOB_STATES)[number];
 export interface JobRecord {
     id: string;
@@ -42,33 +45,41 @@ export interface JobRecord {
      * trust_full_access_required) — lets surfaces key remedies on the CODE,
      * never on substring-matching the human message. */
     errorCode?: string;
+    /** HTTP status carried by a typed throw (400-599). Refusal semantics are
+     * born AT THE THROW (trust=403, requirements=400, journal recovery=503) —
+     * a bare errno-style `code` without a status is an infra failure and must
+     * not masquerade as a client-actionable 4xx. */
+    errorStatus?: number;
     createdAt: string;
-    /** Surfaced as soon as the run starts so a client can tail .claudexor/runs/<runId>/events.jsonl. */
+    /** Surfaced as soon as the run starts so a client can tail the external run's events.jsonl. */
     runId?: string;
     taskId?: string;
     runDir?: string;
     startedAt?: string;
     finishedAt?: string;
 }
-/**
- * Local daemon: Unix-socket JSON-RPC with token auth + a bounded-concurrency
- * worker pool (up to maxConcurrent jobs in parallel) backed by an optional
- * durable, atomically-written job registry. It does NOT contain a second
- * scheduler — it calls the injected runner (the same Orchestrator the CLI uses).
- */
+/** Unix-socket worker pool; scheduling stays in the injected Orchestrator. */
 export declare class DaemonServer {
     private readonly opts;
     private server?;
+    private readonly sockets;
     private readonly queue;
-    private readonly records;
     private readonly cancelled;
     private readonly controllers;
+    private readonly activeTasks;
+    private readonly taskFailures;
     private active;
     private readonly startedAt;
-    private onClosed?;
+    private stopping;
+    private startPromise?;
+    private stopPromise?;
+    private resolveShutdown;
+    private readonly shutdownPromise;
     constructor(opts: DaemonOptions);
     start(): Promise<void>;
+    private startOnce;
     stop(): Promise<void>;
+    private stopOnce;
     /** Resolves when the daemon is shut down via RPC. */
     waitForShutdown(): Promise<void>;
     private onConnection;
@@ -76,22 +87,12 @@ export declare class DaemonServer {
     private handle;
     private dispatch;
     private get maxConcurrent();
-    /**
-     * Best-effort durable persistence of the job registry. Writes atomically
-     * (temp file + rename) so a crash mid-write cannot corrupt/drop the registry.
-     * The raw run `result` is intentionally NOT persisted: canonical output lives
-     * in .claudexor/runs (redacted), and result.summary can contain raw model text —
-     * keeping it out of jobs.json upholds the redaction-at-persistence invariant.
-     */
-    private persist;
-    /** Bound memory/disk: prune the oldest terminal jobs beyond maxHistory.
-     * `blocked` runs are NEVER pruned — they are the needs-human inbox awaiting an
-     * operator decision; dropping one would silently lose a pending action. */
+    private stoppingError;
     private pruneHistory;
-    /** Reload the registry on startup; a fresh process cannot resume in-memory runs. */
-    private load;
-    /** Preserve the raw bytes of a damaged registry and report the loss loudly. */
-    private backupCorruptRegistry;
+    private acceptCommand;
+    private allRecords;
+    private getRecord;
+    private updateRecord;
     private threadIdOf;
     /**
      * Schedule queued jobs up to the concurrency limit (non-blocking).
@@ -106,7 +107,6 @@ export declare class DaemonServer {
     private drain;
     private runJob;
 }
-/** True when something is actively accepting connections on the socket path. */
 /** Is a daemon already listening on this socket? Exported so the claudexord
  * entrypoint can refuse BEFORE running crash GC — a second daemon must never
  * reap the live daemon's children or sweep envelopes its jobs still own. */

package/dist/server.d.ts.map

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