@qodeca/xezar 0.10.1

package/dist/core/pi-ui-mapper.js

@@ -0,0 +1,270 @@
+import { toolDisplay } from './tool-display.js';
+export function createPiUiState() {
+    return {
+        sessionStarted: false,
+        sessionId: null,
+        turnSeq: 0,
+        turnId: null,
+        stopReason: 'end_turn',
+        turnUsage: null,
+        turnCostUsd: null,
+        startedItems: new Set(),
+        textByItem: new Map(),
+        tools: new Map(),
+    };
+}
+export function piTurnStarted(state) {
+    const turnSeq = state.turnSeq + 1;
+    const turnId = `turn_${turnSeq}`;
+    return {
+        events: [{ type: 'turn.started', turnId }],
+        state: { ...state, turnSeq, turnId, stopReason: 'end_turn' },
+    };
+}
+export function mapPiRpcMessage(value, state) {
+    if (!isRecord(value) || typeof value.type !== 'string')
+        return { events: [], state };
+    if (value.type === 'response') {
+        if (value.command === 'get_state' && value.success === true && isRecord(value.data)) {
+            const sessionId = string(value.data.sessionId);
+            if (sessionId && !state.sessionStarted) {
+                const model = isRecord(value.data.model) ? string(value.data.model.id) : undefined;
+                return {
+                    events: [{ type: 'session.started', sessionId, backend: 'pi', ...(model ? { model } : {}) }],
+                    state: { ...state, sessionStarted: true, sessionId },
+                };
+            }
+        }
+        if (value.success === false) {
+            return {
+                events: [{ type: 'session.error', message: rpcError(value), fatal: false }],
+                state,
+            };
+        }
+        return { events: [], state };
+    }
+    switch (value.type) {
+        case 'message_update':
+            return mapMessageUpdate(value, state);
+        case 'message_end':
+            return mapMessageEnd(value, state);
+        case 'tool_execution_start':
+            return mapToolStart(value, state);
+        case 'tool_execution_update':
+            return mapToolUpdate(value, state);
+        case 'tool_execution_end':
+            return mapToolEnd(value, state);
+        case 'agent_settled':
+            return completeTurn(state.stopReason, state);
+        case 'extension_error': {
+            const message = string(value.error) ?? string(value.message) ?? 'pi extension error';
+            return { events: [{ type: 'session.error', message, fatal: false }], state };
+        }
+        default:
+            return { events: [], state };
+    }
+}
+function mapMessageUpdate(value, state) {
+    const update = isRecord(value.assistantMessageEvent) ? value.assistantMessageEvent : undefined;
+    const updateType = update ? string(update.type) : undefined;
+    const contentIndex = update ? number(update.contentIndex) ?? 0 : 0;
+    if (!update || !updateType || !state.turnId)
+        return { events: [], state };
+    if (updateType === 'done') {
+        return {
+            events: [],
+            state: { ...state, stopReason: string(update.reason) === 'length' ? 'max_tokens' : 'end_turn' },
+        };
+    }
+    if (updateType === 'error') {
+        const reason = string(update.reason) === 'aborted' ? 'cancelled' : 'error';
+        const error = isRecord(update.error) ? string(update.error.errorMessage) : undefined;
+        return {
+            events: [{ type: 'session.error', message: error ?? `pi model ${reason}`, fatal: false }],
+            state: { ...state, stopReason: reason },
+        };
+    }
+    const field = updateType.startsWith('thinking_') ? 'reasoning' : updateType.startsWith('text_') ? 'text' : null;
+    if (!field)
+        return { events: [], state };
+    const itemId = `${state.turnId}_${field}_${contentIndex}`;
+    const events = [];
+    let startedItems = state.startedItems;
+    let textByItem = state.textByItem;
+    const makeItem = (text) => field === 'text'
+        ? { kind: 'message', id: itemId, role: 'assistant', text }
+        : { kind: 'reasoning', id: itemId, text };
+    if (!startedItems.has(itemId)) {
+        events.push({ type: 'item.started', item: makeItem('') });
+        startedItems = new Set(startedItems).add(itemId);
+    }
+    const delta = string(update.delta);
+    if (delta !== undefined) {
+        events.push({ type: 'item.delta', itemId, field, delta });
+        const next = new Map(textByItem);
+        next.set(itemId, `${next.get(itemId) ?? ''}${delta}`);
+        textByItem = next;
+    }
+    if (updateType.endsWith('_end')) {
+        const text = string(update.content) ?? textByItem.get(itemId) ?? '';
+        events.push({ type: 'item.completed', item: makeItem(text) });
+    }
+    return { events, state: { ...state, startedItems, textByItem } };
+}
+function mapToolStart(value, state) {
+    const id = string(value.toolCallId);
+    const name = string(value.toolName);
+    if (!id || !name)
+        return { events: [], state };
+    const display = toolDisplay(name, value.args);
+    const item = {
+        kind: 'tool',
+        id,
+        name,
+        toolKind: display.toolKind,
+        title: display.title,
+        status: 'running',
+        input: value.args,
+    };
+    const diffs = toolDiffs(name, value.args);
+    if (diffs)
+        item.diffs = diffs;
+    const tools = new Map(state.tools);
+    tools.set(id, item);
+    const events = [{ type: 'item.started', item }];
+    const plan = toolPlan(name, value.args);
+    if (plan)
+        events.push({ type: 'plan.updated', entries: plan });
+    return { events, state: { ...state, tools } };
+}
+function mapToolUpdate(value, state) {
+    const id = string(value.toolCallId);
+    const previous = id ? state.tools.get(id) : undefined;
+    if (!id || !previous)
+        return { events: [], state };
+    const output = contentText(isRecord(value.partialResult) ? value.partialResult.content : undefined);
+    if (output === undefined)
+        return { events: [], state };
+    const item = { ...previous, output };
+    const tools = new Map(state.tools);
+    tools.set(id, item);
+    return { events: [{ type: 'item.updated', item }], state: { ...state, tools } };
+}
+function mapToolEnd(value, state) {
+    const id = string(value.toolCallId);
+    const previous = id ? state.tools.get(id) : undefined;
+    if (!id || !previous)
+        return { events: [], state };
+    const result = isRecord(value.result) ? value.result : {};
+    const output = contentText(result.content);
+    const isError = value.isError === true;
+    const item = {
+        ...previous,
+        status: isError ? 'failed' : 'completed',
+        ...(isError ? { error: output ?? 'pi tool failed' } : output !== undefined ? { output } : {}),
+    };
+    const tools = new Map(state.tools);
+    tools.set(id, item);
+    return { events: [{ type: 'item.completed', item }], state: { ...state, tools } };
+}
+function completeTurn(reason, state) {
+    if (!state.turnId)
+        return { events: [], state };
+    const event = {
+        type: 'turn.completed',
+        turnId: state.turnId,
+        stopReason: reason,
+    };
+    if (state.turnUsage)
+        event.usage = state.turnUsage;
+    if (state.turnCostUsd !== null)
+        event.costUsd = state.turnCostUsd;
+    // Cleared with the turn id: the next turn's counts are its own, and a turn pi ends without
+    // reporting usage must not inherit the previous turn's numbers.
+    return { events: [event], state: { ...state, turnId: null, turnUsage: null, turnCostUsd: null } };
+}
+function mapMessageEnd(value, state) {
+    const message = isRecord(value.message) ? value.message : undefined;
+    const usage = message && message.role === 'assistant' ? usageEvent(message.usage) : undefined;
+    if (!usage)
+        return { events: [], state };
+    return {
+        events: [usage],
+        state: { ...state, turnUsage: usage.usage, turnCostUsd: usage.costUsd ?? null },
+    };
+}
+function usageEvent(value) {
+    if (!isRecord(value))
+        return undefined;
+    const input = number(value.input) ?? 0;
+    const output = number(value.output) ?? 0;
+    const cacheRead = number(value.cacheRead);
+    const cacheWrite = number(value.cacheWrite);
+    const total = number(value.totalTokens) ?? input + output + (cacheRead ?? 0) + (cacheWrite ?? 0);
+    if (total <= 0)
+        return undefined;
+    const cost = isRecord(value.cost) ? number(value.cost.total) : undefined;
+    return {
+        type: 'usage.updated',
+        usage: {
+            input,
+            output,
+            total,
+            ...(cacheRead !== undefined ? { cacheRead } : {}),
+            ...(cacheWrite !== undefined ? { cacheWrite } : {}),
+        },
+        ...(cost !== undefined ? { costUsd: cost } : {}),
+    };
+}
+function toolDiffs(name, input) {
+    if (!isRecord(input) || !['edit', 'write'].includes(name.toLowerCase()))
+        return undefined;
+    const path = string(input.path) ?? string(input.file_path) ?? string(input.filePath);
+    if (!path)
+        return undefined;
+    const oldText = string(input.oldText) ?? string(input.old_string) ?? (name.toLowerCase() === 'write' ? null : undefined);
+    const newText = string(input.newText) ?? string(input.new_string) ?? string(input.content);
+    if (oldText === undefined && newText === undefined)
+        return undefined;
+    return [{ path, oldText: oldText ?? null, ...(newText !== undefined ? { newText } : {}) }];
+}
+function toolPlan(name, input) {
+    if (!['todowrite', 'todo_write'].includes(name.toLowerCase()) || !isRecord(input) || !Array.isArray(input.todos)) {
+        return undefined;
+    }
+    const entries = [];
+    for (const todo of input.todos) {
+        if (!isRecord(todo))
+            continue;
+        const content = string(todo.content);
+        const status = string(todo.status);
+        if (!content || !['pending', 'in_progress', 'completed', 'cancelled'].includes(status ?? ''))
+            continue;
+        entries.push({ content, status: status });
+    }
+    return entries;
+}
+function rpcError(value) {
+    const error = isRecord(value.error) ? value.error : undefined;
+    return string(error?.message) ?? string(value.message) ?? `pi RPC command ${string(value.command) ?? 'unknown'} failed`;
+}
+function contentText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (!Array.isArray(value))
+        return undefined;
+    const parts = value
+        .map((part) => (isRecord(part) && part.type === 'text' ? string(part.text) : undefined))
+        .filter((part) => part !== undefined);
+    return parts.length > 0 ? parts.join('\n') : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function string(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function number(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+//# sourceMappingURL=pi-ui-mapper.js.map

package/dist/core/pi-ui-mapper.js.map

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

package/dist/core/process-usage.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Live process telemetry for the Runs table (#348): while any run has a
+ * registered backend process, ONE `ps` snapshot every ~2 s is aggregated per
+ * run over the process's full descendant tree (the CLI plus every Bash child
+ * an agent spawned) into `{ cpuPct, rssBytes, procCount }`.
+ *
+ * Design constraints, in order:
+ *  - never affect a run — a missing/failing `ps` (Windows, exotic containers)
+ *    degrades silently to "no data";
+ *  - one shared sampler, not one per run — N parallel runs still cost a
+ *    single `ps` every tick, and the timer is unref()ed and stopped the
+ *    moment the registry empties, so an idle cockpit spawns nothing;
+ *  - parsing + tree aggregation are pure functions, testable against canned
+ *    `ps` output (scripts/test-process-usage.mjs).
+ */
+/** One aggregated sample for a run's process tree. */
+export interface ProcessUsage {
+    /** Sum of `%cpu` across the tree — can exceed 100 on multi-core work. */
+    cpuPct: number;
+    /** Sum of resident set sizes, in bytes. */
+    rssBytes: number;
+    /** Number of live processes in the tree, the root included. */
+    procCount: number;
+}
+/** One parsed `ps` row (`pid ppid rss %cpu`; rss is in KB, ps's unit). */
+export interface ProcStat {
+    pid: number;
+    ppid: number;
+    rssKb: number;
+    cpuPct: number;
+}
+/**
+ * Parse `ps -axo pid=,ppid=,rss=,%cpu=` output (the `=` suffixes suppress
+ * headers on darwin and linux alike). Malformed lines are skipped — `ps`
+ * racing process exits can truncate rows.
+ */
+export declare function parsePsOutput(text: string): ProcStat[];
+/**
+ * Aggregate the full descendant tree rooted at `rootPid` from one `ps`
+ * snapshot. Null when the root is gone (process exited between register and
+ * sample) — callers treat that as "no data", not zero usage.
+ */
+export declare function aggregateTreeUsage(procs: ProcStat[], rootPid: number): ProcessUsage | null;
+export declare const SAMPLE_INTERVAL_MS = 2000;
+type UsageListener = (usage: Record<string, ProcessUsage>) => void;
+/** Start tracking a run's process tree. A re-register (a run's next agent
+ *  step) replaces the pid but keeps nothing else — peaks are per session and
+ *  the engine maxes them into the run record on unregister. */
+export declare function registerRunProcess(runId: string, pid: number): void;
+/** Stop tracking; returns the session's peaks (undefined when no sample ever
+ *  landed — `ps` unavailable, or the process died before the first tick). */
+export declare function unregisterRunProcess(runId: string): {
+    peakRssBytes: number;
+    peakProcCount: number;
+} | undefined;
+/** Latest sample for one run, if any. */
+export declare function currentUsage(runId: string): ProcessUsage | undefined;
+/** Latest samples for every registered run that has data. */
+export declare function allUsage(): Record<string, ProcessUsage>;
+/** Subscribe to fresh samples (fires ~every 2 s while runs are registered);
+ *  returns the unsubscribe. The SSE endpoint relays these to the GUI. */
+export declare function onUsage(listener: UsageListener): () => void;
+/** Test hook: fan one snapshot out to every subscriber without shelling `ps` —
+ *  lets unit tests prove a dispose()d subscriber stops receiving ticks. */
+export declare function emitUsageForTest(snapshot: Record<string, ProcessUsage>): void;
+export {};

package/dist/core/process-usage.js

@@ -0,0 +1,193 @@
+/**
+ * Live process telemetry for the Runs table (#348): while any run has a
+ * registered backend process, ONE `ps` snapshot every ~2 s is aggregated per
+ * run over the process's full descendant tree (the CLI plus every Bash child
+ * an agent spawned) into `{ cpuPct, rssBytes, procCount }`.
+ *
+ * Design constraints, in order:
+ *  - never affect a run — a missing/failing `ps` (Windows, exotic containers)
+ *    degrades silently to "no data";
+ *  - one shared sampler, not one per run — N parallel runs still cost a
+ *    single `ps` every tick, and the timer is unref()ed and stopped the
+ *    moment the registry empties, so an idle cockpit spawns nothing;
+ *  - parsing + tree aggregation are pure functions, testable against canned
+ *    `ps` output (scripts/test-process-usage.mjs).
+ */
+import { execFile } from 'node:child_process';
+/**
+ * Parse `ps -axo pid=,ppid=,rss=,%cpu=` output (the `=` suffixes suppress
+ * headers on darwin and linux alike). Malformed lines are skipped — `ps`
+ * racing process exits can truncate rows.
+ */
+export function parsePsOutput(text) {
+    const out = [];
+    for (const line of text.split('\n')) {
+        const parts = line.trim().split(/\s+/);
+        if (parts.length < 4)
+            continue;
+        const pid = Number(parts[0]);
+        const ppid = Number(parts[1]);
+        const rssKb = Number(parts[2]);
+        const cpuPct = Number(parts[3]);
+        if (!Number.isInteger(pid) || !Number.isInteger(ppid))
+            continue;
+        out.push({
+            pid,
+            ppid,
+            rssKb: Number.isFinite(rssKb) && rssKb > 0 ? rssKb : 0,
+            cpuPct: Number.isFinite(cpuPct) && cpuPct > 0 ? cpuPct : 0,
+        });
+    }
+    return out;
+}
+/**
+ * Aggregate the full descendant tree rooted at `rootPid` from one `ps`
+ * snapshot. Null when the root is gone (process exited between register and
+ * sample) — callers treat that as "no data", not zero usage.
+ */
+export function aggregateTreeUsage(procs, rootPid) {
+    const byPid = new Map();
+    const children = new Map();
+    for (const p of procs) {
+        byPid.set(p.pid, p);
+        const siblings = children.get(p.ppid);
+        if (siblings)
+            siblings.push(p.pid);
+        else
+            children.set(p.ppid, [p.pid]);
+    }
+    if (!byPid.has(rootPid))
+        return null;
+    let cpuPct = 0;
+    let rssKb = 0;
+    let procCount = 0;
+    const queue = [rootPid];
+    const seen = new Set(); // pid-reuse in a torn snapshot can't loop us
+    while (queue.length > 0) {
+        const pid = queue.pop();
+        if (seen.has(pid))
+            continue;
+        seen.add(pid);
+        const p = byPid.get(pid);
+        if (!p)
+            continue;
+        cpuPct += p.cpuPct;
+        rssKb += p.rssKb;
+        procCount += 1;
+        for (const child of children.get(pid) ?? [])
+            queue.push(child);
+    }
+    return { cpuPct: Math.round(cpuPct * 10) / 10, rssBytes: rssKb * 1024, procCount };
+}
+// ---- registry + sampler -----------------------------------------------------
+export const SAMPLE_INTERVAL_MS = 2_000;
+const entries = new Map();
+const listeners = new Set();
+let timer = null;
+let sampling = false;
+/** Start tracking a run's process tree. A re-register (a run's next agent
+ *  step) replaces the pid but keeps nothing else — peaks are per session and
+ *  the engine maxes them into the run record on unregister. */
+export function registerRunProcess(runId, pid) {
+    entries.set(runId, { pid, peakRssBytes: 0, peakProcCount: 0 });
+    if (!timer) {
+        timer = setInterval(() => void sample(), SAMPLE_INTERVAL_MS);
+        timer.unref?.();
+        void sample(); // first data point right away, not 2 s late
+    }
+}
+/** Stop tracking; returns the session's peaks (undefined when no sample ever
+ *  landed — `ps` unavailable, or the process died before the first tick). */
+export function unregisterRunProcess(runId) {
+    const entry = entries.get(runId);
+    entries.delete(runId);
+    if (entries.size === 0 && timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    if (!entry || entry.peakProcCount === 0)
+        return undefined;
+    return { peakRssBytes: entry.peakRssBytes, peakProcCount: entry.peakProcCount };
+}
+/** Latest sample for one run, if any. */
+export function currentUsage(runId) {
+    return entries.get(runId)?.last;
+}
+/** Latest samples for every registered run that has data. */
+export function allUsage() {
+    const out = {};
+    for (const [runId, entry] of entries) {
+        if (entry.last)
+            out[runId] = entry.last;
+    }
+    return out;
+}
+/** Subscribe to fresh samples (fires ~every 2 s while runs are registered);
+ *  returns the unsubscribe. The SSE endpoint relays these to the GUI. */
+export function onUsage(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+/** Test hook: fan one snapshot out to every subscriber without shelling `ps` —
+ *  lets unit tests prove a dispose()d subscriber stops receiving ticks. */
+export function emitUsageForTest(snapshot) {
+    for (const listener of listeners) {
+        try {
+            listener(snapshot);
+        }
+        catch {
+            // mirror sample(): one broken listener never kills the fan-out
+        }
+    }
+}
+async function sample() {
+    if (sampling || entries.size === 0)
+        return;
+    sampling = true;
+    try {
+        const text = await runPs();
+        if (text === null)
+            return; // ps unavailable — degrade to no data
+        const procs = parsePsOutput(text);
+        for (const entry of entries.values()) {
+            const usage = aggregateTreeUsage(procs, entry.pid);
+            entry.last = usage ?? undefined;
+            if (usage) {
+                entry.peakRssBytes = Math.max(entry.peakRssBytes, usage.rssBytes);
+                entry.peakProcCount = Math.max(entry.peakProcCount, usage.procCount);
+            }
+        }
+        if (listeners.size > 0) {
+            const snapshot = allUsage();
+            for (const listener of listeners) {
+                try {
+                    listener(snapshot);
+                }
+                catch {
+                    // a broken SSE stream must not kill the sampler
+                }
+            }
+        }
+    }
+    finally {
+        sampling = false;
+    }
+}
+/** One system-wide snapshot in the `pid ppid rssKb cpu` shape `parsePsOutput` expects; null on
+ *  any failure. Unix uses `ps`; Windows uses PowerShell's Win32_Process (WorkingSetSize → KB,
+ *  cpu reported as 0 — the memory guard only needs RSS). */
+function runPs() {
+    if (process.platform === 'win32') {
+        return new Promise((resolve) => {
+            execFile('powershell', [
+                '-NoProfile',
+                '-Command',
+                "Get-CimInstance Win32_Process | ForEach-Object { \"$($_.ProcessId) $($_.ParentProcessId) $([math]::Round($_.WorkingSetSize/1024)) 0\" }",
+            ], { maxBuffer: 16 * 1024 * 1024, windowsHide: true }, (err, stdout) => resolve(err ? null : stdout));
+        });
+    }
+    return new Promise((resolve) => {
+        execFile('ps', ['-axo', 'pid=,ppid=,rss=,%cpu='], { maxBuffer: 16 * 1024 * 1024 }, (err, stdout) => resolve(err ? null : stdout));
+    });
+}
+//# sourceMappingURL=process-usage.js.map

package/dist/core/process-usage.js.map

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