@0xmaxma/claude-gateway 2.0.3 → 2.0.5

package/dist/orchestration/channel-input-media.d.ts

@@ -7,5 +7,11 @@ export declare function channelInputMedia(agent: AgentConfig, root: string, sour
         name?: string;
         quoted: boolean;
     }[];
+    unavailable: {
+        code: string;
+        name?: string;
+        quoted: boolean;
+    }[];
+    primaryDirectMedia: string | undefined;
 }>;
 //# sourceMappingURL=channel-input-media.d.ts.map

package/dist/orchestration/channel-input-media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-input-media.d.ts","sourceRoot":"","sources":["../../src/orchestration/channel-input-media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAI5C,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAC,MAAM,KAAG,IAAI;;;;aAahG,MAAM;eAAO,MAAM;gBAAQ,OAAO;;GAqBpG"}
+{"version":3,"file":"channel-input-media.d.ts","sourceRoot":"","sources":["../../src/orchestration/channel-input-media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAK5C,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAC,MAAM,KAAG,IAAI;;;;aAgBhG,MAAM;eAAO,MAAM;gBAAQ,OAAO;;;cACpE,MAAM;eAAO,MAAM;gBAAQ,OAAO;;;GA+BlE"}

package/dist/orchestration/channel-input-media.js

@@ -4,25 +4,36 @@ exports.channelInputMedia = channelInputMedia;
 const media_1 = require("./media");
 const channel_media_1 = require("./channel-media");
 const types_1 = require("./types");
+const channel_media_error_1 = require("./channel-media-error");
 async function channelInputMedia(agent, root, source, chatId, meta, discard) {
     const items = [];
     if (meta.attachments_json) {
-        const parsed = JSON.parse(meta.attachments_json);
+        let parsed;
+        try {
+            parsed = JSON.parse(meta.attachments_json);
+        }
+        catch {
+            throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
+        }
         if (!Array.isArray(parsed) || parsed.length > 20 || parsed.some(a => !a || typeof a !== 'object' || (a.path !== undefined && typeof a.path !== 'string') || (a.ref !== undefined && typeof a.ref !== 'string') || (a.name !== undefined && typeof a.name !== 'string') || (a.kind !== undefined && typeof a.kind !== 'string') || (a.quoted !== undefined && typeof a.quoted !== 'boolean') || (!a.path && !a.ref)))
             throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
         items.push(...parsed);
     }
     else {
         if (meta.image_path || meta.document_path || meta.sticker_path)
-            items.push({ path: meta.image_path || meta.document_path || meta.sticker_path, name: meta.attachment_name });
+            items.push({ path: meta.image_path || meta.document_path || meta.sticker_path, name: meta.attachment_name, size: meta.attachment_size === undefined ? undefined : Number(meta.attachment_size) });
         else if (meta.attachment_file_id)
-            items.push({ ref: meta.attachment_file_id, name: meta.attachment_name });
+            items.push({ ref: meta.attachment_file_id, name: meta.attachment_name, size: meta.attachment_size === undefined ? undefined : Number(meta.attachment_size) });
     }
     if (meta.replied_image_path)
         items.push({ path: meta.replied_image_path, quoted: true });
     else if (meta.replied_attachment_file_id)
-        items.push({ ref: meta.replied_attachment_file_id, name: meta.replied_attachment_name, quoted: true });
+        items.push({ ref: meta.replied_attachment_file_id, name: meta.replied_attachment_name, size: meta.replied_attachment_size === undefined ? undefined : Number(meta.replied_attachment_size), quoted: true });
+    const primaryDirect = items.find(item => !item.quoted);
+    let primaryDirectMedia;
     const media = [], quoted = [], details = [];
+    const unavailable = [];
+    const discardPaths = new Set();
     const seen = new Map();
     for (const item of items) {
         const key = item.path ?? item.ref;
@@ -31,24 +42,37 @@ async function channelInputMedia(agent, root, source, chatId, meta, discard) {
         let ref = seen.get(key);
         if (!ref) {
             try {
-                ref = item.path ? (0, media_1.ingestOrchestrationMedia)(root, agent.id, `${source}-${chatId}`, item.path) : await (0, channel_media_1.receiveChannelMedia)(agent, root, source, chatId, item.ref);
+                if (item.size !== undefined && (!Number.isSafeInteger(item.size) || item.size < 0))
+                    throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
+                if (item.size !== undefined && item.size > (source === 'telegram' ? 20 : 50) * 1024 * 1024)
+                    throw new types_1.OrchestrationError('ATTACHMENT_TOO_LARGE');
+                ref = item.path ? (0, media_1.ingestOrchestrationMedia)(root, agent.id, `${source}-${chatId}`, item.path) : await (0, channel_media_1.receiveChannelMedia)(agent, root, source, chatId, item.ref, fetch, item.size);
             }
             catch (error) {
-                // An expired quote must not discard the user's new message or its own files.
-                if (!item.quoted)
-                    throw error;
-                meta.attachment_error = [meta.attachment_error, 'A quoted attachment is unavailable. Do not claim to have read it.'].filter(Boolean).join(' ');
+                const failure = (0, channel_media_error_1.classifyChannelMediaError)(error);
+                if (failure.retryable)
+                    throw failure;
+                const name = item.name?.replace(/[\x00-\x1f\x7f]/g, '').slice(0, 200);
+                unavailable.push({ code: failure.code, ...(name ? { name } : {}), quoted: Boolean(item.quoted) });
                 continue;
             }
             seen.set(key, ref);
             media.push(ref);
             if (item.path && meta.media_ephemeral === '1')
-                discard(item.path);
+                discardPaths.add(item.path);
         }
+        if (item === primaryDirect)
+            primaryDirectMedia = ref;
         if (item.quoted)
             quoted.push(ref);
         details.push({ ref, name: item.name, quoted: Boolean(item.quoted) });
     }
-    return { media, quoted: [...new Set(quoted)], details };
+    if (unavailable.length) {
+        const diagnostic = unavailable.some(item => item.quoted) ? 'A quoted attachment is unavailable. Do not claim to have read it.' : 'An attachment is unavailable. Do not claim to have read it.';
+        meta.attachment_error = [meta.attachment_error, diagnostic].filter(Boolean).join(' ');
+    }
+    for (const path of discardPaths)
+        discard(path);
+    return { media, quoted: [...new Set(quoted)], details, unavailable, primaryDirectMedia };
 }
 //# sourceMappingURL=channel-input-media.js.map

package/dist/orchestration/channel-input-media.js.map

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

package/dist/orchestration/channel-media-error.d.ts

@@ -0,0 +1,11 @@
+import { OrchestrationError } from './types';
+/** Safe admission diagnostics: never expose provider URLs, bodies, or credentials. */
+export declare class ChannelMediaError extends OrchestrationError {
+    readonly retryable: boolean;
+    readonly status?: number | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(code: string, retryable: boolean, status?: number | undefined, retryAfterMs?: number | undefined);
+}
+export declare function classifyChannelMediaError(error: unknown): ChannelMediaError;
+export declare function channelMediaHttpError(status: number, retryAfter?: string | null): ChannelMediaError;
+//# sourceMappingURL=channel-media-error.d.ts.map

package/dist/orchestration/channel-media-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-media-error.d.ts","sourceRoot":"","sources":["../../src/orchestration/channel-media-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,sFAAsF;AACtF,qBAAa,iBAAkB,SAAQ,kBAAkB;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;gBAAnG,IAAI,EAAE,MAAM,EAAW,SAAS,EAAE,OAAO,EAAW,MAAM,CAAC,EAAE,MAAM,YAAA,EAAW,YAAY,CAAC,EAAE,MAAM,YAAA;CAGhH;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAS3E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAQnG"}

package/dist/orchestration/channel-media-error.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelMediaError = void 0;
+exports.classifyChannelMediaError = classifyChannelMediaError;
+exports.channelMediaHttpError = channelMediaHttpError;
+const types_1 = require("./types");
+/** Safe admission diagnostics: never expose provider URLs, bodies, or credentials. */
+class ChannelMediaError extends types_1.OrchestrationError {
+    constructor(code, retryable, status, retryAfterMs) {
+        super(code);
+        this.retryable = retryable;
+        this.status = status;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+exports.ChannelMediaError = ChannelMediaError;
+function classifyChannelMediaError(error) {
+    if (error instanceof ChannelMediaError)
+        return error;
+    if (error instanceof types_1.OrchestrationError && ['INVALID_ATTACHMENT', 'ATTACHMENT_TOO_LARGE', 'ATTACHMENT_NOT_CONFIGURED'].includes(error.code)) {
+        return new ChannelMediaError(error.code, false);
+    }
+    const code = error?.code;
+    // Missing source files cannot be recovered by retrying the same reference.
+    // Disk, permission and reconciliation errors may recover after operator action.
+    return new ChannelMediaError('ATTACHMENT_UNAVAILABLE', !['ENOENT', 'ENOTDIR', 'EISDIR'].includes(code ?? ''));
+}
+function channelMediaHttpError(status, retryAfter) {
+    let retryAfterMs;
+    if (retryAfter) {
+        const seconds = Number(retryAfter);
+        const delay = Number.isFinite(seconds) ? seconds * 1000 : Date.parse(retryAfter) - Date.now();
+        if (Number.isFinite(delay) && delay >= 0)
+            retryAfterMs = Math.min(delay, 24 * 60 * 60 * 1000);
+    }
+    return new ChannelMediaError('ATTACHMENT_UNAVAILABLE', status === 408 || status === 429 || status >= 500, status, retryAfterMs);
+}
+//# sourceMappingURL=channel-media-error.js.map

package/dist/orchestration/channel-media-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-media-error.js","sourceRoot":"","sources":["../../src/orchestration/channel-media-error.ts"],"names":[],"mappings":";;;AASA,8DASC;AAED,sDAQC;AA5BD,mCAA6C;AAE7C,sFAAsF;AACtF,MAAa,iBAAkB,SAAQ,0BAAkB;IACvD,YAAY,IAAY,EAAW,SAAkB,EAAW,MAAe,EAAW,YAAqB;QAC7G,KAAK,CAAC,IAAI,CAAC,CAAC;QADqB,cAAS,GAAT,SAAS,CAAS;QAAW,WAAM,GAAN,MAAM,CAAS;QAAW,iBAAY,GAAZ,YAAY,CAAS;IAE/G,CAAC;CACF;AAJD,8CAIC;AAED,SAAgB,yBAAyB,CAAC,KAAc;IACtD,IAAI,KAAK,YAAY,iBAAiB;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,KAAK,YAAY,0BAAkB,IAAI,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,2BAA2B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5I,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,GAAI,KAA2C,EAAE,IAAI,CAAC;IAChE,2EAA2E;IAC3E,gFAAgF;IAChF,OAAO,IAAI,iBAAiB,CAAC,wBAAwB,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;AAChH,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAc,EAAE,UAA0B;IAC9E,IAAI,YAAgC,CAAC;IACrC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9F,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,iBAAiB,CAAC,wBAAwB,EAAE,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAClI,CAAC"}

package/dist/orchestration/channel-media.d.ts

@@ -1,4 +1,4 @@
 import { AgentConfig } from '../types';
 /** Resolve provider-only attachment references before acknowledging receiver ingress. */
-export declare function receiveChannelMedia(agent: AgentConfig, agentsRoot: string, source: string, chatId: string, ref: string, request?: typeof fetch): Promise<string>;
+export declare function receiveChannelMedia(agent: AgentConfig, agentsRoot: string, source: string, chatId: string, ref: string, request?: typeof fetch, size?: number): Promise<string>;
 //# sourceMappingURL=channel-media.d.ts.map

package/dist/orchestration/channel-media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-media.d.ts","sourceRoot":"","sources":["../../src/orchestration/channel-media.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAIvC,yFAAyF;AACzF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B7K"}
+{"version":3,"file":"channel-media.d.ts","sourceRoot":"","sources":["../../src/orchestration/channel-media.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKvC,yFAAyF;AACzF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,KAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5L"}

package/dist/orchestration/channel-media.js

@@ -6,16 +6,39 @@ const path_1 = require("path");
 const crypto_1 = require("crypto");
 const types_1 = require("./types");
 const media_1 = require("./media");
+const channel_media_error_1 = require("./channel-media-error");
 /** Resolve provider-only attachment references before acknowledging receiver ingress. */
-async function receiveChannelMedia(agent, agentsRoot, source, chatId, ref, request = fetch) {
+async function receiveChannelMedia(agent, agentsRoot, source, chatId, ref, request = fetch, size) {
+    try {
+        return await receive(agent, agentsRoot, source, chatId, ref, request, size);
+    }
+    catch (error) {
+        throw (0, channel_media_error_1.classifyChannelMediaError)(error);
+    }
+}
+async function receive(agent, agentsRoot, source, chatId, ref, request, size) {
+    const limit = (source === 'telegram' ? 20 : 50) * 1024 * 1024;
+    if (size !== undefined && (!Number.isSafeInteger(size) || size < 0))
+        throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
+    if (size !== undefined && size > limit)
+        throw new types_1.OrchestrationError('ATTACHMENT_TOO_LARGE');
     if (!ref || ref.length > 8192)
         throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
     let url;
     if (source === 'telegram' && agent.telegram?.botToken) {
         const response = await request(`https://api.telegram.org/bot${agent.telegram.botToken}/getFile`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ file_id: ref }), signal: AbortSignal.timeout(10000) });
-        if (!response.ok)
-            throw new types_1.OrchestrationError('ATTACHMENT_UNAVAILABLE');
+        if (!response.ok) {
+            const errorBody = await response.json().catch(() => undefined);
+            const retryAfter = response.headers.get('retry-after') ?? (typeof errorBody?.parameters?.retry_after === 'number' ? String(errorBody.parameters.retry_after) : undefined);
+            throw (0, channel_media_error_1.channelMediaHttpError)(response.status, retryAfter);
+        }
         const body = await response.json();
+        if (!body.ok) {
+            const status = body.error_code;
+            throw status && Number.isInteger(status) && status >= 400 && status <= 599
+                ? (0, channel_media_error_1.channelMediaHttpError)(status, body.parameters?.retry_after === undefined ? undefined : String(body.parameters.retry_after))
+                : new channel_media_error_1.ChannelMediaError('ATTACHMENT_UNAVAILABLE', true);
+        }
         const path = body.result?.file_path;
         if (!body.ok || !path || path.split('/').some(part => part === '..') || !/^[A-Za-z0-9_./-]+$/.test(path))
             throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
@@ -24,7 +47,13 @@ async function receiveChannelMedia(agent, agentsRoot, source, chatId, ref, reque
         url = `https://api.telegram.org/file/bot${agent.telegram.botToken}/${path}`;
     }
     else if (source === 'discord') {
-        const parsed = new URL(ref);
+        let parsed;
+        try {
+            parsed = new URL(ref);
+        }
+        catch {
+            throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
+        }
         if (parsed.protocol !== 'https:' || parsed.username || parsed.password || !['cdn.discordapp.com', 'media.discordapp.net'].includes(parsed.hostname))
             throw new types_1.OrchestrationError('INVALID_ATTACHMENT');
         url = parsed.href;
@@ -32,9 +61,10 @@ async function receiveChannelMedia(agent, agentsRoot, source, chatId, ref, reque
     else
         throw new types_1.OrchestrationError('ATTACHMENT_NOT_CONFIGURED');
     const response = await request(url, { redirect: 'error', signal: AbortSignal.timeout(30000) });
-    if (!response.ok || !response.body)
-        throw new types_1.OrchestrationError('ATTACHMENT_UNAVAILABLE');
-    const limit = (source === 'telegram' ? 20 : 50) * 1024 * 1024;
+    if (!response.ok)
+        throw (0, channel_media_error_1.channelMediaHttpError)(response.status, response.headers.get('retry-after'));
+    if (!response.body)
+        throw new channel_media_error_1.ChannelMediaError('ATTACHMENT_UNAVAILABLE', true);
     const reader = response.body.getReader(), chunks = [];
     let bytes = 0;
     try {

package/dist/orchestration/channel-media.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel-media.js","sourceRoot":"","sources":["../../src/orchestration/channel-media.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"channel-media.js","sourceRoot":"","sources":["../../src/orchestration/channel-media.ts"],"names":[],"mappings":";;AASA,kDAIC;AAbD,2BAA0D;AAC1D,+BAAqC;AACrC,mCAAoC;AAEpC,mCAA6C;AAC7C,mCAAmD;AACnD,+DAA4G;AAE5G,yFAAyF;AAClF,KAAK,UAAU,mBAAmB,CAAC,KAAkB,EAAE,UAAkB,EAAE,MAAc,EAAE,MAAc,EAAE,GAAW,EAAE,UAAwB,KAAK,EAAE,IAAa;IACzK,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,IAAA,+CAAyB,EAAC,KAAK,CAAC,CAAC;IAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,KAAkB,EAAE,UAAkB,EAAE,MAAc,EAAE,MAAc,EAAE,GAAW,EAAE,OAAqB,EAAE,IAAa;IAC9I,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9D,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;IACxH,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,GAAG,KAAK;QAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;IAC7F,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI;QAAE,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;IAClF,IAAI,GAAW,CAAC;IAChB,IAAI,MAAM,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,+BAA+B,KAAK,CAAC,QAAQ,CAAC,QAAQ,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClP,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAsD,CAAC;YACpH,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,UAAU,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC1K,MAAM,IAAA,2CAAqB,EAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAoI,CAAC;QACrK,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;YAC/B,MAAM,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG;gBACxE,CAAC,CAAC,IAAA,2CAAqB,EAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;gBAC7H,CAAC,CAAC,IAAI,uCAAiB,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;QAC7J,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;YAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;QAC3G,GAAG,GAAG,oCAAoC,KAAK,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;IAC9E,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YAAC,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;QAAC,CAAC;QAC5F,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,0BAAkB,CAAC,oBAAoB,CAAC,CAAC;QACxM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;IACpB,CAAC;;QAAM,MAAM,IAAI,0BAAkB,CAAC,2BAA2B,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAA,2CAAqB,EAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IACpG,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,MAAM,IAAI,uCAAiB,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,GAAiB,EAAE,CAAC;IAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IACnF,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,GAAG,KAAK;YAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;QACjH,OAAO,IAAI,EAAE,CAAC;YAAC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAAC,IAAI,KAAK,CAAC,IAAI;gBAAE,MAAM;YAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;YAAC,IAAI,KAAK,GAAG,KAAK;gBAAE,MAAM,IAAI,0BAAkB,CAAC,sBAAsB,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;IAC5M,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC;IAAC,IAAA,cAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5H,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,GAAG,IAAA,mBAAU,GAAE,GAAG,IAAA,cAAO,EAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAC,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/H,IAAI,CAAC;QAAC,IAAA,kBAAa,EAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,IAAA,gCAAwB,EAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;IAAC,CAAC;YACtK,CAAC;QAAC,IAAI,CAAC;YAAC,IAAA,eAAU,EAAC,SAAS,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IAAC,CAAC;AACjF,CAAC"}

package/dist/orchestration/context-footprint.d.ts

@@ -0,0 +1,14 @@
+export declare function referenceTokens(text: string): number;
+export interface ContextFootprint {
+    observedAt: number;
+    rows: Array<{
+        name: string;
+        tokens: number | null;
+        characters: number | null;
+        hasContent?: boolean;
+        note: string;
+    }>;
+}
+/** Run in the dashboard reader thread. Never launch a CLI/model or return file content. */
+export declare function contextFootprint(workspace: string | undefined): ContextFootprint;
+//# sourceMappingURL=context-footprint.d.ts.map

package/dist/orchestration/context-footprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-footprint.d.ts","sourceRoot":"","sources":["../../src/orchestration/context-footprint.ts"],"names":[],"mappings":"AAOA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AACD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAA,MAAM,EAAC,MAAM,GAAC,IAAI,CAAC;QAAA,UAAU,EAAC,MAAM,GAAC,IAAI,CAAC;QAAA,UAAU,CAAC,EAAC,OAAO,CAAC;QAAA,IAAI,EAAC,MAAM,CAAA;KAAC,CAAC,CAAC;CACtG;AACD,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CA2BhF"}

package/dist/orchestration/context-footprint.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.referenceTokens = referenceTokens;
+exports.contextFootprint = contextFootprint;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const js_tiktoken_1 = require("js-tiktoken");
+const agent_tool_schemas_1 = require("./agent-tool-schemas");
+const cache = new Map();
+let encoder;
+function referenceTokens(text) {
+    encoder ?? (encoder = (0, js_tiktoken_1.getEncoding)('cl100k_base'));
+    return encoder.encode(text, [], []).length;
+}
+/** Run in the dashboard reader thread. Never launch a CLI/model or return file content. */
+function contextFootprint(workspace) {
+    if (!workspace)
+        return { observedAt: Date.now(), rows: [] };
+    const key = workspace, previous = cache.get(key);
+    if (previous && Date.now() - previous.at < 30000)
+        return previous.value;
+    const rows = [];
+    const read = (name) => {
+        try {
+            const filename = (0, path_1.join)(workspace, name);
+            if ((0, fs_1.statSync)(filename).size > 1024 * 1024)
+                return undefined;
+            return (0, fs_1.readFileSync)(filename, 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const add = (name, text, note) => rows.push({ name, tokens: text === undefined ? null : referenceTokens(text), characters: text === undefined ? null : [...text].length, hasContent: Boolean(text?.trim()), note });
+    const composed = read('CLAUDE.md');
+    add('CLAUDE.md · composed workspace context', composed, 'Current generated file after workspace budgets. Parent total; do not add its sections again. Not the complete CLI prompt.');
+    const labels = { 'AGENT IDENTITY': 'AGENTS.md', 'IDENTITY': 'IDENTITY.md', 'SOUL': 'SOUL.md', 'USER PROFILE': 'USER.md', 'LONG-TERM MEMORY': 'MEMORY.md', 'HEARTBEAT CONFIG': 'HEARTBEAT.md', 'AVAILABLE SKILLS': 'Skill catalog', 'MEMORY RULE': 'Memory rules', 'MEMORY RETRIEVAL': 'Memory retrieval instructions' };
+    if (composed) {
+        const markers = [...composed.matchAll(/^--- ([A-Z -]+) ---\n/gm)];
+        for (let i = 0; i < markers.length; i++) {
+            const marker = markers[i], name = labels[marker[1]] || marker[1];
+            const text = composed.slice(marker.index + marker[0].length, markers[i + 1]?.index ?? composed.length);
+            add('↳ ' + name, text, 'Section found in generated CLAUDE.md; includes section whitespace. Boundary tokenization can differ from parent total.');
+        }
+    }
+    for (const name of ['AGENTS.md', 'IDENTITY.md', 'SOUL.md', 'USER.md', 'MEMORY.md', 'HEARTBEAT.md'])
+        add(name + ' · source file', read(name), 'Current file on disk before budget/index/truncation. Reference only; not added to composed context.');
+    // Every agent tool is declared on every turn, so the measured schema cost does not
+    // depend on any feature flag. Filtering one out here would under-report the real prefix.
+    add('Agent gateway tool schemas (' + agent_tool_schemas_1.AGENT_TASK_TOOLS.length + ')', JSON.stringify(agent_tool_schemas_1.AGENT_TASK_TOOLS), 'Current host Agent MCP definitions: name, description and inputSchema. Excludes native CLI tools, worker tools and provider framing.');
+    const value = { observedAt: Date.now(), rows };
+    if (cache.size >= 32)
+        cache.delete(cache.keys().next().value);
+    cache.set(key, { at: Date.now(), value });
+    return value;
+}
+//# sourceMappingURL=context-footprint.js.map

package/dist/orchestration/context-footprint.js.map

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

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

@@ -7,7 +7,7 @@ export interface IntakeChoice {
     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.";
+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 to the user and speech is attempted when enabled; it is not a private classification, instruction to yourself, or reasoning field. Do not add a waiting period. A successful acknowledgement permits dispatch even when audio is unavailable. If a task tool fails, explain the failure and never claim work started without a successful receipt.\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 {

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

@@ -1 +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"}
+{"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,ioEAKgV,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

@@ -5,7 +5,7 @@ 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.
+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 to the user and speech is attempted when enabled; it is not a private classification, instruction to yourself, or reasoning field. Do not add a waiting period. A successful acknowledgement permits dispatch even when audio is unavailable. If a task tool fails, explain the failure and never claim work started without a successful receipt.
 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.`;

package/dist/orchestration/dashboard-reader-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dashboard-reader-worker.d.ts.map

package/dist/orchestration/dashboard-reader-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-reader-worker.d.ts","sourceRoot":"","sources":["../../src/orchestration/dashboard-reader-worker.ts"],"names":[],"mappings":""}

package/dist/orchestration/dashboard-reader-worker.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const context_footprint_1 = require("./context-footprint");
+const worker_threads_1 = require("worker_threads");
+const node_sqlite_1 = require("node:sqlite");
+const fs_1 = require("fs");
+const token_ledger_1 = require("./token-ledger");
+const task_directive_1 = require("./tasks/task-directive");
+/**
+ * Conversation activity status — the single source shared by the dashboard
+ * Conversations "Status" column and the Session token report header, so the two
+ * views can never disagree (thinking → working → waiting_input → queued → idle).
+ * `thinking` is returned alongside so callers keep the existing isRunning signal
+ * without re-querying. Display-only; does not touch token accounting.
+ */
+function conversationActivityStatus(get, all, conversationId) {
+    const thinking = Boolean(get("SELECT id FROM conversation_decisions WHERE conversation_id=? AND state IN ('running','interrupting') LIMIT 1", conversationId));
+    const states = all("SELECT DISTINCT state FROM tasks WHERE conversation_id=? AND state NOT IN ('completed','failed','cancelled')", conversationId).map(t => t.state);
+    const lastTurn = get('SELECT MAX(ended_at) ended_at FROM conversation_decisions WHERE conversation_id=?', conversationId)?.ended_at;
+    const resting = lastTurn != null && Date.now() - Number(lastTurn) <= 3600000 ? 'idle' : 'stopped';
+    const status = thinking ? 'thinking' : states.includes('needs_reconciliation') ? 'needs_reconciliation' : states.some(s => ['starting', 'running', 'interrupting', 'cancel_requested', 'recovering'].includes(s)) ? 'working' : states.includes('waiting_input') ? 'waiting_input' : states.includes('queued') ? 'queued' : resting;
+    return { status, thinking };
+}
+const connections = new Map();
+function database(filename) {
+    if (!(0, fs_1.existsSync)(filename))
+        return undefined;
+    let db = connections.get(filename);
+    if (!db) {
+        if (connections.size >= 32) {
+            const key = connections.keys().next().value;
+            connections.get(key).close();
+            connections.delete(key);
+        }
+        db = new node_sqlite_1.DatabaseSync(filename, { readOnly: true });
+        db.exec('PRAGMA query_only=ON; PRAGMA busy_timeout=1000');
+        connections.set(filename, db);
+    }
+    connections.delete(filename);
+    connections.set(filename, db);
+    return db;
+}
+function read(filename, operation, options) {
+    const db = database(filename);
+    if (!db)
+        return undefined;
+    const all = (sql, ...params) => db.prepare(sql).all(...params);
+    const get = (sql, ...params) => db.prepare(sql).get(...params);
+    const exists = (table) => Boolean(get("SELECT name FROM sqlite_master WHERE type='table' AND name=?", table));
+    if (!exists('conversations'))
+        return undefined;
+    const since = Math.max(0, Number(options.since) || 0);
+    // A read transaction makes the session/task/attempt relationships consistent.
+    db.exec('BEGIN');
+    try {
+        const adapter = { all, get, attempt: (id) => { const row = get('SELECT payload_json FROM task_attempts WHERE id=?', id); return row ? JSON.parse(row.payload_json) : undefined; } };
+        if (operation === 'report' || operation === 'session') {
+            if (!get('SELECT id FROM conversations WHERE agent_session_id=?', options.sessionId))
+                return undefined;
+            // Before the ledger table exists (an agent whose very first turn has not recorded
+            // usage yet) a queued input still has to be visible, so derive the pending rows
+            // without the token_turns lookup instead of returning an empty list.
+            const report = exists('token_turns') ? (0, token_ledger_1.readTokenReport)(adapter, options.sessionId, true, { offset: Math.max(0, Number(options.offset) || 0), limit: operation === 'report' ? 25 : 50, since, newestFirst: true }) : { sessionId: options.sessionId, turns: (0, token_ledger_1.pendingInputTurns)(adapter, options.sessionId, since, false), totals: { agentTokens: null, workerTokens: null, totalTokens: null }, coverage: 'recorded-turns-only' };
+            if (operation === 'session') {
+                const session = get('SELECT * FROM conversations WHERE agent_session_id=?', options.sessionId);
+                const offset = Math.max(0, Number(options.offset) || 0);
+                const tasks = all('SELECT id,state,snapshot_json,updated_at FROM tasks WHERE conversation_id=? AND updated_at>=? ORDER BY updated_at DESC,id LIMIT 50 OFFSET ?', session.id, since, offset).map(t => ({ taskId: t.id, state: t.state, title: JSON.parse(t.snapshot_json).title, updatedAt: t.updated_at }));
+                // Same activity status the Conversations column shows, so the session drawer's
+                // Context window box can use the same idle-vs-stopped disambiguation as the report page.
+                const activityStatus = conversationActivityStatus(get, all, session.id).status;
+                return { ...report, session: { sessionId: session.agent_session_id, source: session.source, chatId: session.chat_id, createdAt: session.created_at, updatedAt: session.updated_at }, tasks, totalTasks: Number(get('SELECT COUNT(*) n FROM tasks WHERE conversation_id=? AND updated_at>=?', session.id, since).n), offset, activityStatus };
+            }
+            const session = get('SELECT id,source,chat_id FROM conversations WHERE agent_session_id=?', options.sessionId);
+            // Same activity status the Conversations column shows, so the report header mirrors it.
+            const activityStatus = conversationActivityStatus(get, all, session.id).status;
+            return { ...report, source: session.source, chatId: session.chat_id, activityStatus, since, contextFootprint: (0, context_footprint_1.contextFootprint)(options.workspace) };
+        }
+        if (operation === 'task') {
+            const row = get('SELECT t.*,c.agent_session_id FROM tasks t JOIN conversations c ON c.id=t.conversation_id WHERE t.id=? AND c.agent_session_id=?', options.taskId, options.sessionId);
+            if (!row)
+                return undefined;
+            const snapshot = JSON.parse(row.snapshot_json);
+            // The assignment text is never stored on the task snapshot — it lives in task_revisions.
+            // Read the revisions the worker actually received (appliedRevision, or the newest authored
+            // one before the first claim) and normalize them exactly like TaskService.revision() does,
+            // so a revision > 1 shows the effective brief instead of append-only answer text.
+            const effectiveRevision = Number(snapshot.appliedRevision) || Number(snapshot.revision) || Number.MAX_SAFE_INTEGER;
+            const revisions = all('SELECT payload_json FROM task_revisions WHERE task_id=? AND revision<=? ORDER BY revision', options.taskId, effectiveRevision)
+                .map(r => JSON.parse(String(r.payload_json)));
+            const instructions = revisions.length ? (0, task_directive_1.normalizeTaskRevisions)(revisions).instructions : undefined;
+            const offset = Math.max(0, Number(options.offset) || 0);
+            const attempts = all(`SELECT payload_json FROM task_attempts WHERE task_id=? AND COALESCE(json_extract(payload_json,'$.startedAt'),0)>=? ORDER BY generation DESC LIMIT 25 OFFSET ?`, options.taskId, since, offset).map(r => {
+                const attempt = JSON.parse(r.payload_json);
+                const metrics = exists('token_turns') ? get('SELECT payload_json FROM token_turns WHERE id=? AND session_id=?', attempt.attemptId, options.sessionId) : undefined;
+                const events = all('SELECT type,payload_json,occurred_at FROM worker_events WHERE attempt_id=? ORDER BY local_seq DESC LIMIT 30', attempt.attemptId).map(e => ({ type: e.type, at: e.occurred_at, payload: JSON.parse(e.payload_json) }));
+                return { ...attempt, metrics: metrics ? JSON.parse(metrics.payload_json) : null, events };
+            });
+            return { snapshot, instructions, attempts, totalAttempts: Number(get("SELECT COUNT(*) n FROM task_attempts WHERE task_id=? AND COALESCE(json_extract(payload_json,'$.startedAt'),0)>=?", options.taskId, since).n), offset };
+        }
+        const offset = Math.max(0, Number(options.offset) || 0), limit = 25;
+        const conversations = all('SELECT c.* FROM conversations c WHERE c.updated_at>=? ORDER BY c.updated_at DESC,c.id DESC LIMIT ? OFFSET ?', since, limit, offset);
+        const sessions = conversations.map(c => {
+            const turns = exists('token_turn_metrics')
+                ? all("SELECT COALESCE(m.payload_json,json_remove(t.payload_json,'$.requests','$.inputTexts','$.responseText')) payload_json FROM token_turns t LEFT JOIN token_turn_metrics m ON m.id=t.id WHERE t.session_id=? AND t.started_at>=? ORDER BY t.started_at,t.id", c.agent_session_id, since).map(r => JSON.parse(r.payload_json))
+                : exists('token_turns') ? all(`SELECT id,role,task_id,started_at,json_extract(payload_json,'$.usage') usage,
+          json_extract(payload_json,'$.loadedTools') loadedTools,json_extract(payload_json,'$.usedTools') usedTools,
+          json_extract(payload_json,'$.model') model FROM token_turns WHERE session_id=? AND started_at>=? ORDER BY started_at,id`, c.agent_session_id, since).map(r => ({ ...r, taskId: r.task_id, startedAt: r.started_at, sessionId: c.agent_session_id, usage: r.usage ? JSON.parse(r.usage) : null, loadedTools: r.loadedTools ? JSON.parse(r.loadedTools) : null, usedTools: r.usedTools ? JSON.parse(r.usedTools) : [] })) : [];
+            const agent = (0, token_ledger_1.summarizeTokenTurns)(turns.filter(t => t.role === 'agent')), workers = (0, token_ledger_1.summarizeTokenTurns)(turns.filter(t => t.role === 'worker'));
+            const tasks = all(`SELECT * FROM tasks WHERE conversation_id=? AND updated_at>=? ORDER BY updated_at DESC,id DESC LIMIT 100`, c.id, since).map(t => {
+                const snapshot = JSON.parse(t.snapshot_json);
+                const last = t.active_attempt_id ? { id: t.active_attempt_id } : get('SELECT id FROM task_attempts WHERE task_id=? ORDER BY generation DESC LIMIT 1', t.id);
+                const attempt = last ? adapter.attempt(last.id) : undefined;
+                const metrics = (0, token_ledger_1.summarizeTokenTurns)(turns.filter(turn => turn.id === attempt?.attemptId));
+                const total = (0, token_ledger_1.summarizeTokenTurns)(turns.filter(turn => turn.taskId === t.id));
+                const lastTool = get("SELECT payload_json,occurred_at FROM conversation_events WHERE json_extract(payload_json,'$.task_id')=? AND type='tool.activity' ORDER BY seq DESC LIMIT 1", t.id);
+                const tool = lastTool ? JSON.parse(lastTool.payload_json).payload : undefined;
+                return { taskId: t.id, sessionId: c.agent_session_id, title: snapshot.title, state: t.state, updatedAt: t.updated_at,
+                    createdAt: t.created_at, execution: snapshot.execution, workerId: attempt?.workerId, attemptId: attempt?.attemptId,
+                    workerSessionId: attempt?.sessionId, resumed: attempt?.resumeSession, workstreamId: snapshot.workstreamId,
+                    continueTaskId: snapshot.continueTaskId, hostProcessId: t.active_attempt_id ? attempt?.processIdentity?.pid : undefined,
+                    tokenSummary: { totalTokens: metrics.totalTokens, allAttemptsTokens: total.totalTokens }, contextTools: metrics.contextTools, loadedTools: metrics.loadedTools, usedTools: metrics.usedTools,
+                    lastTool: tool ? { name: tool.name, type: tool.type, is_error: tool.is_error, at: lastTool.occurred_at } : undefined };
+            });
+            const { status: state, thinking } = conversationActivityStatus(get, all, c.id);
+            const totalTokens = agent.totalTokens === null && workers.totalTokens === null ? null : (agent.totalTokens ?? 0) + (workers.totalTokens ?? 0);
+            return { sessionId: c.agent_session_id, chatId: c.chat_id, source: c.source, orchestration: true, mode: 'headless', status: state, isRunning: thinking,
+                model: turns.filter(t => t.role === 'agent' && t.model).at(-1)?.model ?? '', updatedAt: c.updated_at, createdAt: c.created_at,
+                tokenSummary: { agentTokens: agent.totalTokens, workerTokens: workers.totalTokens, totalTokens }, contextTools: agent.contextTools, loadedTools: agent.loadedTools, usedTools: agent.usedTools,
+                tasks, totalTasks: Number(get('SELECT COUNT(*) n FROM tasks WHERE conversation_id=? AND updated_at>=?', c.id, since).n),
+                workerIds: all('SELECT id FROM worker_pool WHERE conversation_id=?', c.id).map(w => w.id), spawnedAt: 0, uptimeSec: 0, tokens: 0 };
+        });
+        const today = Date.now() - Date.now() % 86400000;
+        const usageToday = exists('token_turns') ? all(`SELECT role,CAST((started_at-?)/3600000 AS INTEGER) hour,SUM(json_extract(payload_json,'$.usage.totalTokens')) tokens FROM token_turns WHERE started_at>=? AND json_type(payload_json,'$.usage')='object' GROUP BY role,hour`, today, Math.max(today, since)) : [];
+        const attention = all(`SELECT t.id taskId,t.state,t.snapshot_json,c.agent_session_id sessionId FROM tasks t JOIN conversations c ON c.id=t.conversation_id WHERE t.updated_at>=? AND t.state IN ('waiting_input','needs_reconciliation') ORDER BY t.updated_at DESC LIMIT 8`, since).map(t => ({ taskId: t.taskId, state: t.state, sessionId: t.sessionId, title: JSON.parse(t.snapshot_json).title }));
+        const recentWork = all(`SELECT t.id taskId,t.state,t.snapshot_json,t.updated_at updatedAt,c.agent_session_id sessionId FROM tasks t JOIN conversations c ON c.id=t.conversation_id WHERE t.updated_at>=? ORDER BY t.updated_at DESC,t.id DESC LIMIT 6`, today).map(t => ({ taskId: t.taskId, state: t.state, sessionId: t.sessionId, updatedAt: t.updatedAt, title: JSON.parse(t.snapshot_json).title }));
+        const pool = exists('worker_pool') ? all('SELECT * FROM worker_pool') : [];
+        return { usageToday, attention, recentWork, managedLegacyIds: all('SELECT agent_session_id FROM conversations WHERE agent_session_id IN (SELECT value FROM json_each(?))', JSON.stringify(options.legacyIds ?? [])).map(c => c.agent_session_id), enabled: true, backend: 'headless', workspaceMode: options.workspaceMode, sessions, tasks: sessions.flatMap(s => s.tasks),
+            pagination: { offset, limit, total: Number(get('SELECT COUNT(*) n FROM conversations WHERE updated_at>=?', since).n) },
+            counts: { sessions: Number(get('SELECT COUNT(*) n FROM conversations WHERE updated_at>=?', since).n), tasks: all('SELECT state,COUNT(*) count FROM tasks WHERE updated_at>=? GROUP BY state', since) },
+            activeAgentSessions: sessions.filter(s => s.isRunning).map(s => s.sessionId),
+            workerPool: { maxWorkers: options.maxWorkers, idleTtlMs: options.idleTtlMs, workers: pool.map(w => ({ workerId: w.id, sessionId: w.session_id, workstreamId: w.workstream_id, state: w.active_task_id ? 'busy' : 'idle', taskId: w.active_task_id, expiresAt: w.active_task_id ? undefined : Number(w.idle_since) + Number(options.idleTtlMs) })) } };
+    }
+    finally {
+        db.exec('ROLLBACK');
+    }
+}
+worker_threads_1.parentPort.on('message', ({ id, operation, filename, options }) => {
+    try {
+        worker_threads_1.parentPort.postMessage({ id, value: read(filename, operation, options) });
+    }
+    catch {
+        worker_threads_1.parentPort.postMessage({ id, error: 'Unable to read dashboard data' });
+    }
+});
+//# sourceMappingURL=dashboard-reader-worker.js.map