@braidhq/server 0.0.1

package/dist/infrastructure/agent/SubprocessSkillRunner.js

@@ -0,0 +1,240 @@
+import { mkdir, rm, symlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { newSkillRunId, NotFoundError } from '@braidhq/core';
+import { AbsolutePath as AbsolutePathSchema, SkillEvent as SkillEventSchema, SkillRunId as SkillRunIdSchema, } from '@braidhq/schema';
+import { sessionDirPath } from '../fs/paths.js';
+import { createAsyncQueue } from './asyncQueue.js';
+import { writeMcpConfigFile } from './mcpConfig.js';
+import { attachOutputBuffers } from './subprocessEventStream.js';
+export class SubprocessSkillRunner {
+    deps;
+    running = new Map();
+    /** sessionId → cwd for resuming. claude needs the same cwd between turns. */
+    sessionDirs = new Map();
+    subscribers = new Map();
+    /** How many events have been emitted (and persisted) per run so far. */
+    positions = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async start(workspace, skillId, args, options) {
+        const manifest = await this.deps.skillRegistry.get(workspace, skillId);
+        const runId = newSkillRunId();
+        const sessionDir = await this.resolveSessionDir(workspace, runId, options?.resumeSessionId);
+        const mcpConfigFile = await writeMcpConfigFile(workspace, sessionDir);
+        const invocation = this.deps.agentBinding.resolveSpawn({
+            skillId,
+            args,
+            workspace,
+            manifest,
+            apiUrl: this.deps.apiUrl,
+            mcpConfigFile: AbsolutePathSchema.parse(mcpConfigFile),
+            ...(options?.resumeSessionId ? { resumeSessionId: options.resumeSessionId } : {}),
+        });
+        const spawnFn = this.deps.spawn ?? (await defaultSpawn());
+        // BRAID_SESSION_DIR resolves ambiguity in SKILL.md paths: claude sees
+        // both `BRAID_WORKSPACE` and a cwd that lives inside it, and would
+        // otherwise guess wrong about which one `.claude/skills/...` is rooted in.
+        const child = spawnFn(invocation.bin, [...invocation.args], {
+            cwd: sessionDir,
+            env: { ...invocation.env, BRAID_SESSION_DIR: sessionDir },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        this.running.set(runId, { workspace, child });
+        // Persist the started record up front so listing endpoints see the run
+        // immediately, even before any subprocess output.
+        const startedAt = this.now();
+        const initialRecord = {
+            runId,
+            workspaceId: workspace.id,
+            skillId,
+            args,
+            resumed: options?.resumeSessionId !== undefined,
+            startedAt,
+            ...(options?.resumeSessionId ? { sessionId: options.resumeSessionId } : {}),
+        };
+        await this.deps.runRepository.saveRecord(workspace, initialRecord);
+        this.deps.eventBus?.publish({
+            type: 'run.started',
+            workspaceId: workspace.id,
+            runId,
+            skillId,
+            at: startedAt,
+        });
+        // Fire-and-forget the drain so the HTTP request that called start()
+        // can return immediately.
+        void this.drain({
+            workspace,
+            runId,
+            child,
+            skillId,
+            args,
+            sessionDir,
+            resumeSessionId: options?.resumeSessionId,
+            startedAt,
+            initialRecord,
+        });
+        return runId;
+    }
+    subscribe(runId, listener) {
+        const set = this.subscribers.get(runId) ?? new Set();
+        set.add(listener);
+        this.subscribers.set(runId, set);
+        return {
+            unsubscribe: () => {
+                set.delete(listener);
+                if (set.size === 0)
+                    this.subscribers.delete(runId);
+            },
+            positionAtSubscribe: this.positions.get(runId) ?? 0,
+        };
+    }
+    isActive(runId) {
+        return this.running.has(runId);
+    }
+    async cancel(runId) {
+        const validated = SkillRunIdSchema.parse(runId);
+        const active = this.running.get(validated);
+        if (!active)
+            throw new NotFoundError(`SkillRun "${validated}" not active`);
+        active.child.kill('SIGTERM');
+    }
+    async forgetSession(sessionId) {
+        const dir = this.sessionDirs.get(sessionId);
+        if (!dir)
+            return;
+        this.sessionDirs.delete(sessionId);
+        if (this.deps.cleanupSession !== false)
+            await rm(dir, { recursive: true, force: true });
+    }
+    async drain(input) {
+        let record = input.initialRecord;
+        let capturedSessionId = input.resumeSessionId ?? null;
+        let sawError = false;
+        let exitCode = 0;
+        try {
+            await this.emit(input.workspace, input.runId, SkillEventSchema.parse({
+                type: 'started',
+                runId: input.runId,
+                skillId: input.skillId,
+                args: input.args,
+                resumed: input.resumeSessionId !== undefined,
+                at: input.startedAt,
+            }));
+            const queue = createAsyncQueue();
+            const buffers = attachOutputBuffers(input.child, queue.push, () => this.now());
+            input.child.on('close', (code) => {
+                buffers.flush();
+                queue.push(SkillEventSchema.parse({
+                    type: 'completed',
+                    runId: input.runId,
+                    exitCode: code ?? 0,
+                    at: this.now(),
+                }));
+                queue.end();
+            });
+            for await (const event of queue.iterate()) {
+                if (event.type === 'session-started') {
+                    capturedSessionId = event.sessionId;
+                    this.sessionDirs.set(event.sessionId, input.sessionDir);
+                    record = { ...record, sessionId: event.sessionId };
+                    await this.deps.runRepository.saveRecord(input.workspace, record);
+                }
+                if (event.type === 'completed') {
+                    record = { ...record, completedAt: event.at, exitCode: event.exitCode };
+                    exitCode = event.exitCode;
+                    await this.deps.runRepository.saveRecord(input.workspace, record);
+                }
+                if (event.type === 'error')
+                    sawError = true;
+                await this.emit(input.workspace, input.runId, event);
+            }
+        }
+        finally {
+            this.running.delete(input.runId);
+            this.deps.eventBus?.publish({
+                type: 'run.completed',
+                workspaceId: input.workspace.id,
+                runId: input.runId,
+                skillId: input.skillId,
+                outcome: sawError ? 'error' : exitCode === 0 ? 'success' : 'error',
+                at: this.now(),
+            });
+            this.subscribers.delete(input.runId);
+            // Keep the session dir on disk if a session id was captured: claude
+            // stores conversation state per-cwd, so the dir must survive between
+            // turns. GC happens via forgetSession(sessionId).
+            const keepForResume = capturedSessionId !== null;
+            if (this.deps.cleanupSession !== false && !keepForResume)
+                await rm(input.sessionDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+    // Persist first, then broadcast. A subscriber that arrived just before
+    // this emit is guaranteed to receive events strictly past its
+    // positionAtSubscribe.
+    async emit(workspace, runId, event) {
+        await this.deps.runRepository.appendEvent(workspace, runId, event);
+        const next = (this.positions.get(runId) ?? 0) + 1;
+        this.positions.set(runId, next);
+        const listeners = this.subscribers.get(runId);
+        if (!listeners)
+            return;
+        for (const listener of listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // A buggy listener mustn't break delivery to others.
+            }
+        }
+    }
+    async resolveSessionDir(workspace, runId, resumeSessionId) {
+        if (resumeSessionId) {
+            const cached = this.sessionDirs.get(resumeSessionId);
+            if (cached)
+                return cached;
+            const recovered = await this.recoverSessionDir(workspace, resumeSessionId);
+            if (recovered) {
+                this.sessionDirs.set(resumeSessionId, recovered);
+                return recovered;
+            }
+        }
+        return this.buildSessionDir(workspace, runId);
+    }
+    async recoverSessionDir(workspace, sessionId) {
+        const records = await this.deps.runRepository.listRecords(workspace);
+        const first = records
+            .filter(r => r.sessionId === sessionId && !r.resumed)
+            .sort((a, b) => a.startedAt.localeCompare(b.startedAt))[0];
+        return first ? sessionDirPath(workspace.rootPath, first.runId) : undefined;
+    }
+    async buildSessionDir(workspace, runId) {
+        const sessionDir = sessionDirPath(workspace.rootPath, runId);
+        const skillsDir = join(sessionDir, '.claude', 'skills');
+        await mkdir(skillsDir, { recursive: true });
+        const manifests = await this.deps.skillRegistry.list(workspace);
+        const linked = new Set();
+        for (const manifest of manifests) {
+            const slashName = manifest.frontmatter.name;
+            if (linked.has(slashName))
+                continue;
+            linked.add(slashName);
+            await symlink(dirname(manifest.path), join(skillsDir, slashName), 'dir');
+        }
+        for (const reference of this.deps.referenceDirs ?? []) {
+            if (linked.has(reference.name))
+                continue;
+            linked.add(reference.name);
+            await symlink(reference.path, join(skillsDir, reference.name), 'dir');
+        }
+        return sessionDir;
+    }
+    now() {
+        return (this.deps.clock ?? (() => new Date().toISOString()))();
+    }
+}
+async function defaultSpawn() {
+    const mod = await import('node:child_process');
+    return (command, args, options) => mod.spawn(command, [...args], options);
+}
+//# sourceMappingURL=SubprocessSkillRunner.js.map

package/dist/infrastructure/agent/SubprocessSkillRunner.js.map

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

package/dist/infrastructure/agent/asyncQueue.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Single-producer / single-consumer async queue backing an `AsyncIterable`.
+ *
+ * Used to bridge node `EventEmitter`-style callbacks (which fire whenever
+ * subprocess stdout / stderr / close events arrive) into `for await … of`
+ * consumers (Hono's SSE writer, vitest assertions) without buffering every
+ * event until the producer is done.
+ *
+ * Contract:
+ *   - `push(item)` enqueues an item and wakes a pending consumer.
+ *   - `end()` signals that no more items are coming; the iterator finishes
+ *     once it has drained the queue.
+ *   - `iterate()` returns a single-use async generator. Calling it more than
+ *     once is undefined.
+ */
+export interface AsyncQueue<T> {
+    push: (item: T) => void;
+    end: () => void;
+    iterate: () => AsyncGenerator<T>;
+}
+export declare function createAsyncQueue<T>(): AsyncQueue<T>;
+//# sourceMappingURL=asyncQueue.d.ts.map

package/dist/infrastructure/agent/asyncQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncQueue.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/agent/asyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IACvB,GAAG,EAAE,MAAM,IAAI,CAAA;IACf,OAAO,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,CAAA;CACjC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CA2CnD"}

package/dist/infrastructure/agent/asyncQueue.js

@@ -0,0 +1,43 @@
+export function createAsyncQueue() {
+    const buffer = [];
+    let resolver = null;
+    let finished = false;
+    const wake = () => {
+        if (resolver) {
+            const r = resolver;
+            resolver = null;
+            r();
+        }
+    };
+    return {
+        push: (item) => {
+            buffer.push(item);
+            wake();
+        },
+        end: () => {
+            finished = true;
+            wake();
+        },
+        iterate: async function* iterate() {
+            while (true) {
+                if (buffer.length > 0) {
+                    yield buffer.shift();
+                    continue;
+                }
+                if (finished)
+                    return;
+                // The double check inside the Promise constructor avoids a race
+                // where `push` or `end` is called between the queue-length check
+                // and the resolver assignment.
+                await new Promise((r) => {
+                    if (buffer.length > 0 || finished) {
+                        r();
+                        return;
+                    }
+                    resolver = r;
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=asyncQueue.js.map

package/dist/infrastructure/agent/asyncQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncQueue.js","sourceRoot":"","sources":["../../../src/infrastructure/agent/asyncQueue.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAQ,EAAE,CAAA;IACtB,IAAI,QAAQ,GAAwB,IAAI,CAAA;IACxC,IAAI,QAAQ,GAAG,KAAK,CAAA;IAEpB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,QAAQ,CAAA;YAClB,QAAQ,GAAG,IAAI,CAAA;YACf,CAAC,EAAE,CAAA;QACL,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,IAAI,EAAE,CAAA;QACR,CAAC;QACD,GAAG,EAAE,GAAG,EAAE;YACR,QAAQ,GAAG,IAAI,CAAA;YACf,IAAI,EAAE,CAAA;QACR,CAAC;QACD,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,OAAO;YAC9B,OAAO,IAAI,EAAE,CAAC;gBACZ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,MAAM,CAAC,KAAK,EAAG,CAAA;oBACrB,SAAQ;gBACV,CAAC;gBACD,IAAI,QAAQ;oBACV,OAAM;gBACR,gEAAgE;gBAChE,iEAAiE;gBACjE,+BAA+B;gBAC/B,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;oBAC5B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;wBAClC,CAAC,EAAE,CAAA;wBACH,OAAM;oBACR,CAAC;oBACD,QAAQ,GAAG,CAAC,CAAA;gBACd,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/infrastructure/agent/mcpConfig.d.ts

@@ -0,0 +1,18 @@
+import type { Workspace } from '@braidhq/core';
+export interface McpConfigFile {
+    readonly mcpServers: Readonly<Record<string, McpServerEntry>>;
+}
+/**
+ * Shape claude expects in `--mcp-config <file>`. Mirrors the spec's
+ * Streamable HTTP transport: a single endpoint URL with optional headers.
+ */
+interface McpStreamableHttpEntry {
+    readonly type: 'http';
+    readonly url: string;
+    readonly headers?: Record<string, string>;
+}
+type McpServerEntry = McpStreamableHttpEntry;
+export declare function buildMcpConfig(workspace: Workspace): McpConfigFile;
+export declare function writeMcpConfigFile(workspace: Workspace, targetDir: string): Promise<string>;
+export {};
+//# sourceMappingURL=mcpConfig.d.ts.map

package/dist/infrastructure/agent/mcpConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpConfig.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/agent/mcpConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAM9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;CAC9D;AAED;;;GAGG;AACH,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED,KAAK,cAAc,GAAG,sBAAsB,CAAA;AAE5C,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAMlE;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjG"}

package/dist/infrastructure/agent/mcpConfig.js

@@ -0,0 +1,47 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import process from 'node:process';
+export function buildMcpConfig(workspace) {
+    const entries = {};
+    for (const server of workspace.mcpServers) {
+        entries[server.id] = toEntry(server);
+    }
+    return { mcpServers: entries };
+}
+export async function writeMcpConfigFile(workspace, targetDir) {
+    const config = buildMcpConfig(workspace);
+    const targetPath = join(targetDir, `.braid-mcp-${workspace.id}.json`);
+    await mkdir(dirname(targetPath), { recursive: true });
+    await writeFile(targetPath, `${JSON.stringify(config, null, 2)}\n`, 'utf-8');
+    return targetPath;
+}
+function toEntry(server) {
+    // `type: 'http'` is what the claude CLI's mcp-config schema currently
+    // names the Streamable HTTP transport (it predates the rename in the MCP
+    // 2025-06-18 spec). We use the new name in PRODUCT.md to match the spec;
+    // we emit the legacy name here so claude understands.
+    return {
+        type: 'http',
+        url: server.url,
+        ...(server.headers ? { headers: resolveHeaders(server.headers) } : {}),
+    };
+}
+/**
+ * Replace `${VAR}` references in header values with the matching env var.
+ * Throws if a referenced var is missing so the user gets a clear error at
+ * config-write time rather than a confusing 401 from the MCP server.
+ */
+function resolveHeaders(headers) {
+    const out = {};
+    for (const [name, value] of Object.entries(headers)) {
+        out[name] = value.replace(/\$\{([A-Z_][A-Z0-9_]*)\}/g, (_match, varName) => {
+            const resolved = process.env[varName];
+            if (resolved === undefined) {
+                throw new Error(`MCP header "${name}": environment variable "${varName}" is not set`);
+            }
+            return resolved;
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=mcpConfig.js.map

package/dist/infrastructure/agent/mcpConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpConfig.js","sourceRoot":"","sources":["../../../src/infrastructure/agent/mcpConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,OAAO,MAAM,cAAc,CAAA;AAkBlC,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,MAAM,OAAO,GAAmC,EAAE,CAAA;IAClD,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAoB,EAAE,SAAiB;IAC9E,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,SAAS,CAAC,EAAE,OAAO,CAAC,CAAA;IACrE,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC5E,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,OAAO,CAAC,MAAuB;IACtC,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,sDAAsD;IACtD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,OAA+B;IACrD,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,2BAA2B,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;YACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACrC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,4BAA4B,OAAO,cAAc,CAAC,CAAA;YACvF,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/infrastructure/agent/streamJsonParser.d.ts

@@ -0,0 +1,20 @@
+export type LineHandler = (line: string) => void;
+/**
+ * Splits a chunked text stream into newline-delimited lines, invoking the
+ * handler exactly once per complete line. Partial lines are buffered until
+ * the next chunk completes them. Call `flush()` after the source closes to
+ * release any trailing line without a terminator.
+ */
+export declare class LineBuffer {
+    private readonly onLine;
+    private buffer;
+    constructor(onLine: LineHandler);
+    append(chunk: string): void;
+    flush(): void;
+}
+export interface StreamJsonEvent {
+    readonly type: string;
+    readonly [key: string]: unknown;
+}
+export declare function parseJsonLine(line: string): StreamJsonEvent | undefined;
+//# sourceMappingURL=streamJsonParser.d.ts.map

package/dist/infrastructure/agent/streamJsonParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamJsonParser.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/agent/streamJsonParser.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAEhD;;;;;GAKG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAK;gBAEU,MAAM,EAAE,WAAW;IAEhD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY3B,KAAK,IAAI,IAAI;CAOd;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAChC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAWvE"}

package/dist/infrastructure/agent/streamJsonParser.js

@@ -0,0 +1,44 @@
+/**
+ * Splits a chunked text stream into newline-delimited lines, invoking the
+ * handler exactly once per complete line. Partial lines are buffered until
+ * the next chunk completes them. Call `flush()` after the source closes to
+ * release any trailing line without a terminator.
+ */
+export class LineBuffer {
+    onLine;
+    buffer = '';
+    constructor(onLine) {
+        this.onLine = onLine;
+    }
+    append(chunk) {
+        this.buffer += chunk;
+        let newlineIndex = this.buffer.indexOf('\n');
+        while (newlineIndex >= 0) {
+            const line = this.buffer.slice(0, newlineIndex);
+            this.buffer = this.buffer.slice(newlineIndex + 1);
+            if (line.length > 0)
+                this.onLine(line);
+            newlineIndex = this.buffer.indexOf('\n');
+        }
+    }
+    flush() {
+        if (this.buffer.length === 0)
+            return;
+        const remainder = this.buffer;
+        this.buffer = '';
+        this.onLine(remainder);
+    }
+}
+export function parseJsonLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=streamJsonParser.js.map

package/dist/infrastructure/agent/streamJsonParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamJsonParser.js","sourceRoot":"","sources":["../../../src/infrastructure/agent/streamJsonParser.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IAGQ;IAFrB,MAAM,GAAG,EAAE,CAAA;IAEnB,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAA;QACpB,IAAI,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC5C,OAAO,YAAY,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;YAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAA;YACjD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACnB,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,OAAM;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAA;QAC7B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACxB,CAAC;CACF;AAOD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QACtB,OAAO,SAAS,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAA;QACrD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,MAAM,CAAC;QACL,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/infrastructure/agent/subprocessEventStream.d.ts

@@ -0,0 +1,26 @@
+import type { SkillEvent } from '@braidhq/schema';
+import type { ChildProcess } from 'node:child_process';
+interface RawEvent {
+    readonly type: string;
+    readonly [key: string]: unknown;
+}
+/**
+ * Wires a child's stdout / stderr to a single SkillEvent callback.
+ * Returns `flush` so callers can drain the final un-terminated line on
+ * `close`.
+ */
+export declare function attachOutputBuffers(child: ChildProcess, onEvent: (event: SkillEvent) => void, now: () => string): {
+    flush: () => void;
+};
+/**
+ * Maps a single `claude --output-format stream-json` line into zero or more
+ * `SkillEvent`s. Claude emits these envelope shapes today: `system` (init
+ * meta, ignored except for `session_id`), `assistant` (text / tool_use
+ * content parts), `user` (echoed tool_result, only `is_error` surfaced),
+ * `rate_limit_*` (ignored), `result` (final outcome). Legacy flat shapes
+ * (`text`, `tool_use`, `artifact-written`, `error`) are kept for tests and
+ * older tools.
+ */
+export declare function mapSubprocessEvents(raw: RawEvent, now: string): SkillEvent[];
+export {};
+//# sourceMappingURL=subprocessEventStream.d.ts.map

package/dist/infrastructure/agent/subprocessEventStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocessEventStream.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/agent/subprocessEventStream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAItD,UAAU,QAAQ;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;AAG7E;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACpC,GAAG,EAAE,MAAM,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAyBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAyE5E"}

package/dist/infrastructure/agent/subprocessEventStream.js

@@ -0,0 +1,112 @@
+import { SkillEvent as SkillEventSchema } from '@braidhq/schema';
+import { LineBuffer, parseJsonLine } from './streamJsonParser.js';
+/**
+ * Wires a child's stdout / stderr to a single SkillEvent callback.
+ * Returns `flush` so callers can drain the final un-terminated line on
+ * `close`.
+ */
+export function attachOutputBuffers(child, onEvent, now) {
+    const stdout = new LineBuffer((line) => {
+        const parsed = parseJsonLine(line);
+        if (parsed === undefined)
+            return;
+        for (const event of mapSubprocessEvents(parsed, now()))
+            onEvent(event);
+    });
+    // stderr is wrapped verbatim into a `[stderr]` message event so it
+    // shows up in the transcript alongside model output.
+    const stderr = new LineBuffer((line) => {
+        onEvent(SkillEventSchema.parse({ type: 'message', text: `[stderr] ${line}` }));
+    });
+    child.stdout?.setEncoding('utf-8');
+    child.stdout?.on('data', (chunk) => stdout.append(chunk));
+    child.stderr?.setEncoding('utf-8');
+    child.stderr?.on('data', (chunk) => stderr.append(chunk));
+    return {
+        flush: () => {
+            stdout.flush();
+            stderr.flush();
+        },
+    };
+}
+/**
+ * Maps a single `claude --output-format stream-json` line into zero or more
+ * `SkillEvent`s. Claude emits these envelope shapes today: `system` (init
+ * meta, ignored except for `session_id`), `assistant` (text / tool_use
+ * content parts), `user` (echoed tool_result, only `is_error` surfaced),
+ * `rate_limit_*` (ignored), `result` (final outcome). Legacy flat shapes
+ * (`text`, `tool_use`, `artifact-written`, `error`) are kept for tests and
+ * older tools.
+ */
+export function mapSubprocessEvents(raw, now) {
+    const out = [];
+    if (raw.type === 'system' && raw.subtype === 'init' && typeof raw.session_id === 'string') {
+        out.push(SkillEventSchema.parse({ type: 'session-started', sessionId: raw.session_id }));
+        return out;
+    }
+    if (raw.type === 'assistant') {
+        for (const part of readContent(raw)) {
+            if (part?.type === 'text' && typeof part.text === 'string' && part.text.length > 0) {
+                out.push(SkillEventSchema.parse({ type: 'message', text: part.text }));
+            }
+            else if (part?.type === 'tool_use' && typeof part.name === 'string') {
+                const event = {
+                    type: 'tool-call',
+                    tool: part.name,
+                    args: part.input ?? null,
+                };
+                if (typeof part.id === 'string' && part.id.length > 0)
+                    event.toolCallId = part.id;
+                out.push(SkillEventSchema.parse(event));
+            }
+        }
+        return out;
+    }
+    if (raw.type === 'user') {
+        for (const part of readContent(raw)) {
+            if (part?.type === 'tool_result' && typeof part.tool_use_id === 'string') {
+                const output = typeof part.content === 'string'
+                    ? part.content
+                    : JSON.stringify(part.content ?? '');
+                out.push(SkillEventSchema.parse({
+                    type: 'tool-result',
+                    toolCallId: part.tool_use_id,
+                    output,
+                    isError: part.is_error === true,
+                }));
+            }
+        }
+        return out;
+    }
+    if (raw.type === 'result') {
+        const isError = raw.is_error === true;
+        const text = typeof raw.result === 'string' ? raw.result : '';
+        if (isError)
+            out.push(SkillEventSchema.parse({ type: 'error', message: text || 'skill run failed', at: now }));
+        else if (text.length > 0)
+            out.push(SkillEventSchema.parse({ type: 'message', text }));
+        return out;
+    }
+    if (raw.type === 'text' && typeof raw.text === 'string')
+        return [SkillEventSchema.parse({ type: 'message', text: raw.text })];
+    if (raw.type === 'tool_use' && typeof raw.name === 'string')
+        return [SkillEventSchema.parse({ type: 'tool-call', tool: raw.name, args: raw.input ?? null })];
+    if (raw.type === 'artifact-written' && typeof raw.artifactKind === 'string') {
+        return [SkillEventSchema.parse({
+                type: 'artifact-written',
+                artifactKind: raw.artifactKind,
+                artifactId: raw.artifactId,
+                path: raw.path,
+            })];
+    }
+    if (raw.type === 'error' && typeof raw.message === 'string')
+        return [SkillEventSchema.parse({ type: 'error', message: raw.message, at: now })];
+    return out;
+}
+function readContent(raw) {
+    const message = raw.message;
+    if (!message || !Array.isArray(message.content))
+        return [];
+    return message.content;
+}
+//# sourceMappingURL=subprocessEventStream.js.map

package/dist/infrastructure/agent/subprocessEventStream.js.map

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