@sema-agent/server 1.185.0

package/dist/plugins/worktree-isolation.js

@@ -0,0 +1,55 @@
+import path from "node:path";
+import { addWorktree, pruneWorktrees, } from "@sema-agent/core";
+function norm(p) {
+    const r = path.resolve(p);
+    return r.length > 1 && r.endsWith(path.sep) ? r.slice(0, -1) : r;
+}
+function isWithin(root, child) {
+    const r = norm(root);
+    const c = norm(child);
+    if (c === r)
+        return true;
+    const rel = path.relative(r, c);
+    return rel.length > 0 && !rel.startsWith("..") && !path.isAbsolute(rel);
+}
+export function withWorktreeIsolation(baseFactory, opts) {
+    const repoRoot = norm(opts.repoRoot);
+    const allowedRoots = (opts.allowedRoots?.length ? opts.allowedRoots : [repoRoot]).map(norm);
+    if (!allowedRoots.some((root) => isWithin(root, repoRoot))) {
+        throw new Error(`withWorktreeIsolation: repoRoot ${repoRoot} is not within any allowedRoots [${allowedRoots.join(", ")}] — refusing to git-worktree an untrusted path`);
+    }
+    let gitLock = Promise.resolve();
+    const serialize = (fn) => {
+        const run = gitLock.then(fn, fn);
+        gitLock = run.then(() => undefined, () => undefined);
+        return run;
+    };
+    return async (ctx) => {
+        if (ctx.isolation !== "worktree") {
+            return baseFactory(ctx);
+        }
+        const { env, worktreeDir } = await serialize(() => addWorktree(opts.baseEnvForGit, {
+            repoRoot,
+            sessionId: ctx.sessionId,
+            rootEnvAt: opts.rootEnvAt,
+            ...(opts.commit ? { commit: opts.commit } : {}),
+        }));
+        opts.logger?.info?.("worktree_isolation_minted", {
+            sessionId: ctx.sessionId,
+            ...(ctx.taskId ? { taskId: ctx.taskId } : {}),
+            worktreeDir,
+        });
+        const coreDestroy = env.destroy.bind(env);
+        env.destroy = () => serialize(() => coreDestroy());
+        return env;
+    };
+}
+export async function reapOrphanWorktrees(baseEnvForGit, repoRoot, logger) {
+    try {
+        await pruneWorktrees(baseEnvForGit, norm(repoRoot));
+    }
+    catch (e) {
+        logger?.warn?.("worktree_prune_failed", { repoRoot: norm(repoRoot), error: e instanceof Error ? e.message : String(e) });
+    }
+}
+//# sourceMappingURL=worktree-isolation.js.map

package/dist/plugins/worktree-isolation.js.map

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

package/dist/plugins/write-behind-counter.d.ts

@@ -0,0 +1,43 @@
+import type { Pool } from "mysql2/promise";
+export interface CounterTable {
+    table: string;
+    keyCol: string;
+    valCol: string;
+}
+export interface CounterDegradeInfo {
+    table: string;
+    kind: "flush" | "refresh" | "stalled";
+    streak: number;
+    prevStreak: number;
+    error?: string;
+}
+export type CounterDegradeHook = (info: CounterDegradeInfo) => void;
+export declare const DEFAULT_COUNTER_QUERY_TIMEOUT_MS = 30000;
+export declare class WriteBehindCounter {
+    private readonly pool;
+    private readonly t;
+    private readonly windowMs;
+    private readonly now;
+    private readonly onDegraded?;
+    private readonly queryTimeoutMs;
+    private pendingDelta;
+    private fleetTotal;
+    private timer?;
+    private flushing;
+    private flushStartedAt;
+    private failStreak;
+    constructor(pool: Pool, t: CounterTable, windowMs: number, now?: () => number, onDegraded?: CounterDegradeHook | undefined, queryTimeoutMs?: number);
+    private bump;
+    bucket(): number;
+    private rk;
+    used(key: string): number;
+    addLocal(key: string, n: number): void;
+    retryAfterSec(): number;
+    flush(): Promise<void>;
+    private flushOnce;
+    refresh(): Promise<void>;
+    reap(): Promise<number>;
+    startRefresh(intervalMs?: number): this;
+    stop(): void;
+}
+//# sourceMappingURL=write-behind-counter.d.ts.map

package/dist/plugins/write-behind-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-behind-counter.d.ts","sourceRoot":"","sources":["../../src/plugins/write-behind-counter.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,IAAI,EAAkC,MAAM,gBAAgB,CAAC;AAI3E,MAAM,WAAW,YAAY;IAE3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAQpE,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD,qBAAa,kBAAkB;IAU3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAI5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAjBjC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO,CAAC,UAAU,CAAsD;gBAGrD,IAAI,EAAE,IAAI,EACV,CAAC,EAAE,YAAY,EACf,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,MAAyB,EACpC,UAAU,CAAC,EAAE,kBAAkB,YAAA,EAI/B,cAAc,GAAE,MAAyC;IAK5E,OAAO,CAAC,IAAI;IAaZ,MAAM,IAAI,MAAM;IAGhB,OAAO,CAAC,EAAE;IAKV,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMtC,aAAa,IAAI,MAAM;IAOjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAoBd,SAAS;IA0CjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAY7B,YAAY,CAAC,UAAU,SAAQ,GAAG,IAAI;IAKtC,IAAI,IAAI,IAAI;CAIb"}

package/dist/plugins/write-behind-counter.js

@@ -0,0 +1,144 @@
+const SEP = "\u0000";
+export const DEFAULT_COUNTER_QUERY_TIMEOUT_MS = 30_000;
+export class WriteBehindCounter {
+    pool;
+    t;
+    windowMs;
+    now;
+    onDegraded;
+    queryTimeoutMs;
+    pendingDelta = new Map();
+    fleetTotal = new Map();
+    timer;
+    flushing = false;
+    flushStartedAt = 0;
+    failStreak = new Map();
+    constructor(pool, t, windowMs, now = () => Date.now(), onDegraded, queryTimeoutMs = DEFAULT_COUNTER_QUERY_TIMEOUT_MS) {
+        this.pool = pool;
+        this.t = t;
+        this.windowMs = windowMs;
+        this.now = now;
+        this.onDegraded = onDegraded;
+        this.queryTimeoutMs = queryTimeoutMs;
+    }
+    bump(kind, failed, error) {
+        if (!this.onDegraded)
+            return;
+        const prev = this.failStreak.get(kind) ?? 0;
+        if (!failed && prev === 0)
+            return;
+        const next = failed ? prev + 1 : 0;
+        this.failStreak.set(kind, next);
+        try {
+            this.onDegraded({ table: this.t.table, kind, streak: next, prevStreak: prev, ...(failed && error !== undefined ? { error: error instanceof Error ? error.message : String(error) } : {}) });
+        }
+        catch {
+        }
+    }
+    bucket() {
+        return Math.floor(this.now() / this.windowMs);
+    }
+    rk(key) {
+        return `${key}${SEP}${this.bucket()}`;
+    }
+    used(key) {
+        const rk = this.rk(key);
+        return (this.fleetTotal.get(rk) ?? 0) + (this.pendingDelta.get(rk) ?? 0);
+    }
+    addLocal(key, n) {
+        if (n <= 0)
+            return;
+        const rk = this.rk(key);
+        this.pendingDelta.set(rk, (this.pendingDelta.get(rk) ?? 0) + n);
+    }
+    retryAfterSec() {
+        return Math.ceil(((this.bucket() + 1) * this.windowMs - this.now()) / 1000);
+    }
+    async flush() {
+        if (this.flushing) {
+            if (this.now() - this.flushStartedAt > 60_000)
+                this.bump("stalled", true, "flush round stalled >60s (hung query?)");
+            return;
+        }
+        this.flushing = true;
+        this.flushStartedAt = this.now();
+        try {
+            await this.flushOnce();
+        }
+        finally {
+            this.flushing = false;
+            this.bump("stalled", false);
+        }
+    }
+    async flushOnce() {
+        const { table, keyCol, valCol } = this.t;
+        let attempted = false;
+        let failure;
+        let hadFailure = false;
+        for (const [rk, delta] of [...this.pendingDelta]) {
+            if (delta <= 0)
+                continue;
+            const sep = rk.lastIndexOf(SEP);
+            const key = rk.slice(0, sep);
+            const windowBucket = Number(rk.slice(sep + 1));
+            attempted = true;
+            try {
+                await this.pool.query({
+                    sql: `INSERT INTO ${table} (${keyCol}, window_bucket, ${valCol}, updated_at) VALUES (?,?,?,?) ` +
+                        `ON DUPLICATE KEY UPDATE ${valCol} = ${valCol} + VALUES(${valCol}), updated_at = VALUES(updated_at)`,
+                    timeout: this.queryTimeoutMs,
+                }, [key, windowBucket, delta, new Date()]);
+                const remaining = (this.pendingDelta.get(rk) ?? 0) - delta;
+                if (remaining > 0)
+                    this.pendingDelta.set(rk, remaining);
+                else
+                    this.pendingDelta.delete(rk);
+            }
+            catch (err) {
+                hadFailure = true;
+                failure = err;
+            }
+        }
+        if (attempted)
+            this.bump("flush", hadFailure, failure);
+        await this.refresh();
+        await this.reap();
+    }
+    async refresh() {
+        const { table, keyCol, valCol } = this.t;
+        const b = this.bucket();
+        try {
+            const [rows] = await this.pool.query({ sql: `SELECT ${keyCol}, ${valCol} FROM ${table} WHERE window_bucket = ?`, timeout: this.queryTimeoutMs }, [b]);
+            const next = new Map();
+            for (const r of rows) {
+                const row = r;
+                next.set(`${String(row[keyCol])}${SEP}${b}`, Number(row[valCol]));
+            }
+            this.fleetTotal = next;
+            this.bump("refresh", false);
+        }
+        catch (err) {
+            this.bump("refresh", true, err);
+        }
+    }
+    async reap() {
+        try {
+            const [res] = await this.pool.query({ sql: `DELETE FROM ${this.t.table} WHERE window_bucket < ?`, timeout: this.queryTimeoutMs }, [this.bucket()]);
+            return res.affectedRows;
+        }
+        catch {
+            return 0;
+        }
+    }
+    startRefresh(intervalMs = 5_000) {
+        this.timer ??= setInterval(() => void this.flush(), intervalMs);
+        this.timer.unref?.();
+        return this;
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+    }
+}
+//# sourceMappingURL=write-behind-counter.js.map

package/dist/plugins/write-behind-counter.js.map

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

package/dist/project-memory.d.ts

@@ -0,0 +1,14 @@
+interface ProjectMemoryCtx {
+    cwd: string;
+    handsEnabled: boolean;
+    isSubagent: boolean;
+    agentName?: string;
+}
+export declare function makeLoadProjectMemory(opts: {
+    logger?: {
+        debug?: (msg: string, data: Record<string, unknown>) => void;
+    };
+    maxBytes?: number;
+}): (ctx: ProjectMemoryCtx) => Promise<string | null>;
+export {};
+//# sourceMappingURL=project-memory.d.ts.map

package/dist/project-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory.d.ts","sourceRoot":"","sources":["../src/project-memory.ts"],"names":[],"mappings":"AAoBA,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;KAAE,CAAC;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CpD"}

package/dist/project-memory.js

@@ -0,0 +1,96 @@
+import { promises as fs, constants as fsConstants } from "node:fs";
+import { execFile } from "node:child_process";
+import { resolve, isAbsolute, join } from "node:path";
+import { scrubSecretEnv } from "@sema-agent/core";
+import { redactSecrets } from "./trace/redact.js";
+function capUtf8(s, maxBytes) {
+    const buf = Buffer.from(s, "utf8");
+    if (buf.length <= maxBytes)
+        return s;
+    let end = maxBytes;
+    while (end > 0 && (buf[end] & 0xc0) === 0x80)
+        end -= 1;
+    return buf.subarray(0, end).toString("utf8");
+}
+async function readCapped(root, rel, maxBytes, truncatedFlag = { v: false }) {
+    const target = join(root, rel);
+    let fh;
+    try {
+        const lst = await fs.lstat(target);
+        if (lst.isSymbolicLink())
+            return null;
+        if (lst.size > maxBytes)
+            truncatedFlag.v = true;
+        fh = await fs.open(target, fsConstants.O_RDONLY | (fsConstants.O_NOFOLLOW ?? 0));
+        const buf = Buffer.allocUnsafe(maxBytes);
+        const { bytesRead } = await fh.read(buf, 0, maxBytes, 0);
+        return capUtf8(buf.subarray(0, bytesRead).toString("utf8"), maxBytes);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        await fh?.close();
+    }
+}
+function git(root, args, maxBytes) {
+    const safeArgs = ["-c", "core.fsmonitor=false", "-c", "core.hooksPath=/dev/null", ...args];
+    return new Promise((res) => {
+        execFile("git", safeArgs, { cwd: root, timeout: 5000, maxBuffer: maxBytes, env: { ...scrubSecretEnv(process.env), GIT_CONFIG_GLOBAL: "/dev/null", GIT_CONFIG_SYSTEM: "/dev/null" } }, (err, stdout, stderr) => {
+            if (!err)
+                return res({ out: stdout.trim() });
+            const e = err;
+            const fail = e.killed ? "timeout" : e.code === "ENOENT" ? "git-missing" : /not a git repository/i.test(String(stderr)) ? "non-repo" : /maxBuffer/i.test(String(e.message)) ? "maxbuffer" : "error";
+            res({ out: "", fail });
+        });
+    });
+}
+export function makeLoadProjectMemory(opts) {
+    const totalCap = opts.maxBytes ?? 32 * 1024;
+    const claudeCap = 24 * 1024;
+    const subagentClaudeCap = 4 * 1024;
+    const gitCap = 8 * 1024;
+    return async (ctx) => {
+        if (!ctx.handsEnabled)
+            return null;
+        if (!isAbsolute(ctx.cwd))
+            return null;
+        const root = resolve(ctx.cwd);
+        const st = await fs.stat(root).catch(() => null);
+        if (!st?.isDirectory())
+            return null;
+        const claudeTrunc = { v: false };
+        const claudeRaw = (await readCapped(root, "CLAUDE.md", claudeCap, claudeTrunc)) ?? (await readCapped(root, ".claude/CLAUDE.md", claudeCap, claudeTrunc));
+        const claude = ctx.isSubagent && claudeRaw ? capUtf8(claudeRaw, subagentClaudeCap) : claudeRaw;
+        const claudeTruncated = claudeTrunc.v || Boolean(ctx.isSubagent && claudeRaw && Buffer.byteLength(claudeRaw, "utf8") > subagentClaudeCap);
+        let gitNarrative = "";
+        let gitOk = true;
+        let gitDropReason;
+        if (!ctx.isSubagent) {
+            const [log, status] = await Promise.all([
+                git(root, ["log", "-5", "--oneline", "--no-color"], gitCap),
+                git(root, ["status", "--porcelain=v1"], gitCap),
+            ]);
+            gitOk = !log.fail && !status.fail;
+            gitDropReason = log.fail ?? status.fail;
+            const parts = [];
+            if (log.out)
+                parts.push(`## Recent commits\n${log.out}`);
+            if (status.out)
+                parts.push(`## Working tree\n${status.out.split("\n").slice(0, 40).join("\n")}`);
+            gitNarrative = parts.join("\n\n");
+        }
+        const sections = [];
+        if (claude)
+            sections.push(`# CLAUDE.md\n${claude}`);
+        if (gitNarrative)
+            sections.push(gitNarrative);
+        if (sections.length === 0)
+            return null;
+        const redacted = redactSecrets(sections.join("\n\n"));
+        const capped = capUtf8(redacted, totalCap);
+        opts.logger?.debug?.("project_memory_loaded", { cwd: root, bytes: Buffer.byteLength(capped, "utf8"), isSubagent: ctx.isSubagent, gitOk, ...(gitDropReason ? { gitDropReason } : {}), claudeTruncated });
+        return capped || null;
+    };
+}
+//# sourceMappingURL=project-memory.js.map

package/dist/project-memory.js.map

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

package/dist/question.d.ts

@@ -0,0 +1,42 @@
+import { type AskQuestionRequest, type QuestionAnswer, type AskQuestion } from "@sema-agent/core";
+export interface QuestionFrame {
+    type: "question" | "question_complete";
+    questionId: string;
+    questions?: AskQuestion[];
+    outcome?: "answered" | "unanswered";
+}
+export interface QuestionRunContext {
+    taskId: string;
+    owner: string | null;
+    emit: (frame: QuestionFrame) => void | Promise<void>;
+    abortSignal?: AbortSignal;
+}
+export interface QuestionThrottle {
+    maxConcurrentPerRun: number;
+    maxTotalPerRun: number;
+    ttlMs: number;
+}
+export declare const DEFAULT_QUESTION_THROTTLE: QuestionThrottle;
+export declare function parseQuestionAnswer(body: unknown): {
+    ok: true;
+    value: QuestionAnswer;
+} | {
+    ok: false;
+    error: string;
+};
+export declare class QuestionCoordinator {
+    private readonly als;
+    private readonly pending;
+    private readonly counters;
+    private readonly throttle;
+    constructor(throttle?: QuestionThrottle);
+    runWithContext<T>(ctx: QuestionRunContext, fn: () => Promise<T>): Promise<T>;
+    question: (req: AskQuestionRequest, signal?: AbortSignal) => Promise<QuestionAnswer>;
+    respond(id: string, principal: string | undefined, body: unknown): {
+        status: number;
+        body: unknown;
+    };
+    pendingCount(): number;
+    private countersFor;
+}
+//# sourceMappingURL=question.d.ts.map

package/dist/question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.d.ts","sourceRoot":"","sources":["../src/question.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAU,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAA2B,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAWnI,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAG1B,OAAO,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;CACrC;AAID,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAE/B,mBAAmB,EAAE,MAAM,CAAC;IAE5B,cAAc,EAAE,MAAM,CAAC;IAEvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAIvC,CAAC;AAsBF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgBrH;AAqBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAEhC,QAAQ,GAAE,gBAA4C;IAMlE,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB5E,QAAQ,QAAe,kBAAkB,WAAW,WAAW,KAAG,OAAO,CAAC,cAAc,CAAC,CAsDvF;IAKF,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAcpG,YAAY,IAAI,MAAM;IAItB,OAAO,CAAC,WAAW;CAQpB"}

package/dist/question.js

@@ -0,0 +1,140 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { uuidv7 } from "@sema-agent/core";
+import { redactDeep } from "./trace/redact.js";
+const MAX_QUESTIONS_BYTES = 16384;
+export const DEFAULT_QUESTION_THROTTLE = {
+    maxConcurrentPerRun: 2,
+    maxTotalPerRun: 20,
+    ttlMs: 5 * 60_000,
+};
+const NO_HUMAN = { answers: [] };
+export function parseQuestionAnswer(body) {
+    if (body === null || typeof body !== "object" || Array.isArray(body))
+        return { ok: false, error: "body must be an object" };
+    const answers = body.answers;
+    if (!Array.isArray(answers))
+        return { ok: false, error: "answers must be an array" };
+    const out = [];
+    for (const a of answers) {
+        if (a === null || typeof a !== "object" || Array.isArray(a))
+            return { ok: false, error: "each answer must be an object" };
+        const item = a;
+        if (typeof item.header !== "string")
+            return { ok: false, error: "answer.header must be a string" };
+        if (!Array.isArray(item.selected) || !item.selected.every((s) => typeof s === "string")) {
+            return { ok: false, error: "answer.selected must be an array of strings" };
+        }
+        if (item.note !== undefined && typeof item.note !== "string")
+            return { ok: false, error: "answer.note must be a string" };
+        out.push({ header: item.header, selected: item.selected, ...(item.note !== undefined ? { note: item.note } : {}) });
+    }
+    return { ok: true, value: { answers: out } };
+}
+function boundQuestions(questions) {
+    const redacted = redactDeep(questions);
+    try {
+        if (JSON.stringify(redacted).length > MAX_QUESTIONS_BYTES)
+            return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    return redacted;
+}
+export class QuestionCoordinator {
+    als = new AsyncLocalStorage();
+    pending = new Map();
+    counters = new Map();
+    throttle;
+    constructor(throttle = DEFAULT_QUESTION_THROTTLE) {
+        this.throttle = throttle;
+    }
+    runWithContext(ctx, fn) {
+        return this.als.run(ctx, async () => {
+            try {
+                return await fn();
+            }
+            finally {
+                for (const [, p] of [...this.pending]) {
+                    if (p.taskId === ctx.taskId)
+                        p.settle(NO_HUMAN, "unanswered");
+                }
+                this.counters.delete(ctx.taskId);
+            }
+        });
+    }
+    question = async (req, signal) => {
+        const ctx = this.als.getStore();
+        if (!ctx)
+            return NO_HUMAN;
+        if (signal?.aborted || ctx.abortSignal?.aborted)
+            return NO_HUMAN;
+        const rc = this.countersFor(ctx.taskId);
+        if (rc.inflight >= this.throttle.maxConcurrentPerRun || rc.total >= this.throttle.maxTotalPerRun)
+            return NO_HUMAN;
+        const questions = boundQuestions(req.questions);
+        if (!questions)
+            return NO_HUMAN;
+        const id = uuidv7();
+        rc.inflight += 1;
+        let done = false;
+        let timer;
+        let resolveAnswer;
+        const answerP = new Promise((resolve) => { resolveAnswer = resolve; });
+        const settle = (a, outcome) => {
+            if (done)
+                return;
+            done = true;
+            if (timer)
+                clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+            ctx.abortSignal?.removeEventListener("abort", onAbort);
+            this.pending.delete(id);
+            rc.inflight = Math.max(0, rc.inflight - 1);
+            lastOutcome = outcome;
+            resolveAnswer(a);
+        };
+        let lastOutcome = "unanswered";
+        const onAbort = () => settle(NO_HUMAN, "unanswered");
+        timer = setTimeout(() => settle(NO_HUMAN, "unanswered"), this.throttle.ttlMs);
+        timer.unref?.();
+        signal?.addEventListener("abort", onAbort, { once: true });
+        ctx.abortSignal?.addEventListener("abort", onAbort, { once: true });
+        this.pending.set(id, { settle, owner: ctx.owner, taskId: ctx.taskId });
+        try {
+            await ctx.emit({ type: "question", questionId: id, questions });
+            rc.total += 1;
+        }
+        catch {
+            settle(NO_HUMAN, "unanswered");
+        }
+        const answer = await answerP;
+        void Promise.resolve()
+            .then(() => ctx.emit({ type: "question_complete", questionId: id, outcome: lastOutcome }))
+            .catch(() => undefined);
+        return answer;
+    };
+    respond(id, principal, body) {
+        const parsed = parseQuestionAnswer(body);
+        if (!parsed.ok)
+            return { status: 400, body: { error: parsed.error } };
+        const entry = this.pending.get(id);
+        if (!entry || (entry.owner !== null && entry.owner !== principal)) {
+            return { status: 404, body: { error: "no pending question for this id (answered, expired, or not on this replica)" } };
+        }
+        entry.settle(parsed.value, "answered");
+        return { status: 200, body: { questionId: id, delivery: "applied" } };
+    }
+    pendingCount() {
+        return this.pending.size;
+    }
+    countersFor(taskId) {
+        let rc = this.counters.get(taskId);
+        if (!rc) {
+            rc = { inflight: 0, total: 0 };
+            this.counters.set(taskId, rc);
+        }
+        return rc;
+    }
+}
+//# sourceMappingURL=question.js.map

package/dist/question.js.map

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

package/dist/resource-suspend.d.ts

@@ -0,0 +1,11 @@
+export declare function resourceSuspendOptIn(opts: {
+    enabled: boolean;
+    ttlSec: number;
+    isVerify: boolean;
+    isCascade: boolean;
+    scope: string;
+}): {
+    scope: string;
+    ttlMs?: number;
+} | undefined;
+//# sourceMappingURL=resource-suspend.d.ts.map

package/dist/resource-suspend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-suspend.d.ts","sourceRoot":"","sources":["../src/resource-suspend.ts"],"names":[],"mappings":"AAgBA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAEzC,OAAO,EAAE,OAAO,CAAC;IAEjB,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,EAAE,OAAO,CAAC;IAElB,SAAS,EAAE,OAAO,CAAC;IAEnB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAGhD"}

package/dist/resource-suspend.js

@@ -0,0 +1,6 @@
+export function resourceSuspendOptIn(opts) {
+    if (!opts.enabled || opts.isVerify || opts.isCascade)
+        return undefined;
+    return { scope: opts.scope, ...(opts.ttlSec > 0 ? { ttlMs: opts.ttlSec * 1000 } : {}) };
+}
+//# sourceMappingURL=resource-suspend.js.map

package/dist/resource-suspend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-suspend.js","sourceRoot":"","sources":["../src/resource-suspend.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,oBAAoB,CAAC,IAWpC;IACC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1F,CAAC"}