@geminilight/mindos 1.1.26 → 1.1.28

package/dist/agent/bridges/user-question-bridge.js

@@ -0,0 +1,260 @@
+/**
+ * AskUserQuestion bridge: an agent raises structured questions mid-run, the
+ * UI answers them through a separate HTTP route. Sunk from
+ * packages/web/lib/agent/user-question-bridge.ts
+ * (spec-agent-core-consolidation Wave 2). Same shape as the runtime
+ * permission bridge: the pending map is shared across module copies via
+ * global-state.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { ASK_USER_QUESTION_BRIDGE_KEY, getProcessGlobal } from '../global-state.js';
+const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
+function getGlobalBridgeState() {
+    return getProcessGlobal(ASK_USER_QUESTION_BRIDGE_KEY, () => ({
+        bridgeContext: new AsyncLocalStorage(),
+        runs: new Map(),
+        pendingQuestions: new Map(),
+    }));
+}
+const bridgeState = getGlobalBridgeState();
+const bridgeContext = bridgeState.bridgeContext;
+const runs = bridgeState.runs;
+const pendingQuestions = bridgeState.pendingQuestions;
+function pendingKey(runId, toolCallId) {
+    return `${runId}:${toolCallId}`;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function normalizeQuestions(params) {
+    if (!isRecord(params) || !Array.isArray(params.questions))
+        return [];
+    return params.questions
+        .filter(isRecord)
+        .map((question) => ({
+        question: typeof question.question === 'string' ? question.question : '',
+        header: typeof question.header === 'string' ? question.header : '',
+        multiSelect: question.multiSelect === true,
+        options: Array.isArray(question.options)
+            ? question.options.filter(isRecord).map((option) => ({
+                label: typeof option.label === 'string' ? option.label : '',
+                description: typeof option.description === 'string' ? option.description : '',
+                ...(typeof option.preview === 'string' ? { preview: option.preview } : {}),
+            }))
+            : [],
+    }));
+}
+function cancelled(reason) {
+    return { answers: [], cancelled: true, error: reason };
+}
+export function runWithAskUserQuestionBridge(context, callback) {
+    runs.set(context.runId, context);
+    return bridgeContext.run(context, async () => {
+        try {
+            return await callback();
+        }
+        finally {
+            // Two bridges can share a runId (e.g. a retried request) — only tear
+            // down state that still belongs to THIS bridge instance.
+            cancelQuestionsForRun(context.runId, context);
+            if (runs.get(context.runId) === context) {
+                runs.delete(context.runId);
+            }
+        }
+    });
+}
+export function hasAskUserQuestionBridge() {
+    return Boolean(bridgeContext.getStore());
+}
+export async function askUserQuestionViaBridge(input) {
+    const context = bridgeContext.getStore();
+    if (!context)
+        return cancelled('no_bridge');
+    return enqueueAskUserQuestion(context, input);
+}
+export async function askUserQuestionForRun(input) {
+    const context = runs.get(input.runId);
+    if (!context)
+        return cancelled('no_bridge');
+    return enqueueAskUserQuestion(context, input);
+}
+function enqueueAskUserQuestion(context, input) {
+    const questions = normalizeQuestions(input.params);
+    if (questions.length === 0)
+        return Promise.resolve(cancelled('empty_questions'));
+    const params = { questions };
+    const key = pendingKey(context.runId, input.toolCallId);
+    if (pendingQuestions.has(key))
+        return Promise.resolve(cancelled('duplicate_question'));
+    return new Promise((resolve, reject) => {
+        let abort;
+        const finish = (result) => {
+            const pending = pendingQuestions.get(key);
+            if (!pending)
+                return;
+            clearTimeout(pending.timeout);
+            if (abort)
+                input.signal?.removeEventListener('abort', abort);
+            pendingQuestions.delete(key);
+            resolve(result);
+        };
+        const timeout = setTimeout(() => {
+            context.send({
+                type: 'user_question_cancelled',
+                runId: context.runId,
+                toolCallId: input.toolCallId,
+                reason: 'timeout',
+            });
+            finish(cancelled('timeout'));
+        }, context.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        pendingQuestions.set(key, {
+            runId: context.runId,
+            toolCallId: input.toolCallId,
+            params,
+            send: context.send,
+            context,
+            resolve: finish,
+            reject,
+            timeout,
+        });
+        abort = () => {
+            context.send({
+                type: 'user_question_cancelled',
+                runId: context.runId,
+                toolCallId: input.toolCallId,
+                reason: 'aborted',
+            });
+            finish(cancelled('aborted'));
+        };
+        if (input.signal?.aborted) {
+            abort();
+            return;
+        }
+        input.signal?.addEventListener('abort', abort, { once: true });
+        context.send({
+            type: 'user_question_start',
+            runId: context.runId,
+            toolCallId: input.toolCallId,
+            questions,
+        });
+    });
+}
+function cancelQuestionsForRun(runId, context) {
+    for (const pending of Array.from(pendingQuestions.values())) {
+        if (pending.runId !== runId)
+            continue;
+        if (context && pending.context !== context)
+            continue;
+        pending.send({
+            type: 'user_question_cancelled',
+            runId,
+            toolCallId: pending.toolCallId,
+            reason: 'run_finished',
+        });
+        pending.resolve(cancelled('run_finished'));
+    }
+}
+export function answerAskUserQuestion(input) {
+    const key = pendingKey(input.runId, input.toolCallId);
+    const pending = pendingQuestions.get(key);
+    if (!pending)
+        return { ok: false, status: 404, error: 'Question is no longer pending.' };
+    const validation = input.cancelled === true
+        ? { ok: true, answers: [] }
+        : validateAnswers(pending.params.questions, input.answers);
+    if (!validation.ok)
+        return { ok: false, status: 400, error: validation.error };
+    const result = {
+        answers: validation.answers,
+        cancelled: input.cancelled === true,
+    };
+    pending.send(input.cancelled === true
+        ? {
+            type: 'user_question_cancelled',
+            runId: input.runId,
+            toolCallId: input.toolCallId,
+            reason: 'user_cancelled',
+        }
+        : {
+            type: 'user_question_answered',
+            runId: input.runId,
+            toolCallId: input.toolCallId,
+            answers: result.answers,
+        });
+    pending.resolve(result);
+    return { ok: true };
+}
+function validateAnswers(questions, answers) {
+    if (!Array.isArray(answers) || answers.length === 0) {
+        return { ok: false, error: 'At least one answer is required.' };
+    }
+    const seen = new Set();
+    for (const answer of answers) {
+        if (!Number.isInteger(answer.questionIndex)) {
+            return { ok: false, error: 'Answer questionIndex must be an integer.' };
+        }
+        if (seen.has(answer.questionIndex)) {
+            return { ok: false, error: 'Each question can only be answered once.' };
+        }
+        seen.add(answer.questionIndex);
+        const question = questions[answer.questionIndex];
+        if (!question) {
+            return { ok: false, error: 'Answer questionIndex does not match a pending question.' };
+        }
+        if (answer.question !== question.question) {
+            return { ok: false, error: 'Answer question text does not match the pending question.' };
+        }
+        const optionLabels = new Set(question.options.map((option) => option.label));
+        if (answer.kind === 'option') {
+            if (question.multiSelect) {
+                return { ok: false, error: 'Use a multi answer for multi-select questions.' };
+            }
+            if (typeof answer.answer !== 'string' || !answer.answer.trim()) {
+                return { ok: false, error: 'Option answers must include a selected option.' };
+            }
+            if (optionLabels.size > 0 && !optionLabels.has(answer.answer)) {
+                return { ok: false, error: 'Selected option is not valid for this question.' };
+            }
+            continue;
+        }
+        if (answer.kind === 'multi') {
+            if (!question.multiSelect) {
+                return { ok: false, error: 'Use a single answer for single-select questions.' };
+            }
+            const selected = Array.isArray(answer.selected) ? answer.selected : [];
+            if (selected.length === 0) {
+                return { ok: false, error: 'Multi-select answers must include at least one option.' };
+            }
+            if (optionLabels.size > 0 && selected.some((value) => !optionLabels.has(value))) {
+                return { ok: false, error: 'Selected option is not valid for this question.' };
+            }
+            continue;
+        }
+        if (answer.kind === 'custom' || answer.kind === 'chat') {
+            if (typeof answer.answer !== 'string' || !answer.answer.trim()) {
+                return { ok: false, error: 'Custom answers must include text.' };
+            }
+            continue;
+        }
+        return { ok: false, error: 'Answer kind is not valid.' };
+    }
+    return { ok: true, answers };
+}
+export function cancelAskUserQuestion(input) {
+    const key = pendingKey(input.runId, input.toolCallId);
+    const pending = pendingQuestions.get(key);
+    if (!pending)
+        return { ok: false, status: 404, error: 'Question is no longer pending.' };
+    pending.send({
+        type: 'user_question_cancelled',
+        runId: input.runId,
+        toolCallId: input.toolCallId,
+        reason: input.reason ?? 'user_cancelled',
+    });
+    pending.resolve(cancelled(input.reason ?? 'user_cancelled'));
+    return { ok: true };
+}
+export function getPendingAskUserQuestionCount() {
+    return pendingQuestions.size;
+}
+//# sourceMappingURL=user-question-bridge.js.map

package/dist/agent/bridges/user-question-bridge.js.map

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

package/dist/agent/index.d.ts

@@ -6,16 +6,15 @@ export type MindosAgentDescriptor = {
 };
 export declare function defineMindosAgent(descriptor: MindosAgentDescriptor): MindosAgentDescriptor;
 export { MINDOS_SYSTEM_PROMPT, ORGANIZE_SYSTEM_PROMPT, MINDOS_AGENT_PROMPT_ASSET_PATH, MINDOS_AGENT_PROMPT_ASSET_URL, loadMindosAgentPrompt, type LoadMindosAgentPromptOptions, } from './prompt/index.js';
-export { MINDOS_AGENT_MANIFEST, buildMindosContextPrompt, buildMindosSystemPrompt, compactMindosPromptForTokenBudget, formatMindosAskTimeContext, type BuildMindosContextPromptInput, type BuildMindosContextPromptServices, type BuildMindosSystemPromptInput, type CompactMindosPromptOptions, type MindosAgentManifest, type MindosAskActiveRecallConfig, type MindosAskInitializationContext, type MindosAskPromptMessage, type MindosPromptSection, type MindosSystemPromptEnvironment, } from './prompt/index.js';
-export * from './run-ledger-types.js';
+export { MINDOS_AGENT_MANIFEST, buildMindosTurnContext, buildMindosContextPrompt, buildMindosSystemPrompt, compactMindosPromptForTokenBudget, formatMindosAskTimeContext, renderMindosContextPrompt, type BuildMindosContextPromptInput, type BuildMindosContextPromptServices, type BuildMindosSystemPromptInput, type CompactMindosPromptOptions, type MindosAgentManifest, type MindosAskActiveRecallConfig, type MindosAskInitializationContext, type MindosAskPromptMessage, type MindosContextPromptSection, type MindosPromptSection, type MindosSystemPromptEnvironment, type MindosTurnContext, } from './prompt/index.js';
+export { mindosSelectedSkillNames, normalizeMindosSelectedSkills, type MindosSelectedSkill, type MindosSelectedSkillSource, } from './selected-skills.js';
+export * from './ledger/index.js';
+export * from './bridges/index.js';
+export * from './stream/index.js';
+export * from './subagent/index.js';
 export * from './agent-run-context.js';
 export * from './result-reducer.js';
 export * from './global-state.js';
 export * from './redaction.js';
-export * from './run-ledger.js';
-export * from './run-timeline-events.js';
-export * from './run-cancellation.js';
-export * from './runtime-permission-bridge.js';
-export * from './user-question-bridge.js';
 export * from './tool/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC;CACrD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,qBAAqB,CAK1F;AAED,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,iCAAiC,EACjC,0BAA0B,EAC1B,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,GACnC,MAAM,mBAAmB,CAAC;AAE3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC;CACrD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,qBAAqB,CAK1F;AAED,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,iCAAiC,EACjC,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAE9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/agent/index.js

@@ -8,16 +8,15 @@ export function defineMindosAgent(descriptor) {
     return descriptor;
 }
 export { MINDOS_SYSTEM_PROMPT, ORGANIZE_SYSTEM_PROMPT, MINDOS_AGENT_PROMPT_ASSET_PATH, MINDOS_AGENT_PROMPT_ASSET_URL, loadMindosAgentPrompt, } from './prompt/index.js';
-export { MINDOS_AGENT_MANIFEST, buildMindosContextPrompt, buildMindosSystemPrompt, compactMindosPromptForTokenBudget, formatMindosAskTimeContext, } from './prompt/index.js';
-export * from './run-ledger-types.js';
+export { MINDOS_AGENT_MANIFEST, buildMindosTurnContext, buildMindosContextPrompt, buildMindosSystemPrompt, compactMindosPromptForTokenBudget, formatMindosAskTimeContext, renderMindosContextPrompt, } from './prompt/index.js';
+export { mindosSelectedSkillNames, normalizeMindosSelectedSkills, } from './selected-skills.js';
+export * from './ledger/index.js';
+export * from './bridges/index.js';
+export * from './stream/index.js';
+export * from './subagent/index.js';
 export * from './agent-run-context.js';
 export * from './result-reducer.js';
 export * from './global-state.js';
 export * from './redaction.js';
-export * from './run-ledger.js';
-export * from './run-timeline-events.js';
-export * from './run-cancellation.js';
-export * from './runtime-permission-bridge.js';
-export * from './user-question-bridge.js';
 export * from './tool/index.js';
 //# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,iBAAiB,CAAC,UAAiC;IACjE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,UAAU,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC3F,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,UAAU,CAAC,EAAE,uCAAuC,CAAC,CAAC;IACxH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,GAEtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,iCAAiC,EACjC,0BAA0B,GAW3B,MAAM,mBAAmB,CAAC;AAE3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,iBAAiB,CAAC,UAAiC;IACjE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,UAAU,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC3F,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,UAAU,CAAC,EAAE,uCAAuC,CAAC,CAAC;IACxH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,GAEtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,iCAAiC,EACjC,0BAA0B,EAC1B,yBAAyB,GAa1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAG9B,MAAM,sBAAsB,CAAC;AAE9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/agent/ledger/index.d.ts

@@ -0,0 +1,5 @@
+export * from './run-ledger-types.js';
+export * from './run-ledger.js';
+export * from './run-timeline-events.js';
+export * from './run-cancellation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/ledger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/ledger/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/agent/ledger/index.js

@@ -0,0 +1,5 @@
+export * from './run-ledger-types.js';
+export * from './run-ledger.js';
+export * from './run-timeline-events.js';
+export * from './run-cancellation.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/ledger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/ledger/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/agent/ledger/run-cancellation.d.ts

@@ -0,0 +1,13 @@
+export interface AgentRunCancelInput {
+    reason?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export type AgentRunCancelHandler = (input: AgentRunCancelInput) => Promise<void> | void;
+export declare function isAbortLikeError(error: unknown): boolean;
+export declare function abortErrorFromSignal(signal?: AbortSignal, fallback?: string): Error;
+export declare function registerAgentRunCancelHandler(runId: string, handler: AgentRunCancelHandler): () => void;
+export declare function cancelAgentRunWithHandlers(runId: string, input?: AgentRunCancelInput): Promise<void>;
+export declare function linkAbortSignalToAgentRun(runId: string, signal: AbortSignal | undefined, input?: AgentRunCancelInput): () => void;
+export declare function cancelAgentRunTree(rootRunId: string, input?: AgentRunCancelInput): Promise<void>;
+export declare function resetAgentRunCancellationForTest(): void;
+//# sourceMappingURL=run-cancellation.d.ts.map

package/dist/agent/ledger/run-cancellation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cancellation.d.ts","sourceRoot":"","sources":["../../../src/agent/ledger/run-cancellation.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAazF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAUxD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,SAA4B,GAAG,KAAK,CAOtG;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAWvG;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9G;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,GAAE,mBAAwB,GAC9B,MAAM,IAAI,CAiBZ;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1G;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/agent/ledger/run-cancellation.js

@@ -0,0 +1,97 @@
+/**
+ * Agent run cancellation: handler registry + abort-signal plumbing on top of
+ * the run ledger. Sunk from packages/web/lib/agent/run-cancellation.ts
+ * (spec-agent-core-consolidation Wave 2). The cancel API route resolves
+ * handlers registered by the streaming route, so the handler map is shared
+ * across module copies via global-state.
+ */
+import { cancelAgentRun, getAgentRun, listAgentRuns, } from './run-ledger.js';
+import { AGENT_RUN_CANCEL_HANDLERS_KEY, getProcessGlobal } from '../global-state.js';
+function getHandlers() {
+    return getProcessGlobal(AGENT_RUN_CANCEL_HANDLERS_KEY, () => new Map());
+}
+function isTerminal(record) {
+    return record?.status === 'completed'
+        || record?.status === 'failed'
+        || record?.status === 'canceled'
+        || record?.status === 'timed_out';
+}
+export function isAbortLikeError(error) {
+    if (!error)
+        return false;
+    if (typeof DOMException !== 'undefined' && error instanceof DOMException && error.name === 'AbortError')
+        return true;
+    if (error instanceof Error) {
+        return error.name === 'AbortError'
+            || error.message.toLowerCase().includes('aborted')
+            || error.message.toLowerCase().includes('cancelled')
+            || error.message.toLowerCase().includes('canceled');
+    }
+    return false;
+}
+export function abortErrorFromSignal(signal, fallback = 'Agent run was canceled.') {
+    const reason = signal?.reason;
+    if (reason instanceof Error)
+        return reason;
+    if (typeof DOMException !== 'undefined' && reason instanceof DOMException)
+        return new Error(reason.message);
+    const error = new Error(typeof reason === 'string' && reason ? reason : fallback);
+    error.name = 'AbortError';
+    return error;
+}
+export function registerAgentRunCancelHandler(runId, handler) {
+    const handlers = getHandlers();
+    const set = handlers.get(runId) ?? new Set();
+    set.add(handler);
+    handlers.set(runId, set);
+    return () => {
+        const current = handlers.get(runId);
+        if (!current)
+            return;
+        current.delete(handler);
+        if (current.size === 0)
+            handlers.delete(runId);
+    };
+}
+export async function cancelAgentRunWithHandlers(runId, input = {}) {
+    const record = getAgentRun(runId);
+    if (isTerminal(record))
+        return;
+    cancelAgentRun(runId, {
+        reason: input.reason ?? 'Agent run was canceled.',
+        metadata: {
+            ...input.metadata,
+            canceledBy: input.metadata?.canceledBy ?? 'signal',
+        },
+    });
+    const handlers = Array.from(getHandlers().get(runId) ?? []);
+    await Promise.allSettled(handlers.map(async (handler) => {
+        await handler(input);
+    }));
+}
+export function linkAbortSignalToAgentRun(runId, signal, input = {}) {
+    if (!signal)
+        return () => { };
+    const cancel = () => {
+        void cancelAgentRunWithHandlers(runId, {
+            reason: input.reason ?? abortErrorFromSignal(signal),
+            metadata: input.metadata,
+        });
+    };
+    if (signal.aborted) {
+        cancel();
+        return () => { };
+    }
+    signal.addEventListener('abort', cancel, { once: true });
+    return () => signal.removeEventListener('abort', cancel);
+}
+export async function cancelAgentRunTree(rootRunId, input = {}) {
+    const records = listAgentRuns({ limit: 500 })
+        .filter((record) => record.id === rootRunId || record.rootRunId === rootRunId || record.parentRunId === rootRunId)
+        .filter((record) => !isTerminal(record));
+    await Promise.allSettled(records.map((record) => cancelAgentRunWithHandlers(record.id, input)));
+}
+export function resetAgentRunCancellationForTest() {
+    getHandlers().clear();
+}
+//# sourceMappingURL=run-cancellation.js.map

package/dist/agent/ledger/run-cancellation.js.map

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