@komaa/standin-sdk 0.1.0

package/dist/config.js

@@ -0,0 +1,86 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * Reading configuration, and failing usefully when it is wrong.
+ *
+ * Every plugin needs the same four things: a value that must be set, one that
+ * may be, a boolean, and a check that a vendor host is really that vendor's.
+ * Each one had written its own, so the error a user saw for a missing key
+ * depended on which provider they happened to pick.
+ *
+ * The host check is the one worth reading twice. Your API key travels to
+ * whatever host the configuration names, so a mistyped or injected host is not a
+ * failed call, it is credential exfiltration.
+ *
+ * Identical in shape to the Python SDK's `standin.config`.
+ */
+import { StandInError } from "./errors.js";
+/**
+ * Read a variable that must be set, or throw naming it.
+ *
+ * `purpose` completes the sentence "X is required to ...", so write it as a verb
+ * phrase: `"answer calls with ElevenLabs"`.
+ */
+export function required(name, purpose = "") {
+    const value = (process.env[name] ?? "").trim();
+    if (!value)
+        throw new StandInError(`${name} is required${purpose ? ` to ${purpose}` : ""}`);
+    return value;
+}
+/** Read a variable that may be set. Blank reads as absent. */
+export function optional(name, fallback) {
+    return (process.env[name] ?? "").trim() || fallback;
+}
+/**
+ * Read a boolean. Only `true` is true, so a typo is off rather than on.
+ *
+ * Deliberately strict. A setting that turns a guard OFF must not be turned off
+ * by `TRUE`, `1` or `yes` landing in a config file by accident.
+ */
+export function flag(name, fallback = false) {
+    const raw = (process.env[name] ?? "").trim().toLowerCase();
+    if (!raw)
+        return fallback;
+    return raw === "true";
+}
+/**
+ * Read a host and refuse one that is not the vendor's.
+ *
+ * Your API key travels to this host. A mistyped or injected value is credential
+ * exfiltration rather than a failed call, which is why this throws instead of
+ * warning.
+ */
+export function vendorHost(name, fallback, suffix) {
+    const host = (process.env[name] ?? "").trim() || fallback;
+    const bare = suffix.replace(/^\./, "");
+    if (host !== bare && !host.endsWith(suffix)) {
+        throw new StandInError(`${name} must be a ${bare} host, got ${host}`);
+    }
+    return host;
+}
+/**
+ * Read a JSON object of strings, or throw saying it must be one.
+ *
+ * Used for header maps, which carry YOUR credentials to somebody else's
+ * endpoint, so the value is never logged on the failure path.
+ */
+export function jsonObject(name) {
+    const raw = (process.env[name] ?? "").trim();
+    if (!raw)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new StandInError(`${name} must be a JSON object`);
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new StandInError(`${name} must be a JSON object`);
+    }
+    return Object.fromEntries(Object.entries(parsed).map(([k, v]) => [
+        k,
+        String(v),
+    ]));
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,+BAA+B;AAE/B;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAO,GAAG,EAAE;IACjD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,KAAK;QACR,MAAM,IAAI,YAAY,CACpB,GAAG,IAAI,eAAe,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACxD,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAiB;IACtD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,QAAQ,GAAG,KAAK;IACjD,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,OAAO,GAAG,KAAK,MAAM,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,QAAgB,EAChB,MAAc;IAEd,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,YAAY,CAAC,GAAG,IAAI,cAAc,IAAI,cAAc,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CAAC,GAAG,IAAI,wBAAwB,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,YAAY,CAAC,GAAG,IAAI,wBAAwB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAChE,CAAC;QACD,MAAM,CAAC,CAAC,CAAC;KACV,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/consult.d.ts

@@ -0,0 +1,147 @@
+import type { ToolSpec } from "./callTools.js";
+/**
+ * How long a caller will wait on the line before "let me check" stops sounding
+ * like thinking and starts sounding like a dropped call.
+ */
+export declare const DEFAULT_CONSULT_TIMEOUT_MS = 45000;
+/** A background task gets far longer, because nobody is listening to it. */
+export declare const DEFAULT_TASK_TIMEOUT_MS = 300000;
+/**
+ * Promises go stale. Delivering a two-hour-old answer to a question somebody has
+ * long since answered themselves is worse than delivering nothing.
+ */
+export declare const DEFAULT_TASK_TTL_MS: number;
+/**
+ * How many interrupted tasks one startup will take on. A restart storm must not
+ * fan out every promise the fleet ever made at once. What is left stays queued.
+ */
+export declare const DEFAULT_RESUME_LIMIT = 5;
+/** What a consultation is: a question in, an answer out. */
+export type Asker = (query: string) => string | Promise<string>;
+/**
+ * Called to build an asker, on first use and again after a timeout. It is a
+ * factory rather than a value because a timed-out consultation cannot be
+ * stopped: it runs on, and whatever state it holds is no longer yours.
+ */
+export type AskerFactory = () => Asker;
+/** Deliver a finished task's result. Returns whether it actually went out. */
+export type Deliverer = (threadId: string, text: string) => Promise<boolean>;
+export declare const CONSULT_TOOL: ToolSpec;
+export declare const BACKGROUND_TASK_TOOL: ToolSpec;
+/**
+ * One slow agent, reachable from a live call without breaking it.
+ *
+ * Built once per call and asked whenever the fast model delegates:
+ *
+ * ```ts
+ * const consultant = new Consultant(() => myAgent.run);
+ * const answer = await consultant.ask("what did we bill Contoso last quarter?");
+ * ```
+ *
+ * Everything here exists because a caller is listening while it runs.
+ *
+ * **One at a time, and the second asker is told so.** A model that can delegate
+ * can delegate twice before the first answer lands. Queueing the second behind
+ * the first means it waits out both timeouts and answers far too late, so it is
+ * refused immediately with something the model can say out loud.
+ *
+ * **A timeout is admitted, not papered over.** The work cannot be cancelled: a
+ * promise runs to its end whatever this returns. So the answer says it stopped
+ * rather than promising a follow-up nothing will send. Pass
+ * `backgroundAvailable` when you have registered {@link BACKGROUND_TASK_TOOL}
+ * and the answer will point the caller at it.
+ *
+ * Your asker must not block. Node has one thread, and a synchronous agent holds
+ * it for its whole duration, stopping the call's audio along with everything
+ * else. Do the work in a promise, a worker, or another process.
+ */
+export declare class Consultant {
+    #private;
+    constructor(build: AskerFactory, timeoutMs?: number, backgroundAvailable?: boolean);
+    /** Whether a consultation is running right now. */
+    get busy(): boolean;
+    /**
+     * Put a question to the slow agent and return what to say.
+     *
+     * Never throws, and always returns something speakable. A tool result goes
+     * straight back to a model that will read it out, so an exception here is an
+     * agent that goes quiet mid-sentence.
+     */
+    ask(query: string, timeoutMs?: number): Promise<string>;
+}
+/** One promise, as it sits on disk. */
+export interface BackgroundTask {
+    readonly taskId: string;
+    readonly query: string;
+    /** Where the result goes. A task with nowhere to deliver cannot be kept. */
+    readonly threadId: string;
+    readonly sessionKey?: string;
+    readonly createdMs?: number;
+    /**
+     * Set only on a claimed task, so {@link BackgroundTasks.finish} can put it
+     * back if the delivery fails.
+     */
+    readonly claimPath?: string;
+}
+/** Options for {@link BackgroundTasks}. */
+export interface BackgroundTasksOptions {
+    directory?: string;
+    ttlMs?: number;
+    resumeLimit?: number;
+}
+/**
+ * Promised work that survives the process that promised it.
+ *
+ * "I will send you the result" is a promise made on a call that is about to end.
+ * Held in memory it lasts until the next deploy, and then it is gone with
+ * nothing said to the person waiting. Held here it is a small file, written
+ * BEFORE the work starts and removed only once the result has actually been
+ * delivered.
+ *
+ * The two-phase claim is what makes a restart safe. A task waiting to run is a
+ * `.json`; a task being run is a `.claimed`. A process that dies mid-run leaves
+ * a claim behind, and the next startup takes it back once it is old enough to be
+ * certain nobody is still working on it. A delivery that fails puts the task
+ * back rather than dropping it.
+ */
+export declare class BackgroundTasks {
+    #private;
+    constructor(options?: BackgroundTasksOptions);
+    /**
+     * Write the promise down, before starting the work.
+     *
+     * Returns undefined when it could not be written, which is a task that runs
+     * but will not survive a restart. That is worth knowing about and worth
+     * continuing with: a non-durable answer still beats no answer.
+     */
+    remember(query: string, threadId: string, sessionKey?: string): BackgroundTask | undefined;
+    /**
+     * Mark a task as being worked on, so a crash mid-run is recoverable.
+     *
+     * Without this, a process that dies halfway leaves a task that looks
+     * untouched, and the next startup runs it again while the delivery from the
+     * first run may still be in flight.
+     */
+    begin(task: BackgroundTask | undefined): void;
+    /** The result was delivered. Retire the record, in either phase. */
+    done(task: BackgroundTask | undefined): void;
+    /**
+     * Take the tasks a previous process left behind.
+     *
+     * Claiming is a rename, so two workers starting together cannot take the same
+     * task. Everything beyond the resume limit is LEFT WHERE IT IS for the next
+     * cycle rather than discarded: a busy restart must not become a quiet way of
+     * losing promises.
+     */
+    claimPending(): BackgroundTask[];
+    /** Retire a claimed task, or put it back so the next cycle retries it. */
+    finish(task: BackgroundTask, delivered: boolean): void;
+    /**
+     * Re-run what a previous process left unfinished. Returns how many landed.
+     *
+     * Call it once at startup. Sequential on purpose: a restart storm must not fan
+     * out one agent per interrupted task across the whole fleet.
+     */
+    resume(build: AskerFactory, deliver: Deliverer, timeoutMs?: number): Promise<number>;
+}
+//# sourceMappingURL=consult.d.ts.map

package/dist/consult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consult.d.ts","sourceRoot":"","sources":["../src/consult.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAqB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAKtC,4DAA4D;AAC5D,MAAM,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC;AAEvC,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7E,eAAO,MAAM,YAAY,EAAE,QAa1B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,QAalC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,UAAU;;gBAQnB,KAAK,EAAE,YAAY,EACnB,SAAS,GAAE,MAAmC,EAC9C,mBAAmB,UAAQ;IAU7B,mDAAmD;IACnD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA8C9D;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;;gBAKd,OAAO,GAAE,sBAA2B;IAUhD;;;;;;OAMG;IACH,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAK,GACd,cAAc,GAAG,SAAS;IA8B7B;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAY7C,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAW5C;;;;;;;OAOG;IACH,YAAY,IAAI,cAAc,EAAE;IAkDhC,0EAA0E;IAC1E,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAgBtD;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,SAAS,EAClB,SAAS,GAAE,MAAgC,GAC1C,OAAO,CAAC,MAAM,CAAC;CA+CnB"}

package/dist/consult.js

@@ -0,0 +1,388 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * The slow half of a two-speed agent.
+ *
+ * A voice model has to answer in under a second or the call sounds broken. Real
+ * work does not fit in a second. Looking something up, reading a file, driving a
+ * browser, running a tool: those take ten seconds, or five minutes, and a caller
+ * listening to silence has no way to tell the difference between thinking and
+ * crashed.
+ *
+ * So an agent that does real work is two agents. The fast one talks. The slow
+ * one works. This module is the seam between them, and it is in the core because
+ * the seam is the same whichever provider is doing the talking and whichever
+ * agent framework is doing the working.
+ *
+ * Two paths, and the difference between them is a promise:
+ *
+ * {@link Consultant} is "hold on, let me check". Time-boxed, answered in the
+ * same breath. The caller waits, so the box has to be small.
+ *
+ * {@link BackgroundTasks} is "I'll send you the result". The caller hangs up.
+ * That promise outlives the call, and therefore has to outlive the process: a
+ * restart between making it and keeping it is ordinary, and an in-memory task
+ * list breaks the promise silently. Every task is on disk before the work
+ * starts.
+ *
+ * Neither knows what your agent is. You supply a function; what it does inside
+ * is yours.
+ *
+ * Identical in shape to the Python SDK's `standin.consult`.
+ */
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { nowMs } from "./hmac.js";
+import { logger } from "./log.js";
+import { stateDir } from "./outbound.js";
+/**
+ * How long a caller will wait on the line before "let me check" stops sounding
+ * like thinking and starts sounding like a dropped call.
+ */
+export const DEFAULT_CONSULT_TIMEOUT_MS = 45_000;
+/** A background task gets far longer, because nobody is listening to it. */
+export const DEFAULT_TASK_TIMEOUT_MS = 300_000;
+/**
+ * Promises go stale. Delivering a two-hour-old answer to a question somebody has
+ * long since answered themselves is worse than delivering nothing.
+ */
+export const DEFAULT_TASK_TTL_MS = 2 * 60 * 60 * 1000;
+/**
+ * How many interrupted tasks one startup will take on. A restart storm must not
+ * fan out every promise the fleet ever made at once. What is left stays queued.
+ */
+export const DEFAULT_RESUME_LIMIT = 5;
+/** A claim older than this belonged to a process that died holding it. */
+const STALE_CLAIM_MS = 600_000;
+export const CONSULT_TOOL = {
+    name: "consult",
+    description: "Hand a question or a task to your fuller agent, which can look things up, read " +
+        "files, browse, and run tools. Use it for anything beyond conversation. The caller " +
+        "waits on the line, so use it only when the answer will come back quickly.",
+    parameters: {
+        query: {
+            type: "string",
+            description: "What to look into or do, phrased as a task.",
+        },
+    },
+    required: ["query"],
+};
+export const BACKGROUND_TASK_TOOL = {
+    name: "background_task",
+    description: "Start a long job and have the result sent to the caller in chat when it is done. " +
+        "Use this instead of consult when the work will not finish while the caller waits. " +
+        "Tell the caller you are on it; the result is delivered afterwards.",
+    parameters: {
+        query: {
+            type: "string",
+            description: "The task to run in the background.",
+        },
+    },
+    required: ["query"],
+};
+/**
+ * One slow agent, reachable from a live call without breaking it.
+ *
+ * Built once per call and asked whenever the fast model delegates:
+ *
+ * ```ts
+ * const consultant = new Consultant(() => myAgent.run);
+ * const answer = await consultant.ask("what did we bill Contoso last quarter?");
+ * ```
+ *
+ * Everything here exists because a caller is listening while it runs.
+ *
+ * **One at a time, and the second asker is told so.** A model that can delegate
+ * can delegate twice before the first answer lands. Queueing the second behind
+ * the first means it waits out both timeouts and answers far too late, so it is
+ * refused immediately with something the model can say out loud.
+ *
+ * **A timeout is admitted, not papered over.** The work cannot be cancelled: a
+ * promise runs to its end whatever this returns. So the answer says it stopped
+ * rather than promising a follow-up nothing will send. Pass
+ * `backgroundAvailable` when you have registered {@link BACKGROUND_TASK_TOOL}
+ * and the answer will point the caller at it.
+ *
+ * Your asker must not block. Node has one thread, and a synchronous agent holds
+ * it for its whole duration, stopping the call's audio along with everything
+ * else. Do the work in a promise, a worker, or another process.
+ */
+export class Consultant {
+    #build;
+    #timeoutMs;
+    #backgroundAvailable;
+    #asker;
+    #busy = false;
+    constructor(build, timeoutMs = DEFAULT_CONSULT_TIMEOUT_MS, backgroundAvailable = false) {
+        this.#build = build;
+        this.#timeoutMs = timeoutMs;
+        // What the caller is told on a timeout depends on whether there is anywhere
+        // to hand the work off to. Pointing at a background task this agent cannot
+        // start is a promise nothing keeps, so it is opt in.
+        this.#backgroundAvailable = backgroundAvailable;
+    }
+    /** Whether a consultation is running right now. */
+    get busy() {
+        return this.#busy;
+    }
+    /**
+     * Put a question to the slow agent and return what to say.
+     *
+     * Never throws, and always returns something speakable. A tool result goes
+     * straight back to a model that will read it out, so an exception here is an
+     * agent that goes quiet mid-sentence.
+     */
+    async ask(query, timeoutMs) {
+        const question = (query ?? "").trim();
+        if (question === "")
+            return "I did not catch what you wanted me to look into.";
+        if (this.#busy)
+            return "I am still finishing the last one. Give me a moment and ask again.";
+        this.#busy = true;
+        let timer;
+        try {
+            const timedOut = Symbol("timed out");
+            const deadline = new Promise((resolve) => {
+                timer = setTimeout(() => resolve(timedOut), timeoutMs ?? this.#timeoutMs);
+                timer.unref?.();
+            });
+            const answer = await Promise.race([this.#run(question), deadline]);
+            if (answer === timedOut) {
+                // The work is still running and cannot be stopped, so the asker is
+                // dropped: the next consultation builds a fresh one rather than sharing
+                // state with something nobody is waiting for any more.
+                this.#asker = undefined;
+                logger.warn("standin: a consultation ran past its time and was abandoned");
+                return this.#backgroundAvailable
+                    ? "Sorry, that took too long and I had to stop. Ask me to work on it in the " +
+                        "background and I will send you the result when it is done."
+                    : "Sorry, that took too long and I had to stop. Ask me again and I will narrow it down.";
+            }
+            return answer.trim() || "I did not find anything to report.";
+        }
+        catch (err) {
+            logger.warn(`standin: a consultation failed: ${String(err)}`);
+            return "Sorry, I ran into a problem working on that.";
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            this.#busy = false;
+        }
+    }
+    async #run(question) {
+        if (this.#asker === undefined)
+            this.#asker = this.#build();
+        return String(await this.#asker(question));
+    }
+}
+/**
+ * Promised work that survives the process that promised it.
+ *
+ * "I will send you the result" is a promise made on a call that is about to end.
+ * Held in memory it lasts until the next deploy, and then it is gone with
+ * nothing said to the person waiting. Held here it is a small file, written
+ * BEFORE the work starts and removed only once the result has actually been
+ * delivered.
+ *
+ * The two-phase claim is what makes a restart safe. A task waiting to run is a
+ * `.json`; a task being run is a `.claimed`. A process that dies mid-run leaves
+ * a claim behind, and the next startup takes it back once it is old enough to be
+ * certain nobody is still working on it. A delivery that fails puts the task
+ * back rather than dropping it.
+ */
+export class BackgroundTasks {
+    #dir;
+    #ttlMs;
+    #resumeLimit;
+    constructor(options = {}) {
+        this.#dir = options.directory ?? join(stateDir(), "tasks");
+        mkdirSync(this.#dir, { recursive: true, mode: 0o700 });
+        this.#ttlMs = options.ttlMs ?? DEFAULT_TASK_TTL_MS;
+        this.#resumeLimit = Math.max(1, options.resumeLimit ?? DEFAULT_RESUME_LIMIT);
+    }
+    /**
+     * Write the promise down, before starting the work.
+     *
+     * Returns undefined when it could not be written, which is a task that runs
+     * but will not survive a restart. That is worth knowing about and worth
+     * continuing with: a non-durable answer still beats no answer.
+     */
+    remember(query, threadId, sessionKey = "") {
+        const task = {
+            taskId: randomUUID().replace(/-/g, ""),
+            query,
+            threadId,
+            sessionKey,
+            createdMs: nowMs(),
+        };
+        const target = join(this.#dir, `${task.taskId}.json`);
+        const temp = `${target}.${randomUUID()}.tmp`;
+        try {
+            writeFileSync(temp, JSON.stringify(task), {
+                encoding: "utf8",
+                mode: 0o600,
+            });
+            renameSync(temp, target);
+        }
+        catch (err) {
+            logger.warn(`standin: a background task could not be made durable: ${String(err)}`);
+            try {
+                rmSync(temp, { force: true });
+            }
+            catch {
+                // Nothing left to clean up.
+            }
+            return undefined;
+        }
+        return task;
+    }
+    /**
+     * Mark a task as being worked on, so a crash mid-run is recoverable.
+     *
+     * Without this, a process that dies halfway leaves a task that looks
+     * untouched, and the next startup runs it again while the delivery from the
+     * first run may still be in flight.
+     */
+    begin(task) {
+        if (task === undefined || !task.taskId)
+            return;
+        try {
+            renameSync(join(this.#dir, `${task.taskId}.json`), join(this.#dir, `${task.taskId}.claimed`));
+        }
+        catch {
+            // Already claimed, already gone, or never durable.
+        }
+    }
+    /** The result was delivered. Retire the record, in either phase. */
+    done(task) {
+        if (task === undefined || !task.taskId)
+            return;
+        for (const suffix of [".json", ".claimed"]) {
+            try {
+                rmSync(join(this.#dir, `${task.taskId}${suffix}`), { force: true });
+            }
+            catch {
+                // Nothing to retire.
+            }
+        }
+    }
+    /**
+     * Take the tasks a previous process left behind.
+     *
+     * Claiming is a rename, so two workers starting together cannot take the same
+     * task. Everything beyond the resume limit is LEFT WHERE IT IS for the next
+     * cycle rather than discarded: a busy restart must not become a quiet way of
+     * losing promises.
+     */
+    claimPending() {
+        this.#recoverOrphans();
+        const claimed = [];
+        for (const name of readdirSync(this.#dir).sort()) {
+            if (!name.endsWith(".json"))
+                continue;
+            if (claimed.length >= this.#resumeLimit) {
+                logger.info("standin: resume limit reached; the remaining background tasks stay queued");
+                break;
+            }
+            const path = join(this.#dir, name);
+            let record;
+            try {
+                record = JSON.parse(readFileSync(path, "utf8"));
+            }
+            catch {
+                // Unreadable is unrecoverable, and leaving it means reading it again on
+                // every startup for ever.
+                rmSync(path, { force: true });
+                continue;
+            }
+            const ageMs = nowMs() - (record.createdMs ?? 0);
+            if (record.createdMs !== undefined && ageMs > this.#ttlMs) {
+                logger.info(`standin: dropping a background task promised ${Math.round(ageMs / 60_000)} minutes ago`);
+                rmSync(path, { force: true });
+                continue;
+            }
+            if (!record.threadId) {
+                logger.info("standin: dropping a background task with nowhere to deliver");
+                rmSync(path, { force: true });
+                continue;
+            }
+            const claim = path.replace(/\.json$/, ".claimed");
+            try {
+                renameSync(path, claim);
+            }
+            catch {
+                continue; // somebody else took it first
+            }
+            claimed.push({ ...record, claimPath: claim });
+        }
+        return claimed;
+    }
+    /** Retire a claimed task, or put it back so the next cycle retries it. */
+    finish(task, delivered) {
+        if (!task.claimPath)
+            return;
+        try {
+            if (delivered) {
+                rmSync(task.claimPath, { force: true });
+            }
+            else if (existsSync(task.claimPath)) {
+                renameSync(task.claimPath, task.claimPath.replace(/\.claimed$/, ".json"));
+            }
+        }
+        catch {
+            // The next cycle's orphan recovery is the backstop.
+        }
+    }
+    /**
+     * Re-run what a previous process left unfinished. Returns how many landed.
+     *
+     * Call it once at startup. Sequential on purpose: a restart storm must not fan
+     * out one agent per interrupted task across the whole fleet.
+     */
+    async resume(build, deliver, timeoutMs = DEFAULT_TASK_TIMEOUT_MS) {
+        let delivered = 0;
+        for (const task of this.claimPending()) {
+            logger.info("standin: finishing a background task left by a restart");
+            const answer = await new Consultant(build, timeoutMs).ask(task.query, timeoutMs);
+            let sent = false;
+            try {
+                sent = await deliver(task.threadId, answer);
+            }
+            catch (err) {
+                logger.warn(`standin: delivering a resumed background task failed: ${String(err)}`);
+            }
+            this.finish(task, sent);
+            if (sent)
+                delivered += 1;
+            else
+                logger.warn("standin: a resumed background task is kept for the next try");
+        }
+        return delivered;
+    }
+    /**
+     * Put back claims whose owner died.
+     *
+     * Judged by the claim's own age. A claim younger than the window may still
+     * have somebody working on it, and taking it would deliver the same answer
+     * twice.
+     */
+    #recoverOrphans() {
+        const cutoff = Date.now() - STALE_CLAIM_MS;
+        for (const name of readdirSync(this.#dir)) {
+            if (!name.endsWith(".claimed"))
+                continue;
+            const path = join(this.#dir, name);
+            try {
+                if (statSync(path).mtimeMs < cutoff) {
+                    renameSync(path, path.replace(/\.claimed$/, ".json"));
+                }
+            }
+            catch {
+                // Gone, or taken by somebody else between the read and the rename.
+            }
+        }
+    }
+}
+//# sourceMappingURL=consult.js.map

package/dist/consult.js.map

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