@braidhq/server 0.0.1 → 0.2.0

package/dist/infrastructure/{agent → skill}/SubprocessSkillRunner.js

@@ -1,18 +1,17 @@
-import { mkdir, rm, symlink } from 'node:fs/promises';
+import { mkdir, rm, symlink, writeFile } 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 { AbsolutePath as AbsolutePathSchema, McpServerId, SkillEvent as SkillEventSchema, SkillRunId as SkillRunIdSchema, splitSkillId } from '@braidhq/schema';
+import { sessionDirPath } from '../_shared/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. */
+    // Maps sessionId to cwd for resuming. claude needs the same cwd per turn.
     sessionDirs = new Map();
     subscribers = new Map();
-    /** How many events have been emitted (and persisted) per run so far. */
+    // How many events have been emitted (and persisted) per run so far.
     positions = new Map();
     constructor(deps) {
         this.deps = deps;
@@ -21,28 +20,63 @@ export class SubprocessSkillRunner {
         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({
+        const skillBundleDirs = await this.skillBundleDirsFor(workspace, sessionDir);
+        const gatewayArgs = [
+            'openapi-mcp-gateway',
+            '--spec',
+            this.deps.coreGateway?.specUrl ?? '',
+            '--transport',
+            'stdio',
+            '--name',
+            'braid-core',
+            // Forward the caller's Bearer token so the gateway authenticates its outgoing API calls.
+            // The gateway resolves `${BRAID_TOKEN}` against its process env at startup.
+            // Without this the server's auth middleware rejects every callback with 401.
+            // eslint-disable-next-line no-template-curly-in-string
+            ...(options?.callerToken ? ['--auth-type', 'bearer', '--auth-token', '${BRAID_TOKEN}'] : []),
+        ];
+        // Compose the MCP server list, the built-in gateway plus any the workspace
+        // declares. The binding writes whatever config its CLI needs from this.
+        const gatewayServers = this.deps.coreGateway
+            ? [{
+                    id: McpServerId.parse('braid-core'),
+                    transport: 'stdio',
+                    command: this.deps.coreGateway.uvxBin ?? 'uvx',
+                    args: gatewayArgs,
+                }]
+            : [];
+        const binding = this.bindingFor(manifest.frontmatter.braid.agent);
+        const invocation = await binding.resolveSpawn({
             skillId,
             args,
             workspace,
             manifest,
             apiUrl: this.deps.apiUrl,
-            mcpConfigFile: AbsolutePathSchema.parse(mcpConfigFile),
+            mcpServers: [...gatewayServers, ...workspace.mcpServers],
+            sessionDir: AbsolutePathSchema.parse(sessionDir),
+            skillBundleDirs,
             ...(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.
+        // BRAID_SESSION_DIR resolves ambiguity in SKILL.md paths.
+        // claude sees both `BRAID_WORKSPACE` and a cwd inside it,
+        // and would otherwise guess which one `.claude/skills/...` is rooted in.
         const child = spawnFn(invocation.bin, [...invocation.args], {
             cwd: sessionDir,
-            env: { ...invocation.env, BRAID_SESSION_DIR: sessionDir },
+            env: {
+                ...invocation.env,
+                BRAID_SESSION_DIR: sessionDir,
+                // BRAID_TOKEN is read by the braid-core MCP gateway,
+                // and by any shell-level callback (curl in a SKILL.md),
+                // so the subprocess can authenticate against the running server.
+                ...(options?.callerToken ? { BRAID_TOKEN: options.callerToken } : {}),
+                ...(options?.extraEnv ?? {}),
+            },
             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.
+        // Persist the started record up front,
+        // so listing endpoints see the run immediately, before any output.
         const startedAt = this.now();
         const initialRecord = {
             runId,
@@ -61,12 +95,13 @@ export class SubprocessSkillRunner {
             skillId,
             at: startedAt,
         });
-        // Fire-and-forget the drain so the HTTP request that called start()
-        // can return immediately.
+        // Fire-and-forget the drain,
+        // so the HTTP request that called start() can return immediately.
         void this.drain({
             workspace,
             runId,
             child,
+            parseLine: binding.parseLine,
             skillId,
             args,
             sessionDir,
@@ -122,13 +157,18 @@ export class SubprocessSkillRunner {
                 at: input.startedAt,
             }));
             const queue = createAsyncQueue();
-            const buffers = attachOutputBuffers(input.child, queue.push, () => this.now());
-            input.child.on('close', (code) => {
+            const buffers = attachOutputBuffers(input.child, input.parseLine, queue.push, () => this.now());
+            input.child.on('close', (code, signal) => {
                 buffers.flush();
                 queue.push(SkillEventSchema.parse({
                     type: 'completed',
                     runId: input.runId,
-                    exitCode: code ?? 0,
+                    // A signal-killed run must be reported as non-zero,
+                    // e.g. cancel via SIGTERM, or OS-level SIGKILL.
+                    // Downstream consumers then distinguish it from a clean exit.
+                    // Without this, `code ?? 0` collapses every signal kill to 0,
+                    // and cancellation looks identical to a clean run.
+                    exitCode: code ?? (signal ? 128 : 0),
                     at: this.now(),
                 }));
                 queue.end();
@@ -161,17 +201,16 @@ export class SubprocessSkillRunner {
                 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).
+            // 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.
+    // Persist first, then broadcast.
+    // This guarantees a just-subscribed listener receives every event 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;
@@ -210,25 +249,70 @@ export class SubprocessSkillRunner {
     }
     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');
-        }
+        // Companion reference docs stay under `.claude/skills/<name>/`,
+        // so SKILL.md bodies keep reading `<cwd>/.claude/skills/shared/...`.
+        const docsDir = join(sessionDir, '.claude', 'skills');
+        await mkdir(docsDir, { recursive: true });
+        const linkedRefs = new Set();
         for (const reference of this.deps.referenceDirs ?? []) {
-            if (linked.has(reference.name))
+            if (linkedRefs.has(reference.name))
                 continue;
-            linked.add(reference.name);
-            await symlink(reference.path, join(skillsDir, reference.name), 'dir');
+            linkedRefs.add(reference.name);
+            await symlink(reference.path, join(docsDir, reference.name), 'dir');
+        }
+        // Invokable skills stage as one claude plugin per namespace, so a skill
+        // invokes as `/namespace:verb`. The colon lives only in the invocation
+        // token claude synthesises, never in a path, so the layout is portable.
+        const byNamespace = new Map();
+        for (const manifest of await this.deps.skillRegistry.list(workspace)) {
+            const { namespace } = splitSkillId(manifest.id);
+            const bucket = byNamespace.get(namespace) ?? [];
+            bucket.push(manifest);
+            byNamespace.set(namespace, bucket);
+        }
+        for (const [namespace, skills] of byNamespace) {
+            const pluginDir = this.skillBundleDir(sessionDir, namespace);
+            await mkdir(join(pluginDir, '.claude-plugin'), { recursive: true });
+            const manifest = { name: namespace, version: '0.0.0', description: `Braid ${namespace} skills` };
+            await writeFile(join(pluginDir, '.claude-plugin', 'plugin.json'), `${JSON.stringify(manifest, null, 2)}\n`, 'utf-8');
+            const skillsDir = join(pluginDir, 'skills');
+            await mkdir(skillsDir, { recursive: true });
+            const linked = new Set();
+            for (const skill of skills) {
+                const { verb } = splitSkillId(skill.id);
+                if (linked.has(verb))
+                    continue;
+                linked.add(verb);
+                await symlink(dirname(skill.path), join(skillsDir, verb), 'dir');
+            }
         }
         return sessionDir;
     }
+    skillBundleDir(sessionDir, namespace) {
+        return join(sessionDir, '.braid-plugins', namespace);
+    }
+    // The plugin bundle dir for every namespace present in the workspace.
+    // Deterministic from the session dir, so it works on a resumed session,
+    // whose bundles were staged on the first run, without restaging.
+    async skillBundleDirsFor(workspace, sessionDir) {
+        const manifests = await this.deps.skillRegistry.list(workspace);
+        const namespaces = [...new Set(manifests.map(manifest => splitSkillId(manifest.id).namespace))];
+        return namespaces.map(namespace => this.skillBundleDir(sessionDir, namespace));
+    }
+    // Merge a skill's agent override onto the server default, then build the binding.
+    // Unset override fields inherit the default.
+    bindingFor(override) {
+        const base = this.deps.defaultAgent;
+        const effort = override?.effort ?? base.effort;
+        return this.deps.buildAgentBinding({
+            id: base.id,
+            kind: override?.kind ?? base.kind,
+            model: override?.model ?? base.model,
+            ...(effort ? { effort } : {}),
+            extraArgs: base.extraArgs,
+            env: base.env,
+        });
+    }
     now() {
         return (this.deps.clock ?? (() => new Date().toISOString()))();
     }

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Single-producer, single-consumer async queue backing an `AsyncIterable`.
+ * Bridges node `EventEmitter`-style callbacks,
+ * which fire whenever subprocess stdout, stderr, or close events arrive,
+ * into `for await of` consumers (Hono's SSE writer, vitest assertions),
+ * without buffering every event until the producer is done.
+ *
+ * `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/skill/asyncQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncQueue.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/asyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;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,CA0CnD"}

package/dist/infrastructure/{agent → skill}/asyncQueue.js

@@ -26,9 +26,8 @@ export function createAsyncQueue() {
                 }
                 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.
+                // Re-check inside the Promise constructor to avoid a race,
+                // where `push` or `end` fires between the queue-length check and the resolver assignment.
                 await new Promise((r) => {
                     if (buffer.length > 0 || finished) {
                         r();

package/dist/infrastructure/{agent → skill}/asyncQueue.js.map

@@ -1 +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"}
+{"version":3,"file":"asyncQueue.js","sourceRoot":"","sources":["../../../src/infrastructure/skill/asyncQueue.ts"],"names":[],"mappings":"AAmBA,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,2DAA2D;gBAC3D,0FAA0F;gBAC1F,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/skill/lineBuffer.d.ts

@@ -0,0 +1,15 @@
+export type LineHandler = (line: string) => void;
+/**
+ * Splits a chunked text stream into newline-delimited lines,
+ * invoking the handler 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;
+}
+//# sourceMappingURL=lineBuffer.d.ts.map

package/dist/infrastructure/skill/lineBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineBuffer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/lineBuffer.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"}

package/dist/infrastructure/{agent/streamJsonParser.js → skill/lineBuffer.js}

@@ -1,8 +1,8 @@
 /**
- * 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.
+ * Splits a chunked text stream into newline-delimited lines,
+ * invoking the handler 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;
@@ -29,16 +29,4 @@ export class LineBuffer {
         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
+//# sourceMappingURL=lineBuffer.js.map

package/dist/infrastructure/skill/lineBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineBuffer.js","sourceRoot":"","sources":["../../../src/infrastructure/skill/lineBuffer.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"}

package/dist/infrastructure/skill/orphanReaper.d.ts

@@ -0,0 +1,20 @@
+import type { Clock, RunRepository, WorkspaceRepository } from '@braidhq/core';
+/**
+ * Run records survive across server restarts,
+ * but the subprocess that was driving each run does not.
+ * On startup any run without a `completedAt` timestamp is an orphan,
+ * nobody is going to drain its events.
+ * We tag those with a synthetic `error` event,
+ * so the UI can show why the transcript is truncated.
+ * A `completed` event then makes the run leave the active list.
+ *
+ * Idempotent: runs that are already marked completed are skipped.
+ */
+export declare function reapOrphanRuns(deps: {
+    workspaceRepository: WorkspaceRepository;
+    runRepository: RunRepository;
+    clock: Clock;
+}): Promise<{
+    reaped: number;
+}>;
+//# sourceMappingURL=orphanReaper.d.ts.map

package/dist/infrastructure/skill/orphanReaper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphanReaper.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/orphanReaper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAG9E;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,aAAa,EAAE,aAAa,CAAA;IAC5B,KAAK,EAAE,KAAK,CAAA;CACb,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B9B"}

package/dist/infrastructure/{orphanReaper.js → skill/orphanReaper.js}

@@ -1,9 +1,11 @@
 /**
- * Run records survive across server restarts, but the subprocess that was
- * driving each run does not. On startup any run without a `completedAt`
- * timestamp is an orphan: nobody is going to drain its events. We tag those
- * with a synthetic `error` event so the UI can show why the transcript is
- * truncated, and a `completed` event so the run leaves the active list.
+ * Run records survive across server restarts,
+ * but the subprocess that was driving each run does not.
+ * On startup any run without a `completedAt` timestamp is an orphan,
+ * nobody is going to drain its events.
+ * We tag those with a synthetic `error` event,
+ * so the UI can show why the transcript is truncated.
+ * A `completed` event then makes the run leave the active list.
  *
  * Idempotent: runs that are already marked completed are skipped.
  */

package/dist/infrastructure/skill/orphanReaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphanReaper.js","sourceRoot":"","sources":["../../../src/infrastructure/skill/orphanReaper.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAIpC;IACC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAA;IACxD,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;QAC/D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;gBAClC,SAAQ;YACV,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;YAC3B,MAAM,KAAK,GAAe;gBACxB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,+DAA+D;gBACxE,EAAE;aACH,CAAA;YACD,MAAM,SAAS,GAAe;gBAC5B,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,CAAC,CAAC;gBACZ,EAAE;aACH,CAAA;YACD,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YACpE,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YACxE,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,EAAE;gBAC7C,GAAG,MAAM;gBACT,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,CAAC,CAAC;aACb,CAAC,CAAA;YACF,MAAM,EAAE,CAAA;QACV,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAA;AACnB,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { SkillEvent } from '@braidhq/schema';
+import type { ChildProcess } from 'node:child_process';
+/**
+ * Maps one stdout line to zero or more SkillEvents.
+ * The agent binding owns this, since the line format is the agent's own.
+ */
+export type LineParser = (line: string, now: string) => SkillEvent[];
+/**
+ * Wires a child's stdout and stderr to a single SkillEvent callback.
+ * `parseLine` comes from the agent binding, so this stays format-agnostic.
+ * Returns `flush` so callers can drain the final un-terminated line on `close`.
+ */
+export declare function attachOutputBuffers(child: ChildProcess, parseLine: LineParser, onEvent: (event: SkillEvent) => void, now: () => string): {
+    flush: () => void;
+};
+//# sourceMappingURL=subprocessEventStream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subprocessEventStream.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/subprocessEventStream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAItD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,UAAU,EAAE,CAAA;AAEpE;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACpC,GAAG,EAAE,MAAM,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAsBvB"}

package/dist/infrastructure/skill/subprocessEventStream.js

@@ -0,0 +1,29 @@
+import { SkillEvent as SkillEventSchema } from '@braidhq/schema';
+import { LineBuffer } from './lineBuffer.js';
+/**
+ * Wires a child's stdout and stderr to a single SkillEvent callback.
+ * `parseLine` comes from the agent binding, so this stays format-agnostic.
+ * Returns `flush` so callers can drain the final un-terminated line on `close`.
+ */
+export function attachOutputBuffers(child, parseLine, onEvent, now) {
+    const stdout = new LineBuffer((line) => {
+        for (const event of parseLine(line, 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();
+        },
+    };
+}
+//# sourceMappingURL=subprocessEventStream.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subprocessEventStream.js","sourceRoot":"","sources":["../../../src/infrastructure/skill/subprocessEventStream.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAQ5C;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAmB,EACnB,SAAqB,EACrB,OAAoC,EACpC,GAAiB;IAEjB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,8DAA8D;IAC9D,2DAA2D;IAC3D,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;IAEF,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACjE,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAEjE,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,KAAK,EAAE,CAAA;YACd,MAAM,CAAC,KAAK,EAAE,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/infrastructure/source/FsSourceUnitDigest.d.ts

@@ -0,0 +1,19 @@
+import type { SourceUnitDigest, Workspace } from '@braidhq/core';
+import type { SourceId, SourceUnitSha } from '@braidhq/schema';
+/**
+ * Filesystem-backed `SourceUnitDigest`. Resolves the unit's relative path,
+ * under its filesystem source root, then hashes.
+ *
+ * - regular file: the sha256 of the file bytes.
+ * - directory: a recursive walk hashes each file by content,
+ *   assembles a deterministic `<relpath>:<filehash>\n` manifest,
+ *   sorted by relpath, then returns the sha256 of that manifest.
+ *   Dot-prefixed entries are skipped, per the intent scanner's convention.
+ *
+ * The intent scanner's trailing-slash convention is accepted,
+ * so a file reads as `foo.md` and a folder as `foo/`.
+ */
+export declare class FsSourceUnitDigest implements SourceUnitDigest {
+    computeSha(workspace: Workspace, sourceId: SourceId, path: string): Promise<SourceUnitSha>;
+}
+//# sourceMappingURL=FsSourceUnitDigest.d.ts.map

package/dist/infrastructure/source/FsSourceUnitDigest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsSourceUnitDigest.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/source/FsSourceUnitDigest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAK9D;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,gBAAgB;IACnD,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAejG"}

package/dist/infrastructure/source/FsSourceUnitDigest.js

@@ -0,0 +1,58 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { isAbsolute, join, relative } from 'node:path';
+/**
+ * Filesystem-backed `SourceUnitDigest`. Resolves the unit's relative path,
+ * under its filesystem source root, then hashes.
+ *
+ * - regular file: the sha256 of the file bytes.
+ * - directory: a recursive walk hashes each file by content,
+ *   assembles a deterministic `<relpath>:<filehash>\n` manifest,
+ *   sorted by relpath, then returns the sha256 of that manifest.
+ *   Dot-prefixed entries are skipped, per the intent scanner's convention.
+ *
+ * The intent scanner's trailing-slash convention is accepted,
+ * so a file reads as `foo.md` and a folder as `foo/`.
+ */
+export class FsSourceUnitDigest {
+    async computeSha(workspace, sourceId, path) {
+        const source = workspace.sources.find(s => s.id === sourceId);
+        if (!source || source.kind !== 'filesystem') {
+            throw new Error(`Cannot compute digest for non-filesystem source "${sourceId}" on workspace "${workspace.id}"`);
+        }
+        const sourceRoot = isAbsolute(source.path) ? source.path : join(workspace.rootPath, source.path);
+        const stripped = path.endsWith('/') ? path.slice(0, -1) : path;
+        const target = join(sourceRoot, stripped);
+        const info = await stat(target);
+        if (info.isDirectory())
+            return hashDirectory(target);
+        return hashFile(target);
+    }
+}
+async function hashFile(filePath) {
+    const buf = await readFile(filePath);
+    return createHash('sha256').update(buf).digest('hex');
+}
+async function hashDirectory(dirPath) {
+    const files = [];
+    await walk(dirPath, dirPath, files);
+    files.sort((a, b) => (a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0));
+    const manifest = files.map(f => `${f.rel}:${f.hash}`).join('\n');
+    return createHash('sha256').update(manifest).digest('hex');
+}
+async function walk(root, dir, out) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        const abs = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walk(root, abs, out);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        out.push({ rel: relative(root, abs), hash: await hashFile(abs) });
+    }
+}
+//# sourceMappingURL=FsSourceUnitDigest.js.map

package/dist/infrastructure/source/FsSourceUnitDigest.js.map

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

package/dist/infrastructure/source/FsSourceUnitObservationRepository.d.ts

@@ -0,0 +1,31 @@
+import type { SourceUnitObservationRepository } from '@braidhq/core';
+import type { AbsolutePath, SourceId, SourceUnitObservation, WorkspaceId } from '@braidhq/schema';
+export interface FsSourceUnitObservationRepositoryOptions {
+    /**
+     * Lookup of `workspaceId` to `workspaceRoot`, shared by the repos,
+     * so this one takes no `WorkspaceService` dependency of its own.
+     * `composeFs.ts` builds the closure once, then hands the same one,
+     * to every fs repo.
+     */
+    readonly workspaceRoots: () => Promise<ReadonlyMap<WorkspaceId, AbsolutePath>>;
+}
+/**
+ * Filesystem-backed `SourceUnitObservationRepository`. Each entity maps to,
+ * `artifacts/source-unit-state/<sourceId>/<encoded-path>.json`, one file each,
+ * matching the file-per-entity pattern used by proposals / clarifications.
+ *
+ * The file body is exactly the `SourceUnitObservation` shape,
+ * with no wrapper or envelope.
+ * In a future SQLite or Postgres store,
+ * each file becomes one row keyed by `(workspaceId, sourceId, path)`.
+ */
+export declare class FsSourceUnitObservationRepository implements SourceUnitObservationRepository {
+    private readonly options;
+    constructor(options: FsSourceUnitObservationRepositoryOptions);
+    find(workspaceId: WorkspaceId, sourceId: SourceId, path: string): Promise<SourceUnitObservation | null>;
+    save(state: SourceUnitObservation): Promise<void>;
+    listByWorkspace(workspaceId: WorkspaceId): Promise<readonly SourceUnitObservation[]>;
+    listBySource(workspaceId: WorkspaceId, sourceId: SourceId): Promise<readonly SourceUnitObservation[]>;
+    private resolveRoot;
+}
+//# sourceMappingURL=FsSourceUnitObservationRepository.d.ts.map

package/dist/infrastructure/source/FsSourceUnitObservationRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsSourceUnitObservationRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/source/FsSourceUnitObservationRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AASjG,MAAM,WAAW,wCAAwC;IACvD;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;CAC/E;AAED;;;;;;;;;GASG;AACH,qBAAa,iCAAkC,YAAW,+BAA+B;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,wCAAwC;IAExE,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAcvG,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC;IAapF,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC;YAK7F,WAAW;CAO1B"}