@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/voice/routes.js

@@ -0,0 +1,91 @@
+import { randomUUID } from 'node:crypto';
+import { basename } from 'node:path';
+import { Hono } from 'hono';
+import { voiceDecideRequestSchema, voiceOutcomeRequestSchema, } from '../contract/index.js';
+import { jsonZodValidator } from '../server/validators.js';
+import { appendVoiceLog } from './decision-log.js';
+import { decideVoice } from './decide.js';
+import { VoiceEngineError } from './engine.js';
+import { readPendingHumanAsk } from './pending-ask.js';
+/** The one refusal both routes answer while voice mode is off (capability `voice`). */
+export const VOICE_OFF = 'Voice mode is off: set CEZ_VOICE=1 and TYPESAFE_API_KEY, then restart cezar';
+/**
+ * Voice mode routes (spec 2026-10-21-voice-mode, "Architecture"). One chained family, mounted in the
+ * `v1` chain so they answer under `/api/v1/voice/*` and `/api/v1/p/:projectId/voice/*`. The gate runs
+ * before validation, so an off server never validates, decides or writes.
+ */
+export function createVoiceRoutes(deps) {
+    const gate = async (c, next) => {
+        if (!deps.voiceEnabled())
+            return c.json({ error: VOICE_OFF }, 409);
+        await next();
+    };
+    return new Hono()
+        .use('/voice/*', gate)
+        .post('/voice/decide', jsonZodValidator(voiceDecideRequestSchema), async (c) => {
+        const project = c.get('project');
+        const body = c.req.valid('json');
+        // An id this project does not know is "no open task", not an error: the tab can outlive the run.
+        // Its card id goes with it, so "no open task" wins over a stale card.
+        const openRun = body.openRunId === undefined ? undefined : project.store.getRun(body.openRunId);
+        const { openRunId: _unknown, askRequestId: _card, ...rest } = body;
+        const request = openRun ? body : rest;
+        const screen = {
+            project: basename(project.root),
+            ...(openRun ? { openTask: { title: openRun.titleSummary ?? openRun.title, status: openRun.status } } : {}),
+        };
+        const ask = openRun ? readPendingHumanAsk(project.dataDir, openRun) : undefined;
+        const decisionId = deps.uuid?.() ?? randomUUID();
+        deps.recent.load(project.id, project.dataDir);
+        const recent = deps.recent.last(project.id);
+        const engine = deps.engine();
+        try {
+            const { decision, answers, latencyMs, state } = await decideVoice({
+                request,
+                ...(ask ? { ask } : {}),
+                screen,
+                recent,
+                engine,
+                decisionId,
+                signal: c.req.raw.signal,
+            });
+            appendVoiceLog(project.dataDir, {
+                type: 'decision',
+                at: new Date().toISOString(),
+                decisionId,
+                sentence: request.text,
+                ...(request.openRunId !== undefined ? { openRunId: request.openRunId } : {}),
+                engine: engine.id,
+                state,
+                answers,
+                decision,
+                latencyMs,
+            });
+            deps.recent.record(project.id, decisionId, request.text, decision.action);
+            return c.json(decision, 200);
+        }
+        catch (error) {
+            // The caller's own abort and any bug go to Hono's error handler and write no line.
+            if (!(error instanceof VoiceEngineError))
+                throw error;
+            appendVoiceLog(project.dataDir, {
+                type: 'decision-error',
+                at: new Date().toISOString(),
+                decisionId,
+                sentence: request.text,
+                code: error.code,
+            });
+            // Only the code leaves the server: never the engine's message, status or headers.
+            return c.json({ error: `Voice decision unavailable (${error.code})` }, 503);
+        }
+    })
+        .post('/voice/outcome', jsonZodValidator(voiceOutcomeRequestSchema), async (c) => {
+        const project = c.get('project');
+        const { decisionId, outcome } = c.req.valid('json');
+        deps.recent.load(project.id, project.dataDir);
+        appendVoiceLog(project.dataDir, { type: 'outcome', at: new Date().toISOString(), decisionId, outcome });
+        deps.recent.settle(project.id, decisionId, outcome);
+        return c.json({ ok: true }, 200);
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/voice/routes.js.map

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

package/dist/voice/sentence.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The dictated sentence as numbered words (hearsay-tools/cezarion#1463). The engine labels each word
+ * with the part of the reply it belongs to; code copies the words back out of the sentence exactly as
+ * said (spec 2026-10-21-voice-mode, "Answer the question card"). Pure string work; nothing here
+ * decides anything.
+ */
+export interface VoiceWord {
+    /** `W01`, `W02`, … as the engine sees it in `words`. */
+    id: string;
+    text: string;
+    /** Where the word sits in the sentence: `sentence.slice(start, end) === text`. */
+    start: number;
+    end: number;
+}
+export declare function wordId(index: number): string;
+export declare function splitWords(sentence: string): VoiceWord[];
+/** The indices of the words inside a question reference: they point at a question, they never answer it. */
+export declare function questionReferenceWords(sentence: string, words: readonly VoiceWord[], headers: string[]): Set<number>;
+export declare function namesQuestion(sentence: string, headers: string[]): boolean;
+/** The words `first`..`last` exactly as said, without a trailing sentence mark or comma. */
+export declare function copyRange(sentence: string, words: readonly VoiceWord[], first: number, last: number): string;

package/dist/voice/sentence.js

@@ -0,0 +1,61 @@
+/**
+ * The dictated sentence as numbered words (hearsay-tools/cezarion#1463). The engine labels each word
+ * with the part of the reply it belongs to; code copies the words back out of the sentence exactly as
+ * said (spec 2026-10-21-voice-mode, "Answer the question card"). Pure string work; nothing here
+ * decides anything.
+ */
+const ORDINAL = '(?:one|two|three|four|first|second|third|fourth|[1-4])';
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Where the sentence names a question: by number ("to question first", "the second question") or by
+ * its card header ("to Library", "for the Library question", "Library question").
+ */
+function questionAnchors(headers) {
+    const named = [...headers]
+        .filter((header) => header.trim() !== '')
+        .sort((a, b) => b.length - a.length)
+        .map((header) => {
+        const h = `(?<!\\w)${escapeRegExp(header.trim())}(?!\\w)`;
+        return `\\b(?:to|for)\\s+(?:the\\s+)?${h}(?:\\s+question\\b)?|(?:\\bthe\\s+)?${h}\\s+question\\b`;
+    });
+    const numbered = `(?:\\b(?:to|for)\\s+)?(?:\\bthe\\s+)?\\b(?:question\\s+${ORDINAL}|${ORDINAL}\\s+question)\\b`;
+    return new RegExp([...named, numbered].join('|'), 'gi');
+}
+export function wordId(index) {
+    return `W${String(index + 1).padStart(2, '0')}`;
+}
+export function splitWords(sentence) {
+    return [...sentence.matchAll(/\S+/g)].map((match, i) => ({
+        id: wordId(i),
+        text: match[0],
+        start: match.index,
+        end: match.index + match[0].length,
+    }));
+}
+/** The indices of the words inside a question reference: they point at a question, they never answer it. */
+export function questionReferenceWords(sentence, words, headers) {
+    const found = new Set();
+    for (const anchor of sentence.matchAll(questionAnchors(headers))) {
+        const from = anchor.index;
+        const to = anchor.index + anchor[0].length;
+        words.forEach((word, i) => {
+            if (word.start < to && word.end > from)
+                found.add(i);
+        });
+    }
+    return found;
+}
+export function namesQuestion(sentence, headers) {
+    return questionAnchors(headers).test(sentence);
+}
+/** The words `first`..`last` exactly as said, without a trailing sentence mark or comma. */
+export function copyRange(sentence, words, first, last) {
+    const from = words[first];
+    const to = words[last];
+    if (from === undefined || to === undefined)
+        return '';
+    return sentence.slice(from.start, to.end).replace(/[\s.!?,]+$/, '');
+}
+//# sourceMappingURL=sentence.js.map

package/dist/voice/sentence.js.map

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

package/dist/voice/thresholds.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The confidence cut-offs `decideVoice` applies to engine answers. They are tuned against one pinned
+ * Jev version (spec 2026-10-21-voice-mode, "How it decides"); no other file holds a threshold.
+ */
+/**
+ * `is_command` noul below this reads as chatter, but only when the action is `none` or below
+ * `ACTION_MIN`; it never vetoes a confident action. Live jev-1.13.0 scored real commands at 0.33–0.47
+ * ("open second failed": 0.33 with `open` at 0.98), while chatter had no action above 0.40.
+ */
+export declare const IS_COMMAND_MIN = 0.5;
+/** The `action` choice below this confidence is not acted on. */
+export declare const ACTION_MIN = 0.55;
+/** A confirm or cancel needs this much confidence, since it sends or drops a proposal. */
+export declare const CONFIRM_MIN = 0.7;
+/** The `status` choice below this confidence comes with alternatives. */
+export declare const OPEN_STATUS_SURE = 0.6;
+/** A card option is taken when its probability is at least this; otherwise the words go to Other. */
+export declare const ANSWER_OPTION_MIN = 0.5;
+/** A multi-select option is taken when its noul is at least this. */
+export declare const OPTION_SELECTED_MIN = 0.5;
+/**
+ * A reply target (an answer to one card question, or the message) is taken when the mean confidence
+ * of its words is at least this. Not the minimum: live jev-1.13.0 gave correct boundary words
+ * 0.04–0.5 (spike for hearsay-tools/cezarion#1463). Set just below the lowest mean of a correct
+ * target in three live runs of the replay set (`scripts/voice-replay.ts`): 0.36, for "tell it that
+ * that file is fine".
+ */
+export declare const EXTRACT_MIN = 0.3;

package/dist/voice/thresholds.js

@@ -0,0 +1,29 @@
+/**
+ * The confidence cut-offs `decideVoice` applies to engine answers. They are tuned against one pinned
+ * Jev version (spec 2026-10-21-voice-mode, "How it decides"); no other file holds a threshold.
+ */
+/**
+ * `is_command` noul below this reads as chatter, but only when the action is `none` or below
+ * `ACTION_MIN`; it never vetoes a confident action. Live jev-1.13.0 scored real commands at 0.33–0.47
+ * ("open second failed": 0.33 with `open` at 0.98), while chatter had no action above 0.40.
+ */
+export const IS_COMMAND_MIN = 0.5;
+/** The `action` choice below this confidence is not acted on. */
+export const ACTION_MIN = 0.55;
+/** A confirm or cancel needs this much confidence, since it sends or drops a proposal. */
+export const CONFIRM_MIN = 0.7;
+/** The `status` choice below this confidence comes with alternatives. */
+export const OPEN_STATUS_SURE = 0.6;
+/** A card option is taken when its probability is at least this; otherwise the words go to Other. */
+export const ANSWER_OPTION_MIN = 0.5;
+/** A multi-select option is taken when its noul is at least this. */
+export const OPTION_SELECTED_MIN = 0.5;
+/**
+ * A reply target (an answer to one card question, or the message) is taken when the mean confidence
+ * of its words is at least this. Not the minimum: live jev-1.13.0 gave correct boundary words
+ * 0.04–0.5 (spike for hearsay-tools/cezarion#1463). Set just below the lowest mean of a correct
+ * target in three live runs of the replay set (`scripts/voice-replay.ts`): 0.36, for "tell it that
+ * that file is fine".
+ */
+export const EXTRACT_MIN = 0.3;
+//# sourceMappingURL=thresholds.js.map

package/dist/voice/thresholds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thresholds.js","sourceRoot":"","sources":["../../src/voice/thresholds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC;AAC/B,0FAA0F;AAC1F,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,qGAAqG;AACrG,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC"}

package/dist/webhooks/cli.d.ts

@@ -0,0 +1,18 @@
+import { type DiscoverOptions } from '../task-cli/discovery.ts';
+import { type Cockpit, type HttpResult } from '../task-cli/http.ts';
+/**
+ * `cez webhook` (hearsay-tools/cezarion#1576): list the project webhooks the owner exposed to
+ * agents, and send one report through one of them. Inside a task it reaches the cockpit through
+ * `CEZ_COCKPIT_URL` and `CEZ_PROJECT_ID`, and names the reporting task with `CEZ_TASK_ID`.
+ */
+export interface WebhookIo {
+    stdout(line: string): void;
+    readFile?: (path: string) => Promise<string>;
+    discover?: (options: DiscoverOptions) => Promise<Cockpit>;
+    /** The transport; tests point it at a test app. */
+    http?: (cockpit: Cockpit, path: string, init?: {
+        method?: string;
+        body?: unknown;
+    }) => Promise<HttpResult>;
+}
+export declare function runWebhookCommand(argv: string[], env?: NodeJS.ProcessEnv, io?: WebhookIo): Promise<number>;

package/dist/webhooks/cli.js

@@ -0,0 +1,145 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { agentWebhooksResponseSchema, sendAgentReportResponseSchema, } from '../contract/index.js';
+import { AGENT_REPORT_MESSAGE_MAX_LENGTH } from '../contract/index.js';
+import { EXIT } from '../task-cli/cli.js';
+import { discoverCockpit } from '../task-cli/discovery.js';
+import { invalidResponse, refuse, request, TaskCliError } from '../task-cli/http.js';
+const USAGE = `cez webhook — send reports to the project webhooks the owner exposed to agents.
+One JSON object per invocation; exit 0 ok, 1 not delivered, 2 refused or no cockpit, 64 usage.
+
+  list                                     the exposed webhooks: id, name and what each is for
+  send <name|id> (--message <text> | --message-file <path>) [--title <text>] [--data '<json object>']
+                                           POST one report (Markdown message) to that webhook; the
+                                           report names this task when CEZ_TASK_ID is set
+
+Address: CEZ_COCKPIT_URL + CEZ_PROJECT_ID (set inside a task). --url <origin> or --repo <dir> look
+for a cockpit instead.`;
+const NO_COCKPIT = 'no cockpit address — this command works inside a task run by a cockpit';
+const ADDRESS_FLAGS = { url: { type: 'string' }, repo: { type: 'string' } };
+const SEND_FLAGS = {
+    message: { type: 'string' },
+    'message-file': { type: 'string' },
+    title: { type: 'string' },
+    data: { type: 'string' },
+};
+function usageError(error) {
+    throw new TaskCliError(EXIT.usage, { code: 'invalid_input', error });
+}
+function parse(argv) {
+    const [name, ...rest] = argv;
+    if (name !== 'list' && name !== 'send')
+        usageError(name === undefined ? 'missing command (list, send)' : `unknown command "${name}"`);
+    let values;
+    let positionals;
+    try {
+        ({ values, positionals } = parseArgs({
+            args: rest,
+            allowPositionals: true,
+            strict: true,
+            options: name === 'send' ? { ...ADDRESS_FLAGS, ...SEND_FLAGS } : ADDRESS_FLAGS,
+        }));
+    }
+    catch (error) {
+        usageError(error instanceof Error ? error.message : String(error));
+    }
+    const expected = name === 'send' ? 1 : 0;
+    if (positionals.length !== expected)
+        usageError(name === 'send' ? 'send takes one webhook name or id' : 'list takes no positional arguments');
+    return { command: name, webhook: positionals[0] ?? '', values };
+}
+async function reportBody(values, env, io) {
+    if ((values.message === undefined) === (values['message-file'] === undefined))
+        usageError('give the report as --message OR --message-file');
+    let message = values.message;
+    if (values['message-file'] !== undefined) {
+        try {
+            message = await (io.readFile ?? ((path) => readFile(path, 'utf8')))(values['message-file']);
+        }
+        catch (error) {
+            usageError(`cannot read ${values['message-file']}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (!message?.trim())
+        usageError('the message is empty');
+    if (message.length > AGENT_REPORT_MESSAGE_MAX_LENGTH)
+        usageError(`the message is longer than ${AGENT_REPORT_MESSAGE_MAX_LENGTH} characters`);
+    let data;
+    if (values.data !== undefined) {
+        try {
+            data = JSON.parse(values.data);
+        }
+        catch {
+            usageError('--data must be a JSON object');
+        }
+        if (data === null || typeof data !== 'object' || Array.isArray(data))
+            usageError('--data must be a JSON object');
+    }
+    const runId = env.CEZ_TASK_ID?.trim();
+    return {
+        message,
+        ...(values.title?.trim() ? { title: values.title.trim() } : {}),
+        ...(data ? { data } : {}),
+        ...(runId ? { runId } : {}),
+    };
+}
+/** The env address first; discovery only when the caller named a cockpit or a checkout. */
+async function resolveCockpit(env, values, io) {
+    const address = env.CEZ_COCKPIT_URL?.trim();
+    const projectId = env.CEZ_PROJECT_ID?.trim();
+    if (address && projectId) {
+        let origin;
+        try {
+            origin = new URL(address).origin;
+        }
+        catch {
+            throw new TaskCliError(EXIT.refused, { code: 'no-cockpit', error: `CEZ_COCKPIT_URL is not a URL: ${address}` });
+        }
+        return { origin, projectId, api: `${origin}/api/v1/p/${encodeURIComponent(projectId)}` };
+    }
+    const url = values.url ?? (env.CEZ_URL?.trim() || undefined);
+    if (url === undefined && values.repo === undefined)
+        throw new TaskCliError(EXIT.refused, { code: 'no-cockpit', error: NO_COCKPIT });
+    return (io.discover ?? discoverCockpit)({ url, repoDir: resolve(values.repo ?? process.cwd()) });
+}
+export async function runWebhookCommand(argv, env = process.env, io = { stdout: (line) => console.log(line) }) {
+    const print = (value) => io.stdout(JSON.stringify(value));
+    try {
+        if (argv.length === 0 || argv[0] === 'help' || argv.includes('--help') || argv.includes('-h')) {
+            io.stdout(USAGE);
+            return argv.length === 0 ? EXIT.usage : EXIT.ok;
+        }
+        // Input is judged before any cockpit is looked for: a usage error is 64 with or without one.
+        const { command, webhook, values } = parse(argv);
+        const body = command === 'send' ? await reportBody(values, env, io) : undefined;
+        const cockpit = await resolveCockpit(env, values, io);
+        const http = io.http ?? request;
+        if (command === 'list') {
+            const result = await http(cockpit, '/agent-webhooks');
+            if (result.status !== 200)
+                refuse(result);
+            const parsed = agentWebhooksResponseSchema.safeParse(result.data);
+            if (!parsed.success)
+                invalidResponse('webhook list');
+            print(parsed.data);
+            return EXIT.ok;
+        }
+        const result = await http(cockpit, `/agent-webhooks/${encodeURIComponent(webhook)}`, { method: 'POST', body });
+        if (result.status !== 200)
+            refuse(result);
+        const parsed = sendAgentReportResponseSchema.safeParse(result.data);
+        if (!parsed.success)
+            invalidResponse('webhook send');
+        print(parsed.data);
+        return parsed.data.ok ? EXIT.ok : EXIT.failed;
+    }
+    catch (error) {
+        if (error instanceof TaskCliError) {
+            print(error.body);
+            return error.exitCode;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/webhooks/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/webhooks/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAiC,MAAM,qBAAqB,CAAC;AAgBpH,MAAM,KAAK,GAAG;;;;;;;;;uBASS,CAAC;AAExB,MAAM,UAAU,GAAG,wEAAwE,CAAC;AAE5F,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAW,CAAC;AACrF,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC3B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAClC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;CAChB,CAAC;AAEX,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;AACvE,CAAC;AAQD,SAAS,KAAK,CAAC,IAAc;IAC3B,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;QAAE,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;IACtI,IAAI,MAAwB,CAAC;IAC7B,IAAI,WAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;YACnC,IAAI,EAAE,IAAI;YACV,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,aAAa;SAC/E,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,WAAW,CAAC,MAAM,KAAK,QAAQ;QAAE,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC;IAC9I,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAwB,EAAE,GAAsB,EAAE,EAAa;IACvF,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,SAAS,CAAC;QAAE,UAAU,CAAC,gDAAgD,CAAC,CAAC;IAC5I,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,SAAS,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QACtG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,eAAe,MAAM,CAAC,cAAc,CAAC,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;QAAE,UAAU,CAAC,sBAAsB,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,GAAG,+BAA+B;QAAE,UAAU,CAAC,8BAA8B,+BAA+B,aAAa,CAAC,CAAC;IAC7I,IAAI,IAAyC,CAAC;IAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAA4B,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,8BAA8B,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACnH,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACtC,OAAO;QACL,OAAO;QACP,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,KAAK,UAAU,cAAc,CAAC,GAAsB,EAAE,MAAwB,EAAE,EAAa;IAC3F,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;QACzB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YAAC,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAC/C,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,iCAAiC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,aAAa,kBAAkB,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;IAC3F,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC;IAC7D,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACpI,OAAO,CAAC,EAAE,CAAC,QAAQ,IAAI,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAc,EACd,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,EAAE,GAAc,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;IAEvD,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9F,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,CAAC;QACD,6FAA6F;QAC7F,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,OAAO,CAAC;QAChC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,eAAe,CAAC,cAAc,CAAC,CAAC;YACrD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,mBAAmB,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/G,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,eAAe,CAAC,cAAc,CAAC,CAAC;QACrD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;YAClC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/webhooks/prompt.d.ts

@@ -0,0 +1,5 @@
+import type { AgentWebhook } from '../contract/index.js';
+/** The absolute `cez webhook` command, so an agent needs no `cez` on its PATH. */
+export declare function webhookCliCommand(): string;
+/** One line per webhook: the owner's description is what tells the agent when to use it. */
+export declare function agentWebhooksPrompt(command: string, webhooks: readonly AgentWebhook[]): string | undefined;

package/dist/webhooks/prompt.js

@@ -0,0 +1,26 @@
+import { fileURLToPath } from 'node:url';
+/**
+ * The "Project webhooks" part of an agent's system prompt (hearsay-tools/cezarion#1576): the
+ * webhooks the owner exposed to agents in this project, by name and description, and the command
+ * that sends a report to one. No exposed webhook: no part, so the zero-config prompt is unchanged.
+ */
+const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+/** The absolute `cez webhook` command, so an agent needs no `cez` on its PATH. */
+export function webhookCliCommand() {
+    const source = import.meta.url.endsWith('.ts');
+    const entry = fileURLToPath(new URL(source ? '../index.ts' : '../index.js', import.meta.url));
+    return [process.execPath, ...(source ? ['--import', import.meta.resolve('tsx')] : []), entry].map(quote).join(' ') + ' webhook';
+}
+/** One line per webhook: the owner's description is what tells the agent when to use it. */
+export function agentWebhooksPrompt(command, webhooks) {
+    if (webhooks.length === 0)
+        return undefined;
+    const lines = webhooks.map((webhook) => `- "${webhook.name}"${webhook.description ? `: ${webhook.description.replace(/\s+/g, ' ').trim()}` : ''}`);
+    return [
+        '## Project webhooks',
+        'The project owner lets you send reports to these webhooks. Read each description to decide when one applies, and use it instead of the channel it replaces (for example, a friction report goes to its webhook, not to a new GitHub issue):',
+        ...lines,
+        `Send one report with ${command} send '<name>' --message-file <report.md> [--title '<one line>'] [--data '<json object>'], or --message '<text>' for a short one. The message is Markdown; the report names this task. The command prints JSON: "ok": false means it was not delivered, and "error" says why. ${command} list prints the current list, which the owner can change while you work. Never put credentials or unrelated private data in a report.`,
+    ].join('\n');
+}
+//# sourceMappingURL=prompt.js.map

package/dist/webhooks/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/webhooks/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;GAIG;AAEH,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;AAEvE,kFAAkF;AAClF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9F,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;AAClI,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,QAAiC;IACpF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnJ,OAAO;QACL,qBAAqB;QACrB,6OAA6O;QAC7O,GAAG,KAAK;QACR,wBAAwB,OAAO,iRAAiR,OAAO,wIAAwI;KAChc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/workflows/active-run.d.ts

@@ -0,0 +1,167 @@
+import type { AgentSession, InputDelivery } from '../core/agent-runner.ts';
+import type { Skill } from '../skills.ts';
+import type { DelegationExecutionSettings } from './run.ts';
+/**
+ * The in-memory state of a run this manager is executing, and the one place it is built
+ * (hearsay-tools/cezarion#1806). `RunManager` registers every instance through `activate`.
+ */
+export interface ActiveRun {
+    /** Last cumulative Claude report per provider session during this process. */
+    reportedClaudeCost?: Map<string, number>;
+    delegationSettings?: DelegationExecutionSettings | undefined;
+    revokeDelegation?: (() => void) | undefined;
+    revokeCiTools?: (() => void) | undefined;
+    /** hearsay-tools/cezarion#1234: the last session started without cezar tools, so its prompt
+     *  taught the lifecycle markers; kept after the session's tools are revoked. */
+    toolless?: boolean;
+    ciGeneration?: string;
+    ciTurnId?: string;
+    waitWakeTurn?: AgentSession | undefined;
+    cancelled: boolean;
+    /** Explicit human Finish survives disposal; shutdown-only result callbacks do not settle. */
+    finishRequested?: boolean;
+    interrupt: () => void;
+    /** Where this run's steps execute: the task worktree, or the repo root. */
+    cwd: string;
+    /** Live claude session of the currently running agent step, if any. */
+    session?: AgentSession | undefined;
+    pendingHumanAsk: boolean;
+    /** Native grants belong only to this live session generation. */
+    pendingPermissions?: Set<string>;
+    agentInputError?: string;
+    agentInputFlight?: {
+        session: AgentSession;
+        inputIds: readonly string[];
+        settled?: Promise<void>;
+        /** This batch carries timer results: it holds one unit of the automatic-wake budget, which
+         *  every budget check counts, and charges it to the record on its acknowledgement. */
+        wakeReserved?: boolean;
+        /** This batch is an admitted wake (hearsay-tools/cezarion#1235): its acknowledgement spends
+         *  the admission, a wake of messages alone included. */
+        admittedWake?: boolean;
+    } | undefined;
+    /** The current session's declared input delivery (#505). */
+    inputDelivery?: InputDelivery;
+    /** Accepted by this session's harness, not yet reported read (observable backends only).
+     * The harness still owes a turn for them, so they count as pending work (#505). */
+    unreadInputIds?: Set<string>;
+    /** Read before the acceptance checkpoint landed; applied when it does. */
+    consumedBeforeAck?: Set<string>;
+    /** Conversation input carried by a human answer's own write; read at that turn's end. */
+    bundledInputIds?: string[] | undefined;
+    /** Reported unread while their own submission was still unacknowledged. */
+    retiredInFlight?: Set<string>;
+    /** Liveness bound for unread input (#505): timer, and IDs already resubmitted once. */
+    unreadInputTimer?: NodeJS.Timeout | undefined;
+    /** Liveness bound for a no-wait nudge that was acknowledged without a turn (#544,
+     *  hearsay-tools/cezarion#1234). */
+    noWaitNudgeReplyTimer?: NodeJS.Timeout | undefined;
+    /** Parent-level text/item/tool arrived for this nudge, possibly before the timer armed. */
+    noWaitNudgeSawContent?: boolean | undefined;
+    /** The reply bound expired on this session: a late reply from it resumes the run. */
+    noWaitNudgeParked?: AgentSession | undefined;
+    unreadRetried?: Set<string>;
+    /** #486: re-settle a boundary that deferred only because holdsHumanInput() was true. */
+    heldHumanInputTimer?: NodeJS.Timeout | undefined;
+    heldHumanInputSince?: number | undefined;
+    heldHumanInputExpired?: boolean | undefined;
+    /** Only this older ask is being answered by the current continuation's opening turn. */
+    openingAnswerAskSeq?: number | undefined;
+    openingAgentInputId?: string | undefined;
+    agentSessionError?: string | undefined;
+    doneAtBoundary?: AgentSession | undefined;
+    /** `cezar_done` accepted in this session since its last turn end (hearsay-tools/cezarion#1234). */
+    doneRequested?: {
+        session: AgentSession;
+        summary?: string;
+    } | undefined;
+    /** The session's done completes a workflow step that is not the last, and this step runs next
+     *  (hearsay-tools/cezarion#1620). Undefined: the done finishes the task. */
+    nextStep?: {
+        session: AgentSession;
+        label: string;
+    } | undefined;
+    /** The step an accepted done closed. A workflow step that is not the last advances only on it. */
+    completedStepId?: string | undefined;
+    /** What declared the done `doneAtBoundary` closes on: the closing event names it. */
+    doneClose?: {
+        via: 'cezar_done' | 'done-line';
+        summary?: string;
+    } | undefined;
+    parkAfterAck?: {
+        session: AgentSession;
+        monitoring: boolean;
+        humanGate?: boolean;
+        nudgedLastTurn?: boolean;
+        scheduleWakeup?: number | null | undefined;
+    } | undefined;
+    /** Last completed boundary belongs to exactly this still-open session. */
+    atTurnBoundary?: AgentSession | undefined;
+    currentStepId?: string | undefined;
+    idleTimer?: NodeJS.Timeout | undefined;
+    /** The inactivity timer closed the wire; resource teardown must not imply task success. */
+    idleClosed?: boolean;
+    /** The monitoring-timer cap note was written for this session. */
+    monitoringCapNoted?: boolean | undefined;
+    autosaveTimer?: NodeJS.Timeout | undefined;
+    /** Has a session EVER opened on this run (#472)? `session` alone cannot answer
+     *  it — teardown sets it back to `undefined`, so a closed session and one that
+     *  never opened look identical. This distinguishes "still starting up, buffer
+     *  the message" from "genuinely closed, 409". */
+    sessionEverOpened?: boolean;
+    /** Autonomous mode (#autonomous): nudge eligible turn ends until done or the cap.
+     *  Pending input, native asks and lifecycle waits retain priority. */
+    autonomous?: boolean;
+    /** An eligible boundary nudge refused until the current transport becomes ready.
+     * Retains its slot, bounded by the existing idle timer; never represents a sent input. */
+    autonomousNudgePending?: AgentSession | undefined;
+    /** Session that received the no-wait nudge (hearsay-tools/cezarion#1234): its next no-wait
+     *  turn end opens a human wait instead of nudging again. */
+    noWaitNudged?: AgentSession | undefined;
+    /** Session that received a refusal nudge for a blocked done (hearsay-tools/cezarion#1301); the
+     *  next turn end on it reads and clears it. */
+    completionNudged?: AgentSession | undefined;
+    /** Session whose turn that just ended answered a refusal nudge (hearsay-tools/cezarion#1301): a
+     *  blocked done at this turn end takes the second step. Every turn end sets or clears it. */
+    completionNudgeAnswered?: AgentSession | undefined;
+    /** Registry snapshot used to expand `/skill` follow-ups before a backend can
+     *  mistake them for its own slash commands (#676). Only `RunManager.loadRunSkills` writes it,
+     *  and only `RunManager.enabledSkills` reads it. */
+    skills?: Skill[];
+    /** The install a live `/name` started after its message went out (#1408); tests await it. */
+    liveSkillProvisioning?: Promise<void>;
+    /** Release for exclusive execution in the user's repository working tree.
+     *  Worktree-backed runs never need it; root runs ordinarily do unless the
+     *  explicit unsafe bypass is active. */
+    releaseRepoRoot?: (() => void) | undefined;
+    /** Durable directional-usage accounting state for the current runner
+     * invocation. Provider-local turn ids are unique only within this epoch. */
+    usageInvocation?: {
+        stepId: string;
+        epoch: number;
+        observed: boolean;
+        startedTurns: Set<string>;
+        recordedTurns: Set<string>;
+    };
+}
+/** What differs between the ways a run starts executing. Every other `ActiveRun` field starts the
+ *  same on all of them, so a field with no value here has one in `createActiveRun`. */
+export interface ActiveRunInit {
+    /** Where this run's steps execute: the task worktree, or the repo root. */
+    cwd: string;
+    pendingHumanAsk: boolean;
+    /** The run's durable mode: `input.autonomous` for a fresh run, the record's for a Continue. */
+    autonomous: boolean;
+}
+/**
+ * The ONE place an `ActiveRun` is built (hearsay-tools/cezarion#1806). `execute` (a fresh run) and
+ * `runContinuation` (Continue and restart recovery) both call it, then register the result through
+ * `RunManager.activate`. A field added to `ActiveRun` as required fails to compile here until this
+ * sets it, and one that differs by entry path becomes a required `ActiveRunInit` field, which
+ * fails to compile at both callers. open-mercato/cezar#811 shipped a field set in one of two
+ * literals; a second literal is refused by the `active-run-literal` ast-grep rule.
+ *
+ * The skill registry is not built here: it needs I/O after the run is registered, so
+ * `RunManager.loadRunSkills` loads it, from the same two callers.
+ */
+export declare function createActiveRun(init: ActiveRunInit): ActiveRun;