@donna-orchestrator/bridge 0.2.21

package/dist/lifecycle.js

@@ -0,0 +1,228 @@
+/**
+ * Bridge lifecycle CLI subcommands (#295).
+ *
+ * `start`  — load the LaunchAgent if not already loaded (the agent itself
+ *            runs `donna-bridge start` to actually connect, so when invoked
+ *            directly we either delegate to launchctl or, for tests/dev,
+ *            connect inline via `runBridge`).
+ * `stop`   — `launchctl bootout gui/<uid>/<label>`.
+ * `status` — print LaunchAgent loaded-state + the last line of the log file.
+ * `logs --follow` — tail `~/Library/Logs/Donna/bridge.log`.
+ *
+ * The LaunchAgent's `ProgramArguments` is `[donna-bridge, start]`. When
+ * launchd spawns it, `runStartInline` runs and connects to the orchestrator.
+ * When the user types `donna-bridge start` interactively, we prefer to ask
+ * launchd to bootstrap (so the process survives a logout); the inline path
+ * is used by tests + the `--inline` debug flag.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import readline from 'node:readline';
+import { spawn } from 'node:child_process';
+import { loadConfig, getDefaults } from './config.js';
+import { isAgentLoaded, loadAgent, unloadAgent } from './launchd.js';
+import { runXcodeProbe, reportToCapabilityTools, readToolReport } from './xcode-probe.js';
+import { runBridge } from './index.js';
+import { createWorkspaceHandler } from './workspace.js';
+function defaultIO() {
+    return {
+        stdout: (m) => process.stdout.write(m),
+        stderr: (m) => process.stderr.write(m),
+    };
+}
+function requireConfig(io) {
+    const config = loadConfig();
+    if (!config) {
+        io.stderr(`No config found. Run \`donna-bridge install\` first.\n`);
+        return null;
+    }
+    return config;
+}
+/** `donna-bridge start` — bootstrap the agent (or run inline). */
+export async function runStart(opts = {}) {
+    const io = opts.io ?? defaultIO();
+    const config = requireConfig(io);
+    if (!config)
+        return 1;
+    if (!opts.inline) {
+        const defaults = getDefaults();
+        if (!fs.existsSync(defaults.plistPath)) {
+            io.stderr(`LaunchAgent plist missing at ${defaults.plistPath}.\n` +
+                `Re-run \`donna-bridge install\` to regenerate it.\n`);
+            return 1;
+        }
+        try {
+            await loadAgent(defaults.plistPath, os.userInfo().uid);
+            io.stdout(`✅ LaunchAgent loaded (gui/${os.userInfo().uid}/${defaults.label})\n`);
+            return 0;
+        }
+        catch (err) {
+            io.stderr(`Failed to bootstrap LaunchAgent: ${err.message}\n`);
+            return 1;
+        }
+    }
+    // Inline path — keep the process alive and run the bridge loop.
+    if (!config.xcodePath) {
+        io.stderr(`config.xcodePath is unset. Run \`donna-bridge xcode select <version>\`.\n`);
+        return 1;
+    }
+    const defaults = getDefaults();
+    const simulatorDeviceSetPath = config.simulatorDeviceSetPath ?? defaults.deviceSetPath;
+    // Refresh the tool report so the hello payload's capabilities.tools is fresh.
+    let report = readToolReport();
+    try {
+        report = await runXcodeProbe({ developerDir: config.xcodePath });
+    }
+    catch {
+        // Probe failures don't block startup — we fall back to the persisted report.
+    }
+    const tools = report ? reportToCapabilityTools(report) : {};
+    const workspace = createWorkspaceHandler({ projectsDir: defaults.projectsDir });
+    const handle = runBridge({
+        config: {
+            orchestratorUrl: config.orchestratorUrl,
+            token: config.token,
+            runnerId: config.runnerId,
+            xcodePath: config.xcodePath,
+            simulatorDeviceSetPath,
+            tools,
+        },
+        workspace,
+    });
+    // Keep the process alive until SIGTERM / SIGINT.
+    await new Promise((resolve) => {
+        const stop = () => {
+            handle.close();
+            resolve();
+        };
+        process.once('SIGTERM', stop);
+        process.once('SIGINT', stop);
+    });
+    return 0;
+}
+export async function runStop(io = defaultIO()) {
+    const defaults = getDefaults();
+    if (!fs.existsSync(defaults.plistPath)) {
+        io.stdout(`LaunchAgent plist not present at ${defaults.plistPath}; nothing to stop.\n`);
+        return 0;
+    }
+    try {
+        await unloadAgent(defaults.plistPath, os.userInfo().uid);
+        io.stdout(`✅ LaunchAgent stopped (gui/${os.userInfo().uid}/${defaults.label})\n`);
+        return 0;
+    }
+    catch (err) {
+        io.stderr(`Failed to bootout LaunchAgent: ${err.message}\n`);
+        return 1;
+    }
+}
+/**
+ * Build the status report without printing it — useful for tests and for
+ * `--json` callers (out of scope for this ticket but cheap to keep).
+ */
+export async function buildStatus() {
+    const config = loadConfig();
+    const defaults = getDefaults();
+    const plistPresent = fs.existsSync(defaults.plistPath);
+    let agentLoaded = false;
+    try {
+        agentLoaded = await isAgentLoaded(defaults.label, os.userInfo().uid);
+    }
+    catch {
+        agentLoaded = false;
+    }
+    const logExists = fs.existsSync(defaults.logPath);
+    let lastLogLine;
+    if (logExists) {
+        lastLogLine = readLastLine(defaults.logPath);
+    }
+    return {
+        configPath: path.join(defaults.deviceSetPath, '..'),
+        configPresent: !!config,
+        orchestratorUrl: config?.orchestratorUrl,
+        runnerId: config?.runnerId,
+        xcodePath: config?.xcodePath,
+        plistPath: defaults.plistPath,
+        plistPresent,
+        agentLoaded,
+        logPath: defaults.logPath,
+        logExists,
+        lastLogLine,
+    };
+}
+export async function runStatusCmd(io = defaultIO()) {
+    const status = await buildStatus();
+    io.stdout(`donna-bridge status\n`);
+    io.stdout(`  config:        ${status.configPresent ? 'present' : 'missing'}\n`);
+    if (status.configPresent) {
+        io.stdout(`  orchestrator:  ${status.orchestratorUrl ?? '(unset)'}\n`);
+        io.stdout(`  runner_id:     ${status.runnerId ?? '(unset)'}\n`);
+        io.stdout(`  xcode_path:    ${status.xcodePath ?? '(unset)'}\n`);
+    }
+    io.stdout(`  plist:         ${status.plistPresent ? status.plistPath : 'missing'}\n`);
+    io.stdout(`  agent_loaded:  ${status.agentLoaded ? 'yes' : 'no'}\n`);
+    io.stdout(`  log:           ${status.logPath}\n`);
+    if (status.logExists && status.lastLogLine) {
+        io.stdout(`  last_log:      ${status.lastLogLine}\n`);
+    }
+    return 0;
+}
+export async function runLogs(opts = {}) {
+    const io = opts.io ?? defaultIO();
+    const defaults = getDefaults();
+    if (!fs.existsSync(defaults.logPath)) {
+        io.stderr(`Log file ${defaults.logPath} does not exist yet.\n`);
+        return 1;
+    }
+    if (!opts.follow) {
+        // Print the existing log content once and exit.
+        const data = fs.readFileSync(defaults.logPath, 'utf-8');
+        io.stdout(data);
+        return 0;
+    }
+    return new Promise((resolve) => {
+        // `tail -F` (capital F) tracks the file across rotation — what users
+        // expect from `--follow`. Inherit stdio so the user sees output live.
+        const proc = spawn('tail', ['-F', defaults.logPath], { stdio: 'inherit' });
+        proc.on('error', (err) => {
+            io.stderr(`tail failed: ${err.message}\n`);
+            resolve(1);
+        });
+        proc.on('close', (code) => resolve(code ?? 0));
+        // Forward SIGINT to the tail process so Ctrl-C cleanly terminates it.
+        const onSigint = () => proc.kill('SIGINT');
+        process.once('SIGINT', onSigint);
+    });
+}
+/**
+ * Read the last non-empty line of a (potentially large) text file without
+ * loading the whole thing. Reads the last 4 KB; good enough for log files.
+ */
+function readLastLine(filePath) {
+    try {
+        const fd = fs.openSync(filePath, 'r');
+        try {
+            const stats = fs.fstatSync(fd);
+            const size = stats.size;
+            const readLen = Math.min(4096, size);
+            const buf = Buffer.alloc(readLen);
+            fs.readSync(fd, buf, 0, readLen, size - readLen);
+            const lines = buf.toString('utf-8').split('\n').map((l) => l.trim()).filter(Boolean);
+            const last = lines.pop();
+            if (!last)
+                return undefined;
+            return last.length > 200 ? `${last.slice(0, 200)}…` : last;
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+// Avoid unused-import warning when readline isn't reachable through the path
+// above; readline is retained for future interactive prompts in this module.
+void readline;
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/pair.js

@@ -0,0 +1,88 @@
+/**
+ * Bridge pairing (#295).
+ *
+ * Two paths:
+ *   1. Standard remote pairing — POST the 6-digit code to
+ *      `/api/v1/runners/pair/complete` and receive a long-lived token (per
+ *      #272). This is the same endpoint the native runner uses.
+ *   2. Local pairing (`--local-pair`) — POST to `/api/v1/runners/local-pair`
+ *      with the runner id and a flag describing the host. The endpoint
+ *      itself is implemented in #296 (gated to loopback). We just know the
+ *      URL here.
+ *
+ * Both paths return `{ token, runner_id }`. The CLI persists the response
+ * to `~/.donna-bridge/config.json` via `bridge/config.ts`.
+ */
+/**
+ * Convert a WS URL to its corresponding HTTP base URL. `wss://host/path` →
+ * `https://host`. We strip the path entirely because all pairing endpoints
+ * live under `/api/v1/runners/...` (mirrors `runner/mcp-donna-derive.ts`).
+ */
+export function deriveHttpBase(wsUrl) {
+    let url;
+    try {
+        url = new URL(wsUrl);
+    }
+    catch {
+        throw new Error(`invalid orchestrator URL: ${wsUrl}`);
+    }
+    const proto = url.protocol === 'wss:' ? 'https:' : url.protocol === 'ws:' ? 'http:' : url.protocol;
+    return `${proto}//${url.host}`;
+}
+/**
+ * Exchange a 6-digit pairing code for a long-lived token. Mirrors the
+ * `runner/native/cli.ts#runPair` flow but written here so the bridge stays
+ * self-contained (`bridge/` has no `runner/` imports).
+ */
+export async function pairWithCode(opts) {
+    if (!/^\d{6}$/.test(opts.pairingCode)) {
+        throw new Error(`pair: --pairing-code must be a 6-digit numeric string`);
+    }
+    const base = deriveHttpBase(opts.orchestratorUrl);
+    const url = `${base}/api/v1/runners/pair/complete`;
+    const fetchFn = opts.fetchImpl ?? fetch;
+    const res = await fetchFn(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ pairing_code: opts.pairingCode, runner_id: opts.runnerId }),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`pair: orchestrator rejected pairing (HTTP ${res.status}): ${text}`);
+    }
+    const body = (await res.json());
+    if (!body.token || !body.runner_id) {
+        throw new Error(`pair: unexpected response shape: ${JSON.stringify(body)}`);
+    }
+    return { token: body.token, runner_id: body.runner_id };
+}
+/**
+ * Local-pair flow — hits `POST /api/v1/runners/local-pair`. The endpoint is
+ * gated to loopback by #296. Here we just send the request; if the
+ * orchestrator URL is not a loopback address (127.0.0.1 / localhost), the
+ * server-side gate refuses with HTTP 403 and we surface that to the user.
+ *
+ * Body shape: `{ runner_id }`. Response: same `{ token, runner_id }` as the
+ * remote flow. Endpoint behaviour is finalized in #296; the CLI flag is
+ * implemented here per the ticket scope.
+ */
+export async function pairLocally(opts) {
+    const base = deriveHttpBase(opts.orchestratorUrl);
+    const url = `${base}/api/v1/runners/local-pair`;
+    const fetchFn = opts.fetchImpl ?? fetch;
+    const res = await fetchFn(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ runner_id: opts.runnerId }),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`pair: local-pair rejected (HTTP ${res.status}): ${text}`);
+    }
+    const body = (await res.json());
+    if (!body.token || !body.runner_id) {
+        throw new Error(`pair: unexpected local-pair response shape: ${JSON.stringify(body)}`);
+    }
+    return { token: body.token, runner_id: body.runner_id };
+}
+//# sourceMappingURL=pair.js.map

package/dist/pair.js.map

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

package/dist/preflight.js

@@ -0,0 +1,117 @@
+/**
+ * Bridge install pre-flight gate (#295).
+ *
+ * Checks that the four required tools (claude CLI, xcodebuild, git, node ≥ 22)
+ * are present on the host before pairing. Each missing tool surfaces an exact
+ * install hint — no AI judgment, just the canned guide from the spec.
+ *
+ * Pure-ish: shells out to each binary but never throws on missing tools. The
+ * caller (`bridge/install.ts`) inspects the result and bails when any required
+ * check fails.
+ */
+import { execFile } from 'node:child_process';
+const PROBE_TIMEOUT_MS = 5_000;
+const MIN_NODE_MAJOR = 22;
+function execFileP(bin, args) {
+    return new Promise((resolve, reject) => {
+        execFile(bin, args, { timeout: PROBE_TIMEOUT_MS, encoding: 'utf-8' }, (err, stdout, stderr) => {
+            if (err) {
+                reject(err);
+                return;
+            }
+            resolve({ stdout: stdout ?? '', stderr: stderr ?? '' });
+        });
+    });
+}
+function extractVersion(raw) {
+    const firstLine = raw.split('\n')[0]?.trim() ?? '';
+    const m = firstLine.match(/(\d+\.\d+(?:\.\d+)?(?:[-+][\w.]+)?)/);
+    return m ? m[1] : firstLine || undefined;
+}
+const INSTALL_HINTS = {
+    claude: 'Install Claude CLI: npm install -g @anthropic-ai/claude-code',
+    xcodebuild: 'Install Xcode from the Mac App Store (xcodebuild ships with the full Xcode app)',
+    git: 'Install git: xcode-select --install',
+    node: `Install Node.js ≥ ${MIN_NODE_MAJOR}: brew install node`,
+};
+async function probeTool(name) {
+    const hint = INSTALL_HINTS[name];
+    try {
+        let outcome;
+        let version;
+        switch (name) {
+            case 'claude':
+                outcome = await execFileP('claude', ['--version']);
+                version = extractVersion(outcome.stdout || outcome.stderr);
+                break;
+            case 'xcodebuild':
+                outcome = await execFileP('xcodebuild', ['-version']);
+                // "Xcode 16.2\nBuild version ..." — grab the numeric token after Xcode.
+                {
+                    const m = outcome.stdout.match(/Xcode\s+(\d+(?:\.\d+)+)/i);
+                    version = m ? m[1] : extractVersion(outcome.stdout);
+                }
+                break;
+            case 'git':
+                outcome = await execFileP('git', ['--version']);
+                version = extractVersion(outcome.stdout);
+                break;
+            case 'node': {
+                // `process.execPath --version` keeps the probe deterministic
+                // regardless of which node is first on PATH.
+                outcome = await execFileP(process.execPath, ['--version']);
+                version = extractVersion(outcome.stdout);
+                // Enforce ≥ 22.
+                if (version) {
+                    const major = parseInt(version.split('.')[0] ?? '0', 10);
+                    if (Number.isFinite(major) && major < MIN_NODE_MAJOR) {
+                        return {
+                            name,
+                            ok: false,
+                            version,
+                            installHint: hint,
+                            error: `node ${version} is too old; need ≥ ${MIN_NODE_MAJOR}`,
+                        };
+                    }
+                }
+                break;
+            }
+        }
+        return { name, ok: true, version, installHint: hint };
+    }
+    catch (err) {
+        return {
+            name,
+            ok: false,
+            installHint: hint,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export async function runPreflight() {
+    const checks = await Promise.all([
+        probeTool('claude'),
+        probeTool('xcodebuild'),
+        probeTool('git'),
+        probeTool('node'),
+    ]);
+    return { ok: checks.every((c) => c.ok), checks };
+}
+/**
+ * Render the pre-flight outcome as plain text. The installer prints this on
+ * failure so the user gets every missing tool's hint in a single block.
+ */
+export function formatPreflightTable(result) {
+    const lines = [];
+    for (const c of result.checks) {
+        if (c.ok) {
+            lines.push(`  [ok]   ${c.name.padEnd(11)} ${c.version ?? ''}`);
+        }
+        else {
+            lines.push(`  [fail] ${c.name.padEnd(11)} ${c.error ?? 'missing'}`);
+            lines.push(`           → ${c.installHint}`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=preflight.js.map

package/dist/preflight.js.map

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

package/dist/scope-guard.js

@@ -0,0 +1,25 @@
+/** Tool tokens that mark a stage as Apple-platform. Lower-cased for comparison. */
+const APPLE_TOOL_TOKENS = new Set(['xcode', 'xcodebuild', 'swift', 'simctl']);
+/**
+ * Decide whether the given `runner:execute` payload represents an Apple-
+ * platform stage that this bridge is allowed to run.
+ *
+ * Pure function — no side effects, no env reads. The caller is responsible
+ * for emitting `runner:scope_violation` when this returns false.
+ */
+export function isAppleStage(payload) {
+    if (!payload)
+        return false;
+    if (payload.applePlatform === true)
+        return true;
+    if (Array.isArray(payload.requiredTools)) {
+        for (const tool of payload.requiredTools) {
+            if (typeof tool !== 'string')
+                continue;
+            if (APPLE_TOOL_TOKENS.has(tool.toLowerCase()))
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=scope-guard.js.map

package/dist/scope-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-guard.js","sourceRoot":"","sources":["../scope-guard.ts"],"names":[],"mappings":"AAkBA,mFAAmF;AACnF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgD;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,OAAO,CAAC,aAAa,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACvC,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/stream-parser.js

@@ -0,0 +1,116 @@
+/**
+ * Apple Platform Bridge — stream-json parser (#294).
+ *
+ * Duplicated narrowly from `runner/stream-parser.ts` to keep the bridge a
+ * standalone library with no cross-tree imports — `runner/` is built by a
+ * separate tsconfig (`tsconfig.runner.json`) with its own `rootDir`, and the
+ * runner Docker build context doesn't ship anything outside `runner/`. The
+ * #294 ticket explicitly allows duplicating "the narrow piece" when extraction
+ * would force a wider refactor.
+ *
+ * Keep this file in lockstep with `runner/stream-parser.ts` — the two parse
+ * the same Claude CLI stream-json schema. If the schema changes, update both.
+ */
+// Claude model pricing (per million tokens) — same table as the runner.
+const MODEL_PRICING = {
+    'claude-opus-4-6': { input: 5, output: 25 },
+    'claude-sonnet-4-6': { input: 3, output: 15 },
+    'claude-haiku-4-5-20251001': { input: 1, output: 5 },
+    default: { input: 3, output: 15 },
+};
+function calculateCost(model, inputTokens, outputTokens) {
+    const pricing = MODEL_PRICING[model];
+    if (!pricing) {
+        console.warn(`[bridge-stream] Unknown model "${model}" — using default pricing for cost estimate`);
+    }
+    return ((inputTokens * (pricing || MODEL_PRICING.default).input +
+        outputTokens * (pricing || MODEL_PRICING.default).output) /
+        1_000_000);
+}
+// 50MB output buffer cap — truncate from front if exceeded to avoid OOM.
+export const MAX_BUFFER_SIZE = 50 * 1024 * 1024;
+export function processStreamLine(line, state) {
+    if (!line.trim())
+        return;
+    try {
+        const parsed = JSON.parse(line);
+        const events = Array.isArray(parsed) ? parsed : [parsed];
+        for (const event of events) {
+            if (event.type === 'assistant' && event.message?.content) {
+                for (const block of event.message.content) {
+                    if (block.type === 'text') {
+                        state.onOutput(block.text, 'text');
+                    }
+                    else if (block.type === 'tool_use') {
+                        const desc = summarizeToolUse(block.name, block.input);
+                        state.onOutput(`\n[tool: ${block.name}] ${desc}\n`, 'tool');
+                    }
+                }
+            }
+            else if (event.type === 'content_block_delta' && event.delta?.text) {
+                state.onOutput(event.delta.text, 'text');
+            }
+            else if (event.type === 'result') {
+                const output = event.structured_output || event.result;
+                if (output) {
+                    const resultStr = typeof output === 'string' ? output : JSON.stringify(output);
+                    state.onOutput(resultStr, 'result');
+                }
+                else if (state.jsonSchema && event.subtype === 'error_max_turns') {
+                    console.error(`⚠️ [bridge-stream] --json-schema used but model hit max_turns (${event.num_turns}) without producing structured_output`);
+                    state.onOutput('[error] Model exhausted max turns before producing structured JSON output. Increase maxTurns.\n', 'text');
+                }
+                if (event.usage && state.onUsage) {
+                    const model = event.model || state.model || 'unknown';
+                    const inputTokens = event.usage.input_tokens || 0;
+                    const outputTokens = event.usage.output_tokens || 0;
+                    const costUsd = event.cost_usd ?? calculateCost(model, inputTokens, outputTokens);
+                    state.onUsage({ inputTokens, outputTokens, model, costUsd });
+                }
+            }
+            else if (event.type === 'system') {
+                state.detectedModel = event.model || state.model || 'unknown';
+                state.onOutput(`[claude] session started (model: ${state.detectedModel})\n`, 'text');
+            }
+        }
+    }
+    catch {
+        state.onOutput(line, 'text');
+    }
+}
+function summarizeToolUse(name, input) {
+    if (!input)
+        return name;
+    if (input.description)
+        return String(input.description);
+    if (input.command) {
+        const cmd = String(input.command);
+        return cmd.length > 120 ? cmd.slice(0, 120) + '…' : cmd;
+    }
+    const filePath = input.file_path || input.path;
+    if (filePath) {
+        const p = String(filePath);
+        const short = p.includes('/') ? p.split('/').slice(-2).join('/') : p;
+        if (name === 'Read')
+            return `Reading ${short}`;
+        if (name === 'Write')
+            return `Writing ${short}`;
+        if (name === 'Edit')
+            return `Editing ${short}`;
+        return `${name} ${short}`;
+    }
+    if (input.pattern) {
+        const pat = String(input.pattern);
+        if (name === 'Glob')
+            return `Finding files matching ${pat}`;
+        if (name === 'Grep')
+            return `Searching for "${pat}"`;
+        return `${name} "${pat}"`;
+    }
+    if (input.prompt) {
+        const prompt = String(input.prompt);
+        return prompt.length > 100 ? prompt.slice(0, 100) + '…' : prompt;
+    }
+    return name;
+}
+//# sourceMappingURL=stream-parser.js.map

package/dist/stream-parser.js.map

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

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * Apple Platform Bridge — types (#294).
+ *
+ * The bridge is a single-purpose runner-side library that connects a developer
+ * Mac to the orchestrator via WebSocket and executes Apple-platform stages
+ * only (Xcode / Swift). Non-Apple dispatches are refused via
+ * `runner:scope_violation`.
+ *
+ * These types are duplicated narrowly from `src/types.ts` (the wire protocol)
+ * rather than imported, because the bridge ships as a standalone library with
+ * its own dependency surface — it must not depend on the orchestrator
+ * compilation root. The shapes are pinned by the cross-tree tests in
+ * `tests/unit/bridge-*.test.ts`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}