uxnan-bridge 0.0.1-alpha.20260621

package/dist/src/adapters/claude-tools.js

@@ -0,0 +1,146 @@
+/**
+ * Maps Claude Code `tool_use` / `tool_result` stream-json blocks onto the
+ * bridge's structured MessageContent JSON (`command_execution` / `diff` /
+ * `tool`) the phone renders in the Work log and Changed files sections.
+ *
+ * Tool inputs are taken from the (complete) `assistant` message's `tool_use`
+ * blocks; outputs from the matching `tool_result` block in the following `user`
+ * message (paired by `tool_use_id`). Verified against `claude` 2.x stream-json.
+ */
+import { extractPlanSteps, planBlock } from './content-blocks.js';
+/** Cap tool output carried on the wire so a big Read/Grep doesn't bloat it. */
+const MAX_OUTPUT = 4000;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function str(value) {
+    return typeof value === 'string' ? value : '';
+}
+function truncate(text) {
+    return text.length > MAX_OUTPUT ? `${text.slice(0, MAX_OUTPUT)}\n… (truncated)` : text;
+}
+/** The tool names whose edits become a `diff` block. */
+const EDIT_TOOLS = new Set(['Edit', 'MultiEdit', 'Write', 'NotebookEdit']);
+/** Extracts the `tool_use` blocks from an `assistant` message's content. */
+export function extractToolUses(content) {
+    if (!Array.isArray(content))
+        return [];
+    const uses = [];
+    for (const block of content) {
+        if (isRecord(block) &&
+            block['type'] === 'tool_use' &&
+            typeof block['id'] === 'string' &&
+            typeof block['name'] === 'string') {
+            uses.push({
+                id: block['id'],
+                name: block['name'],
+                input: isRecord(block['input']) ? block['input'] : {},
+            });
+        }
+    }
+    return uses;
+}
+/** Extracts the `tool_result` blocks from a `user` message's content. */
+export function extractToolResults(content) {
+    if (!Array.isArray(content))
+        return [];
+    const results = [];
+    for (const block of content) {
+        if (isRecord(block) &&
+            block['type'] === 'tool_result' &&
+            typeof block['tool_use_id'] === 'string') {
+            results.push({
+                toolUseId: block['tool_use_id'],
+                text: extractResultText(block['content']),
+                isError: block['is_error'] === true,
+            });
+        }
+    }
+    return results;
+}
+/** A tool_result's content is a string or an array of `{type:'text', text}`. */
+export function extractResultText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        let text = '';
+        for (const block of content) {
+            if (isRecord(block) && block['type'] === 'text' && typeof block['text'] === 'string') {
+                text += block['text'];
+            }
+        }
+        return text;
+    }
+    return '';
+}
+/** Lines as additions (`+`) for a whole-file Write. */
+function additions(text) {
+    return text.length > 0 ? text.split('\n') : [];
+}
+/** Builds a `diff` MessageContent from an edit/write tool's input. */
+function diffBlock(name, input) {
+    const filename = str(input['file_path']);
+    if (name === 'Write' || name === 'NotebookEdit') {
+        const lines = additions(str(input['content']) || str(input['new_source']));
+        return {
+            type: 'diff',
+            filename,
+            diff: lines.map((line) => `+${line}`).join('\n'),
+            additions: lines.length,
+            deletions: 0,
+        };
+    }
+    // Edit / MultiEdit: render old→new as -/+ hunks.
+    const edits = name === 'MultiEdit' && Array.isArray(input['edits']) ? input['edits'] : [input];
+    const parts = [];
+    let added = 0;
+    let removed = 0;
+    for (const edit of edits) {
+        if (!isRecord(edit))
+            continue;
+        const oldLines = additions(str(edit['old_string']));
+        const newLines = additions(str(edit['new_string']));
+        removed += oldLines.length;
+        added += newLines.length;
+        parts.push(...oldLines.map((line) => `-${line}`), ...newLines.map((line) => `+${line}`));
+    }
+    return { type: 'diff', filename, diff: parts.join('\n'), additions: added, deletions: removed };
+}
+/**
+ * Maps a paired tool_use + tool_result onto a MessageContent block:
+ * Bash → `command_execution`, edit/write tools → `diff`, everything else →
+ * a generic `tool` block. Returns the JSON the phone decodes via
+ * `MessageContent.fromJson`.
+ */
+export function toolUseToBlock(tool, result) {
+    if (tool.name === 'Bash') {
+        const output = truncate(result.text);
+        return {
+            type: 'command_execution',
+            command: str(tool.input['command']),
+            status: result.isError ? 'error' : 'completed',
+            ...(output ? { output } : {}),
+        };
+    }
+    if (EDIT_TOOLS.has(tool.name)) {
+        return diffBlock(tool.name, tool.input);
+    }
+    // Claude's TodoWrite tool carries the plan/to-do list: `{ todos: [{ content,
+    // status, activeForm }] }`. Surface it as a `plan` block (the phone renders a
+    // checklist); fall through to a generic tool block if it has no parseable steps.
+    if (tool.name === 'TodoWrite') {
+        const steps = extractPlanSteps(tool.input);
+        if (steps.length > 0)
+            return planBlock(steps);
+    }
+    const output = truncate(result.text);
+    return {
+        type: 'tool',
+        toolName: tool.name,
+        toolId: tool.id,
+        input: tool.input,
+        ...(output ? { output } : {}),
+        isError: result.isError,
+    };
+}
+//# sourceMappingURL=claude-tools.js.map

package/dist/src/adapters/claude-tools.js.map

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

package/dist/src/adapters/codex-adapter.d.ts

@@ -0,0 +1,116 @@
+import type { Readable, Writable } from 'node:stream';
+import type { AgentCapabilities, AgentConfig, AgentId, AgentModel, AgentModelOption, ApprovalDecision, SendTurnOptions } from '@uxnan/shared';
+import { BaseAgentAdapter } from './base-adapter.js';
+import { type CodexFileChange } from './codex-tools.js';
+/**
+ * Headless sandbox + approval posture for the Codex app-server (v2 protocol).
+ * Mirrors the bridge's other agent adapters:
+ *  - `default`           → reads only; commands/writes denied by the sandbox.
+ *  - `acceptEdits`       → workspace writes allowed; no prompts.
+ *  - `bypassPermissions` → danger full access; no prompts.
+ *  - `interactive`       → workspace writes allowed; the user is asked (this
+ *                          is the recommended default for production use).
+ */
+export type CodexPermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'interactive';
+export interface CodexAdapterOptions {
+    /** Resolved binary entry (see resolve-codex.ts). */
+    binaryPath?: string;
+    /** Args prepended before the adapter args (e.g. `[codex.js]` when running via node). */
+    prependArgs?: string[];
+    /** Default model when the thread/turn doesn't pick one. */
+    defaultModel?: string;
+    /** Sandbox + approval posture (default `interactive`; see {@link CodexPermissionMode}). */
+    permissionMode?: CodexPermissionMode;
+    /**
+     * Callback that surfaces a Codex app-server approval to the bridge so the
+     * phone can decide. Returns the user's `ApprovalDecision` (or
+     * `'reject'` after the 5-min timeout). Wired by the bridge during adapter
+     * registration. Optional in tests.
+     */
+    onApprovalRequest?: (threadId: string, info: {
+        toolName: string;
+        input: Record<string, unknown>;
+    }) => Promise<ApprovalDecision>;
+    /**
+     * Injected `app-server` spawner (tests). Should return the child's stdin
+     * (writable), stdout (readable) and an `onClose` callback the adapter
+     * registers with. The default spawns the configured `binaryPath` with
+     * `app-server` appended, with stdin/stdout piped.
+     */
+    spawnAppServer?: () => SpawnedAppServer;
+}
+/** Streams + lifecycle surface a `spawnAppServer` implementation returns. */
+export interface SpawnedAppServer {
+    stdin: Writable;
+    stdout: Readable;
+    onClose: (cb: (code: number | null) => void) => void;
+    kill: () => void;
+}
+/** A normalized Codex event extracted from one app-server notification line. */
+export interface CodexEvent {
+    kind: 'thread' | 'message' | 'thinking' | 'block' | 'file_change' | 'completed' | 'error' | 'other';
+    threadId?: string;
+    text?: string;
+    /** Only set for `completed`: context-occupying token count, if reported. */
+    tokens?: number;
+    /** Only set for `block`: the structured content block(s) for this item. */
+    blocks?: Record<string, unknown>[];
+    /** Only set for `file_change`: the changed paths the adapter reads to diff. */
+    changes?: CodexFileChange[];
+}
+/**
+ * Sum the context-occupying tokens from a Codex `turn.completed.usage` object
+ * (`{ input_tokens, cached_input_tokens, output_tokens, reasoning_output_tokens }`
+ * — `cached_input_tokens` is a subset of `input_tokens`, so it isn't added).
+ */
+export declare function codexUsageTokens(usage: unknown): number | undefined;
+export declare class CodexAdapter extends BaseAgentAdapter {
+    #private;
+    readonly agentId: AgentId;
+    readonly capabilities: AgentCapabilities;
+    /** Native Codex thread id for a thread (on-disk history-fallback locator). */
+    nativeSessionId(threadId: string): string | undefined;
+    constructor(options?: CodexAdapterOptions);
+    get defaultModel(): string | undefined;
+    start(config: AgentConfig): Promise<void>;
+    stop(): Promise<void>;
+    sendTurn(options: SendTurnOptions): Promise<void>;
+    cancelTurn(_threadId: string, turnId: string): Promise<void>;
+    /**
+     * List the models the account can use, account-aware (free vs paid changes
+     * the set). The app-server has no enumerate command in a turn session, so we
+     * drive a short-lived `codex app-server` process just to run the
+     * `initialize` → `model/list` JSON-RPC handshake (the desktop app's source).
+     * Falls back to `~/.codex/config.toml` (`model` + the
+     * `[tui.model_availability_nux]` table) if the app-server is unavailable.
+     *
+     * The short-lived process is independent of the long-lived one used for
+     * turns (so model listing always works even if a turn crashed the main
+     * process).
+     */
+    listModels(): Promise<AgentModel[]>;
+}
+/**
+ * Parse `~/.codex/models_cache.json` into a model-slug → context-window map.
+ * The file is `{ models: [{ slug, context_window, … }] }`; entries without a
+ * positive `context_window` are skipped.
+ */
+export declare function parseCodexModelWindows(raw: string): Map<string, number>;
+/**
+ * Map the app-server `model/list` → `result.data` array into {@link AgentModel}s,
+ * skipping models hidden from the default picker.
+ */
+export declare function parseCodexModelList(data: unknown): AgentModel[];
+/**
+ * Build the per-model reasoning knob from the app-server's
+ * `supportedReasoningEfforts` (`[{ reasoningEffort, description }]`) and
+ * `defaultReasoningEffort`. Returns `[]` when the model reports no efforts.
+ */
+export declare function parseCodexReasoning(raw: unknown, defaultEffort: unknown): AgentModelOption[];
+/**
+ * Fallback parse of `~/.codex/config.toml`: the top-level `model` plus the keys
+ * of the `[tui.model_availability_nux]` table (models the account has seen).
+ * The configured `model` is flagged `isDefault`. Minimal hand-rolled scan — no
+ * TOML dependency — tolerant of comments and quoting.
+ */
+export declare function parseCodexConfigModels(toml: string): AgentModel[];