@0xmaxma/claude-gateway 1.8.14 → 2.0.1

package/dist/orchestration/task-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-files.d.ts","sourceRoot":"","sources":["../../src/orchestration/task-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAA4B,MAAM,SAAS,CAAC;AAMvE,qBAAa,SAAS;IACR,QAAQ,CAAC,KAAK,EAAE,kBAAkB;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM;IAAE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAAU,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAA5H,KAAK,EAAE,kBAAkB,EAAW,UAAU,EAAE,MAAM,EAAmB,cAAc,CAAC,EAAE,MAAM,YAAA,EAAmB,SAAS,SAA+C;IAChM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IAEpE,oFAAoF;IACpF,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAiCxE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOxC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;;;;;IAU3C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM;IAsB9E,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IA2B5F,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;CAsBhG"}

package/dist/orchestration/task-files.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskFiles = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+const store_1 = require("./store");
+const types_1 = require("./types");
+const media_1 = require("./media");
+const media_store_1 = require("../history/media-store");
+const share_store_1 = require("../share/share-store");
+class TaskFiles {
+    constructor(store, agentsRoot, containerSpool, workspace = (0, path_1.join)(agentsRoot, store.agentId, 'workspace')) {
+        this.store = store;
+        this.agentsRoot = agentsRoot;
+        this.containerSpool = containerSpool;
+        this.workspace = workspace;
+        this.capturedImages = new Map();
+        this.pendingImageTools = new Map();
+    }
+    /** Capture actual MCP image bytes, never model-authored paths or assistant text. */
+    captureOutput(attemptId, generation, line) {
+        if (this.containerSpool)
+            return; // Container output must use the container import boundary.
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        const blocks = event.message?.content;
+        if (!Array.isArray(blocks))
+            return;
+        const pending = this.pendingImageTools.get(attemptId) ?? new Set();
+        this.pendingImageTools.set(attemptId, pending);
+        for (const block of blocks) {
+            if (event.type === 'assistant' && block.type === 'tool_use' && typeof block.name === 'string' && block.name.startsWith('mcp__') && typeof block.id === 'string')
+                pending.add(block.id);
+            if (event.type !== 'user' || block.type !== 'tool_result' || !pending.delete(block.tool_use_id) || block.is_error || !Array.isArray(block.content))
+                continue;
+            const image = block.content.find((item) => item.type === 'image');
+            const data = image?.source?.type === 'base64' ? image.source.data : image?.data;
+            if (typeof data !== 'string' || data.length > 28 * 1024 * 1024 || !/^[A-Za-z0-9+/]*={0,2}$/.test(data))
+                continue;
+            const bytes = Buffer.from(data, 'base64');
+            const mime = (0, share_store_1.detectImageMime)(bytes.subarray(0, 12));
+            if (!mime || !bytes.length || bytes.length > 20 * 1024 * 1024)
+                continue;
+            const { mediaDir } = this.scope(attemptId, generation);
+            const images = this.capturedImages.get(attemptId) ?? new Map();
+            if (images.has(block.tool_use_id))
+                continue;
+            if (images.size >= 20) {
+                const oldest = images.entries().next().value;
+                try {
+                    (0, fs_1.unlinkSync)(oldest[1]);
+                }
+                catch { /* already removed */ }
+                images.delete(oldest[0]);
+            }
+            (0, fs_1.mkdirSync)(mediaDir, { recursive: true, mode: 0o700 });
+            const suffix = mime === 'image/png' ? '.png' : mime === 'image/jpeg' ? '.jpg' : mime === 'image/webp' ? '.webp' : '.gif';
+            const file = (0, path_1.join)(mediaDir, `mcp-image-${(0, crypto_1.randomUUID)()}${suffix}`);
+            (0, fs_1.writeFileSync)(file, bytes, { flag: 'wx', mode: 0o600 });
+            images.set(block.tool_use_id, file);
+            this.capturedImages.set(attemptId, images);
+        }
+    }
+    releaseCaptured(attemptId) {
+        this.pendingImageTools.delete(attemptId);
+        for (const path of this.capturedImages.get(attemptId)?.values() ?? []) {
+            try {
+                (0, fs_1.unlinkSync)(path);
+            }
+            catch { /* staged bytes live independently in content-addressed media */ }
+        }
+        this.capturedImages.delete(attemptId);
+    }
+    scope(attemptId, generation) {
+        const attempt = this.store.get('SELECT * FROM task_attempts WHERE id=?', attemptId);
+        const task = attempt && this.store.task(String(attempt.task_id));
+        // The serialized attempt is authoritative; never borrow a later generation.
+        const snapshot = attempt && JSON.parse(String(attempt.payload_json));
+        if (!task || task.activeAttemptId !== attemptId || snapshot.generation !== generation || !['starting', 'running'].includes(task.state))
+            throw new types_1.OrchestrationError('STALE_ATTEMPT');
+        const conversation = this.store.get('SELECT * FROM conversations WHERE id=?', task.conversationId);
+        const mediaDir = (0, path_1.join)(this.agentsRoot, this.store.agentId, 'media', `api-${task.agentSessionId}`);
+        return { task, conversation, mediaDir };
+    }
+    allowedPath(attemptId, generation, candidate) {
+        const { task, mediaDir } = this.scope(attemptId, generation);
+        const value = (0, store_1.boundedText)(candidate, 4096);
+        const path = (0, fs_1.realpathSync)(value.startsWith('media/') ? media_store_1.MediaStore.resolvePath(this.agentsRoot, this.store.agentId, value) : value);
+        const under = (root) => { const ref = (0, path_1.relative)((0, fs_1.realpathSync)(root), path); return !!ref && !ref.startsWith('..') && !(0, path_1.isAbsolute)(ref); };
+        if (this.containerSpool) {
+            if (!under((0, path_1.join)(this.containerSpool, attemptId)) || !(0, fs_1.statSync)(path).isFile())
+                throw new types_1.OrchestrationError('ARTIFACT_PATH_DENIED');
+            return path;
+        }
+        let permitted = false;
+        try {
+            permitted = under(mediaDir);
+        }
+        catch { /* not created yet */ }
+        for (const row of this.store.all("SELECT worktree_path FROM task_resources WHERE task_id=? AND lifecycle_state='active'", task.taskId)) {
+            try {
+                permitted || (permitted = under(String(row.worktree_path)));
+            }
+            catch { /* unavailable resource */ }
+        }
+        for (const row of this.store.all('SELECT attachment_refs_json FROM conversation_inputs WHERE conversation_id=?', task.conversationId)) {
+            for (const ref of JSON.parse(String(row.attachment_refs_json))) {
+                try {
+                    permitted || (permitted = (0, fs_1.realpathSync)(media_store_1.MediaStore.resolvePath(this.agentsRoot, this.store.agentId, ref)) === path);
+                }
+                catch { /* expired attachment */ }
+            }
+        }
+        if (!permitted || !(0, fs_1.statSync)(path).isFile())
+            throw new types_1.OrchestrationError('ARTIFACT_PATH_DENIED', 'ARTIFACT_PATH_DENIED: File is outside this task scope. Use the original file’s absolute path in the active task workspace, a supplied input attachment, or this session’s media directory. Do not copy it to the agent-wide media root. The gateway stages authorized files automatically.');
+        return path;
+    }
+    stage(attemptId, generation, actionId, args) {
+        const { task } = this.scope(attemptId, generation);
+        (0, store_1.boundedText)(actionId, 256);
+        const old = this.store.get('SELECT * FROM task_files WHERE attempt_id=? AND action_id=?', attemptId, actionId);
+        if (old) {
+            if (old.args_hash !== (0, store_1.payloadHash)(args))
+                throw new types_1.OrchestrationError('IDEMPOTENCY_CONFLICT');
+            return { artifactId: String(old.id), path: String(old.path), staged: true };
+        }
+        if (Number(this.store.get('SELECT COUNT(*) n FROM task_files WHERE attempt_id=?', attemptId).n) >= 10)
+            throw new types_1.OrchestrationError('TOO_MANY_ARTIFACTS');
+        if (args.path !== undefined && args.source_tool_call_id !== undefined)
+            throw new types_1.OrchestrationError('INVALID_INPUT', 'Choose path OR source_tool_call_id, not both.');
+        const images = this.capturedImages.get(attemptId);
+        const captured = args.source_tool_call_id === undefined ? [...(images?.values() ?? [])].at(-1) : images?.get((0, store_1.boundedText)(args.source_tool_call_id, 256));
+        if (args.path === undefined && !captured)
+            throw new types_1.OrchestrationError('MCP_IMAGE_NOT_CAPTURED', 'No captured MCP image for this attempt. Capture an image first, or supply an existing local file path.');
+        let source;
+        try {
+            source = this.allowedPath(attemptId, generation, args.path ?? captured);
+        }
+        catch (error) {
+            if (['ENOENT', 'INVALID_REQUEST'].includes(String(error.code)))
+                throw new types_1.OrchestrationError('ARTIFACT_FILE_NOT_FOUND', 'The supplied path is not a saved file. For an MCP screenshot, omit path to stage its captured image, or use source_tool_call_id. Do not invent a filename.');
+            throw error;
+        }
+        const caption = args.caption === undefined ? '' : (0, store_1.boundedText)(args.caption, 1024);
+        if ((0, fs_1.statSync)(source).size > 50 * 1024 * 1024)
+            throw new types_1.OrchestrationError('ATTACHMENT_TOO_LARGE');
+        const path = (0, media_1.ingestOrchestrationMedia)(this.agentsRoot, this.store.agentId, `api-${task.agentSessionId}`, source);
+        const kind = (0, share_store_1.detectImageMime)((0, fs_1.readFileSync)(source).subarray(0, 12)) ? 'image' : 'file';
+        const id = (0, crypto_1.randomUUID)();
+        this.store.run('INSERT INTO task_files VALUES(?,?,?,?,?,?,?,?,?,?,?)', id, task.taskId, attemptId, actionId, path, (0, path_1.basename)(source).replace(/[\r\n]/g, '_').slice(0, 200), kind, caption, null, Date.now(), (0, store_1.payloadHash)(args));
+        return { artifactId: id, path, staged: true };
+    }
+    remember(attemptId, generation, actionId, args) {
+        const { task, conversation } = this.scope(attemptId, generation);
+        if (!task.capabilities.writeMemory || conversation.source === 'api')
+            throw new types_1.OrchestrationError('MEMORY_WRITE_DENIED');
+        const note = (0, store_1.boundedText)(args.note, 8192), name = args.path === undefined ? `memory/${new Date().toISOString().slice(0, 10)}.md` : (0, store_1.boundedText)(args.path, 256);
+        if (!/^(?:MEMORY\.md|USER\.md|memory\/[A-Za-z0-9_-]+\.md)$/.test(name))
+            throw new types_1.OrchestrationError('MEMORY_PATH_DENIED');
+        const workspace = this.workspace, destination = (0, path_1.join)(workspace, name);
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(destination), { recursive: true });
+        if ((0, fs_1.realpathSync)((0, path_1.dirname)(destination)) !== (0, path_1.join)((0, fs_1.realpathSync)(workspace), name.startsWith('memory/') ? 'memory' : '') || ((0, fs_1.existsSync)(destination) && (0, fs_1.lstatSync)(destination).isSymbolicLink()))
+            throw new types_1.OrchestrationError('MEMORY_PATH_DENIED');
+        if ((0, fs_1.existsSync)(destination) && (0, fs_1.statSync)(destination).size > 1048576)
+            throw new types_1.OrchestrationError('MEMORY_TOO_LARGE');
+        const old = (0, fs_1.existsSync)(destination) ? (0, fs_1.readFileSync)(destination, 'utf8') : '';
+        const operation = (0, crypto_1.createHash)('sha256').update(`${attemptId}:${actionId}`).digest('hex');
+        const marker = `<!-- orchestration-memory:${operation}:${(0, crypto_1.createHash)('sha256').update(name + '\0' + note).digest('hex')} -->`;
+        if (old.includes(`<!-- orchestration-memory:${operation}:`) && !old.includes(marker))
+            throw new types_1.OrchestrationError('IDEMPOTENCY_CONFLICT');
+        if (!old.includes(marker)) {
+            const temporary = `${destination}.${(0, crypto_1.randomUUID)()}.tmp`, fd = (0, fs_1.openSync)(temporary, 'wx', 0o600);
+            try {
+                (0, fs_1.writeFileSync)(fd, `${old}\n${marker}\n${note}\n`);
+                (0, fs_1.fsyncSync)(fd);
+            }
+            finally {
+                (0, fs_1.closeSync)(fd);
+            }
+            (0, fs_1.renameSync)(temporary, destination);
+            const directory = (0, fs_1.openSync)((0, path_1.dirname)(destination), 'r');
+            try {
+                (0, fs_1.fsyncSync)(directory);
+            }
+            finally {
+                (0, fs_1.closeSync)(directory);
+            }
+        }
+        this.store.transaction(() => this.store.appendEvent(task.conversationId, 'task.memory_updated', { taskId: task.taskId, path: name, operation }));
+        return { updated: true, path: name };
+    }
+}
+exports.TaskFiles = TaskFiles;
+//# sourceMappingURL=task-files.js.map

package/dist/orchestration/task-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-files.js","sourceRoot":"","sources":["../../src/orchestration/task-files.ts"],"names":[],"mappings":";;;AAAA,2BAAmK;AACnK,+BAAqE;AACrE,mCAAgD;AAChD,mCAAuE;AACvE,mCAA6C;AAC7C,mCAAmD;AACnD,wDAAoD;AACpD,sDAAuD;AAEvD,MAAa,SAAS;IACpB,YAAqB,KAAyB,EAAW,UAAkB,EAAmB,cAAuB,EAAmB,YAAY,IAAA,WAAI,EAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC;QAA3K,UAAK,GAAL,KAAK,CAAoB;QAAW,eAAU,GAAV,UAAU,CAAQ;QAAmB,mBAAc,GAAd,cAAc,CAAS;QAAmB,cAAS,GAAT,SAAS,CAA+C;QAC/K,mBAAc,GAAG,IAAI,GAAG,EAA+B,CAAC;QACxD,sBAAiB,GAAG,IAAI,GAAG,EAAuB,CAAC;IAF+H,CAAC;IAIpM,oFAAoF;IACpF,aAAa,CAAC,SAAiB,EAAE,UAAkB,EAAE,IAAY;QAC/D,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO,CAAC,2DAA2D;QAC5F,IAAI,KAAU,CAAC;QACf,IAAI,CAAC;YAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO;QAAC,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QAC3E,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvL,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,SAAS;YAC7J,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YACvE,MAAM,IAAI,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC;YAChF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YACjH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAA,6BAAe,EAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACpD,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;gBAAE,SAAS;YACxE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;YAC/E,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC;gBAAE,SAAS;YAC5C,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC;gBAC9C,IAAI,CAAC;oBAAC,IAAA,eAAU,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;gBAC9D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;YACD,IAAA,cAAS,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;YACzH,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,QAAQ,EAAE,aAAa,IAAA,mBAAU,GAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAClE,IAAA,kBAAa,EAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,eAAe,CAAC,SAAiB;QAC/B,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACtE,IAAI,CAAC;gBAAC,IAAA,eAAU,EAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,gEAAgE,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,SAAiB,EAAE,UAAkB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wCAAwC,EAAE,SAAS,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,QAAQ,CAAC,UAAU,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,EAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,0BAAkB,CAAC,eAAe,CAAC,CAAC;QACrL,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wCAAwC,EAAE,IAAI,CAAC,cAAc,CAAE,CAAC;QACpG,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAClG,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;IAC1C,CAAC;IACD,WAAW,CAAC,SAAiB,EAAE,UAAkB,EAAE,SAAkB;QACnE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAA,iBAAY,EAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,wBAAU,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACnI,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,GAAG,MAAM,GAAG,GAAG,IAAA,eAAQ,EAAC,IAAA,iBAAY,EAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAA,iBAAU,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/I,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,IAAA,WAAI,EAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC,MAAM,EAAE;gBAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;YACnI,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC;YAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;QACpE,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,uFAAuF,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvI,IAAI,CAAC;gBAAC,SAAS,KAAT,SAAS,GAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;QAC9F,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,8EAA8E,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACtI,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAa,EAAE,CAAC;gBAC3E,IAAI,CAAC;oBAAC,SAAS,KAAT,SAAS,GAAK,IAAA,iBAAY,EAAC,wBAAU,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,EAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;YACnJ,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,IAAI,CAAC,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,EAAE,4RAA4R,CAAC,CAAC;QAC/X,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,SAAiB,EAAE,UAAkB,EAAE,QAAgB,EAAE,IAA6B;QAC1F,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACnD,IAAA,mBAAW,EAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,6DAA6D,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/G,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,GAAG,CAAC,SAAS,KAAK,IAAA,mBAAW,EAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;YAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC9E,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sDAAsD,EAAE,SAAS,CAAE,CAAC,CAAC,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;QAC3J,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,mBAAmB,KAAK,SAAS;YAAE,MAAM,IAAI,0BAAkB,CAAC,eAAe,EAAE,+CAA+C,CAAC,CAAC;QACtK,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,IAAA,mBAAW,EAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,CAAC;QACzJ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,0BAAkB,CAAC,wBAAwB,EAAE,wGAAwG,CAAC,CAAC;QAC3M,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;QAAC,CAAC;QAChF,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAE,KAAa,CAAC,IAAI,CAAC,CAAC;gBAAE,MAAM,IAAI,0BAAkB,CAAC,yBAAyB,EAAE,4JAA4J,CAAC,CAAC;YAC/R,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAA,mBAAW,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClF,IAAI,IAAA,aAAQ,EAAC,MAAM,CAAC,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;YAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;QACnG,MAAM,IAAI,GAAG,IAAA,gCAAwB,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,CAAC,CAAC;QACjH,MAAM,IAAI,GAAG,IAAA,6BAAe,EAAC,IAAA,iBAAY,EAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACtF,MAAM,EAAE,GAAG,IAAA,mBAAU,GAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sDAAsD,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAA,eAAQ,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAA,mBAAW,EAAC,IAAI,CAAC,CAAC,CAAC;QAC/N,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IACD,QAAQ,CAAC,SAAiB,EAAE,UAAkB,EAAE,QAAgB,EAAE,IAA6B;QAC7F,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,IAAI,YAAY,CAAC,MAAM,KAAK,KAAK;YAAE,MAAM,IAAI,0BAAkB,CAAC,qBAAqB,CAAC,CAAC;QACzH,MAAM,IAAI,GAAG,IAAA,mBAAW,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,mBAAW,EAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9J,IAAI,CAAC,sDAAsD,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;QAC3H,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACtE,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,IAAA,iBAAY,EAAC,IAAA,cAAO,EAAC,WAAW,CAAC,CAAC,KAAK,IAAA,WAAI,EAAC,IAAA,iBAAY,EAAC,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC,IAAI,IAAA,cAAS,EAAC,WAAW,CAAC,CAAC,cAAc,EAAE,CAAC;YAAE,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;QACjP,IAAI,IAAA,eAAU,EAAC,WAAW,CAAC,IAAI,IAAA,aAAQ,EAAC,WAAW,CAAC,CAAC,IAAI,GAAG,OAAO;YAAE,MAAM,IAAI,0BAAkB,CAAC,kBAAkB,CAAC,CAAC;QACtH,MAAM,GAAG,GAAG,IAAA,eAAU,EAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAY,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,SAAS,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,6BAA6B,SAAS,IAAI,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7H,IAAI,GAAG,CAAC,QAAQ,CAAC,6BAA6B,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;QAC3I,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,IAAA,mBAAU,GAAE,MAAM,EAAE,EAAE,GAAG,IAAA,aAAQ,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9F,IAAI,CAAC;gBAAC,IAAA,kBAAa,EAAC,EAAE,EAAE,GAAG,GAAG,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC;gBAAC,IAAA,cAAS,EAAC,EAAE,CAAC,CAAC;YAAC,CAAC;oBAAS,CAAC;gBAAC,IAAA,cAAS,EAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YACpG,IAAA,eAAU,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,IAAA,aAAQ,EAAC,IAAA,cAAO,EAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;YAAC,IAAI,CAAC;gBAAC,IAAA,cAAS,EAAC,SAAS,CAAC,CAAC;YAAC,CAAC;oBAAS,CAAC;gBAAC,IAAA,cAAS,EAAC,SAAS,CAAC,CAAC;YAAC,CAAC;QACxH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,EAAE,qBAAqB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACjJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;CACF;AA/HD,8BA+HC"}

package/dist/orchestration/task-questions.d.ts

@@ -0,0 +1,26 @@
+import { ControlMenu, ControlScope } from './channel-controls';
+import { DecisionService } from './decisions';
+import { DeliveryControl } from './delivery';
+import { AcceptInput, OrchestrationStore } from './store';
+import { TaskService } from './tasks/service';
+/** Questions are durable user controls, not ordinary model-generated progress reports. */
+export declare class TaskQuestions {
+    private store;
+    private tasks;
+    private decisions;
+    private deliver;
+    private publish;
+    private reminderMs;
+    constructor(store: OrchestrationStore, tasks: TaskService, decisions: DecisionService, deliver: (responseId: string, bindingId: string, text: string, controls: DeliveryControl[]) => void, publish: (sessionId: string, responseId: string, text: string) => void, reminderMs: () => number);
+    tick(now?: number): void;
+    private suppressQuestionReports;
+    private owned;
+    handle(scope: ControlScope, text: string, inputId?: string): ControlMenu | undefined;
+    private apply;
+    /** Only a platform reply to a persisted question message is an unambiguous answer. */
+    answerReply(input: AcceptInput, inputId: string): ControlMenu | undefined;
+    normalizeReply(input: AcceptInput): AcceptInput;
+    matches(input: AcceptInput): boolean;
+    private replyQuestion;
+}
+//# sourceMappingURL=task-questions.d.ts.map

package/dist/orchestration/task-questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-questions.d.ts","sourceRoot":"","sources":["../../src/orchestration/task-questions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAoB,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C,0FAA0F;AAC1F,qBAAa,aAAa;IACZ,OAAO,CAAC,KAAK;IAAsB,OAAO,CAAC,KAAK;IAAe,OAAO,CAAC,SAAS;IAC1F,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,UAAU;gBAHA,KAAK,EAAE,kBAAkB,EAAU,KAAK,EAAE,WAAW,EAAU,SAAS,EAAE,eAAe,EACnG,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,IAAI,EACnG,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,EACtE,UAAU,EAAE,MAAM,MAAM;IAElC,IAAI,CAAC,GAAG,SAAa,GAAG,IAAI;IAmD5B,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,KAAK;IAYb,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAGpF,OAAO,CAAC,KAAK;IAmBb,sFAAsF;IACtF,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAQzE,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAW/C,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAcpC,OAAO,CAAC,aAAa;CAOtB"}

package/dist/orchestration/task-questions.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskQuestions = void 0;
+const store_1 = require("./store");
+const types_1 = require("./types");
+const UUID = '[a-f0-9-]{36}';
+/** Questions are durable user controls, not ordinary model-generated progress reports. */
+class TaskQuestions {
+    constructor(store, tasks, decisions, deliver, publish, reminderMs) {
+        this.store = store;
+        this.tasks = tasks;
+        this.decisions = decisions;
+        this.deliver = deliver;
+        this.publish = publish;
+        this.reminderMs = reminderMs;
+    }
+    tick(now = Date.now()) {
+        const published = [];
+        this.store.compose(() => {
+            // A pending message must not ask for an already answered or replaced question.
+            for (const row of this.store.all(`SELECT q.* FROM task_questions q JOIN tasks t ON t.id=q.task_id
+        WHERE (q.closed=0 OR EXISTS(SELECT 1 FROM deliveries d JOIN task_question_messages m ON m.response_id=d.response_id WHERE m.question_id=q.question_id AND d.state='pending')) AND (t.state!='waiting_input' OR COALESCE(json_extract(t.snapshot_json,'$.pendingQuestion.questionId'),'')!=q.question_id)`)) {
+                this.store.run('UPDATE task_questions SET closed=1 WHERE question_id=?', row.question_id);
+                this.suppressQuestionReports(String(row.question_id));
+                this.store.cancelQuestionDeliveries(String(row.question_id));
+            }
+            for (const row of this.store.all(`SELECT t.*,c.agent_session_id FROM tasks t JOIN conversations c ON c.id=t.conversation_id
+        WHERE t.state='waiting_input' AND c.status='active'`)) {
+                const task = this.store.task(String(row.id)), question = task.pendingQuestion;
+                if (!question || question.revision !== task.revision)
+                    continue;
+                let saved = this.store.get('SELECT * FROM task_questions WHERE question_id=?', question.questionId);
+                if (!saved) {
+                    // Preserve the originating channel/thread, never pick an arbitrary linked channel.
+                    const binding = this.store.get('SELECT binding_id FROM conversation_inputs WHERE id=?', task.initiatingInputId);
+                    if (!binding)
+                        continue;
+                    this.store.run('INSERT INTO task_questions(question_id,task_id,revision,state_version,binding_id,next_reminder_at) VALUES(?,?,?,?,?,?)', question.questionId, task.taskId, question.revision, task.stateVersion, binding.binding_id, now);
+                    saved = this.store.get('SELECT * FROM task_questions WHERE question_id=?', question.questionId);
+                }
+                if (!saved.closed && !saved.muted && Number(saved.next_reminder_at) <= now) {
+                    const pending = this.store.get(`SELECT d.id FROM deliveries d JOIN task_question_messages m ON m.response_id=d.response_id
+            WHERE m.question_id=? AND d.state IN ('pending','sending') LIMIT 1`, question.questionId);
+                    if (!pending) {
+                        const prefix = Number(saved.reminder_count) ? 'Reminder · Waiting for your answer' : 'Waiting for your answer';
+                        const command = `/task_question ${question.questionId}`;
+                        const channel = this.store.get('SELECT channel FROM conversation_bindings WHERE id=?', saved.binding_id).channel;
+                        const fallback = ['telegram', 'discord', 'slack', 'line'].includes(String(channel)) ? '' : `\n\n${command} snooze\n${command} mute`;
+                        const text = `${prefix}\n${task.title}\n\n${question.text}\n\nReply to this message with your answer, or use:\n${command} answer <your answer>${fallback}`;
+                        const responseId = this.decisions.notice(task.conversationId, text, false);
+                        this.store.run('INSERT INTO task_question_messages VALUES(?,?)', responseId, question.questionId);
+                        this.deliver(responseId, String(saved.binding_id), text, [
+                            { label: 'Remind in 1 hour', data: `orch:q:${question.questionId}:snooze` },
+                            { label: 'Mute reminders', data: `orch:q:${question.questionId}:mute` },
+                        ]);
+                        const count = Number(saved.reminder_count) + 1;
+                        this.store.run('UPDATE task_questions SET reminder_count=?,next_reminder_at=? WHERE question_id=?', count, now + this.reminderMs() * (count === 1 ? 1 : count === 2 ? 3 : 6), question.questionId);
+                        published.push([String(row.agent_session_id), responseId, text]);
+                    }
+                }
+                if (Number(saved.state_version) !== task.stateVersion)
+                    this.store.run('UPDATE task_questions SET state_version=? WHERE question_id=?', task.stateVersion, question.questionId);
+                this.suppressQuestionReports(question.questionId);
+            }
+        });
+        for (const item of published)
+            this.publish(...item);
+    }
+    suppressQuestionReports(questionId) {
+        // Earlier pending progress for this task is superseded by its current question.
+        // The durable version fence excludes later terminal results or replacement questions.
+        const question = this.store.get('SELECT task_id,state_version FROM task_questions WHERE question_id=?', questionId);
+        this.store.run("UPDATE notifications SET status='handled' WHERE task_id=? AND task_state_version<=? AND status='pending'", question.task_id, question.state_version);
+        this.store.run(`UPDATE outbox SET state='completed' WHERE kind='notification' AND state='pending' AND json_extract(payload_json,'$.notificationId') IN
+      (SELECT id FROM notifications WHERE task_id=? AND task_state_version<=? AND status='handled')`, question.task_id, question.state_version);
+    }
+    owned(scope, questionId) {
+        const row = this.store.get(`SELECT q.*,t.conversation_id,c.agent_session_id FROM task_questions q JOIN tasks t ON t.id=q.task_id
+      JOIN conversations c ON c.id=t.conversation_id JOIN conversation_bindings b ON b.id=q.binding_id
+      WHERE q.question_id=? AND c.agent_session_id=? AND b.channel=? AND b.chat_id=? AND (b.thread_key=? OR (b.channel='slack' AND b.thread_key='' AND EXISTS(
+        SELECT 1 FROM task_question_messages m JOIN deliveries d ON d.response_id=m.response_id
+          WHERE m.question_id=q.question_id AND d.binding_id=b.id AND d.state='delivered' AND d.provider_message_id=?)))`, questionId, scope.sessionId, scope.channel, scope.chatId, scope.thread, scope.thread);
+        if (!row)
+            throw new types_1.OrchestrationError('QUESTION_NOT_FOUND');
+        this.store.assertMember(String(row.conversation_id), scope.principalId);
+        return row;
+    }
+    handle(scope, text, inputId) {
+        return this.store.compose(() => this.apply(scope, text, inputId));
+    }
+    apply(scope, text, inputId) {
+        const command = new RegExp(`^/task_question (${UUID}) (answer|snooze|mute)(?:\\s+([\\s\\S]+))?$`).exec(text.trim());
+        const callback = new RegExp(`^/orch q:(${UUID}):(snooze|mute)$`).exec(text.trim());
+        if (!command && !callback)
+            return undefined;
+        const [, questionId, action] = (command ?? callback);
+        const row = this.owned(scope, questionId);
+        if (action === 'answer') {
+            const task = this.tasks.answerByUser(String(row.conversation_id), scope.principalId, String(row.task_id), questionId, command?.[3] ?? '', inputId);
+            this.store.run('UPDATE task_questions SET closed=1 WHERE question_id=?', questionId);
+            this.suppressQuestionReports(questionId);
+            return { text: `Answer received · ${task.title}\nThe answer is saved. Current task status: ${task.state}.`, buttons: [] };
+        }
+        const task = this.store.task(String(row.task_id));
+        if (row.closed || task?.state !== 'waiting_input' || task.pendingQuestion?.questionId !== questionId)
+            throw new types_1.OrchestrationError('STALE_QUESTION');
+        this.store.cancelQuestionDeliveries(questionId);
+        this.store.run('UPDATE task_questions SET muted=?,next_reminder_at=? WHERE question_id=?', action === 'mute' ? 1 : 0, Date.now() + 3600000, questionId);
+        return { text: `${action === 'mute' ? 'Reminders muted' : 'Reminder snoozed for 1 hour'} · ${task.title}\nThe task is still waiting for your answer.`, buttons: [] };
+    }
+    /** Only a platform reply to a persisted question message is an unambiguous answer. */
+    answerReply(input, inputId) {
+        if (!input.text.trim() || input.attachmentIds?.length || !input.metadata?.repliedMessageId || input.text.trim().startsWith('/'))
+            return undefined;
+        const row = this.replyQuestion(input);
+        if (!row)
+            return undefined;
+        const scope = { channel: input.scope.source, chatId: input.scope.chatId, thread: input.scope.threadKey, sessionId: input.scope.agentSessionId, principalId: input.scope.principalId };
+        return this.handle(scope, `/task_question ${row.question_id} answer ${input.text}`, inputId);
+    }
+    normalizeReply(input) {
+        if (input.scope.source !== 'slack' || !input.scope.threadKey || input.metadata?.repliedMessageId !== input.scope.threadKey)
+            return input;
+        const row = this.store.get(`SELECT b.conversation_id FROM task_question_messages m JOIN deliveries d ON d.response_id=m.response_id
+      JOIN conversation_bindings b ON b.id=d.binding_id JOIN conversations c ON c.id=b.conversation_id
+      WHERE d.provider_message_id=? AND d.state='delivered' AND b.channel='slack' AND b.chat_id=? AND b.account_id=?
+        AND b.thread_key='' AND c.agent_session_id=?`, input.scope.threadKey, input.scope.chatId, input.scope.accountId, input.scope.agentSessionId);
+        if (!row)
+            return input;
+        this.store.assertMember(String(row.conversation_id), input.scope.principalId);
+        return { ...input, scope: { ...input.scope, threadKey: '' } };
+    }
+    matches(input) {
+        if (/^\/task_question(?:\s|$)/.test(input.text.trim()))
+            return true;
+        if (!input.text.trim() || input.text.trim().startsWith('/') || input.attachmentIds?.length || !input.metadata?.repliedMessageId)
+            return false;
+        const question = this.replyQuestion(input);
+        if (!question)
+            return false;
+        if (input.scope.source !== 'slack' || !question.closed)
+            return true;
+        // Slack repeats the root message as reply metadata for every later thread message.
+        // Once answered, only an actual retry of the saved receipt is a question control.
+        if (!input.ingressKey)
+            return false;
+        const s = input.scope;
+        const key = (0, store_1.payloadHash)([this.store.agentId, s.source, s.accountId, s.chatId, s.threadKey, s.principalId, input.ingressKey]);
+        return Boolean(this.store.get(`SELECT i.input_id FROM ingress_receipts i JOIN conversation_decisions d
+      ON d.kind='notice' AND EXISTS(SELECT 1 FROM json_each(d.input_ids_json) WHERE value=i.input_id) WHERE i.ingress_key=?`, key));
+    }
+    replyQuestion(input) {
+        const scope = { channel: input.scope.source, chatId: input.scope.chatId, thread: input.scope.threadKey, sessionId: input.scope.agentSessionId };
+        return this.store.get(`SELECT DISTINCT m.question_id,q.closed FROM task_question_messages m JOIN task_questions q ON q.question_id=m.question_id JOIN deliveries d ON d.response_id=m.response_id
+      JOIN conversation_bindings b ON b.id=d.binding_id JOIN conversations c ON c.id=b.conversation_id
+      WHERE d.provider_message_id=? AND d.state='delivered' AND b.channel=? AND b.chat_id=? AND b.thread_key=? AND c.agent_session_id=?`, input.metadata.repliedMessageId, scope.channel, scope.chatId, scope.thread, scope.sessionId);
+    }
+}
+exports.TaskQuestions = TaskQuestions;
+//# sourceMappingURL=task-questions.js.map

package/dist/orchestration/task-questions.js.map

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

package/dist/orchestration/task-report.d.ts

@@ -0,0 +1,7 @@
+import { OrchestrationStore } from './store';
+/** Scheduled callers need the report of their own work, not the queue acknowledgement. */
+export declare function taskReport(store: OrchestrationStore, inputId: string): {
+    pending: boolean;
+    text?: string;
+};
+//# sourceMappingURL=task-report.d.ts.map

package/dist/orchestration/task-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-report.d.ts","sourceRoot":"","sources":["../../src/orchestration/task-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7C,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAoB1G"}

package/dist/orchestration/task-report.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskReport = taskReport;
+const types_1 = require("./types");
+/** Scheduled callers need the report of their own work, not the queue acknowledgement. */
+function taskReport(store, inputId) {
+    const tasks = store.all(`SELECT DISTINCT t.snapshot_json FROM task_commands tc
+    JOIN conversation_decisions d ON d.id=tc.decision_id JOIN tasks t ON t.id=tc.task_id
+    WHERE EXISTS (SELECT 1 FROM json_each(d.input_ids_json) WHERE value=?)`, inputId)
+        .map(row => JSON.parse(String(row.snapshot_json)));
+    if (!tasks.length)
+        return { pending: false };
+    const reports = new Map();
+    let pending = false;
+    for (const task of tasks) {
+        if (['failed', 'cancelled', 'needs_reconciliation', 'waiting_input'].includes(task.state)) {
+            throw new types_1.OrchestrationError('SCHEDULED_TASK_INCOMPLETE', `Task ${task.taskId} ${task.state}: ${task.failure?.code ?? task.state} ${task.failure?.message ?? ''}`.trim());
+        }
+        if (task.state !== 'completed') {
+            pending = true;
+            continue;
+        }
+        const report = store.get(`SELECT r.id,r.generated_text FROM notifications n
+      JOIN assistant_responses r ON r.decision_id=n.decision_id
+      WHERE n.task_id=? AND n.task_state_version=? AND n.status='handled' AND r.state='completed'`, task.taskId, task.stateVersion);
+        if (!report?.generated_text)
+            pending = true;
+        else
+            reports.set(String(report.id), String(report.generated_text));
+    }
+    return pending ? { pending: true } : { pending: false, text: [...reports.values()].join('\n\n') };
+}
+//# sourceMappingURL=task-report.js.map

package/dist/orchestration/task-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-report.js","sourceRoot":"","sources":["../../src/orchestration/task-report.ts"],"names":[],"mappings":";;AAIA,gCAoBC;AAvBD,mCAA2D;AAE3D,0FAA0F;AAC1F,SAAgB,UAAU,CAAC,KAAyB,EAAE,OAAe;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC;;2EAEiD,EAAE,OAAO,CAAC;SAChF,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAiB,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAC,OAAO,EAAC,KAAK,EAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACzC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,EAAC,WAAW,EAAC,sBAAsB,EAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvF,MAAM,IAAI,0BAAkB,CAAC,2BAA2B,EAAE,QAAQ,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5K,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC;YAAC,SAAS;QAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;;kGAEqE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAChI,IAAI,CAAC,MAAM,EAAE,cAAc;YAAE,OAAO,GAAG,IAAI,CAAC;;YACvC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,EAAC,OAAO,EAAC,IAAI,EAAC,CAAC,CAAC,CAAC,EAAC,OAAO,EAAC,KAAK,EAAC,IAAI,EAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAC,CAAC;AAC5F,CAAC"}

package/dist/orchestration/tasks/checkpoint-hook.d.ts

@@ -0,0 +1,19 @@
+/** Installed into the attempt directory; never invokes a shell with task/tool data.
+ * Claude Code PostToolUse/Failure supplies context before its next model call.
+ * Stop handles an update arriving after the last tool. Empty checkpoints are silent.
+ */
+export declare const CHECKPOINT_HOOK: string;
+export declare function checkpointSettings(command: string): {
+    disableAllHooks: boolean;
+    hooks: {
+        [k: string]: {
+            matcher: string;
+            hooks: {
+                type: string;
+                command: string;
+                timeout: number;
+            }[];
+        }[];
+    };
+};
+//# sourceMappingURL=checkpoint-hook.d.ts.map

package/dist/orchestration/tasks/checkpoint-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-hook.d.ts","sourceRoot":"","sources":["../../../src/orchestration/tasks/checkpoint-hook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,QAoC3B,CAAC;AACF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM;;;;;;;;;;;;EAEjD"}

package/dist/orchestration/tasks/checkpoint-hook.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHECKPOINT_HOOK = void 0;
+exports.checkpointSettings = checkpointSettings;
+/** Installed into the attempt directory; never invokes a shell with task/tool data.
+ * Claude Code PostToolUse/Failure supplies context before its next model call.
+ * Stop handles an update arriving after the last tool. Empty checkpoints are silent.
+ */
+exports.CHECKPOINT_HOOK = String.raw `
+const fs = require('fs'), http = require('http');
+let input = ''; process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => { input += chunk; if (input.length > 8*1024*1024) process.exit(0); });
+process.stdin.on('end', async () => {
+  try {
+    const event = JSON.parse(input);
+    if (event.agent_id || !['PostToolUse','PostToolUseFailure','Stop'].includes(event.hook_event_name)) return;
+    const ticket = JSON.parse(fs.readFileSync(process.argv[2], 'utf8'));
+    const call = args => new Promise((resolve,reject) => {
+      const url = ticket.socket ? null : new URL(ticket.url);
+      const options = ticket.socket ? { socketPath: ticket.socket, path: '/call' } : { hostname:url.hostname, port:url.port, path:url.pathname };
+      const request = http.request({...options, method: 'POST', headers: { Authorization: 'Bearer '+ticket.token, 'Content-Type': 'application/json' } }, response => {
+        let body = ''; response.setEncoding('utf8');
+        response.on('data', chunk => { body += chunk; if(body.length > 2*1024*1024) response.destroy(); });
+        response.on('error', reject);
+        response.on('end', () => { try { if(response.statusCode !== 200) return reject(Error('checkpoint')); resolve(JSON.parse(body)); } catch(error) { reject(error); } });
+      });
+      request.on('error',reject); request.setTimeout(2000,()=>request.destroy(Error('timeout')));
+      request.end(JSON.stringify({tool:'task_checkpoint', action_id:'hook', args:{sessionId:event.session_id,...args}}));
+    });
+    const next = await call({});
+    const context = [next.directive ? 'Task revision '+next.revision+' received at a tool boundary. Continue this same task; do not redo completed actions.\n'+next.directive : '', next.feedback?.message].filter(Boolean).join('\n\n');
+    if (!context) return;
+    // Monitoring advice cannot keep a completed worker alive. Explicit task
+    // amendments still block Stop so new user work cannot be silently dropped.
+    if (event.hook_event_name === 'Stop' && next.directiveKind === 'advice') {
+      await call({ackRevision:next.revision,ackFeedback:next.feedback?.id}); return;
+    }
+    // Stop blocks only for a new revision, never because monitoring wants more work.
+    if (event.hook_event_name === 'Stop' && !next.directive) return;
+    const output = event.hook_event_name === 'Stop' ? {decision:'block',reason:context} : {hookSpecificOutput:{hookEventName:event.hook_event_name,additionalContext:context}};
+    await new Promise(resolve => process.stdout.write(JSON.stringify(output)+'\n',resolve));
+    await call({ackRevision:next.revision,ackFeedback:next.feedback?.id});
+  } catch { /* A bridge failure cannot kill or authorize a task; its revision stays pending. */ }
+});
+`;
+function checkpointSettings(command) {
+    return { disableAllHooks: false, hooks: Object.fromEntries(['PostToolUse', 'PostToolUseFailure', 'Stop'].map(event => [event, [{ matcher: '*', hooks: [{ type: 'command', command, timeout: 5 }] }]])) };
+}
+//# sourceMappingURL=checkpoint-hook.js.map

package/dist/orchestration/tasks/checkpoint-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-hook.js","sourceRoot":"","sources":["../../../src/orchestration/tasks/checkpoint-hook.ts"],"names":[],"mappings":";;;AAyCA,gDAEC;AA3CD;;;GAGG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCxC,CAAC;AACF,SAAgB,kBAAkB,CAAC,OAAe;IAChD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,EAAC,oBAAoB,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzM,CAAC"}

package/dist/orchestration/tasks/cleanup.d.ts

@@ -0,0 +1,18 @@
+import { OrchestrationStore } from '../store';
+/** Conservative retention: archive clean worktrees and private shared-project
+ * snapshots. Dirty worktrees remain available for review. Never delete a shared
+ * project, uncertain attempt, or path outside the orchestration's resource directory. */
+export declare class ResourceCleanup {
+    private readonly store;
+    private readonly resourceRoot;
+    private readonly archiveRoot;
+    private readonly retentionDays;
+    private running?;
+    private readonly controller;
+    constructor(store: OrchestrationStore, resourceRoot: string, archiveRoot: string, retentionDays: number);
+    tick(now?: number): Promise<void>;
+    settle(): Promise<void>;
+    stop(): void;
+    private run;
+}
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/orchestration/tasks/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/orchestration/tasks/cleanup.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAM9C;;yFAEyF;AACzF,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAsB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAU,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAU,OAAO,CAAC,QAAQ,CAAC,aAAa;IAFnK,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;gBACvB,KAAK,EAAE,kBAAkB,EAAmB,YAAY,EAAE,MAAM,EAAmB,WAAW,EAAE,MAAM,EAAmB,aAAa,EAAE,MAAM;IAC3K,IAAI,CAAC,GAAG,SAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAC7B,IAAI,IAAI,IAAI;YACE,GAAG;CA+ClB"}