@0xmaxma/claude-gateway 1.8.14 → 2.0.1

package/dist/orchestration/control-delivery.d.ts

@@ -0,0 +1,5 @@
+import type { AgentConfig } from '../types';
+import type { ControlMenu } from './channel-controls';
+/** Provider adapters keep menus native; LINE replaces quick replies instead of editing old messages. */
+export declare function sendControlMenu(agent: AgentConfig, channel: string, chatId: string, menu: ControlMenu, meta: Record<string, string>, request?: typeof fetch): Promise<void>;
+//# sourceMappingURL=control-delivery.d.ts.map

package/dist/orchestration/control-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-delivery.d.ts","sourceRoot":"","sources":["../../src/orchestration/control-delivery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wGAAwG;AACxG,wBAAsB,eAAe,CAAC,KAAK,EAAC,WAAW,EAAC,OAAO,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,IAAI,EAAC,WAAW,EAAC,IAAI,EAAC,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,EAAC,OAAO,GAAC,OAAO,KAAW,GAAE,OAAO,CAAC,IAAI,CAAC,CAwBzK"}

package/dist/orchestration/control-delivery.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendControlMenu = sendControlMenu;
+const line_pure_1 = require("../agent/line-pure");
+const line_request_order_1 = require("../shared/line-request-order");
+/** Provider adapters keep menus native; LINE replaces quick replies instead of editing old messages. */
+async function sendControlMenu(agent, channel, chatId, menu, meta, request = fetch) {
+    const call = async (url, body, headers, method = 'POST') => {
+        const send = () => request(url, { method, headers: { 'Content-Type': 'application/json', ...headers }, body: JSON.stringify(body), signal: AbortSignal.timeout(15000) });
+        const response = await (channel === 'line' ? (0, line_request_order_1.orderLineRequest)(agent.id, chatId, send) : send());
+        if (!response.ok)
+            throw Object.assign(Error('CONTROL_DELIVERY_FAILED'), { status: response.status });
+        const result = await response.json();
+        if (result.ok === false)
+            throw Error('CONTROL_DELIVERY_FAILED');
+    };
+    const buttons = menu.buttons;
+    if (channel === 'discord' && agent.discord?.botToken) {
+        const components = [];
+        for (let i = 0; i < buttons.length; i += 5)
+            components.push({ type: 1, components: buttons.slice(i, i + 5).map(b => ({ type: 2, style: 2, label: b.label.slice(0, 80), custom_id: b.data })) });
+        await call(`https://discord.com/api/v10/channels/${encodeURIComponent(chatId)}/messages${meta.control_message_id ? '/' + encodeURIComponent(meta.control_message_id) : ''}`, { content: menu.text.slice(0, 1950), components, allowed_mentions: { parse: [] } }, { Authorization: `Bot ${agent.discord.botToken}` }, meta.control_message_id ? 'PATCH' : 'POST');
+    }
+    else if (channel === 'slack' && agent.slack?.botToken) {
+        const blocks = [{ type: 'section', text: { type: 'plain_text', text: menu.text.slice(0, 2900) } }];
+        for (let i = 0; i < buttons.length; i += 5)
+            blocks.push({ type: 'actions', elements: buttons.slice(i, i + 5).map(b => ({ type: 'button', text: { type: 'plain_text', text: b.label.slice(0, 75) }, action_id: b.data, value: b.data })) });
+        await call(`https://slack.com/api/${meta.control_message_id ? 'chat.update' : 'chat.postMessage'}`, { channel: chatId, text: menu.text.slice(0, 2900), blocks, mrkdwn: false, ...(meta.control_message_id ? { ts: meta.control_message_id } : meta.thread_ts ? { thread_ts: meta.thread_ts } : {}) }, { Authorization: `Bearer ${agent.slack.botToken}` });
+    }
+    else if (channel === 'line' && agent.line?.channelAccessToken) {
+        if (buttons.length > 13)
+            throw Error('TOO_MANY_QUICK_REPLIES');
+        const message = { type: 'text', text: (0, line_pure_1.stripMarkdownPreservingUrls)(menu.text).slice(0, 4900), ...(buttons.length ? { quickReply: { items: buttons.map(b => ({ type: 'action', action: { type: 'postback', label: b.label.slice(0, 20), data: b.data } })) } } : {}) };
+        const headers = { Authorization: `Bearer ${agent.line.channelAccessToken}` };
+        if (meta.reply_token) {
+            try {
+                await call('https://api.line.me/v2/bot/message/reply', { replyToken: meta.reply_token, messages: [message] }, headers);
+                return;
+            }
+            catch (error) {
+                if (error.status !== 400)
+                    throw error; /* expired reply tokens fall back to push */
+            }
+        }
+        await call('https://api.line.me/v2/bot/message/push', { to: chatId, messages: [message] }, headers);
+    }
+    else
+        throw Error('CONTROL_DELIVERY_NOT_CONFIGURED');
+}
+//# sourceMappingURL=control-delivery.js.map

package/dist/orchestration/control-delivery.js.map

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

package/dist/orchestration/conversation-intake.d.ts

@@ -0,0 +1,32 @@
+import { OrchestrationStore } from './store';
+import { CommandContext } from './types';
+export interface IntakeChoice {
+    mode: 'ready' | 'wait' | 'update';
+    acknowledgement?: string;
+    preparation?: string;
+    clarification?: string;
+    task_id?: string;
+}
+export declare const INTAKE_OVERLAY = "Use conversation_intake only for executable work, incomplete materials, or amendments to an existing task. Greetings, introductions, casual conversation and questions you can answer directly need one normal answer: do not call conversation_intake or emit a separate acknowledgement for them.\nBefore any work mutation, use conversation_intake to decide how to handle the user's latest input together with pending materials and current tasks.\nready: the requested executable action and required material are complete. Supply a brief, specific acknowledgement addressed directly to the user, in their language and your existing persona. This text is immediately displayed and spoken to the user; it is not a private classification, instruction to yourself, or reasoning field. Do not add a waiting period.\nwait: the user is supplying materials without an action, promises an attachment that has not arrived, or says the instruction will follow. Inspect available images now. Preserve useful facts in preparation, clearly distinguishing observed contents from instructions. Supply one short clarification to ask only if no further input arrives for the configured intake wait interval. Do not speculate about unavailable link contents. End this turn without user-facing text; the gateway owns the waiting timer. Each new item will be read as it arrives.\nupdate: the user changes or supplements a specific existing task. Supply its exact task_id and acknowledge the change; use task_update/task_answer, not an independent duplicate. If the target is ambiguous, ask a precise question instead of guessing.\nNever create work merely to acknowledge material. A complete instruction arriving after materials is ready now; do not request another waiting interval. Preserve all unchanged requirements and refer to the original input/attachment IDs. Urgent stop or prohibition may call task_cancel before acknowledgement; do not delay fencing unsafe work for speech playback.";
+/** Durable preparation is scoped by conversation AND authenticated principal.
+ * Source inputs remain canonical; this cache only supplements their full contents. */
+export declare class ConversationIntake {
+    private store;
+    constructor(store: OrchestrationStore);
+    context(conversationId: string, principalId: string, bindingId?: string): any;
+    touch(inputId: string): void;
+    /** A direct answer can consume preparation from an older decision. Never
+     * discard newer material or another binding's pending context. */
+    consume(inputId: string): void;
+    choose(context: CommandContext, choice: IntakeChoice): {
+        acknowledgement: string;
+        clarification: string;
+        preparation: string;
+        inputIds: string[];
+        preparedInputSeq: string | number | null;
+        mode: "ready" | "wait" | "update";
+        task_id?: string;
+    };
+    due(waitMs?: number, now?: number): import("./store").Row[];
+}
+//# sourceMappingURL=conversation-intake.d.ts.map

package/dist/orchestration/conversation-intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-intake.d.ts","sourceRoot":"","sources":["../../src/orchestration/conversation-intake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAe,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,eAAO,MAAM,cAAc,o7DAKgV,CAAC;AAE5W;sFACsF;AACtF,qBAAa,kBAAkB;IACjB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,kBAAkB;IAQ7C,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAMvE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B;sEACkE;IAClE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9B,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY;;;;;;cA7C9C,OAAO,GAAG,MAAM,GAAG,QAAQ;kBAIvB,MAAM;;IAqEhB,GAAG,CAAC,MAAM,SAAO,EAAE,GAAG,SAAa;CAUpC"}

package/dist/orchestration/conversation-intake.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationIntake = exports.INTAKE_OVERLAY = void 0;
+const store_1 = require("./store");
+const types_1 = require("./types");
+exports.INTAKE_OVERLAY = `Use conversation_intake only for executable work, incomplete materials, or amendments to an existing task. Greetings, introductions, casual conversation and questions you can answer directly need one normal answer: do not call conversation_intake or emit a separate acknowledgement for them.
+Before any work mutation, use conversation_intake to decide how to handle the user's latest input together with pending materials and current tasks.
+ready: the requested executable action and required material are complete. Supply a brief, specific acknowledgement addressed directly to the user, in their language and your existing persona. This text is immediately displayed and spoken to the user; it is not a private classification, instruction to yourself, or reasoning field. Do not add a waiting period.
+wait: the user is supplying materials without an action, promises an attachment that has not arrived, or says the instruction will follow. Inspect available images now. Preserve useful facts in preparation, clearly distinguishing observed contents from instructions. Supply one short clarification to ask only if no further input arrives for the configured intake wait interval. Do not speculate about unavailable link contents. End this turn without user-facing text; the gateway owns the waiting timer. Each new item will be read as it arrives.
+update: the user changes or supplements a specific existing task. Supply its exact task_id and acknowledge the change; use task_update/task_answer, not an independent duplicate. If the target is ambiguous, ask a precise question instead of guessing.
+Never create work merely to acknowledge material. A complete instruction arriving after materials is ready now; do not request another waiting interval. Preserve all unchanged requirements and refer to the original input/attachment IDs. Urgent stop or prohibition may call task_cancel before acknowledgement; do not delay fencing unsafe work for speech playback.`;
+/** Durable preparation is scoped by conversation AND authenticated principal.
+ * Source inputs remain canonical; this cache only supplements their full contents. */
+class ConversationIntake {
+    constructor(store) {
+        this.store = store;
+        store.run(`CREATE TABLE IF NOT EXISTS conversation_intake (
+      conversation_id TEXT NOT NULL REFERENCES conversations(id), principal_id TEXT NOT NULL,
+      binding_id TEXT NOT NULL, mode TEXT NOT NULL, data_json TEXT NOT NULL,
+      latest_input_seq INTEGER NOT NULL, last_received_at INTEGER NOT NULL,
+      clarified_seq INTEGER, decision_id TEXT NOT NULL,
+      PRIMARY KEY(conversation_id,principal_id))`);
+    }
+    context(conversationId, principalId, bindingId) {
+        this.store.assertMember(conversationId, principalId);
+        const row = this.store.get('SELECT * FROM conversation_intake WHERE conversation_id=? AND principal_id=?', conversationId, principalId);
+        if (row && bindingId !== undefined && row.binding_id !== bindingId)
+            return undefined;
+        return row ? { ...JSON.parse(String(row.data_json)), mode: row.mode, latestInputSeq: row.latest_input_seq } : undefined;
+    }
+    touch(inputId) {
+        const input = this.store.get('SELECT * FROM conversation_inputs WHERE id=?', inputId);
+        if (!input || !input.store_user_message)
+            return;
+        this.store.run(`UPDATE conversation_intake SET latest_input_seq=?,last_received_at=?
+      WHERE conversation_id=? AND principal_id=? AND binding_id=? AND latest_input_seq<?`, input.input_seq, input.created_at, input.conversation_id, input.principal_id, input.binding_id, input.input_seq);
+    }
+    /** A direct answer can consume preparation from an older decision. Never
+     * discard newer material or another binding's pending context. */
+    consume(inputId) {
+        const input = this.store.get('SELECT * FROM conversation_inputs WHERE id=?', inputId);
+        if (!input)
+            throw new types_1.OrchestrationError('INPUT_NOT_FOUND');
+        this.store.run(`DELETE FROM conversation_intake WHERE conversation_id=? AND principal_id=?
+      AND binding_id=? AND latest_input_seq<=?`, input.conversation_id, input.principal_id, input.binding_id, input.input_seq);
+    }
+    choose(context, choice) {
+        this.store.assertMember(context.conversationId, context.principalId);
+        const decision = this.store.get("SELECT * FROM conversation_decisions WHERE id=? AND conversation_id=? AND epoch=? AND state='running'", context.decisionId, context.conversationId, context.epoch);
+        const input = this.store.get('SELECT * FROM conversation_inputs WHERE id=? AND conversation_id=? AND principal_id=?', context.inputId, context.conversationId, context.principalId);
+        if (!decision || !input)
+            throw new types_1.OrchestrationError('STALE_DECISION');
+        if (!['ready', 'wait', 'update'].includes(choice.mode))
+            throw new types_1.OrchestrationError('INVALID_INPUT');
+        const acknowledgement = choice.mode !== 'wait' ? (0, store_1.boundedText)(choice.acknowledgement ?? '', 600) : '';
+        const clarification = choice.mode === 'wait' ? (0, store_1.boundedText)(choice.clarification ?? '', 600) : '';
+        if ((choice.mode !== 'wait' && !acknowledgement.trim()) || (choice.mode === 'wait' && !clarification.trim()))
+            throw new types_1.OrchestrationError('INTAKE_MESSAGE_REQUIRED');
+        const preparation = choice.preparation?.trim() ? (0, store_1.boundedText)(choice.preparation, 12000) : '';
+        if (choice.mode === 'update') {
+            const task = choice.task_id && this.store.task(choice.task_id);
+            if (!task || task.conversationId !== context.conversationId || ['completed', 'failed', 'cancelled'].includes(task.state))
+                throw new types_1.OrchestrationError('INTAKE_TASK_UNAVAILABLE');
+        }
+        if (choice.mode === 'wait' && this.store.get("SELECT action_id FROM task_commands WHERE decision_id=? AND command_type IN ('spawn','update','answer')", context.decisionId))
+            throw new types_1.OrchestrationError('INTAKE_AFTER_EXECUTION');
+        const previousRow = this.store.get('SELECT binding_id,data_json FROM conversation_intake WHERE conversation_id=? AND principal_id=?', context.conversationId, context.principalId);
+        const previous = previousRow?.binding_id === input.binding_id ? JSON.parse(String(previousRow.data_json)) : undefined;
+        const inputIds = [...new Set([...(previous?.inputIds ?? []), context.inputId])];
+        if (inputIds.length > 100)
+            throw new types_1.OrchestrationError('INTAKE_TOO_MANY_INPUTS');
+        const data = { ...choice, acknowledgement, clarification, preparation, inputIds, preparedInputSeq: input.input_seq };
+        this.store.run(`INSERT INTO conversation_intake (conversation_id,principal_id,binding_id,mode,data_json,
+      latest_input_seq,last_received_at,clarified_seq,decision_id) VALUES(?,?,?,?,?,?,?,?,?)
+      ON CONFLICT(conversation_id,principal_id) DO UPDATE SET binding_id=excluded.binding_id,mode=excluded.mode,data_json=excluded.data_json,
+      latest_input_seq=MAX(conversation_intake.latest_input_seq,excluded.latest_input_seq),
+      last_received_at=MAX(conversation_intake.last_received_at,excluded.last_received_at),decision_id=excluded.decision_id`, context.conversationId, context.principalId, input.binding_id, choice.mode, JSON.stringify(data), input.input_seq, input.created_at, null, context.decisionId);
+        return data;
+    }
+    due(waitMs = 2000, now = Date.now()) {
+        return this.store.all(`SELECT p.* FROM conversation_intake p WHERE p.mode='wait' AND p.last_received_at+?<=?
+      AND (p.clarified_seq IS NULL OR p.clarified_seq<p.latest_input_seq)
+      AND json_extract(p.data_json,'$.preparedInputSeq')=p.latest_input_seq
+      AND EXISTS(SELECT 1 FROM conversation_members m WHERE m.conversation_id=p.conversation_id AND m.principal_id=p.principal_id)
+      AND EXISTS(SELECT 1 FROM conversations c WHERE c.id=p.conversation_id AND c.status='active')
+      AND EXISTS(SELECT 1 FROM conversation_decisions d WHERE d.id=p.decision_id AND d.state='completed')
+      AND NOT EXISTS(SELECT 1 FROM conversation_decisions d WHERE d.conversation_id=p.conversation_id AND d.state IN ('running','interrupting'))
+      AND NOT EXISTS(SELECT 1 FROM conversation_inputs i WHERE i.conversation_id=p.conversation_id AND i.status IN ('accepted','assigned'))`, waitMs, now);
+    }
+}
+exports.ConversationIntake = ConversationIntake;
+//# sourceMappingURL=conversation-intake.js.map

package/dist/orchestration/conversation-intake.js.map

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

package/dist/orchestration/decisions.d.ts

@@ -0,0 +1,27 @@
+import { OrchestrationStore } from './store';
+export interface DecisionReceipt {
+    decisionId: string;
+    epoch: number;
+    inputIds: string[];
+    requestId?: string;
+    responseId?: string;
+}
+export declare class DecisionService {
+    readonly store: OrchestrationStore;
+    private readonly deliver?;
+    constructor(store: OrchestrationStore, deliver?: ((responseId: string, bindingId: string, text: string) => void) | undefined);
+    /** Deterministic system notice: no inference, input consumption, or epoch change. */
+    notice(conversationId: string, text: string, deliver: boolean, inputId?: string): string;
+    begin(conversationId: string, principalId: string, inputIds: string[], requestId?: string): DecisionReceipt;
+    /** Independent durable receipt: task execution still belongs to the original
+     * running decision. This completed notice never consumes result notifications. */
+    acknowledge(receipt: DecisionReceipt, text: string, spoken?: string, allowCompleted?: boolean): string;
+    /** Explicit stop controls acknowledge cancellation themselves; retain history without redelivering. */
+    finish(receipt: DecisionReceipt, text: string, state?: 'completed' | 'interrupted' | 'failed', spoken?: string, deliver?: boolean): string;
+    /** Invalidate commands before asking the driver to stop. Caller must wait for
+     * its true terminal/exit acknowledgment before releaseInterrupted. */
+    interrupt(receipt: DecisionReceipt): void;
+    releaseInterrupted(receipt: DecisionReceipt, explicitStop: boolean): void;
+    private historyOperation;
+}
+//# sourceMappingURL=decisions.d.ts.map

package/dist/orchestration/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/orchestration/decisions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7C,MAAM,WAAW,eAAe;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAAE;AACpI,qBAAa,eAAe;IACd,QAAQ,CAAC,KAAK,EAAE,kBAAkB;IAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAApD,KAAK,EAAE,kBAAkB,EAAmB,OAAO,CAAC,GAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,aAAA;IACxI,qFAAqF;IACrF,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAgBxF,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IAwB3G;sFACkF;IAClF,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,MAAM;IAqBpG,uGAAuG;IACvG,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,WAAW,GAAG,aAAa,GAAG,QAAsB,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,MAAM;IA8BpJ;0EACsE;IACtE,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAOzC,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI;IASzE,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/orchestration/decisions.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionService = void 0;
+const crypto_1 = require("crypto");
+const types_1 = require("./types");
+class DecisionService {
+    constructor(store, deliver) {
+        this.store = store;
+        this.deliver = deliver;
+    }
+    /** Deterministic system notice: no inference, input consumption, or epoch change. */
+    notice(conversationId, text, deliver, inputId) {
+        return this.store.transaction(() => {
+            const conversation = this.store.get("SELECT * FROM conversations WHERE id=? AND status='active'", conversationId);
+            if (!conversation)
+                throw new types_1.OrchestrationError('CONVERSATION_NOT_FOUND');
+            const input = inputId ? this.store.get('SELECT * FROM conversation_inputs WHERE id=? AND conversation_id=?', inputId, conversationId) : undefined;
+            if (inputId && !input)
+                throw new types_1.OrchestrationError('INPUT_NOT_FOUND');
+            const id = (0, crypto_1.randomUUID)(), responseId = (0, crypto_1.randomUUID)(), now = Date.now();
+            this.store.run('INSERT INTO conversation_decisions VALUES(?,?,?,?,?,?,?,?,?,?,?)', id, conversationId, conversation.epoch, 'notice', input?.request_id ?? null, 'completed', conversation.agent_session_id, JSON.stringify(inputId ? [inputId] : []), '[]', now, now);
+            this.store.run('INSERT INTO assistant_responses VALUES(?,?,?,?,?,?,?,?)', responseId, conversationId, id, input?.request_id ?? null, 'completed', text, now, now);
+            this.historyOperation(`response:${responseId}`, conversationId, null, responseId);
+            const binding = this.store.get('SELECT * FROM conversation_bindings WHERE conversation_id=? AND channel=? AND chat_id=? AND thread_key=?', conversationId, conversation.source, conversation.chat_id, conversation.thread_key);
+            if (deliver && binding && binding.channel !== 'api')
+                this.deliver?.(responseId, String(binding.id), text);
+            this.store.appendEvent(conversationId, 'response.completed', { responseId });
+            return responseId;
+        });
+    }
+    begin(conversationId, principalId, inputIds, requestId) {
+        if (!inputIds.length || inputIds.length > 100 || new Set(inputIds).size !== inputIds.length)
+            throw new types_1.OrchestrationError('INVALID_INPUT');
+        return this.store.transaction(() => {
+            const conversation = this.store.assertMember(conversationId, principalId);
+            if (this.store.get("SELECT id FROM conversation_decisions WHERE conversation_id=? AND state IN ('running','interrupting')", conversationId))
+                throw new types_1.OrchestrationError('AGENT_BUSY');
+            for (const inputId of inputIds) {
+                const input = this.store.get('SELECT * FROM conversation_inputs WHERE id=? AND conversation_id=? AND principal_id=?', inputId, conversationId, principalId);
+                if (!input || input.status !== 'accepted' || (input.request_id ?? undefined) !== requestId)
+                    throw new types_1.OrchestrationError('INPUT_CONFLICT');
+            }
+            const decisionId = (0, crypto_1.randomUUID)(), epoch = Number(conversation.epoch) + 1;
+            this.store.run('UPDATE conversations SET epoch=? WHERE id=?', epoch, conversationId);
+            const notifications = this.store.all("SELECT id FROM notifications WHERE conversation_id=? AND status='pending' ORDER BY id LIMIT 100", conversationId).map(row => String(row.id));
+            this.store.run('INSERT INTO conversation_decisions VALUES(?,?,?,?,?,?,?,?,?,?,?)', decisionId, conversationId, epoch, 'user', requestId ?? null, 'running', conversation.agent_session_id, JSON.stringify(inputIds), JSON.stringify(notifications), Date.now(), null);
+            const responseId = (0, crypto_1.randomUUID)();
+            this.store.run('INSERT INTO assistant_responses VALUES(?,?,?,?,?,?,?,?)', responseId, conversationId, decisionId, requestId ?? null, 'generating', '', Date.now(), null);
+            for (const inputId of inputIds) {
+                this.store.run("UPDATE conversation_inputs SET status='assigned' WHERE id=?", inputId);
+                this.store.run("UPDATE outbox SET state='completed' WHERE dedup_key=? AND kind='input'", `input:${inputId}`);
+            }
+            for (const id of notifications)
+                this.store.run("UPDATE notifications SET status='assigned',decision_id=? WHERE id=?", decisionId, id);
+            return { decisionId, epoch, inputIds, requestId, responseId };
+        });
+    }
+    /** Independent durable receipt: task execution still belongs to the original
+     * running decision. This completed notice never consumes result notifications. */
+    acknowledge(receipt, text, spoken, allowCompleted = false) {
+        if (!text.trim() || Buffer.byteLength(text) > 2400)
+            throw new types_1.OrchestrationError('INVALID_INPUT');
+        return this.store.transaction(() => {
+            const current = this.store.get("SELECT * FROM conversation_decisions WHERE id=? AND epoch=? AND (state='running' OR (? AND state='completed'))", receipt.decisionId, receipt.epoch, allowCompleted ? 1 : 0);
+            if (!current)
+                throw new types_1.OrchestrationError('STALE_DECISION');
+            const ackDecisionId = `ack:${receipt.decisionId}`, previous = this.store.get('SELECT id FROM assistant_responses WHERE decision_id=?', ackDecisionId);
+            if (previous)
+                return String(previous.id);
+            const now = Date.now(), id = (0, crypto_1.randomUUID)();
+            this.store.run('INSERT INTO conversation_decisions VALUES(?,?,?,?,?,?,?,?,?,?,?)', ackDecisionId, current.conversation_id, current.epoch, 'acknowledgement', null, 'completed', current.session_id, current.input_ids_json, '[]', now, now);
+            this.store.run('INSERT INTO assistant_responses VALUES(?,?,?,?,?,?,?,?)', id, current.conversation_id, ackDecisionId, null, 'completed', text, now, now);
+            for (const inputId of receipt.inputIds)
+                this.historyOperation(`input:${inputId}`, String(current.conversation_id), inputId, null);
+            this.historyOperation(`response:${id}`, String(current.conversation_id), null, id);
+            if (spoken)
+                this.store.run('INSERT INTO response_speech VALUES(?,?)', id, spoken);
+            const input = this.store.get('SELECT binding_id FROM conversation_inputs WHERE id=?', receipt.inputIds[0]);
+            const binding = input && this.store.get('SELECT channel FROM conversation_bindings WHERE id=?', input.binding_id);
+            if (binding && binding.channel !== 'api')
+                this.deliver?.(id, String(input.binding_id), text);
+            this.store.appendEvent(String(current.conversation_id), 'response.completed', { responseId: id });
+            return id;
+        });
+    }
+    /** Explicit stop controls acknowledge cancellation themselves; retain history without redelivering. */
+    finish(receipt, text, state = 'completed', spoken, deliver = true) {
+        if (Buffer.byteLength(text) > 262144)
+            throw new types_1.OrchestrationError('PAYLOAD_TOO_LARGE');
+        return this.store.transaction(() => {
+            const decision = this.store.get(`SELECT d.* FROM conversation_decisions d JOIN conversations c ON c.id=d.conversation_id
+        WHERE d.id=? AND d.epoch=? AND ((d.epoch=c.epoch AND d.state='running') OR (d.epoch+1=c.epoch AND d.state='interrupting' AND ?='interrupted'))`, receipt.decisionId, receipt.epoch, state);
+            if (!decision)
+                throw new types_1.OrchestrationError('STALE_DECISION');
+            const now = Date.now(), responseId = String(this.store.get('SELECT id FROM assistant_responses WHERE decision_id=?', receipt.decisionId).id);
+            this.store.run('UPDATE assistant_responses SET state=?,generated_text=?,completed_at=? WHERE id=?', state, text, now, responseId);
+            this.store.run('UPDATE conversation_decisions SET state=?,ended_at=? WHERE id=?', state, now, receipt.decisionId);
+            for (const id of JSON.parse(String(decision.input_ids_json))) {
+                this.store.run("UPDATE conversation_inputs SET status='handled' WHERE id=?", id);
+                this.historyOperation(`input:${id}`, String(decision.conversation_id), id, null);
+            }
+            this.historyOperation(`response:${responseId}`, String(decision.conversation_id), null, responseId);
+            if (state === 'completed' && text.trim())
+                this.store.run(`UPDATE task_files SET response_id=? WHERE response_id IS NULL AND task_id IN
+        (SELECT n.task_id FROM notifications n JOIN tasks t ON t.id=n.task_id WHERE n.decision_id=? AND t.state='completed')
+        AND id IN (SELECT j.value FROM tasks t,json_each(t.snapshot_json,'$.result.artifactIds') j WHERE t.id=task_files.task_id)`, responseId, receipt.decisionId);
+            if (state === 'completed' && spoken)
+                this.store.run('INSERT INTO response_speech VALUES(?,?) ON CONFLICT(response_id) DO UPDATE SET text=excluded.text', responseId, spoken);
+            const firstInput = this.store.get('SELECT binding_id FROM conversation_inputs WHERE id=?', receipt.inputIds[0]);
+            const binding = firstInput && this.store.get('SELECT channel FROM conversation_bindings WHERE id=?', firstInput.binding_id);
+            if (deliver && binding && binding.channel !== 'api')
+                this.deliver?.(responseId, String(firstInput.binding_id), text);
+            if (state === 'completed')
+                this.store.run("UPDATE notifications SET status='handled' WHERE decision_id=? AND status='assigned'", receipt.decisionId);
+            else
+                this.store.run("UPDATE notifications SET status='pending',decision_id=NULL WHERE decision_id=? AND status='assigned'", receipt.decisionId);
+            for (const id of state === 'completed' ? JSON.parse(String(decision.notification_ids_json)) : []) {
+                this.store.run("UPDATE outbox SET state='completed' WHERE kind='notification' AND json_extract(payload_json,'$.notificationId')=?", id);
+            }
+            this.store.appendEvent(String(decision.conversation_id), `response.${state}`, { responseId });
+            return responseId;
+        });
+    }
+    /** Invalidate commands before asking the driver to stop. Caller must wait for
+     * its true terminal/exit acknowledgment before releaseInterrupted. */
+    interrupt(receipt) {
+        this.store.transaction(() => {
+            const row = this.store.get("UPDATE conversation_decisions SET state='interrupting' WHERE id=? AND epoch=? AND state='running' RETURNING conversation_id", receipt.decisionId, receipt.epoch);
+            if (!row)
+                throw new types_1.OrchestrationError('STALE_DECISION');
+            this.store.run('UPDATE conversations SET epoch=epoch+1 WHERE id=? AND epoch=?', row.conversation_id, receipt.epoch);
+        });
+    }
+    releaseInterrupted(receipt, explicitStop) {
+        this.store.transaction(() => {
+            const row = this.store.get("SELECT * FROM conversation_decisions WHERE id=? AND epoch=? AND state='interrupting'", receipt.decisionId, receipt.epoch);
+            if (!row)
+                throw new types_1.OrchestrationError('STALE_DECISION');
+            this.store.run("UPDATE conversation_decisions SET state='interrupted',ended_at=? WHERE id=?", Date.now(), receipt.decisionId);
+            for (const id of JSON.parse(String(row.input_ids_json)))
+                this.store.run('UPDATE conversation_inputs SET status=? WHERE id=?', explicitStop ? 'handled' : 'accepted', id);
+            this.store.run("UPDATE notifications SET status='pending',decision_id=NULL WHERE decision_id=? AND status='assigned'", receipt.decisionId);
+        });
+    }
+    historyOperation(operationId, conversationId, inputId, responseId) {
+        this.store.run('INSERT INTO history_operations VALUES(?,?,?,?,?,?,?,?) ON CONFLICT(operation_id) DO NOTHING', operationId, conversationId, inputId, responseId, 'append', null, 'pending', Date.now());
+        this.store.enqueue('history', operationId, { operationId });
+    }
+}
+exports.DecisionService = DecisionService;
+//# sourceMappingURL=decisions.js.map

package/dist/orchestration/decisions.js.map

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

package/dist/orchestration/delivery.d.ts

@@ -0,0 +1,34 @@
+import { SpeechDelivery } from './telegram-speech';
+import type { AgentConfig } from '../types';
+import { OrchestrationStore, Row } from './store';
+import { ChannelFile } from './file-delivery';
+export type DeliveryOutcome = {
+    state: 'delivered';
+    providerId?: string;
+} | {
+    state: 'failed' | 'unknown';
+    code: string;
+    speechSynthesisFailed?: boolean;
+};
+export type DeliveryControl = {
+    label: string;
+    data: string;
+};
+export type ChannelSender = (binding: Row, text: string, deliveryId: string, file?: ChannelFile, speech?: SpeechDelivery, textFormat?: 'HTML' | 'text', controls?: DeliveryControl[]) => Promise<DeliveryOutcome>;
+/** A transport receipt means provider acceptance, never that a human read it.
+ * Ambiguous network failures are retained for reconciliation, not blind retry. */
+export declare function channelSender(config: AgentConfig | (() => AgentConfig), request?: typeof fetch, speechEnabled?: (binding: Row, speech: SpeechDelivery) => boolean, linkedSender?: ChannelSender): ChannelSender;
+/** Channel notices share one provider-independent vocabulary; details stay in logs. */
+export declare function speechFailureNotice(code: string): string;
+export declare class DeliveryOutbox {
+    private readonly store;
+    private readonly send;
+    private active?;
+    constructor(store: OrchestrationStore, send: ChannelSender);
+    /** Called inside the decision commit transaction. Each chunk has its own receipt. */
+    enqueue(responseId: string, bindingId: string, text: string, controls?: DeliveryControl[]): void;
+    enqueueSpeech(responseId: string, bindingId: string, speech: SpeechDelivery): void;
+    tick(): Promise<void>;
+    private run;
+}
+//# sourceMappingURL=delivery.d.ts.map

package/dist/orchestration/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/orchestration/delivery.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAmB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAC3J,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAElN;kFACkF;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,EAAE,OAAO,GAAE,OAAO,KAAa,EAAE,aAAa,GAAE,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,KAAK,OAAoB,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,aAAa,CA2DlO;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBxD;AAED,qBAAa,cAAc;IAEb,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAsB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAD7E,OAAO,CAAC,MAAM,CAAC,CAAgB;gBACF,KAAK,EAAE,kBAAkB,EAAmB,IAAI,EAAE,aAAa;IAC5F,qFAAqF;IACrF,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI;IA4BhG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAQlF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAKP,GAAG;CAyDlB"}