visionclaw 0.1.219-dev.codex-issue-2805-worker-runtime.3 → 0.1.219-dev.codex-2941-task-board-on-main.1

package/dist/stt-client.js

@@ -62,6 +62,22 @@ function mergeVocabulary(...groups) {
  * request no one is waiting for.
  */
 export const STT_CLIENT_TIMEOUT_MS = 90_000;
+/**
+ * Total attempts when cloud STT fails with a transient URL-intake / transport
+ * `fetch failed` (Telegram CDN fetches are the usual case). Prefer 3 attempts
+ * total rather than "3 retries after the first".
+ */
+export const STT_TRANSIENT_FETCH_MAX_ATTEMPTS = 3;
+/** Short backoff between transient fetch retries. */
+export const STT_TRANSIENT_FETCH_RETRY_DELAY_MS = 300;
+/** True when the failure looks like a transient undici/CDN fetch failure. */
+export function isTransientSttFetchError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return /\bfetch failed\b/i.test(message);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 export class SttNotConfiguredError extends Error {
     constructor() {
         super("cloud STT service is not configured (no API key)");
@@ -136,40 +152,57 @@ export async function transcribeViaSttService(config, request) {
     else {
         throw new Error("transcribeViaSttService requires either url or bytes");
     }
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), STT_CLIENT_TIMEOUT_MS);
-    try {
-        const res = await fetch(url, {
-            method: "POST",
-            headers,
-            body,
-            signal: controller.signal,
-        });
-        const payload = (await res.json().catch(() => null));
-        if (!res.ok) {
-            const detail = payload?.error ?? `HTTP ${res.status}`;
-            throw new Error(`cloud STT failed: ${detail}`);
-        }
-        const text = payload?.text?.trim();
-        if (!text)
-            throw new Error("cloud STT returned no text");
-        if (request.ownerPublicId && vocabularySnapshotVersion !== undefined && vocabularyTermsForUsage?.length) {
-            try {
-                const { recordVocabularyUsage } = await import("./agent/vocabulary-glossary.js");
-                // Injection alone is not evidence of use. Reward only terms present in
-                // the successful transcript, with word boundaries for Latin terms.
-                const { containsVocabularyTerm } = await import("./agent/vocabulary-evidence.js");
-                const used = vocabularyTermsForUsage.filter((term) => vocabulary.includes(term) && containsVocabularyTerm(text, term));
-                recordVocabularyUsage(request.ownerPublicId, used, vocabularySnapshotVersion);
+    // URL intake (Telegram CDN → STT service) occasionally fails with undici
+    // "fetch failed". Retry a few times here so channel pre-transcription can
+    // still succeed before marking the voice note unheard. Do not log the
+    // request URL: Telegram file links embed the bot token.
+    let lastError;
+    for (let attempt = 1; attempt <= STT_TRANSIENT_FETCH_MAX_ATTEMPTS; attempt += 1) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), STT_CLIENT_TIMEOUT_MS);
+        try {
+            const res = await fetch(url, {
+                method: "POST",
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            const payload = (await res.json().catch(() => null));
+            if (!res.ok) {
+                const detail = payload?.error ?? `HTTP ${res.status}`;
+                throw new Error(`cloud STT failed: ${detail}`);
             }
-            catch {
-                logger.debug("[stt-client] Vocabulary usage update unavailable");
+            const text = payload?.text?.trim();
+            if (!text)
+                throw new Error("cloud STT returned no text");
+            if (request.ownerPublicId && vocabularySnapshotVersion !== undefined && vocabularyTermsForUsage?.length) {
+                try {
+                    const { recordVocabularyUsage } = await import("./agent/vocabulary-glossary.js");
+                    // Injection alone is not evidence of use. Reward only terms present in
+                    // the successful transcript, with word boundaries for Latin terms.
+                    const { containsVocabularyTerm } = await import("./agent/vocabulary-evidence.js");
+                    const used = vocabularyTermsForUsage.filter((term) => vocabulary.includes(term) && containsVocabularyTerm(text, term));
+                    recordVocabularyUsage(request.ownerPublicId, used, vocabularySnapshotVersion);
+                }
+                catch {
+                    logger.debug("[stt-client] Vocabulary usage update unavailable");
+                }
             }
+            return { text, vendor: payload?.vendor ?? "unknown" };
+        }
+        catch (err) {
+            lastError = err;
+            const canRetry = isTransientSttFetchError(err) && attempt < STT_TRANSIENT_FETCH_MAX_ATTEMPTS;
+            if (!canRetry)
+                throw err;
+            const detail = err instanceof Error ? err.message : String(err);
+            logger.warn(`[stt-client] Transient STT fetch failure (attempt ${attempt}/${STT_TRANSIENT_FETCH_MAX_ATTEMPTS}): ${detail}`);
+            await sleep(STT_TRANSIENT_FETCH_RETRY_DELAY_MS);
+        }
+        finally {
+            clearTimeout(timer);
         }
-        return { text, vendor: payload?.vendor ?? "unknown" };
-    }
-    finally {
-        clearTimeout(timer);
     }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
 }
 //# sourceMappingURL=stt-client.js.map

package/dist/stt-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"stt-client.js","sourceRoot":"","sources":["../src/stt-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,OAAO;IACP,OAAO;IACP,UAAU;IACV,YAAY;IACZ,WAAW;IACX,UAAU;IACV,IAAI;IACJ,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAErF,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,SAAS,eAAe,CAAC,GAAG,MAAsC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,KAAK,CAAC,MAAM,IAAI,wBAAwB;gBAAE,OAAO,KAAK,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AA8B5C,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,OAAO,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAwB,EACxB,OAAyB;IAEzB,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,qBAAqB,EAAE,CAAC;IAE/C,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,uBAAuB,CAAC;IACvD,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACjG,IAAI,UAAU,GAAG,eAAe,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;IAChF,IAAI,uBAA6C,CAAC;IAClD,IAAI,yBAA6C,CAAC;IAElD,gEAAgE;IAChE,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAClF,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;YAEvF,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE;gBAC7D,QAAQ,EAAE,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,QAAQ;aACzD,CAAC,CAAC;YAEH,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;gBAC1B,UAAU,GAAG,eAAe,CAAC,wBAAwB,EAAE,SAAS,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;gBAC1G,uBAAuB,GAAG,SAAS,CAAC,aAAa,CAAC;gBAClD,yBAAyB,GAAG,SAAS,CAAC,eAAe,CAAC;gBACtD,MAAM,CAAC,IAAI,CACT,yBAAyB,SAAS,CAAC,iBAAiB,gCAAgC,SAAS,CAAC,eAAe,GAAG,CACjH,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;YAC3E,MAAM,CAAC,IAAI,CACT,+CAA+C,CAChD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,iBAAiB,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAE/D,MAAM,OAAO,GAA2B,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,CAAC;IAC9E,IAAI,IAAqB,CAAC;IAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC;IAErB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC7C,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YACpB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM;YACN,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,UAAU;SACX,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACzB,mEAAmE;QACnE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC7C,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC1D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,0BAA0B;YACxD,MAAM;YACN,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,UAAU;SACX,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,qBAAqB,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI;YACJ,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAE3C,CAAC;QACT,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,OAAO,EAAE,KAAK,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,aAAa,IAAI,yBAAyB,KAAK,SAAS,IAAI,uBAAuB,EAAE,MAAM,EAAE,CAAC;YACxG,IAAI,CAAC;gBACH,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;gBACjF,uEAAuE;gBACvE,mEAAmE;gBACnE,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;gBAClF,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBACvH,qBAAqB,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,yBAAyB,CAAC,CAAC;YAChF,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,KAAK,CACV,kDAAkD,CACnD,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;IACxD,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"stt-client.js","sourceRoot":"","sources":["../src/stt-client.ts"],"names":[],"mappings":"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"}

package/dist/threads/foreground-task.d.ts

@@ -51,6 +51,8 @@ export type ForegroundAdmission = {
 export declare class ForegroundTaskTracker {
     private readonly now;
     private readonly isExempt;
+    /** Task ids the host accepted since the last reset; in memory for this wake only. */
+    private handedOffIds;
     private record;
     private readonly filePath;
     /**
@@ -69,8 +71,14 @@ export declare class ForegroundTaskTracker {
     admit(toolName: string): ForegroundAdmission;
     /** The current task, created when no task call has been made yet, for a handoff. */
     taskForHandoff(): ForegroundTaskRecord;
-    /** The worker accepted the task: General must not keep writing for it. */
-    markHandedOff(taskId: string): void;
+    /**
+     * The worker accepted the task: General must not keep writing for it.
+     * `acceptedTaskIds` are the ids the host admitted (a batch admits several),
+     * kept so the status card can wait for every one of them.
+     */
+    markHandedOff(taskId: string, acceptedTaskIds?: readonly string[]): void;
+    /** Every task id the host accepted during this wake, in order. */
+    handedOffTaskIds(): readonly string[];
     /**
      * A new wake starts. A task handed off in an earlier wake belongs to its
      * worker: follow-ups for it go through the coordination tools, so new task

package/dist/threads/foreground-task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foreground-task.d.ts","sourceRoot":"","sources":["../../src/threads/foreground-task.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAkB3D,QAAA,MAAM,YAAY;;;;;;;kBASP,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEhE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,qBAAa,qBAAqB;IAW9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;;OAIG;gBAED,GAAG,EAAE,MAAM,EACM,GAAG,GAAE,MAAM,IAAuB,EAClC,QAAQ,GAAE,MAAM,OAAqB;IAMxD,IAAI,OAAO,IAAI,oBAAoB,GAAG,IAAI,CAEzC;IAED,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IA+B5C,oFAAoF;IACpF,cAAc,IAAI,oBAAoB;IAMtC,0EAA0E;IAC1E,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOnC;;;;;OAKG;IACH,SAAS,IAAI,IAAI;IAIjB,sDAAsD;IACtD,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,IAAI;CAGb;AAID,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAExF;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE"}
+{"version":3,"file":"foreground-task.d.ts","sourceRoot":"","sources":["../../src/threads/foreground-task.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAkB3D,QAAA,MAAM,YAAY;;;;;;;kBASP,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEhE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,qBAAa,qBAAqB;IAa9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAb3B,qFAAqF;IACrF,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;;OAIG;gBAED,GAAG,EAAE,MAAM,EACM,GAAG,GAAE,MAAM,IAAuB,EAClC,QAAQ,GAAE,MAAM,OAAqB;IAMxD,IAAI,OAAO,IAAI,oBAAoB,GAAG,IAAI,CAEzC;IAED,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IA+B5C,oFAAoF;IACpF,cAAc,IAAI,oBAAoB;IAMtC;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,SAAS,MAAM,EAAa,GAAG,IAAI;IAQlF,kEAAkE;IAClE,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAIrC;;;;;OAKG;IACH,SAAS,IAAI,IAAI;IAKjB,sDAAsD;IACtD,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,IAAI;CAGb;AAID,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAExF;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE"}

package/dist/threads/foreground-task.js

@@ -67,6 +67,8 @@ export function countsAsForegroundWork(toolName) {
 export class ForegroundTaskTracker {
     now;
     isExempt;
+    /** Task ids the host accepted since the last reset; in memory for this wake only. */
+    handedOffIds = [];
     record;
     filePath;
     /**
@@ -112,7 +114,7 @@ export class ForegroundTaskTracker {
                 reason: [
                     `Foreground limit reached: this task already used ${record.toolCallsUsed} of ${FOREGROUND_TOOL_CALL_LIMIT} task tool calls in the conversation.`,
                     "If you already have enough to answer, answer now. If you only need a clarification, ask the user.",
-                    "Otherwise hand the remaining work to a background worker with delegate_task (say what is done, what remains, and any artifacts), tell the user it is running in the background, then call finish.",
+                    "Otherwise hand the remaining work to a background worker with delegate_task (say what is done, what remains, and any artifacts), tell the user in the first person that you are on it (never mention a background task, a worker or this limit), then call finish.",
                 ].join(" "),
             };
         }
@@ -127,14 +129,25 @@ export class ForegroundTaskTracker {
         this.save();
         return { ...record, calls: [...record.calls] };
     }
-    /** The worker accepted the task: General must not keep writing for it. */
-    markHandedOff(taskId) {
+    /**
+     * The worker accepted the task: General must not keep writing for it.
+     * `acceptedTaskIds` are the ids the host admitted (a batch admits several),
+     * kept so the status card can wait for every one of them.
+     */
+    markHandedOff(taskId, acceptedTaskIds = [taskId]) {
+        for (const id of acceptedTaskIds)
+            if (!this.handedOffIds.includes(id))
+                this.handedOffIds.push(id);
         if (this.record?.taskId !== taskId)
             return;
         this.record.handedOff = true;
         this.record.accountedToolCalls = this.record.toolCallsUsed;
         this.save();
     }
+    /** Every task id the host accepted during this wake, in order. */
+    handedOffTaskIds() {
+        return this.handedOffIds;
+    }
     /**
      * A new wake starts. A task handed off in an earlier wake belongs to its
      * worker: follow-ups for it go through the coordination tools, so new task
@@ -142,12 +155,14 @@ export class ForegroundTaskTracker {
      * foreground keeps its count across wakes.
      */
     beginWake() {
+        this.handedOffIds = [];
         if (this.record?.handedOff)
             this.reset();
     }
     /** The task ended: the next task starts from zero. */
     reset() {
         this.record = null;
+        this.handedOffIds = [];
         try {
             fs.rmSync(this.filePath, { force: true });
         }

package/dist/threads/foreground-task.js.map

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

package/dist/threads/foreman-host.d.ts

@@ -1,4 +1,4 @@
-import { type CommandMessage, type DeliveryTarget } from "../channels/interface.js";
+import { type BackgroundTaskFailure, type BackgroundTaskView, type CommandMessage, type DeliveryTarget } from "../channels/interface.js";
 import type { DeliveryResult } from "../channels/manager.js";
 import type { ExecutionService } from "../agent/state.js";
 import { type Locale } from "../i18n/index.js";
@@ -19,11 +19,17 @@ export interface ForemanHostDeps {
     enqueueToGeneral: (threadId: string, message: CommandMessage) => void;
     /** Send a fallback notice to a recorded reply target. */
     deliver: (target: DeliveryTarget, text: string, threadId: string) => Promise<DeliveryResult>;
+    /** Mirror a task's state to the task board of its reply target's channel. */
+    publishTask?: (target: DeliveryTarget, task: BackgroundTaskView) => void;
+    /** A conversation's Task reached a final state; its progress card stops waiting for it. */
+    settleTask?: (threadId: string, taskId: string, state: "completed" | "failed") => void;
     /** The owner's primary target, for a default-thread task dispatched without an inbound message. */
     ownerTarget: () => DeliveryTarget | null;
     locale: () => Locale;
     now?: () => Date;
 }
+/** The plain category the user is told for a failure code (worker-reported failures have none). */
+export declare function failureKind(code: string | undefined): BackgroundTaskFailure;
 export declare class ForemanHost {
     private readonly deps;
     private readonly pendingBatches;
@@ -44,12 +50,18 @@ export declare class ForemanHost {
      * in the thread's durable queue; a throw makes the outbox retry it.
      */
     deliverEvent(event: ExecutionEvent, caller: ExecutionCaller): Promise<boolean>;
+    /** Live execution events: show the delegating chat where each of its tasks stands. */
+    publishTaskState(event: ExecutionEvent, caller: ExecutionCaller): void;
+    /** A task's current board row from the ledger; null when the task or its run is unknown. */
+    taskView(taskId: string): BackgroundTaskView | null;
     /** Deliver the public event content for every obligation that is due. */
     sweep(): Promise<void>;
     private run;
     private envelope;
     /** A task dispatched by this thread; any other thread's task is not visible. */
     private ownedDispatch;
+    /** Why the task's latest run did not finish, in plain words for the fallback notice. */
+    private failureText;
     private latest;
     private childRecords;
     private parentState;

package/dist/threads/foreman-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foreman-host.d.ts","sourceRoot":"","sources":["../../src/threads/foreman-host.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"foreman-host.d.ts","sourceRoot":"","sources":["../../src/threads/foreman-host.ts"],"names":[],"mappings":"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"}

package/dist/threads/foreman-host.js

@@ -1,5 +1,5 @@
 import { createHash, randomUUID } from "node:crypto";
-import { DEFAULT_THREAD_ID } from "../channels/interface.js";
+import { DEFAULT_THREAD_ID, } from "../channels/interface.js";
 import { isDeliveryTarget } from "../channels/delivery-target.js";
 import { taskContinuationRouting } from "../agent/reply-target.js";
 import { resolveWorkspaceCwd } from "../agent/workspace-cwd.js";
@@ -70,6 +70,27 @@ function describeState(record) {
         case "cancelled": return "cancelled";
     }
 }
+function boardState(state) {
+    switch (state) {
+        case "queued": return "queued";
+        case "running":
+        case "cancel_requested": return "running";
+        case "waiting_input": return "waiting";
+        case "succeeded": return "completed";
+        case "failed": return "failed";
+        case "cancelled": return "cancelled";
+    }
+}
+/** The plain category the user is told for a failure code (worker-reported failures have none). */
+export function failureKind(code) {
+    switch (code) {
+        case "budget_exhausted": return "limit";
+        case "interrupted":
+        case "executor_exit":
+        case "executor_refused": return "interrupted";
+        default: return "error";
+    }
+}
 function fallbackKey(obligation) {
     if (obligation.kind === "question")
         return "foreman.fallback.question";
@@ -180,6 +201,43 @@ export class ForemanHost {
         }
         return direct ? this.sweep().then(() => true) : Promise.resolve(true);
     }
+    /** Live execution events: show the delegating chat where each of its tasks stands. */
+    publishTaskState(event, caller) {
+        if (caller.kind !== "general" || event.type === "progress")
+            return;
+        const dispatch = this.ownedDispatch(caller.ref, event.taskId);
+        const record = this.latest(event.taskId);
+        // An older execution's late event must not overwrite its retry's state.
+        if (!dispatch || record?.executionId !== event.executionId)
+            return;
+        const state = boardState(record.state);
+        if (state === "completed" || state === "failed" || state === "cancelled") {
+            this.deps.settleTask?.(caller.ref, dispatch.taskId, state === "completed" ? "completed" : "failed");
+        }
+        if (!dispatch.replyTarget || !this.deps.publishTask)
+            return;
+        this.deps.publishTask(dispatch.replyTarget, {
+            taskId: dispatch.taskId,
+            title: dispatch.title,
+            state,
+            ...(record.state === "failed" ? { failure: failureKind(record.result?.error?.code) } : {}),
+            at: record.updatedAt,
+        });
+    }
+    /** A task's current board row from the ledger; null when the task or its run is unknown. */
+    taskView(taskId) {
+        const dispatch = this.deps.store.dispatch(taskId);
+        const record = dispatch ? this.latest(taskId) : null;
+        if (!dispatch || !record)
+            return null;
+        return {
+            taskId: dispatch.taskId,
+            title: dispatch.title,
+            state: boardState(record.state),
+            ...(record.state === "failed" ? { failure: failureKind(record.result?.error?.code) } : {}),
+            at: record.updatedAt,
+        };
+    }
     /** Deliver the public event content for every obligation that is due. */
     async sweep() {
         if (this.sweeping)
@@ -201,9 +259,11 @@ export class ForemanHost {
                     ? this.allEvents(obligation.executionId).find((event) => event.eventId === obligation.eventId) : undefined;
                 const publicText = obligation.publicText ?? (legacyEvent ? publicTaskText(legacyEvent) : null);
                 const text = obligation.deliveryMode === "direct" && publicText ? `${dispatch.title}\n\n${publicText}`
-                    : obligation.deliveryMode === "review" && obligation.kind === "result"
+                    // A finished result still waits for General's reply; a task that did
+                    // not finish says so, with the plain reason.
+                    : obligation.deliveryMode === "review" && obligation.kind === "result" && obligation.status === "succeeded"
                         ? t("foreman.fallback.review", this.deps.locale(), dispatch.title)
-                        : [t(fallbackKey(obligation), this.deps.locale(), dispatch.title), publicText].filter(Boolean).join("\n\n");
+                        : [t(fallbackKey(obligation), this.deps.locale(), dispatch.title, this.failureText(obligation.taskId)), publicText].filter(Boolean).join("\n\n");
                 let result;
                 try {
                     result = await this.deps.deliver(dispatch.replyTarget, text, dispatch.threadId);
@@ -268,6 +328,10 @@ export class ForemanHost {
         const dispatch = this.deps.store.dispatch(taskId);
         return dispatch?.threadId === threadId ? dispatch : null;
     }
+    /** Why the task's latest run did not finish, in plain words for the fallback notice. */
+    failureText(taskId) {
+        return t(`task.failure.${failureKind(this.latest(taskId)?.result?.error?.code)}`, this.deps.locale());
+    }
     latest(taskId) {
         return this.deps.executions.latestForTask(taskId, FOREMAN_SCOPE);
     }
@@ -888,14 +952,14 @@ export class ForemanHost {
                 lines.push(`Review the child results together. Deliver the overall result with notify_user(${quote}, purpose="completion"). Retry only children that need further work using their child task_id; do not repeat successful children. The parent does not occupy a worker.`);
             }
             else if (status === "succeeded") {
-                lines.push(`Check the result against the request before you deliver it. If it holds up, tell the requester with notify_user(${quote}, purpose="completion") in your own words, and send any drafts it contains with the right tool. If it falls short, run it again with delegate_task(retry_task_id="${event.taskId}") and say what must change.`);
+                lines.push(`Check the result against the request before you deliver it. If it holds up, tell the requester with notify_user(${quote}, purpose="completion") in your own words, as your own work and without calling it a background task. Put the actual result in that message (what was found, made, or the output that was asked for), not only that it is done. Send any drafts it contains with the right tool. If it falls short, run it again with delegate_task(retry_task_id="${event.taskId}") and say what must change.`);
             }
             else {
-                lines.push(`Tell the requester what happened with notify_user(${quote}, purpose="completion"), or run it again with delegate_task(retry_task_id="${event.taskId}") if a retry can succeed.`);
+                lines.push(`Tell the requester with notify_user(${quote}, purpose="completion") in your own first-person words what went wrong, in plain terms without internal details, and what happens next. Or run it again with delegate_task(retry_task_id="${event.taskId}") if a retry can succeed.`);
             }
         }
         if (obligationOpens)
-            lines.push("If this turn ends without that notify_user, the requester gets a short automatic notice instead.");
+            lines.push("Send one notify_user per task that names it, even when several tasks report in the same turn. If this turn ends without that notify_user, the requester gets a short automatic notice instead.");
         const routing = taskContinuationRouting(dispatch?.replyTarget
             ? { sender: dispatch.sender, delivery: dispatch.replyTarget }
             : undefined);
@@ -908,7 +972,15 @@ export class ForemanHost {
             attachments: [],
             timestamp: event.createdAt,
             ...routing,
-            meta: { ...routing.meta, [FOREMAN_EVENT_META_KEY]: { taskId: event.taskId, eventId: event.eventId } },
+            meta: {
+                ...routing.meta,
+                [FOREMAN_EVENT_META_KEY]: {
+                    taskId: event.taskId,
+                    eventId: event.eventId,
+                    kind: event.type,
+                    ...(event.type === "result" ? { status: String(payload.status) } : {}),
+                },
+            },
             ...(threadId !== DEFAULT_THREAD_ID ? { threadId } : {}),
         };
     }