@maudecode/talaria-web 1.11.0 → 1.13.0

package/dist/sessions/tool-display.js

@@ -0,0 +1,113 @@
+import { str } from '../util.js';
+import { isDict, TOOL_ARG_CONTENT_CAP, TOOL_ARG_CONTENT_KEYS } from './merge.js';
+/** Ordered rules over whole `_`-separated name tokens (a substring match would read `merge` as `rg`). */
+const RULES = [
+    ['delegate', (_, n) => n === 'subagent_progress' || n === 'delegate_task'],
+    ['skill', (t) => t.has('skill') || t.has('skills')],
+    ['memory', (t) => t.has('memory')],
+    ['shell', (t, n) => ['terminal', 'shell', 'command', 'process', 'bash', 'exec'].some((k) => t.has(k)) || n === 'execute_code'],
+    ['read', (t, n) => ['read', 'view', 'open'].some((k) => t.has(k)) || n === 'vision_analyze'],
+    ['list', (t, n) => t.has('list') || n === 'todo'],
+    ['web', (t) => ['web', 'fetch', 'curl', 'extract', 'browse', 'browser', 'navigate'].some((k) => t.has(k))],
+    ['search', (t) => ['search', 'grep', 'find', 'rg', 'ripgrep', 'glob'].some((k) => t.has(k))],
+    ['write', (t) => ['write', 'patch', 'edit'].some((k) => t.has(k))],
+];
+export function toolKind(name) {
+    // camelCase and acronym words split like snake_case ones (`readFile` is `read`, `file`; `HTTPFetch` is `http`, `fetch`).
+    const n = str(name).replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2').replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+    if (!n)
+        return 'unknown';
+    const tokens = new Set(n.split('_'));
+    return RULES.find(([, match]) => match(tokens, n))?.[0] ?? 'unknown';
+}
+const TARGET_KEYS = {
+    shell: ['cmd', 'command'],
+    skill: ['name', 'skill'],
+    memory: ['target', 'name', 'action'],
+    read: ['path', 'file_path', 'file', 'target', 'name'],
+    write: ['path', 'file_path', 'file', 'target', 'name'],
+    search: ['query', 'pattern', 'url', 'uri'],
+    web: ['query', 'pattern', 'url', 'uri'],
+};
+const FALLBACK_KEYS = ['cmd', 'command', 'path', 'file_path', 'file', 'uri', 'url', 'query', 'pattern', 'dir', 'task', 'name'];
+const TOOL_TARGET_MAX = 200;
+/** Python's `repr` of a JSON value (what `str()` shows for items inside a list or dict). */
+function pythonRepr(value) {
+    if (typeof value === 'string') {
+        const quote = value.includes("'") && !value.includes('"') ? '"' : "'";
+        return quote + value.replace(/[\\\n\r\t]/g, (c) => ({ '\\': '\\\\', '\n': '\\n', '\r': '\\r', '\t': '\\t' })[c]).replaceAll(quote, `\\${quote}`) + quote;
+    }
+    return pythonStr(value);
+}
+/**
+ * A JSON value in Python's `str()` shape with JavaScript number text (a persisted `1.0` parses to `1`). The sidecar's
+ * `_display_str` renders a live non-string argument by this same rule, so a call shows one target live and after reload.
+ */
+function pythonStr(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === null)
+        return 'None';
+    if (typeof value === 'boolean')
+        return value ? 'True' : 'False';
+    if (Array.isArray(value))
+        return `[${value.map(pythonRepr).join(', ')}]`;
+    if (isDict(value))
+        return `{${Object.entries(value).map(([k, v]) => `${pythonRepr(k)}: ${pythonRepr(v)}`).join(', ')}}`;
+    return typeof value === 'number' ? String(value) : '';
+}
+/**
+ * An argument as the live frame carries it (the sidecar's `_args_snapshot`): only the first four arguments, and a
+ * non-content value capped at 120 code points plus `...`. Targets come from this view, so a call shows the same target
+ * live and after reload.
+ */
+function snapshotArg(args, key) {
+    if (!Object.keys(args).slice(0, 4).includes(key) || args[key] === undefined)
+        return null;
+    return snapshotValue(key, args[key]);
+}
+function snapshotValue(key, raw) {
+    const value = pythonStr(raw);
+    const cap = TOOL_ARG_CONTENT_KEYS.has(key.toLowerCase()) ? TOOL_ARG_CONTENT_CAP : 120;
+    const chars = Array.from(value);
+    return chars.length > cap ? `${chars.slice(0, cap).join('')}...` : value;
+}
+/**
+ * A persisted call's arguments as the live frame carries them (the sidecar's `_args_snapshot`), so its target is
+ * redacted after the same cap the live one was (a credential straddling the cap masks alike). Idempotent on a snapshot.
+ */
+export function snapshotArgs(args) {
+    if (!isDict(args))
+        return args;
+    return Object.fromEntries(Object.entries(args).slice(0, 4).filter(([, v]) => v !== undefined).map(([k, v]) => [k, snapshotValue(k, v)]));
+}
+/** A call's display class and label: the first line of its kind's argument, whitespace-collapsed and capped. */
+export function toolDisplay(name, args) {
+    const kind = toolKind(name);
+    const a = isDict(args) ? args : {};
+    const raw = (TARGET_KEYS[kind] ?? FALLBACK_KEYS).map((k) => snapshotArg(a, k)).find((v) => typeof v === 'string' && Boolean(v.trim())) ?? '';
+    const first = raw.trim().split('\n')[0] ?? '';
+    // Capped by code point, so the cap never splits a surrogate pair into invalid JSON.
+    return { kind, target: Array.from(first.replace(/\s+/g, ' ').trim()).slice(0, TOOL_TARGET_MAX).join('') };
+}
+/** A persisted call's arguments: live `args`, a `tool_use` block's `input`, or OpenAI `function.arguments` JSON. */
+export function toolArgs(call) {
+    if (call.args !== undefined)
+        return call.args;
+    if (call.input !== undefined)
+        return call.input;
+    const raw = isDict(call.function) ? call.function.arguments : undefined;
+    if (typeof raw !== 'string')
+        return raw ?? null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+/** A live frame's or persisted call's tool name, in any of the shapes the transcript carries. */
+export function toolName(call) {
+    return str(call.name) || str(call.tool_name) || (isDict(call.function) ? str(call.function.name) : '');
+}
+//# sourceMappingURL=tool-display.js.map

package/dist/sessions/tool-display.js.map

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

package/dist/sessions/turn.d.ts

@@ -4,6 +4,7 @@ import type { SessionService } from './service.js';
 import { HttpFailure } from './service.js';
 import type { SessionEventBus } from './events.js';
 import { StreamRegistry, SessionChannels } from './streams.js';
+import type { ClarifyAnswers } from '@maudecode/talaria-web-contracts';
 import { PendingPrompts } from './pending.js';
 import { RunJournal, type RunJournalWriter } from './journal.js';
 import { Session } from './session.js';
@@ -29,7 +30,6 @@ export interface TurnRunnerDeps {
     /** Per-session toolsets override or the profile's configured toolsets (null lets the Agent decide). */
     toolsetsFor: (session: Session) => string[] | null;
     attachmentDir: (sid: string) => string;
-    agentName: () => string;
     titleGenerationEnabled: () => boolean;
     /** Terminal relay phase per stream (`completed`/`cancelled`/`failed`); Python `note_talaria_terminal`. */
     onTerminal?: (streamId: string, phase: string) => void;
@@ -78,7 +78,6 @@ export declare function classifyProviderError(errStr: string, opts?: {
     silentFailure?: boolean | undefined;
     condition?: string | undefined;
 }): ErrorClassification;
-export declare function cancelledTurnHint(agentName?: string): string;
 export declare function providerErrorPayload(message: string, errType: string, hint?: string, redact?: boolean): Record<string, unknown>;
 /** The image formats a provider accepts inline; the MIME comes from the bytes, never from the client. */
 /**
@@ -104,6 +103,13 @@ export declare class TurnRunner {
     private readonly lastCompletedTool;
     /** Streams whose run completed (`done` emitted) and only await title work; a late cancel is a no-op for these. */
     private readonly settledStreams;
+    /**
+     * TAL-364: what a Stop needs to write the turn's model context: its starting context, the prompt the Agent got, and
+     * whether a settlement already used a canonical checkpoint (which marks the stop boundary; later work never replaces it).
+     */
+    /** TAL-364: a Stop's in-flight `chat.interrupt` reply (null when it failed), so a worker that settles first can use its checkpoint. */
+    private readonly interrupts;
+    private readonly stopContexts;
     constructor(deps: TurnRunnerDeps);
     private get registry();
     /** Python `_start_chat_stream_for_session`: persist pending state, register the channel, launch the worker. */
@@ -130,10 +136,16 @@ export declare class TurnRunner {
     private persistError;
     private materializePendingUserTurn;
     private appendPartialSnapshot;
-    private cancelPayload;
-    /** Python `_emit_cancel_event`: the terminal frame carries the settled session so tabs can render the partial without a reload. */
+    /**
+     * Python `_emit_cancel_event`: the terminal frame carries the settled session so tabs can render the partial without a
+     * reload. TAL-364: no copy — clients show their one localized status for the `cancelled` outcome.
+     */
     private cancelFrame;
-    /** Python `_finalize_cancelled_turn`/`_persist_cancelled_turn`: only while this stream still owns writeback. */
+    /**
+     * Python `_finalize_cancelled_turn`/`_persist_cancelled_turn`: only while this stream still owns writeback. TAL-364: the
+     * turn's model context keeps what the Agent had captured (`checkpoint`, its canonical transcript) and the prose that
+     * streamed, so the next request continues from it; the terminal row carries the outcome and no copy.
+     */
     private finalizeCancelled;
     /** Push a frame onto the session's live chat stream from outside the turn (Python gateway notify callbacks). */
     private emitToSession;
@@ -182,10 +194,16 @@ export declare class TurnRunner {
     private withYoloLock;
     /** Python `set_session_yolo_enabled(False)`: the sidecar must drop its per-session YOLO state before the local flag clears. */
     disableYolo(sessionId: string): Promise<Record<string, unknown>>;
-    /** `stale` when no such prompt is queued; `ok:false` without `stale` when the sidecar did not acknowledge (prompt retained). */
-    respondClarify(sessionId: string, clarifyId: string, response: string): Promise<{
+    /**
+     * `reply` is the raw Agent reply or keyed step answers the server shapes for the prompt. `stale` when no such
+     * prompt is queued; `invalid` when the answers do not fit its steps; `ok:false` without either when the sidecar
+     * did not acknowledge (prompt retained).
+     */
+    respondClarify(sessionId: string, clarifyId: string, reply: string | ClarifyAnswers): Promise<{
         ok: boolean;
+        response?: string;
         stale?: boolean;
+        invalid?: boolean;
         error?: string;
     }>;
 }