@sema-agent/core 1.451.0 → 2.0.0

package/dist/agents/teacher.d.ts

@@ -52,7 +52,6 @@ export interface TeacherRunResult extends TaskResult {
     teacherStats: {
         tokens: number;
         tasks: number;
-        costUsd?: number;
         costMicroUsd?: number;
         humanReview?: {
             count: number;

package/dist/agents/teacher.js

@@ -82,7 +82,6 @@ async function runTeacherCore(runner, studentSpec, teacher) {
     const escalations = [];
     let studentTokens = 0;
     let studentTurns = 0;
-    let studentCost = 0;
     let studentCostMicro = 0;
     let studentPrompt = 0;
     let studentCached = 0;
@@ -98,10 +97,8 @@ async function runTeacherCore(runner, studentSpec, teacher) {
     let studentNestedTurns = 0;
     let studentNestedTasks = 0;
     let studentNestedCostMicro = 0;
-    let studentNestedCost = 0;
     let teacherTokens = 0;
     let teacherTasks = 0;
-    let teacherCost = 0;
     let teacherCostMicro = 0;
     let teacherHrCount = 0;
     let teacherHrWaitMs = 0;
@@ -175,7 +172,6 @@ async function runTeacherCore(runner, studentSpec, teacher) {
         const s = r.stats;
         studentTokens += s.tokens;
         studentTurns += s.turns;
-        studentCost += s.costUsd ?? 0;
         studentCostMicro += s.costMicroUsd ?? 0;
         studentPrompt += s.promptTokens ?? 0;
         studentCached += s.cachedTokens ?? 0;
@@ -196,13 +192,11 @@ async function runTeacherCore(runner, studentSpec, teacher) {
             studentNestedTurns += s.nested.turns;
             studentNestedTasks += s.nested.tasks;
             studentNestedCostMicro += s.nested.costMicroUsd ?? 0;
-            studentNestedCost += s.nested.costUsd ?? 0;
         }
     };
     const addTeacher = (r) => {
         teacherTokens += r.stats.tokens + (r.stats.nested?.tokens ?? 0);
         teacherTasks += 1;
-        teacherCost += (r.stats.costUsd ?? 0) + (r.stats.nested?.costUsd ?? 0);
         teacherCostMicro += (r.stats.costMicroUsd ?? 0) + (r.stats.nested?.costMicroUsd ?? 0);
         if (r.stats.humanReview) {
             teacherHrCount += r.stats.humanReview.count;
@@ -422,7 +416,6 @@ async function runTeacherCore(runner, studentSpec, teacher) {
                 ...result.stats,
                 tokens: studentTokens,
                 turns: studentTurns,
-                costUsd: studentCost || undefined,
                 costMicroUsd: studentCostMicro || undefined,
                 promptTokens: studentPrompt || undefined,
                 totalInputTokens: studentPrompt || undefined,
@@ -437,7 +430,6 @@ async function runTeacherCore(runner, studentSpec, teacher) {
                         turns: studentNestedTurns,
                         tasks: studentNestedTasks,
                         costMicroUsd: studentNestedCostMicro || undefined,
-                        costUsd: studentNestedCost || undefined,
                     }
                     : undefined,
                 costBreakdown: {
@@ -452,7 +444,6 @@ async function runTeacherCore(runner, studentSpec, teacher) {
             teacherStats: {
                 tokens: teacherTokens,
                 tasks: teacherTasks,
-                costUsd: teacherCost || undefined,
                 costMicroUsd: teacherCostMicro || undefined,
                 humanReview: teacherHrCount > 0 ? { count: teacherHrCount, totalWaitMs: teacherHrWaitMs, gates: teacherHrGates } : undefined,
             },

package/dist/bin/sema-tb.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync, realpathSync, createWriteStream } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { Runner, NodeExecutionEnv, createOpenAIBrain, createAnthropicBrain, CODE_SYSTEM_PROMPT, assembleCodeTools, makeWebFetchSummarizer, } from "../index.js";
+import { Runner, NodeExecutionEnv, createOpenAIBrain, createAnthropicBrain, CODE_SYSTEM_PROMPT, assembleCodeTools, createWebFetchSummarizer, } from "../index.js";
 import { positiveIntFromEnv, tbModelInput } from "./tb-env.js";
 import { inferMaxTokensField } from "../brain/openai.js";
 function usage(code = 2) {
@@ -353,7 +353,7 @@ async function main() {
             ? {
                 systemPrompt: CODE_SYSTEM_PROMPT,
                 tools: assembleCodeTools({
-                    ...(process.env.TB_SUMMARIZE === "0" ? {} : { webFetch: { summarize: makeWebFetchSummarizer(brain, model) } }),
+                    ...(process.env.TB_SUMMARIZE === "0" ? {} : { webFetch: { summarize: createWebFetchSummarizer(brain, model) } }),
                     ...(process.env.TB_TASKLIST === "0" || process.env.TB_TASKLIST === "false" ? { taskList: false } : {}),
                 }),
             }
@@ -426,7 +426,7 @@ async function main() {
     const r = await stream.result();
     const mech = r.stats.mechanisms;
     line(`[done] status=${r.status} turns=${r.stats.turns} toolCalls=${r.stats.toolCalls ?? 0} ` +
-        `tokens=${r.stats.tokens} costUsd=${((r.stats.costMicroUsd ?? 0) / 1e6).toFixed(6)} costMicroUsd=${r.stats.costMicroUsd ?? 0}` +
+        `tokens=${r.stats.tokens} costMicroUsd=${r.stats.costMicroUsd ?? 0}` +
         ` model=${lastServedModel ?? model.id} degraded=${degradedTo ?? "no"}` +
         (r.stats.cacheHitRate !== undefined ? ` cacheHitRate=${r.stats.cacheHitRate.toFixed(3)}` : "") +
         (mech ? ` mech=${mech.finalizeInjected ? "finalize" : ""}${mech.nudgesSent ? `+nudges:${mech.nudgesSent}` : ""}${mech.capShrinks ? `+capShrinks:${mech.capShrinks}` : ""}${mech.callCutoffs ? `+callCutoffs:${mech.callCutoffs}` : ""}${mech.toolClamps ? `+toolClamps:${mech.toolClamps}` : ""}` : "") +

package/dist/brain/anthropic.js

@@ -1,6 +1,7 @@
 import {} from "../internal/llm.js";
 import { BrainError } from "./errors.js";
-import { DEGENERATE_MESSAGE, inspectDegenerate, trimDegenerateTail } from "./repetition.js";
+import { DEGENERATE_MESSAGE, trimDegenerateTail } from "./repetition.js";
+import { createRepetitionPoll, createWalltimeGate } from "./stream-shared.js";
 import { WALLTIME_CUTOFF_MESSAGE } from "./walltime.js";
 import { emitBrainTelemetry } from "./status-sink.js";
 import { ANTHROPIC_RESERVED, applyExtraBody, stripAuthHeaders } from "./request-params.js";
@@ -340,24 +341,8 @@ export function createAnthropicBrain(config = {}) {
                 let nextContentIndex = 0;
                 let degenerate = false;
                 let degenTextBlock;
-                let repCut;
-                const repSpared = new Map();
-                const pollRepetition = (text) => {
-                    const insp = inspectDegenerate(text);
-                    for (const s of insp.spared) {
-                        const k = `${s.rule} ${s.segment}`;
-                        const prev = repSpared.get(k);
-                        if (prev === undefined)
-                            repSpared.set(k, s);
-                        else if (s.reps > prev.reps)
-                            prev.reps = s.reps;
-                    }
-                    if (insp.degenerate)
-                        repCut = insp.cut;
-                    return insp.degenerate;
-                };
-                let walltimeCut = false;
-                const callDeadlineMs = options?.callDeadlineMs;
+                const rep = createRepetitionPoll();
+                const walltime = createWalltimeGate({ callDeadlineMs: options?.callDeadlineMs, isDegenerate: () => degenerate, cancel: () => ctrl.cancel() });
                 let lastDegenCheck = 0;
                 let lastDegenCheckThinking = 0;
                 const detectRep = config.detectRepetition !== false;
@@ -416,7 +401,7 @@ export function createAnthropicBrain(config = {}) {
                                 out.push({ type: "text_delta", contentIndex: idx, delta: d.text, partial: { ...partial } });
                                 if (detectRep && !degenerate && acc.text.length - lastDegenCheck >= 64) {
                                     lastDegenCheck = acc.text.length;
-                                    if (pollRepetition(acc.text)) {
+                                    if (rep.poll(acc.text)) {
                                         degenerate = true;
                                         degenTextBlock = acc;
                                         ctrl.cancel();
@@ -430,7 +415,7 @@ export function createAnthropicBrain(config = {}) {
                                 out.push({ type: "thinking_delta", contentIndex: idx, delta: d.thinking, partial: { ...partial } });
                                 if (detectRep && !degenerate && acc.text.length - lastDegenCheckThinking >= 64) {
                                     lastDegenCheckThinking = acc.text.length;
-                                    if (pollRepetition(acc.text)) {
+                                    if (rep.poll(acc.text)) {
                                         degenerate = true;
                                         ctrl.cancel();
                                     }
@@ -512,19 +497,9 @@ export function createAnthropicBrain(config = {}) {
                             }
                         }
                     },
-                    onDeadline() {
-                        if (degenerate)
-                            return false;
-                        walltimeCut = true;
-                        return true;
-                    },
+                    onDeadline: () => walltime.onDeadline(),
                     onLine(rawLine) {
-                        if (callDeadlineMs !== undefined && !walltimeCut && !degenerate && Date.now() >= callDeadlineMs) {
-                            walltimeCut = true;
-                            ctrl.cancel();
-                            return;
-                        }
-                        if (walltimeCut)
+                        if (walltime.shouldDropLine())
                             return;
                         const line = rawLine.trim();
                         if (!line.startsWith("data:"))
@@ -559,7 +534,7 @@ export function createAnthropicBrain(config = {}) {
                                 finalContent.push(block);
                             }
                             else if (acc.type === "text") {
-                                const text = acc === degenTextBlock && repCut !== undefined ? trimDegenerateTail(acc.text, repCut) : acc.text;
+                                const text = acc === degenTextBlock && rep.cut !== undefined ? trimDegenerateTail(acc.text, rep.cut) : acc.text;
                                 if (text) {
                                     finalContent.push({ type: "text", text });
                                     if (text.trim())
@@ -593,9 +568,9 @@ export function createAnthropicBrain(config = {}) {
                         const staticReasoningCut = truncatedEmpty && !dynamicCut && reasoningSeen && options?.staticReasoningCutDowngrade === true;
                         const safetyCut = stopReason === "refusal";
                         const contextWindowExceeded = stopReason === "model_context_window_exceeded";
-                        const emptyNoFinish = noUsableContent && stopReason == null && !degenerate && !walltimeCut;
+                        const emptyNoFinish = noUsableContent && stopReason == null && !degenerate && !walltime.cut;
                         const maxTokensNote = `effective max_tokens=${sentMaxTokens ?? "?"} (from ${sentMaxTokensLane === "options" ? "options.maxTokens" : sentMaxTokensLane === "model" ? "model.maxTokens" : "config default"})`;
-                        const errorMessage = walltimeCut
+                        const errorMessage = walltime.cut
                             ? WALLTIME_CUTOFF_MESSAGE
                             : degenerate
                                 ? DEGENERATE_MESSAGE
@@ -613,14 +588,14 @@ export function createAnthropicBrain(config = {}) {
                                                 : emptyNoFinish
                                                     ? `[stream_torn] model stream ended with no content and no stop_reason — the response was lost (a torn stream or an in-band provider error frame)`
                                                     : undefined));
-                        const errored = walltimeCut ||
+                        const errored = walltime.cut ||
                             degenerate ||
                             safetyCut ||
                             contextWindowExceeded ||
                             emptyNoFinish ||
                             (toolError !== undefined && noUsableContent) ||
                             (truncatedEmpty && !dynamicCut && !staticReasoningCut);
-                        const errorKind = !walltimeCut && !degenerate && !safetyCut && toolError === undefined && truncatedEmpty && !dynamicCut && !staticReasoningCut
+                        const errorKind = !walltime.cut && !degenerate && !safetyCut && toolError === undefined && truncatedEmpty && !dynamicCut && !staticReasoningCut
                             ? "length_empty"
                             : undefined;
                         const finalMessage = {
@@ -632,8 +607,8 @@ export function createAnthropicBrain(config = {}) {
                             timestamp: Date.now(),
                             ...(errorMessage ? { errorMessage } : {}),
                             ...(errorKind ? { errorKind } : {}),
-                            ...(repCut !== undefined || repSpared.size > 0
-                                ? { repetition: { ...(repCut !== undefined ? { cut: repCut } : {}), ...(repSpared.size > 0 ? { spared: [...repSpared.values()] } : {}) } }
+                            ...(rep.cut !== undefined || rep.spared.length > 0
+                                ? { repetition: { ...(rep.cut !== undefined ? { cut: rep.cut } : {}), ...(rep.spared.length > 0 ? { spared: rep.spared } : {}) } }
                                 : {}),
                             ...(staticReasoningCut ? { staticReasoningCut: true } : {}),
                             ...(stopDetails

package/dist/brain/openai.js

@@ -1,6 +1,7 @@
 import {} from "../internal/llm.js";
 import { repairTextToolCalls } from "./tool-call-repair.js";
-import { DEGENERATE_MESSAGE, inspectDegenerate, trimDegenerateTail } from "./repetition.js";
+import { DEGENERATE_MESSAGE, trimDegenerateTail } from "./repetition.js";
+import { createRepetitionPoll, createWalltimeGate } from "./stream-shared.js";
 import { WALLTIME_CUTOFF_MESSAGE } from "./walltime.js";
 import { emitBrainTelemetry } from "./status-sink.js";
 import { OPENAI_RESERVED, applyExtraBody, stripAuthHeaders } from "./request-params.js";
@@ -343,24 +344,8 @@ export function createOpenAIBrain(config = {}) {
                 let accumRefusal = "";
                 let degenerate = false;
                 let degenFace;
-                let repCut;
-                const repSpared = new Map();
-                const pollRepetition = (text) => {
-                    const insp = inspectDegenerate(text);
-                    for (const s of insp.spared) {
-                        const k = `${s.rule} ${s.segment}`;
-                        const prev = repSpared.get(k);
-                        if (prev === undefined)
-                            repSpared.set(k, s);
-                        else if (s.reps > prev.reps)
-                            prev.reps = s.reps;
-                    }
-                    if (insp.degenerate)
-                        repCut = insp.cut;
-                    return insp.degenerate;
-                };
-                let walltimeCut = false;
-                const callDeadlineMs = options?.callDeadlineMs;
+                const rep = createRepetitionPoll();
+                const walltime = createWalltimeGate({ callDeadlineMs: options?.callDeadlineMs, isDegenerate: () => degenerate, cancel: () => ctrl.cancel() });
                 let lastDegenCheck = 0;
                 let lastDegenCheckReasoning = 0;
                 const detectRep = config.detectRepetition !== false;
@@ -389,7 +374,7 @@ export function createOpenAIBrain(config = {}) {
                     out.push({ type: "thinking_delta", contentIndex: 0, delta, partial: { ...partial } });
                     if (detectRep && !degenerate && accumReasoning.length - lastDegenCheckReasoning >= 64) {
                         lastDegenCheckReasoning = accumReasoning.length;
-                        if (pollRepetition(accumReasoning)) {
+                        if (rep.poll(accumReasoning)) {
                             degenerate = true;
                             degenFace = "reasoning";
                             ctrl.cancel();
@@ -418,7 +403,7 @@ export function createOpenAIBrain(config = {}) {
                     out.push({ type: "text_delta", contentIndex: textIndex, delta, partial: { ...partial } });
                     if (detectRep && !degenerate && accumText.length - lastDegenCheck >= 64) {
                         lastDegenCheck = accumText.length;
-                        if (pollRepetition(accumText)) {
+                        if (rep.poll(accumText)) {
                             degenerate = true;
                             degenFace = "text";
                             ctrl.cancel();
@@ -438,19 +423,9 @@ export function createOpenAIBrain(config = {}) {
                     sealForRetry() {
                         closeThinking();
                     },
-                    onDeadline() {
-                        if (degenerate)
-                            return false;
-                        walltimeCut = true;
-                        return true;
-                    },
+                    onDeadline: () => walltime.onDeadline(),
                     onLine(rawLine) {
-                        if (callDeadlineMs !== undefined && !walltimeCut && !degenerate && Date.now() >= callDeadlineMs) {
-                            walltimeCut = true;
-                            ctrl.cancel();
-                            return;
-                        }
-                        if (walltimeCut)
+                        if (walltime.shouldDropLine())
                             return;
                         const line = rawLine.trim();
                         if (!line.startsWith("data:"))
@@ -518,7 +493,7 @@ export function createOpenAIBrain(config = {}) {
                         const finalContent = [];
                         if (accumReasoning)
                             finalContent.push({ type: "thinking", thinking: accumReasoning });
-                        const textFace = degenerate && degenFace === "text" && repCut !== undefined ? trimDegenerateTail(accumText, repCut) : accumText;
+                        const textFace = degenerate && degenFace === "text" && rep.cut !== undefined ? trimDegenerateTail(accumText, rep.cut) : accumText;
                         if (textFace)
                             finalContent.push({ type: "text", text: textFace });
                         const toolCalls = [];
@@ -564,11 +539,11 @@ export function createOpenAIBrain(config = {}) {
                         const dynamicCut = truncatedEmpty && options?.maxTokensDynamic === true;
                         const safetyCut = finishReason === "content_filter";
                         const refused = accumRefusal.trim().length > 0;
-                        const emptyNoFinish = noUsableContent && finishReason == null && !degenerate && !walltimeCut;
+                        const emptyNoFinish = noUsableContent && finishReason == null && !degenerate && !walltime.cut;
                         const maxTokensNote = sentMaxTokens !== undefined
                             ? `effective max_tokens=${sentMaxTokens} (from ${sentMaxTokensLane === "options" ? "options.maxTokens" : "model.maxTokens"})`
                             : "max_tokens not set (neither options.maxTokens nor model.maxTokens — the provider's default cap applied)";
-                        const errorMessage = walltimeCut
+                        const errorMessage = walltime.cut
                             ? WALLTIME_CUTOFF_MESSAGE
                             : degenerate
                                 ? DEGENERATE_MESSAGE
@@ -584,14 +559,14 @@ export function createOpenAIBrain(config = {}) {
                                                 : emptyNoFinish
                                                     ? `[stream_torn] model stream ended with no content and no finish_reason — the response was lost (a torn stream or an in-band provider error frame)`
                                                     : undefined));
-                        const errored = walltimeCut ||
+                        const errored = walltime.cut ||
                             degenerate ||
                             safetyCut ||
                             refused ||
                             emptyNoFinish ||
                             (toolError !== undefined && noUsableContent) ||
                             (truncatedEmpty && !dynamicCut);
-                        const errorKind = !walltimeCut && !degenerate && !safetyCut && !refused && toolError === undefined && truncatedEmpty && !dynamicCut
+                        const errorKind = !walltime.cut && !degenerate && !safetyCut && !refused && toolError === undefined && truncatedEmpty && !dynamicCut
                             ? "length_empty"
                             : undefined;
                         const finalMessage = {
@@ -603,8 +578,8 @@ export function createOpenAIBrain(config = {}) {
                             timestamp: Date.now(),
                             ...(errorMessage ? { errorMessage } : {}),
                             ...(errorKind ? { errorKind } : {}),
-                            ...(repCut !== undefined || repSpared.size > 0
-                                ? { repetition: { ...(repCut !== undefined ? { cut: repCut } : {}), ...(repSpared.size > 0 ? { spared: [...repSpared.values()] } : {}) } }
+                            ...(rep.cut !== undefined || rep.spared.length > 0
+                                ? { repetition: { ...(rep.cut !== undefined ? { cut: rep.cut } : {}), ...(rep.spared.length > 0 ? { spared: rep.spared } : {}) } }
                                 : {}),
                         };
                         if (errored) {

package/dist/brain/reasoning.d.ts

@@ -1,4 +1,4 @@
-import type { ThinkingLevel } from "../internal/harness.js";
+import type { ThinkingLevel } from "../internal/harness-types.js";
 export type ReasoningIntensity = ThinkingLevel;
 export declare function isThinkingLevel(v: unknown): v is ThinkingLevel;
 export declare function rankOf(level: ThinkingLevel): number;

package/dist/brain/stream-engine.js

@@ -2,7 +2,7 @@ import { createAssistantMessageEventStream, } from "../internal/llm.js";
 import { BrainError, classifyHttp } from "./errors.js";
 import { retryBackoffMs } from "./retry.js";
 import { emitBrainStatus, emitBrainTelemetry } from "./status-sink.js";
-import { makeConnectController } from "./timeout.js";
+import { createConnectController } from "./timeout.js";
 import { WALLTIME_CUTOFF_MESSAGE } from "./walltime.js";
 const EMPTY_USAGE = {
     input: 0,
@@ -80,7 +80,7 @@ export function runStreamingBrain(args) {
                 if (callDeadlineMs !== undefined && Date.now() >= callDeadlineMs) {
                     throw new Error(WALLTIME_CUTOFF_MESSAGE);
                 }
-                const cc = makeConnectController(connectTimeoutMs, signal, callDeadlineMs);
+                const cc = createConnectController(connectTimeoutMs, signal, callDeadlineMs);
                 let r;
                 let netErr;
                 try {

package/dist/brain/stream-shared.d.ts

@@ -0,0 +1,17 @@
+import { type RepetitionEvent } from "./repetition.js";
+export interface RepetitionPoll {
+    poll(text: string): boolean;
+    readonly cut: RepetitionEvent | undefined;
+    readonly spared: RepetitionEvent[];
+}
+export declare function createRepetitionPoll(): RepetitionPoll;
+export interface WalltimeGate {
+    onDeadline(): boolean;
+    shouldDropLine(): boolean;
+    readonly cut: boolean;
+}
+export declare function createWalltimeGate(deps: {
+    callDeadlineMs: number | undefined;
+    isDegenerate: () => boolean;
+    cancel: () => void;
+}): WalltimeGate;

package/dist/brain/stream-shared.js

@@ -0,0 +1,50 @@
+import { inspectDegenerate } from "./repetition.js";
+export function createRepetitionPoll() {
+    let repCut;
+    const repSpared = new Map();
+    return {
+        get cut() {
+            return repCut;
+        },
+        get spared() {
+            return [...repSpared.values()];
+        },
+        poll(text) {
+            const insp = inspectDegenerate(text);
+            for (const s of insp.spared) {
+                const k = `${s.rule} ${s.segment}`;
+                const prev = repSpared.get(k);
+                if (prev === undefined)
+                    repSpared.set(k, s);
+                else if (s.reps > prev.reps)
+                    prev.reps = s.reps;
+            }
+            if (insp.degenerate)
+                repCut = insp.cut;
+            return insp.degenerate;
+        },
+    };
+}
+export function createWalltimeGate(deps) {
+    const { callDeadlineMs, isDegenerate, cancel } = deps;
+    let walltimeCut = false;
+    return {
+        get cut() {
+            return walltimeCut;
+        },
+        onDeadline() {
+            if (isDegenerate())
+                return false;
+            walltimeCut = true;
+            return true;
+        },
+        shouldDropLine() {
+            if (callDeadlineMs !== undefined && !walltimeCut && !isDegenerate() && Date.now() >= callDeadlineMs) {
+                walltimeCut = true;
+                cancel();
+                return true;
+            }
+            return walltimeCut;
+        },
+    };
+}

package/dist/brain/timeout.d.ts

@@ -3,7 +3,7 @@ export interface BrainTimeoutConfig {
     firstTokenTimeoutMs?: number;
     idleTimeoutMs?: number;
 }
-export declare function makeConnectController(connectTimeoutMs: number | undefined, outerSignal: AbortSignal | undefined, deadlineAtMs?: number): {
+export declare function createConnectController(connectTimeoutMs: number | undefined, outerSignal: AbortSignal | undefined, deadlineAtMs?: number): {
     signal: AbortSignal;
     timedOut: () => boolean;
     deadlineHit: () => boolean;

package/dist/brain/timeout.js

@@ -1,4 +1,4 @@
-export function makeConnectController(connectTimeoutMs, outerSignal, deadlineAtMs) {
+export function createConnectController(connectTimeoutMs, outerSignal, deadlineAtMs) {
     const ac = new AbortController();
     let timedOut = false;
     let deadlineHit = false;

package/dist/config/catalog.js

@@ -1,6 +1,4 @@
-import { DEFAULT_MAX_TURNS } from "../core/runner/runtask.js";
-import { FORK_DEFAULT_MAX_TURNS, SESSION_BG_DEFAULT_TIMEOUT_SEC, RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX } from "../agents/subagent.js";
-import { SESSION_DEFAULT_TTL_DAYS } from "../core/session-store.js";
+import { DEFAULT_MAX_TURNS, FORK_DEFAULT_MAX_TURNS, SESSION_BG_DEFAULT_TIMEOUT_SEC, RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX, SESSION_DEFAULT_TTL_DAYS } from "./defaults.js";
 export const CONFIG_CATALOG_VERSION = "sema-config@1";
 export function describeConfigCatalog() {
     const knobs = [

package/dist/config/defaults.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_MAX_TURNS = 1000;
+export declare const FORK_DEFAULT_MAX_TURNS = 200;
+export declare const SESSION_BG_DEFAULT_TIMEOUT_SEC: number;
+export declare const RETAIN_DEFAULT_TTL_MS: number;
+export declare const RETAIN_DEFAULT_MAX = 16;
+export declare const SESSION_DEFAULT_TTL_DAYS = 7;

package/dist/config/defaults.js

@@ -0,0 +1,6 @@
+export const DEFAULT_MAX_TURNS = 1000;
+export const FORK_DEFAULT_MAX_TURNS = 200;
+export const SESSION_BG_DEFAULT_TIMEOUT_SEC = 30 * 60;
+export const RETAIN_DEFAULT_TTL_MS = 30 * 60 * 1000;
+export const RETAIN_DEFAULT_MAX = 16;
+export const SESSION_DEFAULT_TTL_DAYS = 7;

package/dist/core/ask-question.d.ts

@@ -1,4 +1,4 @@
-import type { AgentTool } from "../internal/harness.js";
+import type { AgentTool } from "../internal/harness-types.js";
 import type { ToolPolicy } from "./tool-policy.js";
 export declare const ASK_USER_QUESTION_TOOL_NAME = "AskUserQuestion";
 export interface AskQuestionOption {

package/dist/core/ask-question.js

@@ -1,5 +1,5 @@
 import { Type } from "typebox";
-import { defineTool } from "./tools.js";
+import { defineTool, errorResult } from "./tools.js";
 import { delimitUntrusted, inlineUntrusted } from "./untrusted-text.js";
 export const ASK_USER_QUESTION_TOOL_NAME = "AskUserQuestion";
 const NO_HUMAN = "No human is available to answer right now. Proceed with your best judgment: pick the most reasonable " +
@@ -66,23 +66,23 @@ export function createAskUserQuestionTool(onQuestion, source) {
         execute: async (args, ctx) => {
             const { questions } = args;
             if (!Array.isArray(questions) || questions.length < 1 || questions.length > 4) {
-                return "Error (AskUserQuestion): provide between 1 and 4 questions.";
+                return errorResult("Error (AskUserQuestion): provide between 1 and 4 questions.");
             }
             const seenHeaders = new Set();
             for (const q of questions) {
                 if (!Array.isArray(q.options) || q.options.length < 2 || q.options.length > 4) {
-                    return `Error (AskUserQuestion): the question "${q.header || q.question}" must have between 2 and 4 options.`;
+                    return errorResult(`Error (AskUserQuestion): the question "${q.header || q.question}" must have between 2 and 4 options.`);
                 }
                 const key = typeof q.header === "string" ? q.header.trim() : "";
                 if (key === "" || seenHeaders.has(key)) {
-                    return `Error (AskUserQuestion): each question needs a distinct, non-empty header (got a duplicate or empty one).`;
+                    return errorResult(`Error (AskUserQuestion): each question needs a distinct, non-empty header (got a duplicate or empty one).`);
                 }
                 seenHeaders.add(key);
                 const seenLabels = new Set();
                 for (const o of q.options) {
                     const labelKey = typeof o?.label === "string" ? o.label.trim() : "";
                     if (seenLabels.has(labelKey)) {
-                        return `Error (AskUserQuestion): the question "${q.header || q.question}" has duplicate option labels — option labels must be unique within each question.`;
+                        return errorResult(`Error (AskUserQuestion): the question "${q.header || q.question}" has duplicate option labels — option labels must be unique within each question.`);
                     }
                     seenLabels.add(labelKey);
                 }

package/dist/core/background-agent-store.d.ts

@@ -28,6 +28,7 @@ export interface BackgroundAgentRecord {
     settledAt?: number;
     status: "running" | "parked" | "completed" | "failed" | "killed";
     stoppedBy?: string;
+    completionId?: string;
     seq?: number;
     parkedCheckpointToken?: string;
     parkedAt?: number;
@@ -66,6 +67,7 @@ export declare function canAccessAgentRecord(record: Pick<BackgroundAgentRecord,
     scope?: string;
     sessionId?: string;
 }): boolean;
+export declare const STALE_RUNNING_REAP_ATTRIBUTION = "the host process was interrupted while this agent was running \u2014 its in-process state was lost. Check its worktree / output file for partial work before assuming the task landed (stale running row reaped).";
 export interface BackgroundAgentStore {
     put(record: BackgroundAgentRecord): Promise<void>;
     get(handle: string, scope: string): Promise<BackgroundAgentRecord | null>;

package/dist/core/background-agent-store.js

@@ -1,3 +1,4 @@
+import { uuidv7 } from "../internal/harness.js";
 export class BackgroundAgentStoreError extends Error {
     code;
     constructor(code, message) {
@@ -20,6 +21,7 @@ export function canAccessAgentRecord(record, access) {
     }
     return false;
 }
+export const STALE_RUNNING_REAP_ATTRIBUTION = "the host process was interrupted while this agent was running — its in-process state was lost. Check its worktree / output file for partial work before assuming the task landed (stale running row reaped).";
 export async function reconcileParkedAgents(stores, scope, now, opts) {
     const out = { failed: 0, rolledBack: 0 };
     const excluded = (row) => (opts?.excludeHandles?.has(row.handle) ?? false) ||
@@ -31,6 +33,7 @@ export async function reconcileParkedAgents(stores, scope, now, opts) {
         next.stoppedBy = "system";
         next.settledAt = now;
         next.updatedAt = now;
+        next.completionId ??= uuidv7();
         delete next.parkedCheckpointToken;
         delete next.parkClaimId;
         delete next.parkedAt;
@@ -248,7 +251,8 @@ export class InMemoryBackgroundAgentStore {
                 const flipped = structuredClone(r);
                 flipped.status = "failed";
                 flipped.stoppedBy = "system";
-                flipped.summary = flipped.summary ?? "host process interrupted (stale running row reaped)";
+                flipped.summary = flipped.summary ?? STALE_RUNNING_REAP_ATTRIBUTION;
+                flipped.error = flipped.error ?? STALE_RUNNING_REAP_ATTRIBUTION;
                 flipped.settledAt = now;
                 flipped.updatedAt = now;
                 flipped.rev = r.rev + 1;

package/dist/core/background-shell.d.ts

@@ -1,4 +1,4 @@
-import type { ExecutionEnv, ExecutionEnvExecOptions, Result } from "../internal/harness.js";
+import type { ExecutionEnv, ExecutionEnvExecOptions, Result } from "../internal/harness-types.js";
 export type BackgroundShellId = string & {
     readonly __brand: "BackgroundShellId";
 };

package/dist/core/checkpoint-store.d.ts

@@ -115,7 +115,6 @@ export interface CheckpointState {
         tokens: number;
         turns: number;
         tasks: number;
-        costUsd: number;
         costMicroUsd: number;
     };
     consolidationNotes?: ConsolidationNote[];

package/dist/core/exec-gate.d.ts

@@ -1,4 +1,4 @@
-import type { ExecutionEnv } from "../internal/harness.js";
+import type { ExecutionEnv } from "../internal/harness-types.js";
 export interface ExecStep {
     command: string;
     label?: string;

package/dist/core/exec-output-tail.d.ts

@@ -1,9 +1,11 @@
+import { StringDecoder } from "node:string_decoder";
 export declare const MAX_EXEC_OUTPUT_BYTES: number;
 export declare class RollingTailBuffer {
     private readonly maxBytes;
     private readonly chunks;
     private size;
-    private dropped;
+    private headDropped;
+    private sourceSkipped;
     constructor(maxBytes?: number);
     push(chunk: Buffer): void;
     recordSkippedBytes(n: number): void;
@@ -11,5 +13,21 @@ export declare class RollingTailBuffer {
         text: string;
         droppedBytes: number;
     };
+    bytes(): Buffer;
+    headDroppedBytes(): number;
+    sourceSkippedBytes(): number;
 }
+export interface StreamCursorState {
+    tail: RollingTailBuffer;
+    cursorBytes: number;
+    acceptedBytes: number;
+    disclosedSkippedBytes: number;
+    decoder: StringDecoder;
+}
+export declare function newStreamCursorState(tail?: RollingTailBuffer): StreamCursorState;
+export declare function sliceStreamIncrement(s: StreamCursorState, terminal: boolean): {
+    inc: string;
+    droppedBeforeCursor: number;
+};
 export declare function markTruncated(text: string, droppedBytes: number): string;
+export declare function markLiveSpoolRotations(text: string, liveRotations: number): string;