@claudexor/daemon 1.0.0

package/dist/server.js

@@ -0,0 +1,544 @@
+import { connect, createServer } from "node:net";
+import { timingSafeEqual } from "node:crypto";
+import { chmodSync, copyFileSync, mkdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { createInterface } from "node:readline";
+import { join } from "node:path";
+import { appendRunEvent } from "@claudexor/event-log";
+import { assertNoInlineSecretValues, errorCode, newId, nowIso, pathExists, readJsonSafe, redactSecrets } from "@claudexor/util";
+export const JOB_STATES = [
+    "queued",
+    "running",
+    "blocked",
+    "succeeded",
+    "no_op",
+    "ungated",
+    "review_not_run",
+    "failed",
+    "cancelled",
+    "interrupted",
+    "exhausted",
+    "not_converged",
+    "stuck_no_progress",
+];
+/**
+ * Per-record validation for the persisted registry: one hand-edited or
+ * version-skewed record must not wipe the whole run history, and a record
+ * with a state outside the enum must never reach the strict control-api
+ * DTOs (where it would 500 the entire GET /runs list).
+ */
+function salvageJobRecord(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const rec = raw;
+    if (typeof rec["id"] !== "string" || rec["id"].length === 0)
+        return null;
+    if (typeof rec["state"] !== "string" || !JOB_STATES.includes(rec["state"]))
+        return null;
+    if (typeof rec["createdAt"] !== "string")
+        return null;
+    const optionalString = (key) => typeof rec[key] === "string" ? rec[key] : undefined;
+    return {
+        id: rec["id"],
+        state: rec["state"],
+        params: rec["params"],
+        error: optionalString("error"),
+        errorCode: optionalString("errorCode"),
+        createdAt: rec["createdAt"],
+        runId: optionalString("runId"),
+        taskId: optionalString("taskId"),
+        runDir: optionalString("runDir"),
+        startedAt: optionalString("startedAt"),
+        finishedAt: optionalString("finishedAt"),
+    };
+}
+/**
+ * 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).
+ */
+export class DaemonServer {
+    opts;
+    server;
+    queue = [];
+    records = new Map();
+    cancelled = new Set();
+    controllers = new Map();
+    active = 0;
+    startedAt = Date.now();
+    onClosed;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async start() {
+        // Refuse to clobber a LIVE daemon: deleting its socket would orphan it and
+        // turn jobs.json into a last-writer-wins race between two processes.
+        if (pathExists(this.opts.socketPath) && (await socketAlive(this.opts.socketPath))) {
+            throw new Error(`a claudexor daemon is already listening on ${this.opts.socketPath}; stop it first`);
+        }
+        this.load();
+        try {
+            rmSync(this.opts.socketPath, { force: true });
+        }
+        catch {
+            /* nothing to clean */
+        }
+        await new Promise((resolve, reject) => {
+            this.server = createServer((sock) => this.onConnection(sock));
+            this.server.once("error", reject);
+            this.server.listen(this.opts.socketPath, () => {
+                // Owner-only socket: the bearer token is the auth layer, but a
+                // world-connectable socket needlessly exposes the RPC surface to every
+                // local user; chmod narrows it to the owning account.
+                try {
+                    chmodSync(this.opts.socketPath, 0o600);
+                }
+                catch {
+                    /* best-effort on exotic filesystems */
+                }
+                resolve();
+            });
+        });
+        // Resume any queued jobs re-enqueued from a previous session (see load()).
+        void this.drain();
+    }
+    async stop() {
+        // Graceful shutdown: abort in-flight runs so the runner cancels their harness
+        // children and settles each job (no orphaned processes / "running" zombies in
+        // jobs.json), then WAIT (bounded) for the cancellations to settle. Without
+        // the wait, the process could exit before the SIGKILL escalation timers
+        // fire, leaving a SIGTERM-ignoring harness child alive in its group.
+        for (const controller of this.controllers.values()) {
+            try {
+                controller.abort();
+            }
+            catch {
+                /* already gone */
+            }
+        }
+        const deadline = Date.now() + 5_000;
+        while (this.active > 0 && Date.now() < deadline) {
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+        this.persist();
+        await new Promise((resolve) => {
+            if (!this.server)
+                return resolve();
+            this.server.close(() => resolve());
+        });
+        this.onClosed?.();
+    }
+    /** Resolves when the daemon is shut down via RPC. */
+    waitForShutdown() {
+        return new Promise((resolve) => {
+            this.onClosed = resolve;
+        });
+    }
+    onConnection(sock) {
+        const rl = createInterface({ input: sock });
+        rl.on("line", (line) => {
+            void this.handle(line, sock);
+        });
+        sock.on("error", () => rl.close());
+    }
+    send(sock, obj) {
+        try {
+            sock.write(JSON.stringify(obj) + "\n");
+        }
+        catch {
+            /* socket closed */
+        }
+    }
+    async handle(line, sock) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(trimmed);
+        }
+        catch {
+            return;
+        }
+        const { id, method, params, token } = msg;
+        if (!tokenMatches(typeof token === "string" ? token : "", this.opts.token)) {
+            this.send(sock, { id, error: { message: "unauthorized" } });
+            return;
+        }
+        try {
+            this.send(sock, { id, result: await this.dispatch(method, params) });
+        }
+        catch (err) {
+            // Carry the machine-readable error code (e.g. inline_secret_rejected)
+            // alongside the redacted message so socket clients get the typed class.
+            const code = errorCode(err);
+            this.send(sock, { id, error: { message: redactSecrets(err instanceof Error ? err.message : String(err)), ...(code ? { code } : {}) } });
+        }
+    }
+    async dispatch(method, params) {
+        switch (method) {
+            case "claudexor.health":
+                return {
+                    ok: true,
+                    uptime_ms: Date.now() - this.startedAt,
+                    queue: this.queue.length,
+                    running: this.active > 0,
+                    active: this.active,
+                    jobs: this.records.size,
+                };
+            case "claudexor.enqueue": {
+                assertNoInlineSecretValues(params, "$", "daemon job params");
+                const id = newId("job");
+                this.records.set(id, { id, state: "queued", params, createdAt: nowIso() });
+                this.queue.push(id);
+                this.persist();
+                void this.drain();
+                return { id, state: "queued" };
+            }
+            case "claudexor.status": {
+                const rec = this.records.get(String(params?.id));
+                if (!rec)
+                    throw new Error(`no such job: ${params?.id}`);
+                return publicJobRecord(rec);
+            }
+            case "claudexor.list":
+                return [...this.records.values()].map(publicJobRecord);
+            case "claudexor.cancel": {
+                const jid = String(params?.id);
+                // Honesty: cancelling an unknown id must fail loudly (like status),
+                // never claim `{cancelled:true}` for a job that does not exist.
+                const rec = this.records.get(jid);
+                if (!rec)
+                    throw new Error(`no such job: ${jid}`);
+                this.cancelled.add(jid);
+                if (rec.state === "queued")
+                    rec.state = "cancelled";
+                // Abort the in-flight run; the runner (Orchestrator) honors the signal,
+                // cancels the harness, then settles this job as cancelled.
+                this.controllers.get(jid)?.abort();
+                this.persist();
+                return { id: jid, cancelled: true };
+            }
+            case "claudexor.shutdown":
+                setTimeout(() => void this.stop(), 10);
+                return { ok: true };
+            default:
+                throw new Error(`unknown method: ${method}`);
+        }
+    }
+    get maxConcurrent() {
+        return this.opts.maxConcurrent ?? 4;
+    }
+    /**
+     * 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.
+     */
+    persist() {
+        const path = this.opts.persistPath;
+        if (!path)
+            return;
+        try {
+            const view = [...this.records.values()].map(persistedJobRecord);
+            mkdirSync(dirname(path), { recursive: true });
+            const tmp = `${path}.tmp`;
+            writeFileSync(tmp, JSON.stringify(view, null, 2) + "\n", { mode: 0o600 });
+            chmodSync(tmp, 0o600);
+            renameSync(tmp, path);
+            chmodSync(path, 0o600);
+        }
+        catch {
+            /* best-effort; never break a run on a persistence failure */
+        }
+    }
+    /** 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. */
+    pruneHistory() {
+        const cap = this.opts.maxHistory ?? 500;
+        const terminal = [...this.records.values()].filter((r) => r.state !== "running" && r.state !== "queued" && r.state !== "blocked");
+        if (terminal.length <= cap)
+            return;
+        terminal.sort((a, b) => (a.createdAt < b.createdAt ? -1 : 1));
+        for (const r of terminal.slice(0, terminal.length - cap)) {
+            this.records.delete(r.id);
+            this.cancelled.delete(r.id);
+        }
+    }
+    /** Reload the registry on startup; a fresh process cannot resume in-memory runs. */
+    load() {
+        const path = this.opts.persistPath;
+        if (!path || !pathExists(path))
+            return;
+        const saved = readJsonSafe(path);
+        if (saved === null || !Array.isArray(saved)) {
+            // A corrupt registry must not be silently wiped: the run history includes
+            // the blocked needs-human inbox. Back the raw bytes up, start empty, and
+            // say so loudly (ThreadStore discipline).
+            this.backupCorruptRegistry(path, "registry file is not a JSON array");
+            return;
+        }
+        let dropped = 0;
+        for (const raw of saved) {
+            const rec = salvageJobRecord(raw);
+            if (!rec) {
+                dropped += 1;
+                continue;
+            }
+            // A fresh process cannot resume an in-memory RUN, so a `running` job becomes
+            // interrupted (honest). `blocked` is a TERMINAL outcome (NEEDS_HUMAN / web
+            // policy) the review queue must keep across restarts.
+            if (rec.state === "running") {
+                rec.state = "interrupted";
+                // Stamp the orphaned event log with a TERMINAL event: the
+                // canonical events.jsonl must agree with jobs.json, or SSE tailers and
+                // `follow` wait forever on a log that will never terminate.
+                if (rec.runDir && rec.runId) {
+                    try {
+                        appendRunEvent(join(rec.runDir, "events.jsonl"), rec.runId, rec.taskId ?? "", "run.failed", {
+                            status: "interrupted",
+                            error: "daemon restarted while the run was in flight",
+                        });
+                    }
+                    catch {
+                        /* best-effort: a missing/corrupt log must not block startup */
+                    }
+                }
+            }
+            this.records.set(rec.id, rec);
+            // A `queued` job never started; its params are persisted, so RE-ENQUEUE it
+            // on restart (drain() runs after start()) instead of silently dropping
+            // pending work to interrupted.
+            if (rec.state === "queued")
+                this.queue.push(rec.id);
+        }
+        if (dropped > 0) {
+            this.backupCorruptRegistry(path, `${dropped} unparseable job record(s) dropped`);
+        }
+    }
+    /** Preserve the raw bytes of a damaged registry and report the loss loudly. */
+    backupCorruptRegistry(path, reason) {
+        try {
+            copyFileSync(path, `${path}.bak`);
+            console.error(`[claudexor] jobs store: ${reason}; original backed up to ${path}.bak`);
+        }
+        catch {
+            console.error(`[claudexor] jobs store: ${reason}; backup to ${path}.bak FAILED`);
+        }
+    }
+    threadIdOf(rec) {
+        const p = rec.params;
+        return p && typeof p.threadId === "string" ? p.threadId : undefined;
+    }
+    /**
+     * Schedule queued jobs up to the concurrency limit (non-blocking).
+     *
+     * One active run per thread: a thread is a linear conversation and an in-place
+     * turn mutates the live tree, so two concurrent turns on the same thread would
+     * race the same files. We pick the first queued job whose thread is idle rather
+     * than always taking the head; thread-less jobs (CLI/MCP) keep running in
+     * parallel as before. drain() re-runs on every completion, so a thread's next
+     * turn starts as soon as its previous one settles.
+     */
+    drain() {
+        while (this.active < this.maxConcurrent && this.queue.length > 0) {
+            const busyThreads = new Set([...this.records.values()]
+                .filter((r) => r.state === "running")
+                .map((r) => this.threadIdOf(r))
+                .filter((t) => !!t));
+            let pickIdx = -1;
+            for (let i = 0; i < this.queue.length; i++) {
+                const rec = this.records.get(this.queue[i]);
+                const tid = rec ? this.threadIdOf(rec) : undefined;
+                if (!rec || !tid || !busyThreads.has(tid)) {
+                    pickIdx = i;
+                    break;
+                }
+            }
+            if (pickIdx === -1)
+                break; // every queued job waits on a busy thread
+            const id = this.queue.splice(pickIdx, 1)[0];
+            const rec = this.records.get(id);
+            if (!rec)
+                continue;
+            if (this.cancelled.has(id)) {
+                rec.state = "cancelled";
+                continue;
+            }
+            this.active += 1;
+            void this.runJob(id, rec);
+        }
+    }
+    async runJob(id, rec) {
+        const controller = new AbortController();
+        this.controllers.set(id, controller);
+        rec.state = "running";
+        rec.startedAt = nowIso();
+        this.persist();
+        try {
+            rec.result = await this.opts.runner(rec.params, {
+                signal: controller.signal,
+                onRunStart: (info) => {
+                    rec.runId = info.runId;
+                    rec.taskId = info.taskId;
+                    rec.runDir = info.runDir;
+                    // Persist the pointer immediately so a mid-run crash still reloads with
+                    // runId/runDir to locate .claudexor/runs/<runId> (the recovery path).
+                    this.persist();
+                },
+            });
+            rec.state = jobStateFromResult(rec.result, controller.signal.aborted);
+            // Only failure-shaped terminals carry an error string. no_op / ungated /
+            // review_not_run / blocked are HONEST terminals: fabricating an error here
+            // would make the control facade render a failure that never happened.
+            if (rec.state === "failed" || rec.state === "exhausted" || rec.state === "not_converged" || rec.state === "stuck_no_progress") {
+                rec.error = resultSummary(rec.result) ?? `run ended with status ${rec.state}`;
+            }
+        }
+        catch (err) {
+            rec.state = controller.signal.aborted ? "cancelled" : "failed";
+            rec.error = redactSecrets(err instanceof Error ? err.message : String(err));
+            // Preserve a typed throw's machine code (e.g. the trust gate) so
+            // consumers can key remedies on it instead of parsing the message.
+            const code = err && typeof err === "object" && "code" in err ? err.code : undefined;
+            if (typeof code === "string" && code)
+                rec.errorCode = code;
+        }
+        finally {
+            rec.finishedAt = nowIso();
+            this.controllers.delete(id);
+            this.active -= 1;
+            if (rec.runId) {
+                try {
+                    this.opts.onRunTerminal?.(rec.runId);
+                }
+                catch {
+                    /* observer failure must not corrupt terminal bookkeeping */
+                }
+            }
+            else if (rec.error) {
+                // Failure-shaped terminal with NO run ever bound: the refusal happened
+                // before the run materialized. If this job carried a pre-created thread
+                // turn, persist the reason on it (honest inline refusal, INV-093).
+                const turnId = rec.params?.turnId;
+                if (typeof turnId === "string" && turnId) {
+                    try {
+                        this.opts.onTurnEnqueueFailed?.(turnId, rec.error, rec.errorCode ?? null);
+                    }
+                    catch {
+                        /* observer failure must not corrupt terminal bookkeeping */
+                    }
+                }
+            }
+            this.pruneHistory();
+            this.persist();
+            this.drain();
+        }
+    }
+}
+function jobStateFromResult(result, aborted) {
+    if (aborted)
+        return "cancelled";
+    const status = resultStatus(result);
+    switch (status) {
+        case "success":
+            return "succeeded";
+        case "no_op":
+            return "no_op";
+        case "ungated":
+            return "ungated";
+        case "review_not_run":
+            return "review_not_run";
+        case "blocked":
+            return "blocked";
+        case "cancelled":
+            return "cancelled";
+        case "exhausted":
+            return "exhausted";
+        case "not_converged":
+            return "not_converged";
+        case "stuck_no_progress":
+            return "stuck_no_progress";
+        case "failed":
+            return "failed";
+        default:
+            // Fail loudly: a runner result without a recognizable status is NOT a
+            // success — success-by-default would mask malformed results forever.
+            return "failed";
+    }
+}
+/** Constant-time token comparison (parity with the HTTP control facade). */
+function tokenMatches(candidate, expected) {
+    const a = Buffer.from(candidate);
+    const b = Buffer.from(expected);
+    if (a.length !== b.length)
+        return false;
+    return timingSafeEqual(a, b);
+}
+/** 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. */
+export function socketAlive(socketPath) {
+    return new Promise((resolve) => {
+        const sock = connect(socketPath);
+        const done = (alive) => {
+            sock.destroy();
+            resolve(alive);
+        };
+        sock.once("connect", () => done(true));
+        sock.once("error", () => done(false));
+        setTimeout(() => done(false), 500).unref();
+    });
+}
+function resultStatus(result) {
+    if (!result || typeof result !== "object" || Array.isArray(result))
+        return null;
+    const status = result["status"];
+    return typeof status === "string" ? status : null;
+}
+function resultSummary(result) {
+    if (!result || typeof result !== "object" || Array.isArray(result))
+        return null;
+    const summary = result["summary"];
+    return typeof summary === "string" ? redactSecrets(summary) : null;
+}
+function publicJobRecord(rec) {
+    return {
+        ...rec,
+        error: rec.error ? redactSecrets(rec.error) : undefined,
+        params: redactParams(rec.params),
+    };
+}
+function persistedJobRecord(rec) {
+    return {
+        id: rec.id,
+        state: rec.state,
+        params: redactParams(rec.params),
+        error: rec.error ? redactSecrets(rec.error) : undefined,
+        errorCode: rec.errorCode,
+        createdAt: rec.createdAt,
+        runId: rec.runId,
+        taskId: rec.taskId,
+        runDir: rec.runDir,
+        startedAt: rec.startedAt,
+        finishedAt: rec.finishedAt,
+    };
+}
+function redactParams(value) {
+    if (typeof value === "string")
+        return redactSecrets(value);
+    if (Array.isArray(value))
+        return value.map(redactParams);
+    if (!value || typeof value !== "object")
+        return value;
+    const out = {};
+    for (const [key, child] of Object.entries(value)) {
+        out[key] = key === "prompt" && typeof child === "string" ? redactSecrets(child) : redactParams(child);
+    }
+    return out;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiChI,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ;IACR,SAAS;IACT,SAAS;IACT,WAAW;IACX,OAAO;IACP,SAAS;IACT,gBAAgB;IAChB,QAAQ;IACR,WAAW;IACX,aAAa;IACb,WAAW;IACX,eAAe;IACf,mBAAmB;CACX,CAAC;AAIX;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAE,UAAgC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/G,IAAI,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,cAAc,GAAG,CAAC,GAAW,EAAsB,EAAE,CACzD,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,GAAG,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC;QACb,KAAK,EAAE,GAAG,CAAC,OAAO,CAAa;QAC/B,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;QACrB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC;QAC9B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC;QACtC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC;QAC3B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC;QAChC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC;QAChC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC;QACtC,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC;KACzC,CAAC;AACJ,CAAC;AAsBD;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAUM;IATrB,MAAM,CAAU;IACP,KAAK,GAAa,EAAE,CAAC;IACrB,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IACvC,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC1D,MAAM,GAAG,CAAC,CAAC;IACF,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,QAAQ,CAAc;IAE9B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,KAAK;QACT,2EAA2E;QAC3E,qEAAqE;QACrE,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,IAAI,CAAC,UAAU,iBAAiB,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;gBAC5C,+DAA+D;gBAC/D,uEAAuE;gBACvE,sDAAsD;gBACtD,IAAI,CAAC;oBACH,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBACzC,CAAC;gBAAC,MAAM,CAAC;oBACP,uCAAuC;gBACzC,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,2EAA2E;QAC3E,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,8EAA8E;QAC9E,8EAA8E;QAC9E,2EAA2E;QAC3E,wEAAwE;QACxE,qEAAqE;QACrE,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC;gBACH,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IACpB,CAAC;IAED,qDAAqD;IACrD,eAAe;QACb,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAEO,IAAI,CAAC,IAAY,EAAE,GAAY;QACrC,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,IAAY;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,sEAAsE;YACtE,wEAAwE;YACxE,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1I,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,MAAW;QAChD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,kBAAkB;gBACrB,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;oBACtC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;oBACxB,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;oBACxB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;iBACxB,CAAC;YACJ,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,0BAA0B,CAAC,MAAM,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC;gBAC7D,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACpB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YACjC,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;gBACjD,IAAI,CAAC,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;gBACxD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YACD,KAAK,gBAAgB;gBACnB,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACzD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC/B,oEAAoE;gBACpE,gEAAgE;gBAChE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;gBACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxB,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ;oBAAE,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC;gBACpD,wEAAwE;gBACxE,2DAA2D;gBAC3D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACtC,CAAC;YACD,KAAK,oBAAoB;gBACvB,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB;gBACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACK,OAAO;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;YAC1B,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1E,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtB,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC;IAED;;+EAE2E;IACnE,YAAY;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;QACxC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAC9E,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;YAAE,OAAO;QACnC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,oFAAoF;IAC5E,IAAI;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO;QACvC,MAAM,KAAK,GAAG,YAAY,CAAU,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,0EAA0E;YAC1E,yEAAyE;YACzE,0CAA0C;YAC1C,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,mCAAmC,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,IAAI,CAAC,CAAC;gBACb,SAAS;YACX,CAAC;YACD,6EAA6E;YAC7E,2EAA2E;YAC3E,sDAAsD;YACtD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC5B,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC;gBAC1B,0DAA0D;gBAC1D,uEAAuE;gBACvE,4DAA4D;gBAC5D,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;oBAC5B,IAAI,CAAC;wBACH,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,YAAY,EAAE;4BAC1F,MAAM,EAAE,aAAa;4BACrB,KAAK,EAAE,8CAA8C;yBACtD,CAAC,CAAC;oBACL,CAAC;oBAAC,MAAM,CAAC;wBACP,+DAA+D;oBACjE,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YAC9B,2EAA2E;YAC3E,uEAAuE;YACvE,+BAA+B;YAC/B,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ;gBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,OAAO,oCAAoC,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,+EAA+E;IACvE,qBAAqB,CAAC,IAAY,EAAE,MAAc;QACxD,IAAI,CAAC;YACH,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,2BAA2B,IAAI,MAAM,CAAC,CAAC;QACxF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,eAAe,IAAI,aAAa,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,GAAc;QAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,MAAmD,CAAC;QAClE,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK;QACX,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;iBACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;iBACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;iBAC9B,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CACnC,CAAC;YACF,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;YACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnD,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1C,OAAO,GAAG,CAAC,CAAC;oBACZ,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,CAAC;gBAAE,MAAM,CAAC,0CAA0C;YACrE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,GAAc;QAC7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC;QACtB,GAAG,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE;gBAC9C,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;oBACnB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;oBACvB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;oBACzB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;oBACzB,wEAAwE;oBACxE,sEAAsE;oBACtE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,CAAC;aACF,CAAC,CAAC;YACH,GAAG,CAAC,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtE,yEAAyE;YACzE,2EAA2E;YAC3E,sEAAsE;YACtE,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW,IAAI,GAAG,CAAC,KAAK,KAAK,eAAe,IAAI,GAAG,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;gBAC9H,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,yBAAyB,GAAG,CAAC,KAAK,EAAE,CAAC;YAChF,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/D,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5E,iEAAiE;YACjE,mEAAmE;YACnE,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAE,GAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3G,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI;gBAAE,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;QAC7D,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACvC,CAAC;gBAAC,MAAM,CAAC;oBACP,4DAA4D;gBAC9D,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACrB,uEAAuE;gBACvE,wEAAwE;gBACxE,mEAAmE;gBACnE,MAAM,MAAM,GAAI,GAAG,CAAC,MAAkD,EAAE,MAAM,CAAC;gBAC/E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACzC,IAAI,CAAC;wBACH,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;oBAC5E,CAAC;oBAAC,MAAM,CAAC;wBACP,4DAA4D;oBAC9D,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAED,SAAS,kBAAkB,CAAC,MAAe,EAAE,OAAgB;IAC3D,IAAI,OAAO;QAAE,OAAO,WAAW,CAAC;IAChC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,gBAAgB;YACnB,OAAO,gBAAgB,CAAC;QAC1B,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,eAAe;YAClB,OAAO,eAAe,CAAC;QACzB,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,sEAAsE;YACtE,qEAAqE;YACrE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,SAAS,YAAY,CAAC,SAAiB,EAAE,QAAgB;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,gFAAgF;AAChF;;4EAE4E;AAC5E,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,MAAM,MAAM,GAAI,MAAkC,CAAC,QAAQ,CAAC,CAAC;IAC7D,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED,SAAS,aAAa,CAAC,MAAe;IACpC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,MAAM,OAAO,GAAI,MAAkC,CAAC,SAAS,CAAC,CAAC;IAC/D,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,GAAc;IACrC,OAAO;QACL,GAAG,GAAG;QACN,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACvD,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAc;IACxC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC;QAChC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACvD,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/threads.d.ts

@@ -0,0 +1,88 @@
+import type { Attachment, Session, Thread, ThreadTurn, WorkspaceMode } from "@claudexor/schema";
+export interface CreateThreadInput {
+    title?: string;
+    repoRoot?: string | null;
+    mode?: Thread["mode"];
+    /** in_place (default) mutates the live tree; isolated keeps a thread worktree. */
+    workspace?: WorkspaceMode;
+    authPreference?: Thread["auth_preference"];
+    primaryHarness?: string | null;
+    /** Sticky eligible harness pool for the thread (turns inherit when unset). */
+    eligibleHarnesses?: string[];
+}
+export interface CreateTurnInput {
+    kind?: ThreadTurn["kind"];
+    parentRunId?: string | null;
+    /** Set when this turn implements an approved plan from an earlier run. */
+    planRunId?: string | null;
+    /** Files/images attached to this turn, already resolved to scoped on-disk paths. */
+    attachments?: Attachment[];
+}
+export interface UpdateThreadInput {
+    title?: string;
+    state?: Thread["state"];
+    /** Switch the sticky primary harness (null => clear back to auto). */
+    primaryHarness?: string | null;
+    /** Replace the sticky eligible harness pool. */
+    eligibleHarnesses?: string[];
+}
+/**
+ * Durable thread/session registry (chat/session-first SSOT). The Thread is
+ * the Claudexor-owned conversation; Sessions are re-hostable pointers to each
+ * harness's native CLI session. Persisted as one JSON file with atomic writes
+ * (temp + rename), mirroring the daemon job registry's durability contract.
+ */
+export declare class ThreadStore {
+    private readonly path;
+    private state;
+    constructor(path: string);
+    private load;
+    private persist;
+    createThread(input: CreateThreadInput): Thread;
+    /** Rename and/or open/close (archive) a thread. */
+    updateThread(id: string, patch: UpdateThreadInput): Thread;
+    /** Persist the resolved isolated worktree path + base sha for a thread. */
+    setThreadWorktree(id: string, worktreePath: string, baseSha: string): void;
+    listThreads(): Thread[];
+    getThread(id: string): Thread | undefined;
+    turnsFor(threadId: string): ThreadTurn[];
+    getTurn(turnId: string): ThreadTurn | undefined;
+    /**
+     * Fail-loud prologue for the daemon runner: control-api validates thread/turn
+     * ids at the HTTP boundary, but a direct socket caller can pass bogus ids —
+     * a silent unbind would orphan the run from its conversation. A typed throw
+     * settles the job `failed` instead. Returns the normalized ids.
+     */
+    assertKnownIds(rawThreadId: unknown, rawTurnId: unknown): {
+        threadId?: string;
+        turnId?: string;
+    };
+    sessionsForThread(threadId: string): Session[];
+    /** Native resume map for a thread: harnessId -> native session id (live sessions only). */
+    resumeMap(threadId: string): Record<string, string>;
+    /**
+     * Create a turn BEFORE its run is enqueued (run_id is bound later via
+     * `bindTurnRun`). This is the single-writer entry point: the control API and
+     * the daemon runner both create here, so a run is recorded on its thread
+     * exactly once — there is no second "POST /runs with threadId silently skips
+     * the turn" path. `parentRunId` is captured here (head at creation time), so
+     * concurrent turns cannot both claim the same stale head.
+     */
+    createTurn(threadId: string, prompt: string, input?: CreateTurnInput): ThreadTurn;
+    /** Bind a started run to its turn and advance the thread head (runner-owned). */
+    bindTurnRun(turnId: string, runId: string): void;
+    /**
+     * Persist the reason a turn's run could NOT be enqueued/started (trust
+     * refusal, preflight validation, enqueue throw). Only meaningful for a
+     * RUNLESS turn: once a run is bound the turn's honesty lives on the run's
+     * own terminal artifacts, so a late failure report is ignored. `code` is
+     * the typed throw's machine code (e.g. trust_full_access_required) that
+     * surfaces key remedies on; `retryable=false` marks refusals with NO
+     * recorded job to replay (the enqueue itself threw) so surfaces offer
+     * "send a new message" instead of a doomed Retry.
+     */
+    setTurnEnqueueError(turnId: string, message: string, code?: string | null, retryable?: boolean): void;
+    /** Record/refresh the native CLI session a harness emitted for this thread. */
+    recordSession(threadId: string, harnessId: string, nativeSessionId: string, observedModel?: string | null): void;
+}
+//# sourceMappingURL=threads.d.ts.map

package/dist/threads.d.ts.map

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