@braidhq/server 0.0.1 → 0.2.0

package/dist/infrastructure/reactor/FsReactorCycleRepository.js

@@ -0,0 +1,94 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import process from 'node:process';
+import { NotFoundError } from '@braidhq/core';
+import { ReactorCycle as ReactorCycleSchema } from '@braidhq/schema';
+import { reactorCycleFilePath, reactorCyclesDir } from '../_shared/paths.js';
+/**
+ * Filesystem-backed `ReactorCycleRepository`. One JSON file per cycle,
+ * at `artifacts/reactor-cycles/<cycleId>.json`.
+ * Each save is an atomic rename,
+ * so the Studio Activity page never reads a half-written file.
+ *
+ * The file body is exactly the `ReactorCycle` shape, no wrapper or envelope.
+ * A future SQLite or Postgres impl maps one file to one row keyed by `cycleId`,
+ * with `(workspaceId, startedAt)` indexed for the list query.
+ */
+export class FsReactorCycleRepository {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async save(cycle) {
+        const root = await this.resolveRoot(cycle.workspaceId);
+        const file = reactorCycleFilePath(root, cycle.id);
+        await mkdir(reactorCyclesDir(root), { recursive: true });
+        // Random suffix so concurrent saves in the same ms don't collide.
+        const tmp = `${file}.tmp-${process.pid}-${randomUUID()}`;
+        await writeFile(tmp, `${JSON.stringify(cycle, null, 2)}\n`, 'utf-8');
+        await rename(tmp, file);
+    }
+    async load(workspaceId, cycleId) {
+        const root = await this.resolveRoot(workspaceId);
+        const file = reactorCycleFilePath(root, cycleId);
+        try {
+            const raw = await readFile(file, 'utf-8');
+            const parsed = ReactorCycleSchema.parse(JSON.parse(raw));
+            // The directory layout is per-workspace already,
+            // but double-check the body matches, guarding the case,
+            // where an operator copy-pasted in a file from another workspace.
+            if (parsed.workspaceId !== workspaceId)
+                return undefined;
+            return parsed;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        }
+    }
+    async listByWorkspace(workspaceId) {
+        const root = await this.resolveRoot(workspaceId);
+        const dir = reactorCyclesDir(root);
+        const entries = await safeReaddir(dir);
+        const cycles = [];
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.endsWith('.json'))
+                continue;
+            if (entry.name.includes('.tmp-'))
+                continue;
+            const raw = await readFile(join(dir, entry.name), 'utf-8');
+            try {
+                const parsed = ReactorCycleSchema.parse(JSON.parse(raw));
+                if (parsed.workspaceId === workspaceId)
+                    cycles.push(parsed);
+            }
+            catch {
+                // Skip files that fail validation, truncated half-writes,
+                // or manual edits gone wrong.
+                // Raising them as errors here would,
+                // in turn, block the Activity page from rendering recent cycles.
+            }
+        }
+        return cycles.sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+    }
+    async resolveRoot(workspaceId) {
+        const roots = await this.options.workspaceRoots();
+        const root = roots.get(workspaceId);
+        if (!root)
+            throw new NotFoundError(`Workspace "${workspaceId}" has no registered root path`);
+        return root;
+    }
+}
+async function safeReaddir(dir) {
+    try {
+        return await readdir(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+//# sourceMappingURL=FsReactorCycleRepository.js.map

package/dist/infrastructure/reactor/FsReactorCycleRepository.js.map

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

package/dist/infrastructure/secrets/SecretStore.d.ts

@@ -1,20 +1,17 @@
 /**
- * Per-scope JSON secret storage on the local filesystem. One file per
- * `(namespace, key)` under `<root>/<namespace>/<key>.json`. Files are
- * written with mode 0600 so only the running user can read them; the
- * containing directory is mode 0700.
+ * Per-scope JSON secret storage on the local filesystem.
+ * One file per `(namespace, key)` under `<root>/<namespace>/<key>.json`.
+ * Files are written with mode 0600 so only the running user can read them,
+ * the containing directory is mode 0700.
  *
- * This is NOT an encrypted-at-rest store. It's appropriate for local /
- * single-user Braid installs (the OSS target). A hosted SaaS deployment
- * would swap this for a vault adapter (AWS Secrets Manager, Vault, …)
- * by implementing the same interface.
+ * This is NOT an encrypted-at-rest store.
+ * It suits local, single-user Braid installs (the OSS target).
+ * A hosted SaaS deployment would swap this for a vault adapter,
+ * such as AWS Secrets Manager or Vault, behind the same interface.
  *
- * Layout:
- *   <root>/
- *     oauth-google/
- *       <workspaceId>--<sourceId>.json  # one set of tokens per source
- *     oauth-github/
- *       <workspaceId>--<sourceId>.json
+ * Layout, one tokens file per source under a per-provider namespace,
+ * so Google tokens live at `<root>/oauth-google/<workspaceId>--<sourceId>.json`,
+ * and GitHub tokens at `<root>/oauth-github/<workspaceId>--<sourceId>.json`.
  */
 export interface SecretRecord {
     readonly value: unknown;

package/dist/infrastructure/secrets/SecretStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SecretStore.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/secrets/SecretStore.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IACnE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxE,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D;AAED,qBAAa,aAAc,YAAW,WAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEnC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAc/D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,OAAO,CAAC,OAAO;CAGhB"}
+{"version":3,"file":"SecretStore.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/secrets/SecretStore.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IACnE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxE,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D;AAED,qBAAa,aAAc,YAAW,WAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEnC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAc/D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,OAAO,CAAC,OAAO;CAGhB"}

package/dist/infrastructure/secrets/SecretStore.js

@@ -23,8 +23,8 @@ export class FsSecretStore {
         await mkdir(dirname(path), { recursive: true, mode: 0o700 });
         const record = { value, updatedAt: new Date().toISOString() };
         await writeFile(path, JSON.stringify(record, null, 2), { encoding: 'utf-8', mode: 0o600 });
-        // mkdir's mode arg is ignored on some platforms; explicitly chmod the
-        // dir + file to keep the perms stable across reboots / restores.
+        // mkdir's mode arg is ignored on some platforms,
+        // so chmod the dir and file explicitly to keep perms stable across reboots and restores.
         await chmod(dirname(path), 0o700);
         await chmod(path, 0o600);
     }
@@ -36,8 +36,8 @@ export class FsSecretStore {
         return join(this.root, sanitize(namespace), `${sanitize(key)}.json`);
     }
 }
-// Conservative: only ASCII letters / digits / `-`, `_`, `.`. Anything else
-// is replaced with `_` so a hostile workspaceId can't escape the dir.
+// Conservative allowlist of ASCII letters, digits, `-`, `_`, and `.`.
+// Anything else becomes `_` so a hostile workspaceId can't escape the dir.
 function sanitize(input) {
     return input.replace(/[^\w.-]/g, '_');
 }

package/dist/infrastructure/secrets/SecretStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"SecretStore.js","sourceRoot":"","sources":["../../../src/infrastructure/secrets/SecretStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AA+BzC,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAI,SAAiB,EAAE,GAAW;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACzC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAA;YAC9C,OAAO,MAAM,CAAC,KAAU,CAAA;QAC1B,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBACpD,OAAO,SAAS,CAAA;YAClB,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAc;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACzC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;QAC3E,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC1F,sEAAsE;QACtE,iEAAiE;QACjE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAA;QACjC,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,GAAW;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACzC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjC,CAAC;IAEO,OAAO,CAAC,SAAiB,EAAE,GAAW;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACtE,CAAC;CACF;AAED,2EAA2E;AAC3E,sEAAsE;AACtE,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;AACvC,CAAC"}
+{"version":3,"file":"SecretStore.js","sourceRoot":"","sources":["../../../src/infrastructure/secrets/SecretStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AA4BzC,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAI,SAAiB,EAAE,GAAW;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACzC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAA;YAC9C,OAAO,MAAM,CAAC,KAAU,CAAA;QAC1B,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBACpD,OAAO,SAAS,CAAA;YAClB,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAc;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACzC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;QAC3E,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC1F,iDAAiD;QACjD,yFAAyF;QACzF,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAA;QACjC,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,GAAW;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACzC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjC,CAAC;IAEO,OAAO,CAAC,SAAiB,EAAE,GAAW;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACtE,CAAC;CACF;AAED,sEAAsE;AACtE,2EAA2E;AAC3E,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;AACvC,CAAC"}

package/dist/infrastructure/{fs → skill}/FsRunRepository.d.ts

@@ -1,5 +1,5 @@
 import type { RunRepository, Workspace } from '@braidhq/core';
-import type { AbsolutePath, RunRecord, SkillEvent, SkillRunId } from '@braidhq/schema';
+import type { AbsolutePath, RunRecord, SessionMetadata, SkillEvent, SkillRunId } from '@braidhq/schema';
 /**
  * File-system adapter for skill-run recording.
  *
@@ -7,15 +7,20 @@ import type { AbsolutePath, RunRecord, SkillEvent, SkillRunId } from '@braidhq/s
  *     ├── index.jsonl                (append-only summary, last-wins per runId)
  *     └── <runId>.jsonl              (full SkillEvent stream for one run)
  *
- * Index is append-only because every concurrent write of a single workspace
- * goes through one server process today; if that changes we'd swap to
- * `mv tmp final` atomic rewrites or hand it to sqlite.
+ * The index is append-only because every write of one workspace goes,
+ * today, through a single server process.
+ * Should that ever change,
+ * we would swap to atomic `mv tmp final` rewrites, or hand it to sqlite.
  */
 export declare class FsRunRepository implements RunRepository {
     saveRecord(workspace: Workspace, record: RunRecord): Promise<void>;
     appendEvent(workspace: Workspace, runId: SkillRunId, event: SkillEvent): Promise<void>;
     listRecords(workspace: Workspace): Promise<readonly RunRecord[]>;
     readEvents(workspace: Workspace, runId: SkillRunId): AsyncIterable<SkillEvent>;
+    deleteRecords(workspace: Workspace, runIds: readonly SkillRunId[]): Promise<void>;
+    saveSessionMetadata(workspace: Workspace, metadata: SessionMetadata): Promise<void>;
+    listSessionMetadata(workspace: Workspace): Promise<readonly SessionMetadata[]>;
 }
+/** Re-exported so callers don't need to thread AbsolutePath types around. */
 export type { AbsolutePath };
 //# sourceMappingURL=FsRunRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FsRunRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/FsRunRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAQvG;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,aAAa;IAC7C,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtF,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC;IAyB9D,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC;IAkBhF,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCjF,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnF,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;CAsBrF;AA6BD,6EAA6E;AAC7E,YAAY,EAAE,YAAY,EAAE,CAAA"}

package/dist/infrastructure/skill/FsRunRepository.js

@@ -0,0 +1,162 @@
+import { createReadStream } from 'node:fs';
+import { appendFile, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import process from 'node:process';
+import { createInterface } from 'node:readline/promises';
+import { RunRecord as RunRecordSchema, SessionMetadata as SessionMetadataSchema, SkillEvent as SkillEventSchema } from '@braidhq/schema';
+import { runEventsPath, runIndexPath, runsDir, runSessionsMetadataPath } from '../_shared/paths.js';
+/**
+ * File-system adapter for skill-run recording.
+ *
+ *   <workspaceRoot>/artifacts/runs/
+ *     ├── index.jsonl                (append-only summary, last-wins per runId)
+ *     └── <runId>.jsonl              (full SkillEvent stream for one run)
+ *
+ * The index is append-only because every write of one workspace goes,
+ * today, through a single server process.
+ * Should that ever change,
+ * we would swap to atomic `mv tmp final` rewrites, or hand it to sqlite.
+ */
+export class FsRunRepository {
+    async saveRecord(workspace, record) {
+        const root = workspace.rootPath;
+        await mkdir(runsDir(root), { recursive: true });
+        const line = `${JSON.stringify(record)}\n`;
+        await appendFile(runIndexPath(root), line, 'utf-8');
+    }
+    async appendEvent(workspace, runId, event) {
+        const root = workspace.rootPath;
+        await mkdir(runsDir(root), { recursive: true });
+        const line = `${JSON.stringify(event)}\n`;
+        await appendFile(runEventsPath(root, runId), line, 'utf-8');
+    }
+    async listRecords(workspace) {
+        const root = workspace.rootPath;
+        const path = runIndexPath(root);
+        let raw;
+        try {
+            raw = await readFile(path, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        // Last-write-wins per runId so progress updates collapse to a single entry.
+        const byId = new Map();
+        for (const line of raw.split('\n')) {
+            if (line.length === 0)
+                continue;
+            const parsed = safeParseRecord(line);
+            if (parsed)
+                byId.set(parsed.runId, parsed);
+        }
+        // Reverse-chronological by startedAt so the newest conversation lands at top.
+        return Array.from(byId.values()).sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+    }
+    async *readEvents(workspace, runId) {
+        const path = runEventsPath(workspace.rootPath, runId);
+        const stream = createReadStream(path, { encoding: 'utf-8' });
+        const reader = createInterface({ input: stream, crlfDelay: Number.POSITIVE_INFINITY });
+        try {
+            for await (const line of reader) {
+                if (line.length === 0)
+                    continue;
+                const parsed = safeParseEvent(line);
+                if (parsed)
+                    yield parsed;
+            }
+        }
+        finally {
+            stream.destroy();
+        }
+    }
+    async deleteRecords(workspace, runIds) {
+        if (runIds.length === 0)
+            return;
+        const root = workspace.rootPath;
+        const indexPath = runIndexPath(root);
+        const targets = new Set(runIds);
+        let raw;
+        try {
+            raw = await readFile(indexPath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        // Rewrite the index excluding every line that names a target run.
+        // Last-wins reader semantics mean we must drop ALL occurrences,
+        // not just the latest one.
+        // An earlier entry left behind would,
+        // otherwise resurrect the run when `listRecords()` next runs.
+        const kept = [];
+        for (const line of raw.split('\n')) {
+            if (line.length === 0)
+                continue;
+            const parsed = safeParseRecord(line);
+            if (parsed && targets.has(parsed.runId))
+                continue;
+            kept.push(line);
+        }
+        const tmp = `${indexPath}.tmp-${process.pid}-${Date.now()}`;
+        await writeFile(tmp, kept.length === 0 ? '' : `${kept.join('\n')}\n`, 'utf-8');
+        await rename(tmp, indexPath);
+        // Per-runId event files get best-effort removal.
+        // A missing file is fine, the run errored before any event landed.
+        await Promise.all(runIds.map(id => rm(runEventsPath(root, id), { force: true })));
+    }
+    async saveSessionMetadata(workspace, metadata) {
+        const root = workspace.rootPath;
+        await mkdir(runsDir(root), { recursive: true });
+        const line = `${JSON.stringify(metadata)}\n`;
+        await appendFile(runSessionsMetadataPath(root), line, 'utf-8');
+    }
+    async listSessionMetadata(workspace) {
+        const root = workspace.rootPath;
+        let raw;
+        try {
+            raw = await readFile(runSessionsMetadataPath(root), 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        // Last-write-wins per sessionId, matching the index semantics.
+        const byId = new Map();
+        for (const line of raw.split('\n')) {
+            if (line.length === 0)
+                continue;
+            const parsed = safeParseSessionMetadata(line);
+            if (parsed)
+                byId.set(parsed.sessionId, parsed);
+        }
+        return Array.from(byId.values());
+    }
+}
+function safeParseRecord(line) {
+    try {
+        return RunRecordSchema.parse(JSON.parse(line));
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeParseEvent(line) {
+    try {
+        return SkillEventSchema.parse(JSON.parse(line));
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeParseSessionMetadata(line) {
+    try {
+        return SessionMetadataSchema.parse(JSON.parse(line));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=FsRunRepository.js.map

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

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

package/dist/infrastructure/{fs → skill}/FsSkillRegistry.d.ts

@@ -3,11 +3,10 @@ import { type PluginRegistry, SkillManifest, type SkillRegistry, type Workspace
 export interface FsSkillRegistryOptions {
     readonly builtinSkillsRoot: AbsolutePath;
     /**
-     * Optional plugin registry. When provided, skills declared by
-     * registered plugins are mounted under the `plugin` origin between
-     * builtins and workspace skills. Without it (e.g. in unit tests
-     * that don't compose a registry) only builtin / workspace /
-     * extension origins are discovered.
+     * Optional plugin registry. When provided, plugin-declared skills mount,
+     * between builtins and workspace skills, under the `plugin` origin.
+     * Without it, as in unit tests that compose no registry, only builtin,
+     * workspace, and extension origins are discovered.
      */
     readonly pluginRegistry?: PluginRegistry;
 }
@@ -18,14 +17,6 @@ export declare class FsSkillRegistry implements SkillRegistry {
     find(workspace: Workspace, skillId: SkillId): Promise<SkillManifest | undefined>;
     get(workspace: Workspace, skillId: SkillId): Promise<SkillManifest>;
     private scanSkillsRoot;
-    /**
-     * 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.
-     */
     private scanPluginSkills;
     private scanExtensionRoot;
     private readSkillFrontmatter;

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

@@ -0,0 +1 @@
+{"version":3,"file":"FsSkillRegistry.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/skill/FsSkillRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,OAAO,EAAe,MAAM,iBAAiB,CAAA;AAK3F,OAAO,EAAiB,KAAK,cAAc,EAAE,aAAa,EAAE,KAAK,aAAa,EAA0B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAU7I,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,iBAAiB,EAAE,YAAY,CAAA;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CACzC;AAED,qBAAa,eAAgB,YAAW,aAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,sBAAsB;IAEtD,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IA4B7D,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAKhF,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;YAO3D,cAAc;YA+Bd,gBAAgB;YAuBhB,iBAAiB;YAwBjB,oBAAoB;YA4BpB,WAAW;CAc1B"}

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

@@ -2,10 +2,10 @@ import { Buffer } from 'node:buffer';
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { NotFoundError, SkillManifest } from '@braidhq/core';
+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)
@@ -89,6 +92,7 @@ export class FsSkillRegistry {
                 origin: 'plugin',
                 path: skillFile,
                 frontmatter,
+                pluginId: ref.contributedBy,
             }));
         }
         return manifests;
@@ -102,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) {
@@ -122,8 +130,20 @@ export class FsSkillRegistry {
                 return undefined;
             throw error;
         }
-        const { frontmatter } = parseMarkdownFrontmatter(content);
-        return SkillFrontmatterSchema.parse(frontmatter);
+        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.
+        // 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');
+            throw new Error(`SKILL.md at ${skillFile} fails the structure contract:\n${issues}`);
+        }
+        return frontmatter;
     }
     async readDirSafe(directory) {
         try {

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/{agent → skill}/SubprocessSkillRunner.d.ts

@@ -1,11 +1,11 @@
 import type { AgentBinding, RunRepository, SkillEventListener, SkillRegistry, SkillRunner, SkillRunOptions, SkillRunSubscription, Workspace, WorkspaceEventBus } from '@braidhq/core';
-import type { AbsolutePath, SkillId, SkillRunId } from '@braidhq/schema';
+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 used for non-skill reference content (e.g. `shared/`
- * that builtin SKILL.md files reference via `.claude/skills/shared/...`).
+ * 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;
@@ -13,30 +13,25 @@ export interface SkillReferenceDir {
 }
 export interface SubprocessSkillRunnerDeps {
     readonly skillRegistry: SkillRegistry;
-    readonly agentBinding: AgentBinding;
+    readonly buildAgentBinding: (descriptor: AgentBindingDescriptor) => AgentBinding;
+    readonly defaultAgent: AgentBindingDescriptor;
     readonly apiUrl: string;
-    /** Required: runs persist their event log here as the source of truth for replays. */
     readonly runRepository: RunRepository;
     readonly spawn?: SpawnFn;
     readonly clock?: () => string;
-    /** Extra directories symlinked alongside skills (e.g. shared reference docs). */
     readonly referenceDirs?: readonly SkillReferenceDir[];
-    /** Delete the per-run session directory after the run. Default `true`. */
     readonly cleanupSession?: boolean;
-    /**
-     * Optional pub/sub for workspace-scoped notifications. Used by Studio
-     * to invalidate run / proposal lists in real time without polling.
-     * Tests can leave this undefined.
-     */
+    readonly coreGateway?: {
+        readonly specUrl: string;
+        readonly uvxBin?: string;
+    };
     readonly eventBus?: WorkspaceEventBus;
 }
 export declare class SubprocessSkillRunner implements SkillRunner {
     private readonly deps;
     private readonly running;
-    /** sessionId → cwd for resuming. claude needs the same cwd between turns. */
     private readonly sessionDirs;
     private readonly subscribers;
-    /** How many events have been emitted (and persisted) per run so far. */
     private readonly positions;
     constructor(deps: SubprocessSkillRunnerDeps);
     start(workspace: Workspace, skillId: SkillId, args: string, options?: SkillRunOptions): Promise<SkillRunId>;
@@ -49,6 +44,9 @@ export declare class SubprocessSkillRunner implements SkillRunner {
     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"}