@karmaniverous/jeeves-meta 0.15.12 → 0.16.0

package/README.md

@@ -66,7 +66,7 @@ jeeves-meta service install --config /path/to/jeeves-meta/config.json
 | POST | `/config/apply` | Apply a config patch (merge or replace) |
 | GET | `/queue` | Queue state: current (with phase), overrides, automatic, pending |
 | POST | `/queue/clear` | Remove all override queue entries |
-| PATCH | `/metas/:path` | Update user-settable reserved properties (`_steer`, `_emphasis`, `_depth`, `_crossRefs`, `_disabled`, `_architectTimeout`, `_builderTimeout`, `_criticTimeout`) |
+| PATCH | `/metas/:path` | Update user-settable reserved properties (`_steer`, `_emphasis`, `_depth`, `_crossRefs`, `_disabled`) |
 
 ## Configuration
 

package/dist/cli/jeeves-meta/architect.md

@@ -128,8 +128,6 @@ The Builder should:
 4. Merge new findings with previous `_content` (carried in context)
 
 If the scope is small enough to process in one pass, omit chunking instructions.
-The Builder has a timeout of \{{config.builderTimeout}} seconds.
-
 ### 8. Output Structure
 
 Define non-underscore fields for structured data and the _content narrative
@@ -148,7 +146,6 @@ Quote the specific issue and state what to do differently.
 Your task brief will be compiled as a Handlebars template before the Builder
 receives it. You can use these variables to write adaptive instructions:
 
-- `\{{config.builderTimeout}}` — Builder timeout in seconds
 - `\{{config.maxLines}}` — Maximum _content lines
 - `\{{config.architectEvery}}` — Cycles between architect refreshes
 - `\{{config.maxArchive}}` — Archive snapshots retained
@@ -159,7 +156,7 @@ receives it. You can use these variables to write adaptive instructions:
 - `\{{meta._depth}}` — Scheduling depth
 - `\{{meta._emphasis}}` — Scheduling emphasis
 
-Example: "Process files in chunks of 50. You have \{{config.builderTimeout}} seconds."
+Example: "Process files in chunks of 50. Limit output to \{{config.maxLines}} lines."
 
 ## Constraints
 

package/dist/cli/jeeves-meta/index.js

@@ -782,12 +782,6 @@ const autoSeedRuleSchema = z.object({
     crossRefs: z.array(z.string()).optional(),
     /** Walk up this many extra parent levels from the matched file's directory. Default 0. */
     parentDepth: z.number().int().min(0).optional(),
-    /** Per-category timeout override for the architect phase (seconds, min 30). */
-    architectTimeout: z.number().int().min(30).optional(),
-    /** Per-category timeout override for the builder phase (seconds, min 30). */
-    builderTimeout: z.number().int().min(30).optional(),
-    /** Per-category timeout override for the critic phase (seconds, min 30). */
-    criticTimeout: z.number().int().min(30).optional(),
 });
 /** Zod schema for jeeves-meta service configuration (superset of MetaConfig). */
 const serviceConfigSchema = metaConfigSchema.extend({
@@ -925,7 +919,7 @@ class SpawnTimeoutError extends Error {
  * @module executor/GatewayExecutor
  */
 const DEFAULT_POLL_INTERVAL_MS = 5000;
-const DEFAULT_TIMEOUT_MS$1 = 600_000; // 10 minutes
+const DEFAULT_SAFETY_VALVE_MS = 3_600_000; // 1 hour fallback
 /**
  * MetaExecutor that spawns OpenClaw sessions via the gateway's
  * `/tools/invoke` endpoint.
@@ -956,6 +950,42 @@ class GatewayExecutor {
             /* best-effort cleanup */
         }
     }
+    /** Read and clean up the staging output file. Returns content or undefined if absent. */
+    readStagingFile(outputPath) {
+        if (!existsSync(outputPath))
+            return undefined;
+        try {
+            return readFileSync(outputPath, 'utf8');
+        }
+        finally {
+            this.cleanupOutputFile(outputPath);
+        }
+    }
+    /** Extract plain text from a message content field, skipping ANNOUNCE_SKIP sentinels. */
+    static extractMessageText(content) {
+        if (!content)
+            return undefined;
+        const text = typeof content === 'string'
+            ? content
+            : Array.isArray(content)
+                ? content
+                    .filter((b) => b.type === 'text' && b.text)
+                    .map((b) => b.text)
+                    .join('\n')
+                : '';
+        return text && text.trim() !== 'ANNOUNCE_SKIP' ? text : undefined;
+    }
+    /** Check history messages for terminal completion. */
+    static checkHistoryCompletion(messages) {
+        if (messages.length === 0)
+            return { done: false, timedOut: false };
+        const last = messages[messages.length - 1];
+        if (last.role !== 'assistant' || !last.stopReason)
+            return { done: false, timedOut: false };
+        if (last.stopReason === 'toolUse' || last.stopReason === 'error')
+            return { done: false, timedOut: false };
+        return { done: true, timedOut: last.stopReason === 'timeout' };
+    }
     /** Invoke a gateway tool via the /tools/invoke HTTP endpoint. */
     async invoke(tool, args, sessionKey) {
         const headers = {
@@ -982,7 +1012,13 @@ class GatewayExecutor {
         }
         return data;
     }
-    /** Look up session metadata (tokens, completion status) via sessions_list. */
+    /**
+     * Look up session metadata (tokens, completion status) via sessions_list.
+     *
+     * Detects gateway-side timeout (`status: "timeout"`) and killed sessions
+     * (`status: "killed"`) as completed, with a `timedOut` flag to distinguish
+     * timeout from normal completion.
+     */
     async getSessionInfo(sessionKey) {
         try {
             const result = await this.invoke('sessions_list', {
@@ -998,13 +1034,18 @@ class GatewayExecutor {
                 // With limit=200 this is reliable; a false positive here only
                 // means we read the output file slightly early (still correct
                 // if the file exists).
-                return { completed: true };
+                return { completed: true, timedOut: false };
             }
-            const done = match.status === 'completed' || match.status === 'done';
-            return { tokens: match.totalTokens, completed: done };
+            const status = match.status;
+            const done = status === 'completed' ||
+                status === 'done' ||
+                status === 'timeout' ||
+                status === 'killed';
+            const timedOut = status === 'timeout';
+            return { tokens: match.totalTokens, completed: done, timedOut };
         }
         catch {
-            return { completed: false };
+            return { completed: false, timedOut: false };
         }
     }
     /** Whether this executor has been aborted by the operator. */
@@ -1015,12 +1056,38 @@ class GatewayExecutor {
     abort() {
         this.controller.abort();
     }
+    /**
+     * Query the gateway's configured subagent run timeout.
+     *
+     * Returns the value in milliseconds, or `undefined` if the query fails
+     * or the value is absent/zero (no timeout configured).
+     */
+    async queryGatewayRunTimeout() {
+        try {
+            const result = await this.invoke('session_status', {});
+            const details = (result.result?.details ?? result.result ?? {});
+            const runTimeoutSeconds = details.runTimeoutSeconds ??
+                details.timeout;
+            if (typeof runTimeoutSeconds === 'number' && runTimeoutSeconds > 0) {
+                return runTimeoutSeconds * 1000;
+            }
+        }
+        catch {
+            // Gateway unreachable or field not exposed — fall back to default
+        }
+        return undefined;
+    }
     async spawn(task, options) {
         // Fresh controller for each spawn call
         this.controller = new AbortController();
-        const timeoutSeconds = options?.timeout ?? DEFAULT_TIMEOUT_MS$1 / 1000;
-        const timeoutMs = timeoutSeconds * 1000;
-        const deadline = Date.now() + timeoutMs;
+        // Safety-valve deadline: gateway's runTimeoutSeconds + 60s buffer,
+        // defaulting to 1 hour if the gateway value is 0/absent/query fails.
+        // This is a circuit breaker, not a timeout mechanism.
+        const gatewayTimeoutMs = await this.queryGatewayRunTimeout();
+        const safetyValveMs = gatewayTimeoutMs
+            ? gatewayTimeoutMs + 60_000
+            : DEFAULT_SAFETY_VALVE_MS;
+        const safetyDeadline = Date.now() + safetyValveMs;
         // Ensure workspace dir exists
         if (!existsSync(this.workspaceDir)) {
             mkdirSync(this.workspaceDir, { recursive: true });
@@ -1042,7 +1109,6 @@ class GatewayExecutor {
         const spawnResult = await this.invoke('sessions_spawn', {
             task: taskWithOutput,
             label,
-            runTimeoutSeconds: timeoutSeconds,
             ...(options?.thinking ? { thinking: options.thinking } : {}),
             ...(options?.model ? { model: options.model } : {}),
         });
@@ -1054,9 +1120,18 @@ class GatewayExecutor {
             throw new Error('Gateway sessions_spawn returned no sessionKey: ' +
                 JSON.stringify(spawnResult));
         }
-        // Step 2: Poll for completion via sessions_history
+        // Step 2: Poll for completion — gateway owns the subagent lifecycle.
+        // Loop exits via: (a) completion detection, (b) abort signal,
+        // (c) gateway-side timeout detection, or (d) safety-valve circuit breaker.
         await sleepAsync(3000);
-        while (Date.now() < deadline) {
+        while (true) {
+            // Safety-valve circuit breaker
+            if (Date.now() >= safetyDeadline) {
+                this.cleanupOutputFile(outputPath);
+                throw new SpawnTimeoutError('Safety-valve deadline exceeded (' +
+                    safetyValveMs.toString() +
+                    'ms) — gateway timeout may be misconfigured', outputPath);
+            }
             // Check for abort before each poll iteration
             if (this.controller.signal.aborted) {
                 this.cleanupOutputFile(outputPath);
@@ -1073,62 +1148,48 @@ class GatewayExecutor {
                     [];
                 const msgArray = messages;
                 // Check 1: terminal stop reason in history
-                let historyDone = false;
-                if (msgArray.length > 0) {
-                    const lastMsg = msgArray[msgArray.length - 1];
-                    if (lastMsg.role === 'assistant' &&
-                        lastMsg.stopReason &&
-                        lastMsg.stopReason !== 'toolUse' &&
-                        lastMsg.stopReason !== 'error') {
-                        historyDone = true;
-                    }
-                }
+                const { done: historyDone, timedOut: historyTimedOut } = GatewayExecutor.checkHistoryCompletion(msgArray);
                 // Check 2: session completion status via sessions_list
                 const sessionInfo = await this.getSessionInfo(sessionKey);
+                const timedOut = sessionInfo.timedOut || historyTimedOut;
                 if (historyDone || sessionInfo.completed) {
                     const tokens = sessionInfo.tokens;
-                    // Read output from file (sub-agent wrote it via Write tool)
-                    if (existsSync(outputPath)) {
-                        try {
-                            const output = readFileSync(outputPath, 'utf8');
+                    // Gateway-side timeout detected — check staging file for recovery
+                    if (timedOut) {
+                        const output = this.readStagingFile(outputPath);
+                        if (output !== undefined)
                             return { output, tokens };
-                        }
-                        finally {
-                            try {
-                                unlinkSync(outputPath);
-                            }
-                            catch {
-                                /* cleanup best-effort */
-                            }
-                        }
+                        // No output or partial output — throw for _state recovery (§3.16.6)
+                        throw new SpawnTimeoutError('Gateway-side timeout detected (session status: timeout)', outputPath);
                     }
+                    // Normal completion — read output from file
+                    const output = this.readStagingFile(outputPath);
+                    if (output !== undefined)
+                        return { output, tokens };
                     // Fallback: extract from message content if file wasn't written.
                     // Skip ANNOUNCE_SKIP sentinel messages — the real output is in
                     // a preceding assistant message (the file write).
                     for (let i = msgArray.length - 1; i >= 0; i--) {
                         const msg = msgArray[i];
-                        if (msg.role === 'assistant' && msg.content) {
-                            const text = typeof msg.content === 'string'
-                                ? msg.content
-                                : Array.isArray(msg.content)
-                                    ? msg.content
-                                        .filter((b) => b.type === 'text' && b.text)
-                                        .map((b) => b.text)
-                                        .join('\n')
-                                    : '';
-                            if (text && text.trim() !== 'ANNOUNCE_SKIP')
+                        if (msg.role === 'assistant') {
+                            const text = GatewayExecutor.extractMessageText(msg.content);
+                            if (text !== undefined)
                                 return { output: text, tokens };
                         }
                     }
                     return { output: '', tokens };
                 }
             }
-            catch {
+            catch (err) {
+                // Re-throw SpawnTimeoutError and SpawnAbortedError — only swallow transient poll failures
+                if (err instanceof SpawnTimeoutError ||
+                    err instanceof SpawnAbortedError) {
+                    throw err;
+                }
                 // Transient poll failure — keep trying
             }
             await sleepAsync(this.pollIntervalMs);
         }
-        throw new SpawnTimeoutError('Synthesis subprocess timed out after ' + timeoutMs.toString() + 'ms', outputPath);
     }
 }
 
@@ -2626,7 +2687,6 @@ async function runArchitect(node, currentMeta, phaseState, config, executor, wat
         const architectTask = buildArchitectTask(ctx, currentMeta, config);
         const result = await executor.spawn(architectTask, {
             thinking: config.thinking,
-            timeout: currentMeta._architectTimeout ?? config.architectTimeout,
             label: 'meta-architect',
         });
         const builderBrief = parseArchitectOutput(result.output);
@@ -2678,7 +2738,6 @@ async function runBuilder(node, currentMeta, phaseState, config, executor, watch
         const builderTask = buildBuilderTask(ctx, currentMeta, config);
         const result = await executor.spawn(builderTask, {
             thinking: config.thinking,
-            timeout: currentMeta._builderTimeout ?? config.builderTimeout,
             label: 'meta-builder',
         });
         const rawOutput = result.output;
@@ -2773,7 +2832,6 @@ async function runCritic(node, currentMeta, phaseState, config, executor, watche
         const criticTask = buildCriticTask(ctx, metaForCritic, config);
         const result = await executor.spawn(criticTask, {
             thinking: config.thinking,
-            timeout: currentMeta._criticTimeout ?? config.criticTimeout,
             label: 'meta-critic',
         });
         const feedback = parseCriticOutput(result.output);
@@ -3686,12 +3744,6 @@ async function createMeta(ownerPath, options) {
         metaJson._crossRefs = options.crossRefs;
     if (options?.steer !== undefined)
         metaJson._steer = options.steer;
-    if (options?.architectTimeout !== undefined)
-        metaJson._architectTimeout = options.architectTimeout;
-    if (options?.builderTimeout !== undefined)
-        metaJson._builderTimeout = options.builderTimeout;
-    if (options?.criticTimeout !== undefined)
-        metaJson._criticTimeout = options.criticTimeout;
     const metaJsonPath = join(metaDir, 'meta.json');
     await writeFile(metaJsonPath, JSON.stringify(metaJson, null, 2) + '\n');
     return { metaDir, _id };
@@ -3767,9 +3819,6 @@ async function autoSeedPass(rules, watcher, logger) {
             candidates.set(dir, {
                 steer: rule.steer,
                 crossRefs: rule.crossRefs,
-                architectTimeout: rule.architectTimeout,
-                builderTimeout: rule.builderTimeout,
-                criticTimeout: rule.criticTimeout,
             });
         }
     }
@@ -4339,7 +4388,7 @@ function registerMetasRoutes(app, deps) {
 /**
  * PATCH /metas/:path — update user-settable reserved properties on a meta.
  *
- * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled, _architectTimeout, _builderTimeout, _criticTimeout.
+ * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled.
  * Set a field to null to remove it. Unknown keys are rejected.
  *
  * @module routes/metasUpdate
@@ -4351,9 +4400,6 @@ const updateBodySchema = z
     _depth: z.union([z.number(), z.null()]).optional(),
     _crossRefs: z.union([z.array(z.string()), z.null()]).optional(),
     _disabled: z.union([z.boolean(), z.null()]).optional(),
-    _architectTimeout: z.union([z.number().int().min(30), z.null()]).optional(),
-    _builderTimeout: z.union([z.number().int().min(30), z.null()]).optional(),
-    _criticTimeout: z.union([z.number().int().min(30), z.null()]).optional(),
 })
     .strict();
 function registerMetasUpdateRoute(app, deps) {

package/dist/executor/GatewayExecutor.d.ts

@@ -36,13 +36,32 @@ export declare class GatewayExecutor implements MetaExecutor {
     constructor(options?: GatewayExecutorOptions);
     /** Remove a temp output file if it exists. */
     private cleanupOutputFile;
+    /** Read and clean up the staging output file. Returns content or undefined if absent. */
+    private readStagingFile;
+    /** Extract plain text from a message content field, skipping ANNOUNCE_SKIP sentinels. */
+    private static extractMessageText;
+    /** Check history messages for terminal completion. */
+    private static checkHistoryCompletion;
     /** Invoke a gateway tool via the /tools/invoke HTTP endpoint. */
     private invoke;
-    /** Look up session metadata (tokens, completion status) via sessions_list. */
+    /**
+     * Look up session metadata (tokens, completion status) via sessions_list.
+     *
+     * Detects gateway-side timeout (`status: "timeout"`) and killed sessions
+     * (`status: "killed"`) as completed, with a `timedOut` flag to distinguish
+     * timeout from normal completion.
+     */
     private getSessionInfo;
     /** Whether this executor has been aborted by the operator. */
     get aborted(): boolean;
     /** Abort the currently running spawn, if any. */
     abort(): void;
+    /**
+     * Query the gateway's configured subagent run timeout.
+     *
+     * Returns the value in milliseconds, or `undefined` if the query fails
+     * or the value is absent/zero (no timeout configured).
+     */
+    private queryGatewayRunTimeout;
     spawn(task: string, options?: MetaSpawnOptions): Promise<MetaSpawnResult>;
 }

package/dist/index.js

@@ -1271,12 +1271,6 @@ const autoSeedRuleSchema = z.object({
     crossRefs: z.array(z.string()).optional(),
     /** Walk up this many extra parent levels from the matched file's directory. Default 0. */
     parentDepth: z.number().int().min(0).optional(),
-    /** Per-category timeout override for the architect phase (seconds, min 30). */
-    architectTimeout: z.number().int().min(30).optional(),
-    /** Per-category timeout override for the builder phase (seconds, min 30). */
-    builderTimeout: z.number().int().min(30).optional(),
-    /** Per-category timeout override for the critic phase (seconds, min 30). */
-    criticTimeout: z.number().int().min(30).optional(),
 });
 /** Zod schema for jeeves-meta service configuration (superset of MetaConfig). */
 const serviceConfigSchema = metaConfigSchema.extend({
@@ -1459,7 +1453,7 @@ class SpawnTimeoutError extends Error {
  * @module executor/GatewayExecutor
  */
 const DEFAULT_POLL_INTERVAL_MS = 5000;
-const DEFAULT_TIMEOUT_MS$1 = 600_000; // 10 minutes
+const DEFAULT_SAFETY_VALVE_MS = 3_600_000; // 1 hour fallback
 /**
  * MetaExecutor that spawns OpenClaw sessions via the gateway's
  * `/tools/invoke` endpoint.
@@ -1490,6 +1484,42 @@ class GatewayExecutor {
             /* best-effort cleanup */
         }
     }
+    /** Read and clean up the staging output file. Returns content or undefined if absent. */
+    readStagingFile(outputPath) {
+        if (!existsSync(outputPath))
+            return undefined;
+        try {
+            return readFileSync(outputPath, 'utf8');
+        }
+        finally {
+            this.cleanupOutputFile(outputPath);
+        }
+    }
+    /** Extract plain text from a message content field, skipping ANNOUNCE_SKIP sentinels. */
+    static extractMessageText(content) {
+        if (!content)
+            return undefined;
+        const text = typeof content === 'string'
+            ? content
+            : Array.isArray(content)
+                ? content
+                    .filter((b) => b.type === 'text' && b.text)
+                    .map((b) => b.text)
+                    .join('\n')
+                : '';
+        return text && text.trim() !== 'ANNOUNCE_SKIP' ? text : undefined;
+    }
+    /** Check history messages for terminal completion. */
+    static checkHistoryCompletion(messages) {
+        if (messages.length === 0)
+            return { done: false, timedOut: false };
+        const last = messages[messages.length - 1];
+        if (last.role !== 'assistant' || !last.stopReason)
+            return { done: false, timedOut: false };
+        if (last.stopReason === 'toolUse' || last.stopReason === 'error')
+            return { done: false, timedOut: false };
+        return { done: true, timedOut: last.stopReason === 'timeout' };
+    }
     /** Invoke a gateway tool via the /tools/invoke HTTP endpoint. */
     async invoke(tool, args, sessionKey) {
         const headers = {
@@ -1516,7 +1546,13 @@ class GatewayExecutor {
         }
         return data;
     }
-    /** Look up session metadata (tokens, completion status) via sessions_list. */
+    /**
+     * Look up session metadata (tokens, completion status) via sessions_list.
+     *
+     * Detects gateway-side timeout (`status: "timeout"`) and killed sessions
+     * (`status: "killed"`) as completed, with a `timedOut` flag to distinguish
+     * timeout from normal completion.
+     */
     async getSessionInfo(sessionKey) {
         try {
             const result = await this.invoke('sessions_list', {
@@ -1532,13 +1568,18 @@ class GatewayExecutor {
                 // With limit=200 this is reliable; a false positive here only
                 // means we read the output file slightly early (still correct
                 // if the file exists).
-                return { completed: true };
+                return { completed: true, timedOut: false };
             }
-            const done = match.status === 'completed' || match.status === 'done';
-            return { tokens: match.totalTokens, completed: done };
+            const status = match.status;
+            const done = status === 'completed' ||
+                status === 'done' ||
+                status === 'timeout' ||
+                status === 'killed';
+            const timedOut = status === 'timeout';
+            return { tokens: match.totalTokens, completed: done, timedOut };
         }
         catch {
-            return { completed: false };
+            return { completed: false, timedOut: false };
         }
     }
     /** Whether this executor has been aborted by the operator. */
@@ -1549,12 +1590,38 @@ class GatewayExecutor {
     abort() {
         this.controller.abort();
     }
+    /**
+     * Query the gateway's configured subagent run timeout.
+     *
+     * Returns the value in milliseconds, or `undefined` if the query fails
+     * or the value is absent/zero (no timeout configured).
+     */
+    async queryGatewayRunTimeout() {
+        try {
+            const result = await this.invoke('session_status', {});
+            const details = (result.result?.details ?? result.result ?? {});
+            const runTimeoutSeconds = details.runTimeoutSeconds ??
+                details.timeout;
+            if (typeof runTimeoutSeconds === 'number' && runTimeoutSeconds > 0) {
+                return runTimeoutSeconds * 1000;
+            }
+        }
+        catch {
+            // Gateway unreachable or field not exposed — fall back to default
+        }
+        return undefined;
+    }
     async spawn(task, options) {
         // Fresh controller for each spawn call
         this.controller = new AbortController();
-        const timeoutSeconds = options?.timeout ?? DEFAULT_TIMEOUT_MS$1 / 1000;
-        const timeoutMs = timeoutSeconds * 1000;
-        const deadline = Date.now() + timeoutMs;
+        // Safety-valve deadline: gateway's runTimeoutSeconds + 60s buffer,
+        // defaulting to 1 hour if the gateway value is 0/absent/query fails.
+        // This is a circuit breaker, not a timeout mechanism.
+        const gatewayTimeoutMs = await this.queryGatewayRunTimeout();
+        const safetyValveMs = gatewayTimeoutMs
+            ? gatewayTimeoutMs + 60_000
+            : DEFAULT_SAFETY_VALVE_MS;
+        const safetyDeadline = Date.now() + safetyValveMs;
         // Ensure workspace dir exists
         if (!existsSync(this.workspaceDir)) {
             mkdirSync(this.workspaceDir, { recursive: true });
@@ -1576,7 +1643,6 @@ class GatewayExecutor {
         const spawnResult = await this.invoke('sessions_spawn', {
             task: taskWithOutput,
             label,
-            runTimeoutSeconds: timeoutSeconds,
             ...(options?.thinking ? { thinking: options.thinking } : {}),
             ...(options?.model ? { model: options.model } : {}),
         });
@@ -1588,9 +1654,18 @@ class GatewayExecutor {
             throw new Error('Gateway sessions_spawn returned no sessionKey: ' +
                 JSON.stringify(spawnResult));
         }
-        // Step 2: Poll for completion via sessions_history
+        // Step 2: Poll for completion — gateway owns the subagent lifecycle.
+        // Loop exits via: (a) completion detection, (b) abort signal,
+        // (c) gateway-side timeout detection, or (d) safety-valve circuit breaker.
         await sleepAsync(3000);
-        while (Date.now() < deadline) {
+        while (true) {
+            // Safety-valve circuit breaker
+            if (Date.now() >= safetyDeadline) {
+                this.cleanupOutputFile(outputPath);
+                throw new SpawnTimeoutError('Safety-valve deadline exceeded (' +
+                    safetyValveMs.toString() +
+                    'ms) — gateway timeout may be misconfigured', outputPath);
+            }
             // Check for abort before each poll iteration
             if (this.controller.signal.aborted) {
                 this.cleanupOutputFile(outputPath);
@@ -1607,62 +1682,48 @@ class GatewayExecutor {
                     [];
                 const msgArray = messages;
                 // Check 1: terminal stop reason in history
-                let historyDone = false;
-                if (msgArray.length > 0) {
-                    const lastMsg = msgArray[msgArray.length - 1];
-                    if (lastMsg.role === 'assistant' &&
-                        lastMsg.stopReason &&
-                        lastMsg.stopReason !== 'toolUse' &&
-                        lastMsg.stopReason !== 'error') {
-                        historyDone = true;
-                    }
-                }
+                const { done: historyDone, timedOut: historyTimedOut } = GatewayExecutor.checkHistoryCompletion(msgArray);
                 // Check 2: session completion status via sessions_list
                 const sessionInfo = await this.getSessionInfo(sessionKey);
+                const timedOut = sessionInfo.timedOut || historyTimedOut;
                 if (historyDone || sessionInfo.completed) {
                     const tokens = sessionInfo.tokens;
-                    // Read output from file (sub-agent wrote it via Write tool)
-                    if (existsSync(outputPath)) {
-                        try {
-                            const output = readFileSync(outputPath, 'utf8');
+                    // Gateway-side timeout detected — check staging file for recovery
+                    if (timedOut) {
+                        const output = this.readStagingFile(outputPath);
+                        if (output !== undefined)
                             return { output, tokens };
-                        }
-                        finally {
-                            try {
-                                unlinkSync(outputPath);
-                            }
-                            catch {
-                                /* cleanup best-effort */
-                            }
-                        }
+                        // No output or partial output — throw for _state recovery (§3.16.6)
+                        throw new SpawnTimeoutError('Gateway-side timeout detected (session status: timeout)', outputPath);
                     }
+                    // Normal completion — read output from file
+                    const output = this.readStagingFile(outputPath);
+                    if (output !== undefined)
+                        return { output, tokens };
                     // Fallback: extract from message content if file wasn't written.
                     // Skip ANNOUNCE_SKIP sentinel messages — the real output is in
                     // a preceding assistant message (the file write).
                     for (let i = msgArray.length - 1; i >= 0; i--) {
                         const msg = msgArray[i];
-                        if (msg.role === 'assistant' && msg.content) {
-                            const text = typeof msg.content === 'string'
-                                ? msg.content
-                                : Array.isArray(msg.content)
-                                    ? msg.content
-                                        .filter((b) => b.type === 'text' && b.text)
-                                        .map((b) => b.text)
-                                        .join('\n')
-                                    : '';
-                            if (text && text.trim() !== 'ANNOUNCE_SKIP')
+                        if (msg.role === 'assistant') {
+                            const text = GatewayExecutor.extractMessageText(msg.content);
+                            if (text !== undefined)
                                 return { output: text, tokens };
                         }
                     }
                     return { output: '', tokens };
                 }
             }
-            catch {
+            catch (err) {
+                // Re-throw SpawnTimeoutError and SpawnAbortedError — only swallow transient poll failures
+                if (err instanceof SpawnTimeoutError ||
+                    err instanceof SpawnAbortedError) {
+                    throw err;
+                }
                 // Transient poll failure — keep trying
             }
             await sleepAsync(this.pollIntervalMs);
         }
-        throw new SpawnTimeoutError('Synthesis subprocess timed out after ' + timeoutMs.toString() + 'ms', outputPath);
     }
 }
 
@@ -2884,7 +2945,6 @@ async function runArchitect(node, currentMeta, phaseState, config, executor, wat
         const architectTask = buildArchitectTask(ctx, currentMeta, config);
         const result = await executor.spawn(architectTask, {
             thinking: config.thinking,
-            timeout: currentMeta._architectTimeout ?? config.architectTimeout,
             label: 'meta-architect',
         });
         const builderBrief = parseArchitectOutput(result.output);
@@ -2936,7 +2996,6 @@ async function runBuilder(node, currentMeta, phaseState, config, executor, watch
         const builderTask = buildBuilderTask(ctx, currentMeta, config);
         const result = await executor.spawn(builderTask, {
             thinking: config.thinking,
-            timeout: currentMeta._builderTimeout ?? config.builderTimeout,
             label: 'meta-builder',
         });
         const rawOutput = result.output;
@@ -3031,7 +3090,6 @@ async function runCritic(node, currentMeta, phaseState, config, executor, watche
         const criticTask = buildCriticTask(ctx, metaForCritic, config);
         const result = await executor.spawn(criticTask, {
             thinking: config.thinking,
-            timeout: currentMeta._criticTimeout ?? config.criticTimeout,
             label: 'meta-critic',
         });
         const feedback = parseCriticOutput(result.output);
@@ -3944,12 +4002,6 @@ async function createMeta(ownerPath, options) {
         metaJson._crossRefs = options.crossRefs;
     if (options?.steer !== undefined)
         metaJson._steer = options.steer;
-    if (options?.architectTimeout !== undefined)
-        metaJson._architectTimeout = options.architectTimeout;
-    if (options?.builderTimeout !== undefined)
-        metaJson._builderTimeout = options.builderTimeout;
-    if (options?.criticTimeout !== undefined)
-        metaJson._criticTimeout = options.criticTimeout;
     const metaJsonPath = join(metaDir, 'meta.json');
     await writeFile(metaJsonPath, JSON.stringify(metaJson, null, 2) + '\n');
     return { metaDir, _id };
@@ -4025,9 +4077,6 @@ async function autoSeedPass(rules, watcher, logger) {
             candidates.set(dir, {
                 steer: rule.steer,
                 crossRefs: rule.crossRefs,
-                architectTimeout: rule.architectTimeout,
-                builderTimeout: rule.builderTimeout,
-                criticTimeout: rule.criticTimeout,
             });
         }
     }
@@ -4597,7 +4646,7 @@ function registerMetasRoutes(app, deps) {
 /**
  * PATCH /metas/:path — update user-settable reserved properties on a meta.
  *
- * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled, _architectTimeout, _builderTimeout, _criticTimeout.
+ * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled.
  * Set a field to null to remove it. Unknown keys are rejected.
  *
  * @module routes/metasUpdate
@@ -4609,9 +4658,6 @@ const updateBodySchema = z
     _depth: z.union([z.number(), z.null()]).optional(),
     _crossRefs: z.union([z.array(z.string()), z.null()]).optional(),
     _disabled: z.union([z.boolean(), z.null()]).optional(),
-    _architectTimeout: z.union([z.number().int().min(30), z.null()]).optional(),
-    _builderTimeout: z.union([z.number().int().min(30), z.null()]).optional(),
-    _criticTimeout: z.union([z.number().int().min(30), z.null()]).optional(),
 })
     .strict();
 function registerMetasUpdateRoute(app, deps) {
@@ -5817,12 +5863,6 @@ const metaJsonSchema = z
     _error: metaErrorSchema.optional(),
     /** When true, this meta is skipped during staleness scheduling. Manual trigger still works. */
     _disabled: z.boolean().optional(),
-    /** Per-entity timeout override for the architect phase (seconds, min 30). */
-    _architectTimeout: z.number().int().min(30).optional(),
-    /** Per-entity timeout override for the builder phase (seconds, min 30). */
-    _builderTimeout: z.number().int().min(30).optional(),
-    /** Per-entity timeout override for the critic phase (seconds, min 30). */
-    _criticTimeout: z.number().int().min(30).optional(),
     /**
      * SHA-256 hash of ancestor _builder text at last synthesis.
      * Observability only — no invalidation cascade.

package/dist/interfaces/MetaExecutor.d.ts

@@ -7,8 +7,6 @@
 export interface MetaSpawnOptions {
     /** Model override for this subprocess. */
     model?: string;
-    /** Timeout in seconds. */
-    timeout?: number;
     /** Label for the spawned session. */
     label?: string;
     /** Thinking level (e.g. "low", "medium", "high"). */

package/dist/prompts/architect.md

@@ -128,8 +128,6 @@ The Builder should:
 4. Merge new findings with previous `_content` (carried in context)
 
 If the scope is small enough to process in one pass, omit chunking instructions.
-The Builder has a timeout of \{{config.builderTimeout}} seconds.
-
 ### 8. Output Structure
 
 Define non-underscore fields for structured data and the _content narrative
@@ -148,7 +146,6 @@ Quote the specific issue and state what to do differently.
 Your task brief will be compiled as a Handlebars template before the Builder
 receives it. You can use these variables to write adaptive instructions:
 
-- `\{{config.builderTimeout}}` — Builder timeout in seconds
 - `\{{config.maxLines}}` — Maximum _content lines
 - `\{{config.architectEvery}}` — Cycles between architect refreshes
 - `\{{config.maxArchive}}` — Archive snapshots retained
@@ -159,7 +156,7 @@ receives it. You can use these variables to write adaptive instructions:
 - `\{{meta._depth}}` — Scheduling depth
 - `\{{meta._emphasis}}` — Scheduling emphasis
 
-Example: "Process files in chunks of 50. You have \{{config.builderTimeout}} seconds."
+Example: "Process files in chunks of 50. Limit output to \{{config.maxLines}} lines."
 
 ## Constraints
 

package/dist/routes/metasUpdate.d.ts

@@ -1,7 +1,7 @@
 /**
  * PATCH /metas/:path — update user-settable reserved properties on a meta.
  *
- * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled, _architectTimeout, _builderTimeout, _criticTimeout.
+ * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled.
  * Set a field to null to remove it. Unknown keys are rejected.
  *
  * @module routes/metasUpdate

package/dist/schema/config.d.ts

@@ -14,9 +14,6 @@ declare const autoSeedRuleSchema: z.ZodObject<{
     steer: z.ZodOptional<z.ZodString>;
     crossRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     parentDepth: z.ZodOptional<z.ZodNumber>;
-    architectTimeout: z.ZodOptional<z.ZodNumber>;
-    builderTimeout: z.ZodOptional<z.ZodNumber>;
-    criticTimeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** Inferred type for an auto-seed rule. */
 export type AutoSeedRule = z.infer<typeof autoSeedRuleSchema>;
@@ -29,9 +26,6 @@ export declare const serviceConfigSchema: z.ZodObject<{
     depthWeight: z.ZodDefault<z.ZodNumber>;
     maxArchive: z.ZodDefault<z.ZodNumber>;
     maxLines: z.ZodDefault<z.ZodNumber>;
-    architectTimeout: z.ZodDefault<z.ZodNumber>;
-    builderTimeout: z.ZodDefault<z.ZodNumber>;
-    criticTimeout: z.ZodDefault<z.ZodNumber>;
     thinking: z.ZodDefault<z.ZodString>;
     defaultArchitect: z.ZodOptional<z.ZodString>;
     defaultCritic: z.ZodOptional<z.ZodString>;
@@ -54,9 +48,6 @@ export declare const serviceConfigSchema: z.ZodObject<{
         steer: z.ZodOptional<z.ZodString>;
         crossRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         parentDepth: z.ZodOptional<z.ZodNumber>;
-        architectTimeout: z.ZodOptional<z.ZodNumber>;
-        builderTimeout: z.ZodOptional<z.ZodNumber>;
-        criticTimeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>>;
 }, z.core.$strip>;
 /** Inferred type for service configuration. */

package/dist/schema/meta.d.ts

@@ -43,9 +43,6 @@ export declare const metaJsonSchema: z.ZodObject<{
         message: z.ZodString;
     }, z.core.$strip>>;
     _disabled: z.ZodOptional<z.ZodBoolean>;
-    _architectTimeout: z.ZodOptional<z.ZodNumber>;
-    _builderTimeout: z.ZodOptional<z.ZodNumber>;
-    _criticTimeout: z.ZodOptional<z.ZodNumber>;
     _ancestorBuilderHash: z.ZodOptional<z.ZodString>;
     _phaseState: z.ZodOptional<z.ZodObject<{
         architect: z.ZodEnum<{

package/dist/seed/createMeta.d.ts

@@ -11,12 +11,6 @@ export interface CreateMetaOptions {
     crossRefs?: string[];
     /** Steering prompt for the meta. */
     steer?: string;
-    /** Per-entity timeout override for the architect phase (seconds). */
-    architectTimeout?: number;
-    /** Per-entity timeout override for the builder phase (seconds). */
-    builderTimeout?: number;
-    /** Per-entity timeout override for the critic phase (seconds). */
-    criticTimeout?: number;
 }
 /** Result of creating a new meta. */
 export interface CreateMetaResult {

package/package.json

@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "@karmaniverous/jeeves": "^0.5.12",
-    "@karmaniverous/jeeves-meta-core": "^0.1.3",
+    "@karmaniverous/jeeves-meta-core": "^0.2.0",
     "commander": "^14",
     "croner": "^10",
     "fastify": "^5.8",
@@ -98,7 +98,7 @@
     "url": "git+https://github.com/karmaniverous/jeeves-meta.git"
   },
   "scripts": {
-    "build": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "build": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin \"@rollup/plugin-typescript={outputToFilesystem:true}\"",
     "changelog": "git-cliff -o CHANGELOG.md",
     "knip": "knip",
     "lint": "eslint .",
@@ -110,5 +110,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.15.12"
+  "version": "0.16.0"
 }