@braidhq/server 0.1.0 → 0.2.1

package/dist/infrastructure/{fs → skill}/FsSkillRegistry.js

@@ -4,8 +4,8 @@ import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { NotFoundError, SkillManifest, validateSkillStructure } from '@braidhq/core';
 import { AbsolutePath as AbsolutePathSchema, SkillFrontmatter as SkillFrontmatterSchema, SkillId as SkillIdSchema } from '@braidhq/schema';
-import { parseMarkdownFrontmatter } from './frontmatter.js';
-import { workspaceSkillExtensionsDir, workspaceSkillsDir } from './paths.js';
+import { parseMarkdownFrontmatter } from '../_shared/frontmatter.js';
+import { workspaceSkillExtensionsDir, workspaceSkillsDir } from '../_shared/paths.js';
 export class FsSkillRegistry {
     options;
     constructor(options) {
@@ -16,9 +16,9 @@ export class FsSkillRegistry {
         const pluginSkills = await this.scanPluginSkills();
         const workspaceSkills = await this.scanSkillsRoot(AbsolutePathSchema.parse(workspaceSkillsDir(workspace.rootPath)), 'workspace');
         const extensions = await this.scanExtensionRoot(AbsolutePathSchema.parse(workspaceSkillExtensionsDir(workspace.rootPath)));
-        // Precedence (later wins): builtin < plugin < workspace.
-        // Extensions don't override; they attach an EXTEND.md path to the
-        // resolved skill so SubprocessSkillRunner appends it at run time.
+        // Precedence, later wins: builtin < plugin < workspace.
+        // Extensions don't override. They attach an EXTEND.md path,
+        // and the agent binding points claude at that file at run time.
         const manifests = new Map();
         for (const manifest of builtins)
             manifests.set(manifest.id, manifest);
@@ -55,8 +55,12 @@ export class FsSkillRegistry {
             const frontmatter = await this.readSkillFrontmatter(skillFile);
             if (!frontmatter)
                 continue;
+            // The directory is the bare verb. Namespace it by origin,
+            // builtins under `braid`, workspace skills under `workspace`,
+            // so the id matches the plugin the agent binding stages it as.
+            const namespace = origin === 'builtin' ? 'braid' : 'workspace';
             manifests.push(new SkillManifest({
-                id: SkillIdSchema.parse(entry.name),
+                id: SkillIdSchema.parse(`${namespace}:${entry.name}`),
                 origin,
                 path: skillFile,
                 frontmatter,
@@ -64,14 +68,13 @@ export class FsSkillRegistry {
         }
         return manifests;
     }
-    /**
-     * Resolve every PluginSkillRef in the registry to a parsed
-     * SkillManifest. Each ref's `directory` is converted to an absolute
-     * fs path (URL via fileURLToPath), then `SKILL.md` is read and
-     * parsed. Missing files at a plugin-declared path are an error,
-     * not a silent skip: a plugin that ships a broken ref deserves a
-     * loud startup failure, not a mysteriously-absent skill.
-     */
+    // Resolve every PluginSkillRef in the registry to a parsed SkillManifest.
+    // Each ref's `directory` is resolved to an absolute path via fileURLToPath,
+    // then its `SKILL.md` is read and parsed.
+    // A file missing at such a path,
+    // counts as an error, never a silent skip.
+    // A plugin shipping a broken ref,
+    // earns a loud startup failure, not a mysteriously absent skill.
     async scanPluginSkills() {
         const registry = this.options.pluginRegistry;
         if (!registry)
@@ -103,7 +106,11 @@ export class FsSkillRegistry {
             const extendPath = AbsolutePathSchema.parse(join(root, entry.name, 'EXTEND.md'));
             try {
                 await stat(extendPath);
-                const skillId = SkillIdSchema.parse(entry.name.replace(/^braid-/, ''));
+                // The extension dir is `<namespace>-<verb>`, filesystem-safe.
+                // The first hyphen maps back to the id's `:` separator,
+                // so `ddd-extract` targets `ddd:extract` and `braid:generate-doc`
+                // targets `braid:generate-doc`.
+                const skillId = SkillIdSchema.parse(entry.name.replace('-', ':'));
                 results.push({ id: skillId, path: extendPath });
             }
             catch (error) {
@@ -125,11 +132,12 @@ export class FsSkillRegistry {
         }
         const { frontmatter: raw, body } = parseMarkdownFrontmatter(content);
         const frontmatter = SkillFrontmatterSchema.parse(raw);
-        // Structural contract: SKILL.md must declare the required H2 sections
-        // per its `braid.category`. The validator is hard-fail so a broken
-        // skill never silently appears in the workspace's skill list — a
-        // skill missing `## Procedure` would burn an entire run before the
-        // agent notices the gap.
+        // Structural contract: SKILL.md must declare the required H2 sections,
+        // per its `braid.category`.
+        // The validator is hard-fail.
+        // A broken skill never lands silently in the workspace list.
+        // Were `## Procedure` absent, the skill would burn an entire run,
+        // before the agent ever noticed the missing section.
         const validation = validateSkillStructure({ body, frontmatter });
         if (!validation.ok) {
             const issues = validation.issues.map(issue => `- ${issue.message}`).join('\n');

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

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

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

@@ -0,0 +1,52 @@
+import type { AgentBinding, RunRepository, SkillEventListener, SkillRegistry, SkillRunner, SkillRunOptions, SkillRunSubscription, Workspace, WorkspaceEventBus } from '@braidhq/core';
+import type { AbsolutePath, AgentBindingDescriptor, SkillId, SkillRunId } from '@braidhq/schema';
+import type { ChildProcess, SpawnOptions } from 'node:child_process';
+export type SpawnFn = (command: string, args: readonly string[], options: SpawnOptions) => ChildProcess;
+/**
+ * Additional directories to expose under the session's `.claude/skills/` tree.
+ * Typically non-skill reference content,
+ * e.g. a `shared/` dir that builtin SKILL.md files reference.
+ */
+export interface SkillReferenceDir {
+    readonly name: string;
+    readonly path: AbsolutePath;
+}
+export interface SubprocessSkillRunnerDeps {
+    readonly skillRegistry: SkillRegistry;
+    readonly buildAgentBinding: (descriptor: AgentBindingDescriptor) => AgentBinding;
+    readonly defaultAgent: AgentBindingDescriptor;
+    readonly apiUrl: string;
+    readonly runRepository: RunRepository;
+    readonly spawn?: SpawnFn;
+    readonly clock?: () => string;
+    readonly referenceDirs?: readonly SkillReferenceDir[];
+    readonly cleanupSession?: boolean;
+    readonly coreGateway?: {
+        readonly specUrl: string;
+        readonly uvxBin?: string;
+    };
+    readonly eventBus?: WorkspaceEventBus;
+}
+export declare class SubprocessSkillRunner implements SkillRunner {
+    private readonly deps;
+    private readonly running;
+    private readonly sessionDirs;
+    private readonly subscribers;
+    private readonly positions;
+    constructor(deps: SubprocessSkillRunnerDeps);
+    start(workspace: Workspace, skillId: SkillId, args: string, options?: SkillRunOptions): Promise<SkillRunId>;
+    subscribe(runId: SkillRunId, listener: SkillEventListener): SkillRunSubscription;
+    isActive(runId: SkillRunId): boolean;
+    cancel(runId: SkillRunId): Promise<void>;
+    forgetSession(sessionId: string): Promise<void>;
+    private drain;
+    private emit;
+    private resolveSessionDir;
+    private recoverSessionDir;
+    private buildSessionDir;
+    private skillBundleDir;
+    private skillBundleDirsFor;
+    private bindingFor;
+    private now;
+}
+//# sourceMappingURL=SubprocessSkillRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SubprocessSkillRunner.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/SubprocessSkillRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAElB,aAAa,EACb,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAA8D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5J,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AASpE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,YAAY,CAAA;AAEvG;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IAIrC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,YAAY,CAAA;IAEhF,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAA;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IAE7B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAErD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IAejC,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;IAID,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CACtC;AAOD,qBAAa,qBAAsB,YAAW,WAAW;IAQ3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAE7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;gBAE7B,IAAI,EAAE,yBAAyB;IAEtD,KAAK,CACT,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC;IAoGtB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,GAAG,oBAAoB;IAchF,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAI9B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YASvC,KAAK;YAqFL,IAAI;YAiBJ,iBAAiB;YAkBjB,iBAAiB;YAQjB,eAAe;IA6C7B,OAAO,CAAC,cAAc;YAOR,kBAAkB;IAQhC,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,GAAG;CAGZ"}

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, McpServerId, 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,6 +20,7 @@ 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 skillBundleDirs = await this.skillBundleDirsFor(workspace, sessionDir);
         const gatewayArgs = [
             'openapi-mcp-gateway',
             '--spec',
@@ -29,52 +29,54 @@ export class SubprocessSkillRunner {
             '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 inherited process env at startup; without this the
-            // server's auth middleware rejects every callback with 401.
+            // 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}'] : []),
         ];
-        const mcpConfigFile = await writeMcpConfigFile(workspace, sessionDir, {
-            extraServers: this.deps.coreGateway
-                ? [{
-                        id: McpServerId.parse('braid-core'),
-                        transport: 'stdio',
-                        command: this.deps.coreGateway.uvxBin ?? 'uvx',
-                        args: gatewayArgs,
-                    }]
-                : [],
-        });
-        const invocation = this.deps.agentBinding.resolveSpawn({
+        // 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,
-                // 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.
+                // 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,
@@ -93,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,
@@ -154,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();
@@ -193,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;
@@ -242,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