@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/core/cursor-print-tool-catalog.js

@@ -0,0 +1,91 @@
+/** Cursor 2026.10.01-e373342 strict --allowed-tools catalog.
+ * Qualified with fresh/resumed read positive and negative controls in
+ * __fixtures__/cursor/print-delegation.json. A restricted print turn allows the
+ * entries the installed build still advertises (hearsay-tools/cezarion#1257), so
+ * a native entry a newer build adds stays denied until a change lists it here. */
+export const SAFE_CURSOR_PRINT_TOOLS = [
+    'shell_tool_call',
+    'delete_tool_call',
+    'glob_tool_call',
+    'grep_tool_call',
+    'read_tool_call',
+    'update_todos_tool_call',
+    'read_todos_tool_call',
+    'edit_tool_call',
+    'ls_tool_call',
+    'read_lints_tool_call',
+    'mcp_tool_call',
+    'sem_search_tool_call',
+    'create_plan_tool_call',
+    'web_search_tool_call',
+    'list_mcp_resources_tool_call',
+    'read_mcp_resource_tool_call',
+    'apply_agent_diff_tool_call',
+    'ask_question_tool_call',
+    'fetch_tool_call',
+    'switch_mode_tool_call',
+    'generate_image_tool_call',
+    'record_screen_tool_call',
+    'computer_use_tool_call',
+    'write_shell_stdin_tool_call',
+    'reflect_tool_call',
+    'setup_vm_environment_tool_call',
+    'truncated_tool_call',
+    'web_fetch_tool_call',
+    'report_bugfix_results_tool_call',
+    'ai_attribution_tool_call',
+    'pr_management_tool_call',
+    'mcp_auth_tool_call',
+    'await_tool_call',
+    'blame_by_file_path_tool_call',
+    'get_mcp_tools_tool_call',
+    'report_bug_tool_call',
+    'set_active_branch_tool_call',
+    'communicate_update_tool_call',
+    'send_final_summary_tool_call',
+    'update_pr_code_tour_tool_call',
+    'replace_env_tool_call',
+    'edit_pr_labels_tool_call',
+    'record_ci_investigation_findings_tool_call',
+    'fetch_cloud_agent_data_tool_call',
+    'send_to_user_tool_call',
+    'pi_read_tool_call',
+    'pi_bash_tool_call',
+    'pi_edit_tool_call',
+    'pi_write_tool_call',
+    'pi_grep_tool_call',
+    'pi_find_tool_call',
+    'pi_ls_tool_call',
+    'connect_scm_tool_call',
+    'search_conversations_tool_call',
+    'create_goal_tool_call',
+    'update_goal_tool_call',
+    'get_pr_code_tour_tool_call',
+    'write_canvas_tool_call',
+    'read_canvas_tool_call',
+];
+export const NATIVE_CURSOR_DELEGATION_TOOLS = [
+    'task_tool_call',
+    'create_agent_tool_call',
+    'adopt_tool_call',
+    'send_to_agent_tool_call',
+    'send_message_tool_call',
+    'get_agent_status_tool_call',
+    'stop_agent_tool_call',
+    'read_agent_transcript_tool_call',
+    'start_grind_execution_tool_call',
+    'start_grind_planning_tool_call',
+];
+/** A build that no longer advertises one of these cannot do the work of a print session,
+ * so the capability preflight keeps it off print (hearsay-tools/cezarion#1257). */
+export const CORE_CURSOR_PRINT_TOOLS = [
+    'shell_tool_call',
+    'read_tool_call',
+    'edit_tool_call',
+    'glob_tool_call',
+    'grep_tool_call',
+    'ls_tool_call',
+    'delete_tool_call',
+    'mcp_tool_call',
+];
+//# sourceMappingURL=cursor-print-tool-catalog.js.map

package/dist/core/cursor-print-tool-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-print-tool-catalog.js","sourceRoot":"","sources":["../../src/core/cursor-print-tool-catalog.ts"],"names":[],"mappings":"AAAA;;;;kFAIkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,wBAAwB;IACxB,sBAAsB;IACtB,gBAAgB;IAChB,cAAc;IACd,sBAAsB;IACtB,eAAe;IACf,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;IACtB,8BAA8B;IAC9B,6BAA6B;IAC7B,4BAA4B;IAC5B,wBAAwB;IACxB,iBAAiB;IACjB,uBAAuB;IACvB,0BAA0B;IAC1B,yBAAyB;IACzB,wBAAwB;IACxB,6BAA6B;IAC7B,mBAAmB;IACnB,gCAAgC;IAChC,qBAAqB;IACrB,qBAAqB;IACrB,iCAAiC;IACjC,0BAA0B;IAC1B,yBAAyB;IACzB,oBAAoB;IACpB,iBAAiB;IACjB,8BAA8B;IAC9B,yBAAyB;IACzB,sBAAsB;IACtB,6BAA6B;IAC7B,8BAA8B;IAC9B,8BAA8B;IAC9B,+BAA+B;IAC/B,uBAAuB;IACvB,0BAA0B;IAC1B,4CAA4C;IAC5C,kCAAkC;IAClC,wBAAwB;IACxB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,uBAAuB;IACvB,gCAAgC;IAChC,uBAAuB;IACvB,uBAAuB;IACvB,4BAA4B;IAC5B,wBAAwB;IACxB,uBAAuB;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,gBAAgB;IAChB,wBAAwB;IACxB,iBAAiB;IACjB,yBAAyB;IACzB,wBAAwB;IACxB,4BAA4B;IAC5B,sBAAsB;IACtB,iCAAiC;IACjC,iCAAiC;IACjC,gCAAgC;CACxB,CAAC;AAEX;mFACmF;AACnF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,kBAAkB;IAClB,eAAe;CACP,CAAC"}

package/dist/core/cursor-print-ui-mapper.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Cursor Agent CLI `stream-json` → protocol v2 mapper (+ v1 helpers).
+ * Adapted from open-mercato/cezar PR #807's fresh-turn print mapper. This
+ * version retains state across exact-resume processes and maps the native
+ * question rejection observed on Cursor 2026.10.01-e373342.
+ *
+ * Wire shapes: https://cursor.com/docs/cli/reference/output-format
+ * (`system/init`, `assistant`, `tool_call` started/completed, `result`).
+ *
+ * Per the docs above, `thinking` events are suppressed in print mode and the
+ * terminal `result` frame carries no `usage`/`total_cost_usd` — reasoning and
+ * usage.updated/turn.completed-usage are therefore documented `except`
+ * exclusions in `ui-parity.test.ts` (AGENT_PROTOCOL.md §6), not capabilities
+ * this mapper produces. The `usage`/`total_cost_usd` reads below are kept as a
+ * defensive no-op against real output, per the docs' own "field additions may
+ * occur… backward-compatible" note — see `cursor-ui-mapper.test.ts`'s header
+ * for the full verified-vs-unverified provenance split.
+ *
+ * Never throws on malformed input. State is immutable — callers thread the
+ * returned `state` into the next call.
+ */
+import type { AgentEvent } from './agent-runner.ts';
+import type { PlanEntry, UiEvent, UiToolItem } from './ui-events.ts';
+export interface CursorPrintUiState {
+    readonly fallbackSessionId?: string | undefined;
+    readonly sessionStarted: boolean;
+    readonly turnSeq: number;
+    readonly currentTurnId: string | null;
+    readonly itemSeq: number;
+    readonly sawAssistantText: boolean;
+    readonly openTools: ReadonlyMap<string, UiToolItem>;
+    readonly todos: ReadonlyMap<string, PlanEntry>;
+}
+export interface CursorPrintUiMapping {
+    events: UiEvent[];
+    state: CursorPrintUiState;
+}
+export declare function createCursorPrintUiState(opts?: {
+    fallbackSessionId?: string;
+}): CursorPrintUiState;
+/** Fold one parsed stream-json line into v2 events. Never throws. */
+export declare function mapCursorPrintMessage(msg: unknown, state: CursorPrintUiState): CursorPrintUiMapping;
+/**
+ * Convert one Cursor stream-json object into zero or more v1 AgentEvents.
+ * With default (non-partial) stream-json, every assistant event is used.
+ */
+export declare function mapCursorPrintStreamEvent(raw: unknown): AgentEvent[];

package/dist/core/cursor-print-ui-mapper.js

@@ -0,0 +1,553 @@
+import { defined } from './defined.js';
+import { toolDisplay } from '../contract/index.js';
+export function createCursorPrintUiState(opts = {}) {
+    return {
+        fallbackSessionId: opts.fallbackSessionId,
+        sessionStarted: false,
+        turnSeq: 0,
+        currentTurnId: null,
+        itemSeq: 0,
+        sawAssistantText: false,
+        openTools: new Map(),
+        todos: new Map(),
+    };
+}
+/** Fold one parsed stream-json line into v2 events. Never throws. */
+export function mapCursorPrintMessage(msg, state) {
+    try {
+        if (!isRecord(msg))
+            return { events: [], state };
+        switch (msg.type) {
+            case 'system':
+                return msg.subtype === 'init' ? mapInit(msg, state) : { events: [], state };
+            case 'assistant':
+                return mapAssistant(msg, state);
+            case 'tool_call':
+                return mapToolCall(msg, state);
+            case 'result':
+                return mapResult(msg, state);
+            default:
+                return { events: [], state };
+        }
+    }
+    catch {
+        return { events: [], state };
+    }
+}
+function mapInit(msg, state) {
+    const sessionId = str(msg.session_id) ?? state.fallbackSessionId ?? '';
+    if (!sessionId || state.currentTurnId !== null)
+        return { events: [], state };
+    const event = {
+        type: 'session.started',
+        sessionId,
+        backend: 'cursor',
+    };
+    const model = str(msg.model);
+    if (model !== undefined)
+        event.model = model;
+    const cwd = str(msg.cwd);
+    if (cwd !== undefined)
+        event.cwd = cwd;
+    // Every print process starts one turn, but a resumed process belongs to the
+    // same logical session. Only its first init announces session.started.
+    const turnId = `turn_${state.turnSeq + 1}`;
+    return {
+        events: [...(state.sessionStarted ? [] : [event]), { type: 'turn.started', turnId }],
+        state: {
+            ...state,
+            sessionStarted: true,
+            turnSeq: state.turnSeq + 1,
+            currentTurnId: turnId,
+            sawAssistantText: false,
+        },
+    };
+}
+function mapAssistant(msg, state) {
+    // Skip partial-stream duplicates (docs: timestamp_ms + model_call_id table).
+    if ('model_call_id' in msg)
+        return { events: [], state };
+    const content = messageContent(msg);
+    const events = [];
+    let itemSeq = state.itemSeq;
+    let sawAssistantText = state.sawAssistantText;
+    for (const raw of content) {
+        if (!isRecord(raw))
+            continue;
+        if (raw.type === 'text' && typeof raw.text === 'string' && raw.text) {
+            sawAssistantText = true;
+            const item = { kind: 'message', id: `item_${++itemSeq}`, role: 'assistant', text: raw.text };
+            events.push({ type: 'item.started', item }, { type: 'item.completed', item });
+        }
+        else if (raw.type === 'thinking' && typeof raw.thinking === 'string' && raw.thinking.trim() !== '') {
+            // Print mode suppresses dedicated thinking events; content-block thinking
+            // is the documented substitute when a model still emits it.
+            const item = { kind: 'reasoning', id: `item_${++itemSeq}`, text: raw.thinking };
+            events.push({ type: 'item.started', item }, { type: 'item.completed', item });
+        }
+    }
+    if (events.length === 0)
+        return { events, state };
+    return { events, state: { ...state, itemSeq, sawAssistantText } };
+}
+function mapToolCall(msg, state) {
+    const callId = str(msg.call_id);
+    if (!callId)
+        return { events: [], state };
+    const subtype = str(msg.subtype);
+    const parsed = parseCursorToolCall(msg.tool_call);
+    if (subtype === 'started') {
+        const display = toolDisplay(parsed.name, parsed.input);
+        const item = {
+            kind: 'tool',
+            id: callId,
+            name: parsed.name,
+            toolKind: display.toolKind,
+            title: display.title,
+            status: 'running',
+        };
+        if (parsed.input !== undefined)
+            item.input = parsed.input;
+        const edit = editArtifacts(parsed.name, parsed.input);
+        if (edit) {
+            if (edit.diffs)
+                item.diffs = edit.diffs;
+            item.locations = edit.locations;
+        }
+        const events = [{ type: 'item.started', item }];
+        if (parsed.name === 'UpdateTodos') {
+            const updated = nativeTodoUpdate(parsed.input, state.todos);
+            if (updated) {
+                events.push({ type: 'plan.updated', entries: [...updated.values()] });
+                const openTools = new Map(state.openTools);
+                openTools.set(callId, item);
+                return { events, state: { ...state, openTools, todos: updated } };
+            }
+        }
+        else if (parsed.name === 'TodoWrite') {
+            const entries = planEntries(parsed.input);
+            if (entries)
+                events.push({ type: 'plan.updated', entries });
+        }
+        const openTools = new Map(state.openTools);
+        openTools.set(callId, item);
+        return { events, state: { ...state, openTools } };
+    }
+    if (subtype === 'completed') {
+        const open = state.openTools.get(callId);
+        if (!open)
+            return { events: [], state };
+        const failed = toolFailed(parsed);
+        const item = {
+            ...open,
+            status: failed ? 'failed' : 'completed',
+        };
+        const output = toolOutput(parsed);
+        if (output !== undefined)
+            item.output = output;
+        if (failed) {
+            const err = toolErrorMessage(parsed);
+            if (err)
+                item.error = err;
+        }
+        // Prefer completed-side diffs (editToolCall.result.success.diffString).
+        const completedDiffs = completedEditDiffs(parsed);
+        if (completedDiffs) {
+            item.diffs = completedDiffs.diffs;
+            item.locations = completedDiffs.locations;
+        }
+        const openTools = new Map(state.openTools);
+        openTools.delete(callId);
+        return {
+            events: [{ type: 'item.completed', item }],
+            state: { ...state, openTools },
+        };
+    }
+    return { events: [], state };
+}
+function mapResult(msg, state) {
+    if (state.currentTurnId === null)
+        return { events: [], state };
+    const events = [];
+    let itemSeq = state.itemSeq;
+    let sawAssistantText = state.sawAssistantText;
+    // A tool that never got a `completed` tool_call event before the turn ended
+    // (the turn was interrupted or errored) would otherwise stay "running"
+    // forever in the UI — give it a terminal snapshot now.
+    for (const open of state.openTools.values()) {
+        events.push({ type: 'item.completed', item: { ...open, status: 'failed' } });
+    }
+    // If no assistant text streamed, surface the terminal result string once.
+    if (!sawAssistantText && typeof msg.result === 'string' && msg.result.trim() !== '' && msg.is_error !== true) {
+        sawAssistantText = true;
+        const item = {
+            kind: 'message',
+            id: `item_${++itemSeq}`,
+            role: 'assistant',
+            text: msg.result,
+        };
+        events.push({ type: 'item.started', item }, { type: 'item.completed', item });
+    }
+    const turnId = state.currentTurnId ?? `turn_${Math.max(1, state.turnSeq)}`;
+    const turnEvent = {
+        type: 'turn.completed',
+        turnId,
+        stopReason: resultStopReason(msg),
+    };
+    const usage = tokenUsage(msg);
+    if (usage)
+        turnEvent.usage = usage;
+    if (typeof msg.total_cost_usd === 'number')
+        turnEvent.costUsd = msg.total_cost_usd;
+    events.push(turnEvent);
+    if (usage) {
+        const usageEvent = { type: 'usage.updated', usage };
+        if (typeof msg.total_cost_usd === 'number')
+            usageEvent.costUsd = msg.total_cost_usd;
+        events.push(usageEvent);
+    }
+    return {
+        events,
+        state: {
+            ...state,
+            itemSeq,
+            sawAssistantText,
+            currentTurnId: null,
+            openTools: new Map(),
+        },
+    };
+}
+function resultStopReason(msg) {
+    if (msg.is_error === true)
+        return 'error';
+    if (msg.subtype === 'error_max_turns')
+        return 'max_tokens';
+    return 'end_turn';
+}
+function tokenUsage(msg) {
+    if (!isRecord(msg.usage))
+        return undefined;
+    const input = num(msg.usage.input_tokens) ?? 0;
+    const output = num(msg.usage.output_tokens) ?? 0;
+    const cacheRead = num(msg.usage.cache_read_input_tokens) ?? 0;
+    const cacheWrite = num(msg.usage.cache_creation_input_tokens) ?? 0;
+    const total = input + output + cacheRead + cacheWrite;
+    if (total <= 0)
+        return undefined;
+    const usage = { input, output, total };
+    if (cacheRead > 0)
+        usage.cacheRead = cacheRead;
+    if (cacheWrite > 0)
+        usage.cacheWrite = cacheWrite;
+    return usage;
+}
+function parseCursorToolCall(toolCall) {
+    if (!isRecord(toolCall))
+        return { name: 'tool', input: {} };
+    if (isRecord(toolCall.function)) {
+        const name = typeof toolCall.function.name === 'string' ? toolCall.function.name : 'function';
+        let input = toolCall.function.arguments ?? toolCall.function.args ?? {};
+        if (typeof input === 'string') {
+            try {
+                input = JSON.parse(input);
+            }
+            catch {
+                input = { raw: input };
+            }
+        }
+        return { name, input, result: toolCall.function.result, rawKey: 'function' };
+    }
+    for (const [key, value] of Object.entries(toolCall)) {
+        if (!key.endsWith('ToolCall') || !isRecord(value))
+            continue;
+        const name = cursorToolKeyToName(key);
+        return {
+            name,
+            input: value.args ?? {},
+            result: value.result,
+            rawKey: key,
+        };
+    }
+    return { name: 'tool', input: toolCall };
+}
+function cursorToolKeyToName(key) {
+    const base = key.replace(/ToolCall$/, '');
+    switch (base) {
+        case 'read':
+            return 'Read';
+        case 'write':
+            return 'Write';
+        case 'edit':
+            return 'Edit';
+        case 'shell':
+            return 'Bash';
+        case 'ls':
+            return 'Ls';
+        case 'grep':
+            return 'Grep';
+        case 'task':
+            return 'Task';
+        default:
+            return base.charAt(0).toUpperCase() + base.slice(1);
+    }
+}
+function editArtifacts(name, input) {
+    const key = name.toLowerCase();
+    if (key !== 'edit' && key !== 'write')
+        return undefined;
+    if (!isRecord(input))
+        return undefined;
+    const path = (typeof input.path === 'string' && input.path) ||
+        (typeof input.file_path === 'string' && input.file_path) ||
+        (typeof input.filePath === 'string' && input.filePath) ||
+        '';
+    if (!path)
+        return undefined;
+    const locations = [{ path }];
+    if (key === 'edit') {
+        const oldText = typeof input.old_string === 'string'
+            ? input.old_string
+            : typeof input.oldString === 'string'
+                ? input.oldString
+                : null;
+        const newText = typeof input.new_string === 'string'
+            ? input.new_string
+            : typeof input.newString === 'string'
+                ? input.newString
+                : typeof input.fileText === 'string'
+                    ? input.fileText
+                    : undefined;
+        if (oldText !== null || newText !== undefined) {
+            return { diffs: [defined({ path, oldText, newText })], locations };
+        }
+        return { locations };
+    }
+    const diff = { path, oldText: null };
+    if (typeof input.fileText === 'string')
+        diff.newText = input.fileText;
+    else if (typeof input.content === 'string')
+        diff.newText = input.content;
+    return { diffs: [diff], locations };
+}
+function completedEditDiffs(parsed) {
+    const key = parsed.name.toLowerCase();
+    if (key !== 'edit' && key !== 'write')
+        return undefined;
+    if (!isRecord(parsed.input))
+        return undefined;
+    const path = (typeof parsed.input.path === 'string' && parsed.input.path) ||
+        (typeof parsed.input.file_path === 'string' && parsed.input.file_path) ||
+        '';
+    if (!path || !isRecord(parsed.result) || !isRecord(parsed.result.success))
+        return undefined;
+    const success = parsed.result.success;
+    const oldText = key === 'edit'
+        ? typeof parsed.input.old_string === 'string'
+            ? parsed.input.old_string
+            : typeof parsed.input.oldString === 'string'
+                ? parsed.input.oldString
+                : null
+        : null;
+    const diff = { path, oldText };
+    if (typeof success.afterFullFileContent === 'string')
+        diff.newText = success.afterFullFileContent;
+    else if (typeof success.diffString === 'string')
+        diff.unified = success.diffString;
+    else if (typeof parsed.input.fileText === 'string')
+        diff.newText = parsed.input.fileText;
+    else
+        return undefined;
+    if (typeof success.diffString === 'string')
+        diff.unified = success.diffString;
+    return { diffs: [diff], locations: [{ path }] };
+}
+function toolFailed(parsed) {
+    if (!isRecord(parsed.result))
+        return false;
+    if (isRecord(parsed.result.rejected))
+        return true;
+    if (isRecord(parsed.result.error))
+        return true;
+    if (isRecord(parsed.result.success) && typeof parsed.result.success.exitCode === 'number') {
+        return parsed.result.success.exitCode !== 0;
+    }
+    return false;
+}
+function toolErrorMessage(parsed) {
+    if (!isRecord(parsed.result))
+        return undefined;
+    if (isRecord(parsed.result.rejected) && typeof parsed.result.rejected.reason === 'string') {
+        if (parsed.rawKey === 'askQuestionToolCall'
+            && /questions skipped/i.test(parsed.result.rejected.reason)) {
+            return 'Cursor skipped this native question in headless print mode';
+        }
+        return parsed.result.rejected.reason;
+    }
+    if (isRecord(parsed.result.error) && typeof parsed.result.error.errorMessage === 'string') {
+        return parsed.result.error.errorMessage;
+    }
+    if (isRecord(parsed.result.success)) {
+        const stderr = parsed.result.success.stderr;
+        if (typeof stderr === 'string' && stderr.trim())
+            return stderr.trim();
+    }
+    return undefined;
+}
+function toolOutput(parsed) {
+    if (!isRecord(parsed.result))
+        return undefined;
+    if (isRecord(parsed.result.success)) {
+        const s = parsed.result.success;
+        if (typeof s.stdout === 'string')
+            return s.stdout;
+        if (typeof s.content === 'string')
+            return s.content;
+        if (typeof s.resultForModel === 'string')
+            return s.resultForModel;
+    }
+    try {
+        return JSON.stringify(parsed.result);
+    }
+    catch {
+        return undefined;
+    }
+}
+const PLAN_STATUSES = ['pending', 'in_progress', 'completed', 'cancelled'];
+function nativeTodoUpdate(input, prior) {
+    if (!isRecord(input) || !Array.isArray(input.todos))
+        return undefined;
+    const todos = input.merge === true ? new Map(prior) : new Map();
+    for (const raw of input.todos) {
+        if (!isRecord(raw) || typeof raw.id !== 'string' || !raw.id ||
+            typeof raw.content !== 'string' || !PLAN_STATUSES.includes(raw.status))
+            return undefined;
+        const entry = { content: raw.content, status: raw.status };
+        if (typeof raw.priority === 'string' && ['high', 'medium', 'low'].includes(raw.priority)) {
+            entry.priority = raw.priority;
+        }
+        todos.set(raw.id, entry);
+    }
+    return todos;
+}
+function planEntries(input) {
+    if (!isRecord(input) || !Array.isArray(input.todos))
+        return undefined;
+    const entries = [];
+    for (const todo of input.todos) {
+        if (!isRecord(todo) || typeof todo.content !== 'string')
+            continue;
+        const status = PLAN_STATUSES.find((s) => s === todo.status) ?? 'pending';
+        const entry = { content: todo.content, status };
+        if (typeof todo.activeForm === 'string')
+            entry.activeForm = todo.activeForm;
+        entries.push(entry);
+    }
+    return entries;
+}
+// ---- shared helpers ---------------------------------------------------------
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function str(value) {
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function messageContent(msg) {
+    if (!isRecord(msg.message) || !Array.isArray(msg.message.content))
+        return [];
+    return msg.message.content;
+}
+// ---- v1 AgentEvent mapping (unchanged contract for runners / dry-run) -------
+function toolNameFromCall(toolCall) {
+    return parseCursorToolCall(toolCall).name;
+}
+function toolInputFromCall(toolCall) {
+    return parseCursorToolCall(toolCall).input;
+}
+function assistantText(message) {
+    if (!isRecord(message) || !Array.isArray(message.content))
+        return '';
+    const parts = [];
+    for (const block of message.content) {
+        if (isRecord(block) && block.type === 'text' && typeof block.text === 'string' && block.text) {
+            parts.push(block.text);
+        }
+    }
+    return parts.join('');
+}
+/**
+ * Convert one Cursor stream-json object into zero or more v1 AgentEvents.
+ * With default (non-partial) stream-json, every assistant event is used.
+ */
+export function mapCursorPrintStreamEvent(raw) {
+    if (!isRecord(raw))
+        return [];
+    const type = raw.type;
+    try {
+        if (type === 'system' && raw.subtype === 'init' && typeof raw.session_id === 'string') {
+            return [{ type: 'session', sessionId: raw.session_id }];
+        }
+        if (type === 'assistant') {
+            if ('model_call_id' in raw)
+                return [];
+            const text = assistantText(raw.message);
+            return text ? [{ type: 'text', text }] : [];
+        }
+        if (type === 'tool_call') {
+            const callId = typeof raw.call_id === 'string' ? raw.call_id : `cursor-${Date.now()}`;
+            if (raw.subtype === 'started') {
+                return [
+                    {
+                        type: 'tool-call',
+                        id: callId,
+                        tool: toolNameFromCall(raw.tool_call),
+                        input: toolInputFromCall(raw.tool_call),
+                    },
+                ];
+            }
+            if (raw.subtype === 'completed') {
+                const parsed = parseCursorToolCall(raw.tool_call);
+                return [
+                    {
+                        type: 'tool-result',
+                        toolCallId: callId,
+                        result: JSON.stringify(parsed.result ?? {}),
+                        isError: toolFailed(parsed),
+                    },
+                ];
+            }
+            return [];
+        }
+        if (type === 'result') {
+            // `session` and `done` are owned by the runner (init emits session once; the runner's
+            // own post-loop logic emits exactly one terminal `done`) — emitting them here too
+            // produced duplicate events in the append-only run log.
+            const events = [];
+            // Cursor's documented terminal `result` shape is
+            // {type, subtype, is_error, duration_ms, duration_api_ms, result, session_id, request_id}
+            // — no `usage`/`total_cost_usd` field today. Kept defensive per the docs' own "field
+            // additions may occur… backward-compatible" note; harmless no-op against real output.
+            const usage = tokenUsage(raw);
+            if (usage)
+                events.push({ type: 'token-usage', tokensUsed: usage.total });
+            if (typeof raw.total_cost_usd === 'number' && raw.total_cost_usd > 0) {
+                events.push({ type: 'cost', usd: raw.total_cost_usd });
+            }
+            if (raw.is_error === true) {
+                const msg = typeof raw.result === 'string' && raw.result
+                    ? raw.result
+                    : 'Cursor agent reported an error';
+                events.push({ type: 'error', message: msg });
+            }
+            events.push({ type: 'turn-end' });
+            return events;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=cursor-print-ui-mapper.js.map