@tea-agent/loop-agent 0.29.1 → 0.29.3

package/dist/worker/console/chat/pi-runtime.js

@@ -23,8 +23,9 @@
  * `createDefaultPiSdkBindings()`.
  */
 import { randomBytes } from "node:crypto";
-import { projectCompactSnapshot } from "./chat-event-store.js";
+import { access } from "node:fs/promises";
 import path from "node:path";
+import { projectCompactSnapshot, } from "./chat-event-store.js";
 import { extractUsageSample } from "./usage.js";
 import { OPERATOR_CHAT_ALLOWED_TOOLS, authorizeOperatorChatTool, assertNoWriteToolInList, } from "./tools.js";
 import { createOperatorChatResourceLoader, } from "./resource-loader.js";
@@ -46,7 +47,7 @@ import { filterActiveInterviewTools } from "../interview/tools.js";
  *
  * Instruction skills are appended AFTER this as read-only context (plan D1).
  */
-const OPERATOR_CHAT_SYSTEM_PROMPT_BASE = [
+export const OPERATOR_CHAT_SYSTEM_PROMPT_BASE = [
     "You are the General Operator Chat for loop-agent / agent-worker.",
     "You are an OPERATOR first: orchestrate and inspect via operator_* tools, and you also have full Pi repository tools (read, write, edit, bash, grep, find, ls) plus optional safe-read/safe-grep/git-status/git-diff.",
     "Capability honesty (ADR 0011): read/write/edit/bash ARE available. Prefer governed loop-agent / Agent DAG paths (implement-pi / repair-pi) and Human Gate for large refactors, public contracts, credentials, or production-risk changes — treat direct write/edit/bash as soft-disciplined, not as a second DAG kernel.",
@@ -55,7 +56,18 @@ const OPERATOR_CHAT_SYSTEM_PROMPT_BASE = [
     "High-risk mutations still use prepare + browser Human Gate. Prepare contract via interview then apply via contractApply, prepare DAG runs via prepareDagConfirmation, prepare other mutations via prepareMutationGate, then confirm in the browser Human Gate. When a high-risk action (contractApply / runDag / dagRerun / etc.) fails on missing prepared state, diagnose with status/doctor/dagReport/inspect/contractShow/read/safe-read/safe-grep.",
     "You cannot self-confirm a DAG run: confirmDagConfirmation is a human-only action (executed by the browser with a server-signed confirmation token). You may only prepare it via prepareDagConfirmation; the user must confirm in the UI.",
     "Prefer read-only diagnosis (status, doctor, dagReport, inspect, contractShow, read, safe-read, safe-grep, git-status) before mutating.",
+    "Recovery default order (save tokens/time; do NOT open a new task-id for provider flake): (1) dagReport/doctor/status — read primaryFailure.nodeId + primaryRecovery; (2) for completed failed|partial_failed standalone runs prefer dagRerunPlan then prepareMutationGate/dagRerun from the failed or safe upstream node (plan → planHash → human gate); (3) paused → approve path / resume, never treat resume as failure retry; (4) only when plan is ineligible (writer/decision/fingerprint) or contract/source truly changed: standaloneTaskRerun or same-task task advance — never invent a fresh task-id without cause; (5) Worker-owned failures use workerTaskRetry, not dagRerun. Never use direct write/edit as a substitute for repair-pi.",
 ].join("\n");
+/** Compose the inspectable system prompt actually injected into Operator Chat. */
+export function composeOperatorChatSystemPrompt(input) {
+    return [
+        OPERATOR_CHAT_SYSTEM_PROMPT_BASE,
+        ...(input.skillFragment?.trim() ? [input.skillFragment.trim()] : []),
+        ...(input.systemPromptSuffix?.trim()
+            ? [input.systemPromptSuffix.trim()]
+            : []),
+    ].join("\n\n");
+}
 /**
  * Built-in SDK tool names registered for every Chat session (ADR 0011).
  * Full Pi builtins: read/write/edit/bash/grep/find/ls. safe-* custom tools
@@ -125,9 +137,7 @@ async function buildCustomOperatorTools(options) {
                 default:
                     t = Type.Object({}, { additionalProperties: true });
             }
-            acc[param.name] = param.required
-                ? t
-                : Type.Optional(t);
+            acc[param.name] = param.required ? t : Type.Optional(t);
             return acc;
         }, {}), { additionalProperties: false });
         return defineTool({
@@ -141,7 +151,13 @@ async function buildCustomOperatorTools(options) {
                 if (!decision.ok) {
                     return {
                         content: [
-                            { type: "text", text: JSON.stringify({ error: decision.message, code: decision.code }) },
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    error: decision.message,
+                                    code: decision.code,
+                                }),
+                            },
                         ],
                         details: { error: decision.message, code: decision.code },
                     };
@@ -228,7 +244,10 @@ async function buildExploreCustomTools(options) {
                             }),
                         },
                     ],
-                    details: { error: err.message ?? String(e), code: err.code ?? "READ_FAILED" },
+                    details: {
+                        error: err.message ?? String(e),
+                        code: err.code ?? "READ_FAILED",
+                    },
                 };
             }
         },
@@ -266,7 +285,10 @@ async function buildExploreCustomTools(options) {
                             }),
                         },
                     ],
-                    details: { error: err.message ?? String(e), code: err.code ?? "GREP_FAILED" },
+                    details: {
+                        error: err.message ?? String(e),
+                        code: err.code ?? "GREP_FAILED",
+                    },
                 };
             }
         },
@@ -281,7 +303,12 @@ async function buildExploreCustomTools(options) {
             const r = safeGit(["status", "--porcelain"]);
             if (!r.ok) {
                 return {
-                    content: [{ type: "text", text: JSON.stringify({ error: r.message, code: r.code }) }],
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: r.message, code: r.code }),
+                        },
+                    ],
                     details: { error: r.message, code: r.code },
                 };
             }
@@ -299,7 +326,9 @@ async function buildExploreCustomTools(options) {
         description: "Typed `git diff` (fixed argv: --stat or a single -- path; no shell). Returns scrubbed diff. path must be repo-relative and not sensitive.",
         promptSnippet: "git-diff: diff (read-only, scrubbed)",
         parameters: Type.Object({
-            path: Type.Optional(Type.String({ description: "optional repo-relative path to diff (default: whole tree --stat)" })),
+            path: Type.Optional(Type.String({
+                description: "optional repo-relative path to diff (default: whole tree --stat)",
+            })),
         }, { additionalProperties: false }),
         async execute(_toolCallId, params) {
             let rawPath = params.path ? String(params.path) : undefined;
@@ -311,20 +340,26 @@ async function buildExploreCustomTools(options) {
                 if (!g.ok) {
                     return {
                         content: [
-                            { type: "text", text: JSON.stringify({ error: g.message, code: g.code }) },
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: g.message, code: g.code }),
+                            },
                         ],
                         details: { error: g.message, code: g.code },
                     };
                 }
                 rawPath = g.repoRelative;
             }
-            const args = rawPath
-                ? ["diff", "--", rawPath]
-                : ["diff", "--stat"];
+            const args = rawPath ? ["diff", "--", rawPath] : ["diff", "--stat"];
             const r = safeGit(args);
             if (!r.ok) {
                 return {
-                    content: [{ type: "text", text: JSON.stringify({ error: r.message, code: r.code }) }],
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: r.message, code: r.code }),
+                        },
+                    ],
                     details: { error: r.message, code: r.code },
                 };
             }
@@ -338,7 +373,15 @@ async function buildExploreCustomTools(options) {
     });
     return [safeReadTool, safeGrepTool, gitStatusTool, gitDiffTool];
 }
-export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+export const THINKING_LEVELS = [
+    "off",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max",
+];
 /**
  * Extract the latest assistant text fragment from an SDK message object.
  * Tolerant of multiple message shapes the SDK emits.
@@ -361,6 +404,25 @@ export function extractAssistantText(message) {
     }
     return segments.join("");
 }
+function readSessionManagerId(manager) {
+    if (!manager || typeof manager !== "object")
+        return undefined;
+    const record = manager;
+    if (typeof record.getSessionId === "function") {
+        try {
+            const value = record.getSessionId();
+            if (typeof value === "string" && value.trim())
+                return value;
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (typeof record.sessionId === "string" && record.sessionId.trim()) {
+        return record.sessionId;
+    }
+    return undefined;
+}
 /**
  * Console Pi runtime — holds Chat sessions and drives prompt() with three-gate
  * tool enforcement. Session-per-sessionId; cross-request reuse via open().
@@ -377,8 +439,7 @@ export class ConsolePiRuntime {
     constructor(options) {
         this.options = options;
         this.loader = createOperatorChatResourceLoader();
-        this.bindings =
-            options.bindings ?? createDefaultPiSdkBindings();
+        this.bindings = options.bindings ?? createDefaultPiSdkBindings();
     }
     get sessionDir() {
         return this.options.sessionDir;
@@ -388,8 +449,17 @@ export class ConsolePiRuntime {
         return safeGetAgentDir(this.bindings);
     }
     async testConfiguredModel(model) {
-        const { services } = await this.bindings.createServices({ cwd: this.options.cwd, agentDir: await this.getAgentDir() });
-        return { available: Boolean(this.bindings.resolveModel({ modelRuntime: services.modelRuntime, provider: model.provider, modelId: model.modelId })) };
+        const { services } = await this.bindings.createServices({
+            cwd: this.options.cwd,
+            agentDir: await this.getAgentDir(),
+        });
+        return {
+            available: Boolean(this.bindings.resolveModel({
+                modelRuntime: services.modelRuntime,
+                provider: model.provider,
+                modelId: model.modelId,
+            })),
+        };
     }
     setDisabledInstructionSkills(names) {
         this.disabledInstructionSkills = new Set(names);
@@ -559,9 +629,7 @@ export class ConsolePiRuntime {
                 "coding_chat",
                 "shell",
             ],
-            ...(customTools && customTools.length > 0
-                ? { customTools }
-                : {}),
+            ...(customTools && customTools.length > 0 ? { customTools } : {}),
             ...(resolvedModel ? { model: resolvedModel } : {}),
         });
         // Gate 2: re-pin active tools (defensive — some SDK paths may seed
@@ -589,12 +657,21 @@ export class ConsolePiRuntime {
             targetSessionDir: this.options.sessionDir,
             targetSessionId: sessionId,
         });
-        const built = await this.buildSessionWithServices({ sessionManager, model: init.model });
+        const built = await this.buildSessionWithServices({
+            sessionManager,
+            model: init.model,
+        });
         built.session.setActiveToolsByName(OPERATOR_CHAT_ACTIVE_TOOL_NAMES());
         this.sessions.set(sessionId, built.session);
         this.sessionManagers.set(sessionId, sessionManager);
         this.modelRuntimes.set(sessionId, built.modelRuntime);
-        return { sessionId, sessionFile: built.session.sessionFile, createdAt: new Date().toISOString(), model: init.model, activeTools: built.session.getActiveToolNames() };
+        return {
+            sessionId,
+            sessionFile: built.session.sessionFile,
+            createdAt: new Date().toISOString(),
+            model: init.model,
+            activeTools: built.session.getActiveToolNames(),
+        };
     }
     async branchSession(input) {
         const session = this.sessions.get(input.sessionId);
@@ -610,7 +687,10 @@ export class ConsolePiRuntime {
         const entry = input.summary
             ? manager.branchWithSummary?.(input.branchFromEntryId, input.summary)
             : (manager.branch(input.branchFromEntryId), undefined);
-        return { branchedFromEntryId: input.branchFromEntryId, ...(entry?.id ? { branchSummaryEntryId: entry.id } : {}) };
+        return {
+            branchedFromEntryId: input.branchFromEntryId,
+            ...(entry?.id ? { branchSummaryEntryId: entry.id } : {}),
+        };
     }
     switchToMainline(sessionId) {
         const manager = this.sessionManagers.get(sessionId);
@@ -623,7 +703,10 @@ export class ConsolePiRuntime {
         const manager = this.sessionManagers.get(sessionId);
         if (!manager)
             throw new Error(`chat session not active: ${sessionId}`);
-        return { leafId: manager.getLeafId?.() ?? null, entries: manager.getBranch?.() ?? [] };
+        return {
+            leafId: manager.getLeafId?.() ?? null,
+            entries: manager.getBranch?.() ?? [],
+        };
     }
     async listModels(sessionId) {
         const modelRuntime = this.modelRuntimes.get(sessionId);
@@ -638,11 +721,18 @@ export class ConsolePiRuntime {
             throw new Error(`chat session not active: ${sessionId}`);
         if (!session.setModel)
             throw new Error("MODEL_SWITCH_UNSUPPORTED");
-        const resolved = this.bindings.resolveModel({ modelRuntime, provider: model.provider, modelId: model.modelId });
+        const resolved = this.bindings.resolveModel({
+            modelRuntime,
+            provider: model.provider,
+            modelId: model.modelId,
+        });
         if (!resolved)
             throw new Error("MODEL_NOT_AVAILABLE");
         await session.setModel(resolved);
-        return { provider: session.model?.provider ?? model.provider, modelId: session.model?.id ?? session.model?.modelId ?? model.modelId };
+        return {
+            provider: session.model?.provider ?? model.provider,
+            modelId: session.model?.id ?? session.model?.modelId ?? model.modelId,
+        };
     }
     applyThinkingLevel(sessionId, level) {
         const session = this.sessions.get(sessionId);
@@ -659,7 +749,13 @@ export class ConsolePiRuntime {
             return { activeTools: [] };
         const provider = session.model?.provider;
         const modelId = session.model?.id ?? session.model?.modelId;
-        return { ...(provider && modelId ? { model: { provider, modelId } } : {}), ...(session.thinkingLevel ? { thinkingLevel: session.thinkingLevel } : {}), activeTools: session.getActiveToolNames() };
+        return {
+            ...(provider && modelId ? { model: { provider, modelId } } : {}),
+            ...(session.thinkingLevel
+                ? { thinkingLevel: session.thinkingLevel }
+                : {}),
+            activeTools: session.getActiveToolNames(),
+        };
     }
     /**
      * Re-open a previously persisted Chat session after Console restart or
@@ -704,7 +800,15 @@ export class ConsolePiRuntime {
             return {
                 ok: false,
                 code: "REOPEN_FAILED",
-                message: `Pi session file not openable: ${init.sessionFile}`,
+                message: `Pi session file missing or not openable: ${init.sessionFile}`,
+            };
+        }
+        const managerSessionId = readSessionManagerId(sessionManager);
+        if (managerSessionId && managerSessionId !== sessionId) {
+            return {
+                ok: false,
+                code: "REOPEN_FAILED",
+                message: `reopened Pi sessionId mismatch: expected ${sessionId}, got ${managerSessionId}`,
             };
         }
         try {
@@ -714,10 +818,14 @@ export class ConsolePiRuntime {
                 systemPromptSuffix: init.systemPromptSuffix,
             });
             const session = built.session;
-            // The reopened session MUST report the SAME sessionId as the durable
-            // record, otherwise we'd be serving a different conversation under a
-            // stale id. Mismatch is a fail-closed reopen failure.
-            if (session.sessionId !== sessionId) {
+            // Prefer the SessionManager id (from the JSONL header). Some SDK
+            // builds expose a different agent-session UUID on `session.sessionId`
+            // even when the manager correctly reopened our operator-chat file —
+            // map by the durable Console sessionId in that case.
+            const reportedId = session.sessionId ?? managerSessionId;
+            if (reportedId &&
+                reportedId !== sessionId &&
+                managerSessionId !== sessionId) {
                 try {
                     session.dispose();
                 }
@@ -727,7 +835,7 @@ export class ConsolePiRuntime {
                 return {
                     ok: false,
                     code: "REOPEN_FAILED",
-                    message: `reopened Pi sessionId mismatch: expected ${sessionId}, got ${session.sessionId}`,
+                    message: `reopened Pi sessionId mismatch: expected ${sessionId}, got ${reportedId}`,
                 };
             }
             session.setActiveToolsByName(OPERATOR_CHAT_ACTIVE_TOOL_NAMES());
@@ -865,6 +973,15 @@ export class ConsolePiRuntime {
             const mapped = mapSdkEvent(sessionId, event);
             if (mapped)
                 onEvent(mapped);
+            // Pi puts per-assistant-message usage on `message.usage` ({ input, output,
+            // cacheRead, cacheWrite, totalTokens, cost }). Emit on message_end so
+            // multi-step tool turns accumulate like pi-web SessionInfoBar; turn_end
+            // repeats the final message and must not double-count.
+            if (event.type === "message_end") {
+                const usage = extractUsageSample(event);
+                if (usage)
+                    onEvent({ type: "usage", sessionId, usage });
+            }
         });
         const onAbort = () => {
             // M1 T08: Stop must abort only the current turn, NOT dispose the
@@ -956,11 +1073,15 @@ function mapSdkEvent(sessionId, event) {
                 text: extractAssistantText(event.message),
             };
         case "message_end":
-            return { type: "message_end", sessionId, text: extractAssistantText(event.message) };
-        case "turn_end": {
-            const usage = extractUsageSample(event);
-            return usage ? { type: "usage", sessionId, usage } : undefined;
-        }
+            return {
+                type: "message_end",
+                sessionId,
+                text: extractAssistantText(event.message),
+            };
+        case "turn_end":
+            // Usage is emitted from message_end (see prompt subscribe). turn_end
+            // carries the same final assistant message and would double-count.
+            return undefined;
         case "tool_execution_start":
             return {
                 type: "tool_call",
@@ -1085,6 +1206,11 @@ export function createDefaultPiSdkBindings() {
         openSessionManager: async (opts) => {
             const sdk = (await loadSdk());
             try {
+                // Pi SessionManager.open(missingPath) does NOT throw — it creates a
+                // fresh in-memory session with a random UUID. That would reopen the
+                // wrong conversation under the durable Console sessionId. Fail closed
+                // before open when the persisted file is absent.
+                await access(opts.sessionFile);
                 return sdk.SessionManager.open(opts.sessionFile);
             }
             catch {

package/dist/worker/console/chat/routes.js

@@ -17,7 +17,7 @@ import { OPERATOR_CHAT_ALLOWED_TOOLS, OPERATOR_CHAT_DENIED_TOOLS, OPERATOR_CHAT_
 import { OPERATOR_CHAT_ALLOWED_INSTRUCTION_SKILLS, OPERATOR_CHAT_DENIED_INSTRUCTION_SKILLS, OPERATOR_CHAT_WORKFLOW_CONDITIONAL_SKILLS, composeInstructionSkillsPrompt, loadOperatorChatInstructionSkills, } from "./instruction-skills.js";
 import { buildModelCallableToolSchemas } from "./tool-adapter.js";
 import { projectChatToolEventPayload, projectCompactSnapshot, } from "./chat-event-store.js";
-import { THINKING_LEVELS } from "./pi-runtime.js";
+import { THINKING_LEVELS, composeOperatorChatSystemPrompt, } from "./pi-runtime.js";
 import { ComposerDraftStore } from "./composer-draft-store.js";
 import { walkRepoFiles } from "./repo-walk.js";
 import { isSensitivePath, scrubSecrets } from "./explore-tools.js";
@@ -936,7 +936,26 @@ async function handleRuntimeContext(res, deps, sessionId) {
     }
     const skills = await loadOperatorChatInstructionSkills(deps.skillsDir);
     const selection = deps.runtime.getRuntimeSelection(sessionId);
-    sendJson(res, 200, { ok: true, context: projectRuntimeContext({ systemPrompt: "Operator Chat isolated system prompt", skills: skills.loaded, model: selection.model ?? (record.modelProvider && record.modelId ? { provider: record.modelProvider, modelId: record.modelId } : undefined), thinkingLevel: selection.thinkingLevel ?? record.thinkingLevel, activeTools: selection.activeTools }) });
+    const skillFragment = composeInstructionSkillsPrompt(skills.loaded);
+    const systemPrompt = composeOperatorChatSystemPrompt({ skillFragment });
+    sendJson(res, 200, {
+        ok: true,
+        context: projectRuntimeContext({
+            systemPrompt,
+            skills: skills.loaded.map((skill) => ({
+                name: skill.name,
+                description: skill.description,
+                charCount: skill.charCount,
+                bodyText: skill.bodyText,
+            })),
+            model: selection.model ??
+                (record.modelProvider && record.modelId
+                    ? { provider: record.modelProvider, modelId: record.modelId }
+                    : undefined),
+            thinkingLevel: selection.thinkingLevel ?? record.thinkingLevel,
+            activeTools: selection.activeTools,
+        }),
+    });
 }
 async function handleModels(req, res, deps, sessionId) {
     if (!await requireChatSession(res, deps, sessionId))

package/dist/worker/console/chat/runtime-context.js

@@ -1,24 +1,66 @@
 import { createHash } from "node:crypto";
 import { scrubSecrets } from "./explore-tools.js";
-function summary(text, max = 320) {
-    if (!text)
-        return undefined;
+const DEFAULT_SUMMARY_MAX = 320;
+/** Hard cap for inspectable full text returned to the browser. */
+export const RUNTIME_CONTEXT_TEXT_MAX = 120_000;
+function redact(text) {
     return scrubSecrets(text).scrubbed
         .replace(/\bghp_[A-Za-z0-9]{20,}\b/g, "[REDACTED]")
-        .replace(/\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/gi, "Bearer [REDACTED]")
-        .slice(0, max);
+        .replace(/\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/gi, "Bearer [REDACTED]");
+}
+function summary(text, max = DEFAULT_SUMMARY_MAX) {
+    if (!text)
+        return undefined;
+    const cleaned = redact(text).replace(/\s+/g, " ").trim();
+    if (!cleaned)
+        return undefined;
+    return cleaned.length > max ? `${cleaned.slice(0, max)}…` : cleaned;
+}
+function fullText(text, max = RUNTIME_CONTEXT_TEXT_MAX) {
+    if (!text)
+        return undefined;
+    const cleaned = redact(text);
+    if (cleaned.length <= max)
+        return cleaned;
+    return `${cleaned.slice(0, max)}\n\n…[truncated ${cleaned.length - max} chars for inspect UI]`;
 }
 export function projectRuntimeContext(input) {
+    const systemText = fullText(input.systemPrompt) ?? "";
+    const suffixText = fullText(input.systemPromptSuffix);
     return {
         readOnly: true,
         systemPrompt: {
             hash: createHash("sha256").update(input.systemPrompt).digest("hex"),
             summary: summary(input.systemPrompt),
+            text: systemText,
+            charCount: input.systemPrompt.length,
+        },
+        skills: input.skills.map((skill) => ({
+            name: skill.name,
+            description: summary(skill.description, 200) ?? "",
+            charCount: skill.charCount,
+            ...(skill.bodyText
+                ? { body: fullText(skill.bodyText, 40_000) }
+                : {}),
+        })),
+        resources: {
+            mode: "closed",
+            noContextFiles: true,
+            noSkills: true,
+            noExtensions: true,
+            hasBash: true,
+            activeToolCount: input.activeTools.length,
+            activeTools: [...input.activeTools],
         },
-        skills: input.skills.map((skill) => ({ ...skill, description: summary(skill.description, 200) ?? "" })),
-        resources: { mode: "closed", noContextFiles: true, noSkills: true, noExtensions: true, hasBash: true, activeToolCount: input.activeTools.length },
         model: input.model,
         thinkingLevel: input.thinkingLevel,
-        suffix: input.systemPromptSuffix ? { present: true, summary: summary(input.systemPromptSuffix) } : { present: false },
+        suffix: input.systemPromptSuffix
+            ? {
+                present: true,
+                summary: summary(input.systemPromptSuffix),
+                ...(suffixText ? { text: suffixText } : {}),
+                charCount: input.systemPromptSuffix.length,
+            }
+            : { present: false },
     };
 }

package/dist/worker/console/chat/tool-preview.js

@@ -0,0 +1,90 @@
+/**
+ * Human-readable one-line preview for tool call arguments (pi-web getToolPreview).
+ */
+const PREVIEW_KEYS = [
+    "command",
+    "path",
+    "file_path",
+    "filePath",
+    "pattern",
+    "query",
+    "glob",
+    "url",
+];
+const DEFAULT_PREVIEW_MAX = 120;
+const DEFAULT_RESULT_MAX = 800;
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    return value;
+}
+function parseArgs(args) {
+    if (args === undefined || args === null)
+        return undefined;
+    if (typeof args === "string") {
+        const trimmed = args.trim();
+        if (!trimmed)
+            return undefined;
+        try {
+            return asRecord(JSON.parse(trimmed));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return asRecord(args);
+}
+/** One-line summary for a tool-call header; empty when nothing useful. */
+export function getToolPreview(args, options) {
+    const maxLen = options?.maxLen ?? DEFAULT_PREVIEW_MAX;
+    const input = parseArgs(args);
+    if (!input) {
+        if (typeof args === "string") {
+            const s = args.replace(/\s+/g, " ").trim();
+            if (!s || s === "{}")
+                return "";
+            return s.length > maxLen ? `${s.slice(0, maxLen)}…` : s;
+        }
+        return "";
+    }
+    for (const key of PREVIEW_KEYS) {
+        const value = input[key];
+        if (typeof value === "string" && value.trim()) {
+            const s = value.replace(/\s+/g, " ").trim();
+            return s.length > maxLen ? `${s.slice(0, maxLen)}…` : s;
+        }
+    }
+    const keys = Object.keys(input);
+    if (keys.length === 0)
+        return "";
+    const first = input[keys[0]];
+    const s = String(first ?? "").replace(/\s+/g, " ").trim();
+    if (!s)
+        return "";
+    return s.length > maxLen ? `${s.slice(0, maxLen)}…` : s;
+}
+export function formatToolArgsDisplay(args) {
+    if (args === undefined || args === null)
+        return "";
+    try {
+        return typeof args === "string" ? args : JSON.stringify(args, null, 2);
+    }
+    catch {
+        return String(args);
+    }
+}
+export function truncateToolResult(text, options) {
+    if (text === undefined)
+        return { text: "", truncated: false };
+    const maxLen = options?.maxLen ?? DEFAULT_RESULT_MAX;
+    if (text.length <= maxLen)
+        return { text, truncated: false };
+    return { text: `${text.slice(0, maxLen)}…`, truncated: true };
+}
+export function toolCallDurationSeconds(createdAt, finishedAt) {
+    if (finishedAt === undefined || !Number.isFinite(createdAt) || !Number.isFinite(finishedAt)) {
+        return undefined;
+    }
+    const secs = Math.round((finishedAt - createdAt) / 1000);
+    return secs > 0 ? secs : undefined;
+}