@braidhq/server 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mroops0111
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/app.d.ts

@@ -0,0 +1,7 @@
+import type { AppDependencies } from './composition.js';
+import { Hono } from 'hono';
+export interface AppOptions {
+    readonly corsOrigins?: readonly string[];
+}
+export declare function createApp(deps: AppDependencies, options?: AppOptions): Hono;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAkB3B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACzC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,UAAe,GAAG,IAAI,CA6D/E"}

package/dist/app.js

@@ -0,0 +1,71 @@
+import { Hono } from 'hono';
+import { corsMiddleware } from './middleware/cors.js';
+import { errorHandler } from './middleware/error.js';
+import { workspaceIdMiddleware } from './middleware/workspaceId.js';
+import { createClarifyRouter } from './routes/clarify.js';
+import { createDecisionsRouter } from './routes/decisions.js';
+import { createEdgesRouter } from './routes/edges.js';
+import { healthRouter } from './routes/health.js';
+import { createModelRouter } from './routes/model.js';
+import { createNodesRouter } from './routes/nodes.js';
+import { createOAuthRouter } from './routes/oauth.js';
+import { createOntologyRouter } from './routes/ontology.js';
+import { createProposalsRouter } from './routes/proposals.js';
+import { createRunsRouter } from './routes/runs.js';
+import { createSkillsRouter } from './routes/skills.js';
+import { createWorkspaceEventsRouter } from './routes/workspaceEvents.js';
+import { createWorkspacesRouter } from './routes/workspaces.js';
+export function createApp(deps, options = {}) {
+    const app = new Hono();
+    app.use('*', options.corsOrigins
+        ? corsMiddleware({ allowedOrigins: options.corsOrigins })
+        : corsMiddleware());
+    app.onError(errorHandler);
+    app.route('/health', healthRouter);
+    app.route('/workspaces', createWorkspacesRouter({
+        workspaceService: deps.workspaceService,
+        sourceLoaderRunner: deps.sourceLoaderRunner,
+    }));
+    app.route('/workspaces', createWorkspaceEventsRouter({ eventBus: deps.eventBus }));
+    const workspaceScoped = new Hono();
+    workspaceScoped.use('*', workspaceIdMiddleware);
+    workspaceScoped.route('/model', createModelRouter({ modelService: deps.modelService }));
+    workspaceScoped.route('/nodes', createNodesRouter({ modelService: deps.modelService }));
+    workspaceScoped.route('/edges', createEdgesRouter({ modelService: deps.modelService }));
+    workspaceScoped.route('/proposals', createProposalsRouter({
+        hitlService: deps.hitlService,
+        proposalRepository: deps.proposalRepository,
+        modelRepository: deps.modelRepository,
+        validationService: deps.validationService,
+    }));
+    workspaceScoped.route('/clarify', createClarifyRouter({
+        hitlService: deps.hitlService,
+        clarifyRepository: deps.clarifyRepository,
+    }));
+    workspaceScoped.route('/decisions', createDecisionsRouter({ decisionRepository: deps.decisionRepository }));
+    workspaceScoped.route('/ontology', createOntologyRouter({
+        workspaceRepository: deps.workspaceRepository,
+        pluginRegistry: deps.pluginRegistry,
+    }));
+    if (deps.skillRegistry && deps.skillRunner) {
+        workspaceScoped.route('/skills', createSkillsRouter({
+            skillRegistry: deps.skillRegistry,
+            skillRunner: deps.skillRunner,
+            workspaceRepository: deps.workspaceRepository,
+        }));
+        workspaceScoped.route('/runs', createRunsRouter({
+            runRepository: deps.runRepository,
+            skillRunner: deps.skillRunner,
+            workspaceRepository: deps.workspaceRepository,
+        }));
+    }
+    app.route('/workspaces/:workspaceId', workspaceScoped);
+    if (deps.secretStore) {
+        app.route('/oauth', createOAuthRouter({
+            secretStore: deps.secretStore,
+            ...(deps.googleOAuth ? { google: deps.googleOAuth } : {}),
+        }));
+    }
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/composeFs.d.ts

@@ -0,0 +1,20 @@
+import type { AgentEffort } from '@braidhq/schema';
+import type { AppDependencies } from './composition.js';
+export interface ComposeFsOptions {
+    /** Where to persist registered workspace paths. Default `$BRAID_HOME` or `~/.braid`. */
+    readonly braidHome?: string;
+    /** URL the server reports to spawned subprocesses for REST callbacks. */
+    readonly apiUrl?: string;
+    /** Coding-agent model selection (default `opus`). */
+    readonly agentModel?: string;
+    /** Coding-agent effort tier (default `high`). */
+    readonly agentEffort?: AgentEffort;
+}
+/**
+ * Production composition root: real filesystem persistence for workspaces /
+ * proposals / clarify / decisions, built-in skills loaded from `@braidhq/core`,
+ * Claude Code subprocess agent. Model storage uses Kuzu (embedded, zero-infra)
+ * per workspace at `<workspace>/.braid/model.kuzu`.
+ */
+export declare function composeFsApp(options?: ComposeFsOptions): AppDependencies;
+//# sourceMappingURL=composeFs.d.ts.map

package/dist/composeFs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeFs.d.ts","sourceRoot":"","sources":["../src/composeFs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,WAAW,EAAmC,MAAM,iBAAiB,CAAA;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AA+BvD,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA4H5E"}

package/dist/composeFs.js

@@ -0,0 +1,134 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import process from 'node:process';
+import { builtinSkillsRoot, EvidenceValidator, InMemoryWorkspaceEventBus, NotFoundError, OntologyTypeValidator, OrphanEdgeValidator, PluginRegistry, StructuralValidator, } from '@braidhq/core';
+import { dddOntology } from '@braidhq/ontology-ddd';
+import { GoogleDriveLoader } from '@braidhq/source-loader-gdrive';
+import { GitLoader } from '@braidhq/source-loader-git';
+import { KuzuModelRepository } from '@braidhq/storage-kuzu';
+import { composeApp } from './composition.js';
+import { ClaudeCodeAgentBinding } from './infrastructure/agent/ClaudeCodeAgentBinding.js';
+import { SubprocessSkillRunner } from './infrastructure/agent/SubprocessSkillRunner.js';
+import { FsClarifyTicketRepository } from './infrastructure/fs/FsClarifyTicketRepository.js';
+import { FsDecisionRepository } from './infrastructure/fs/FsDecisionRepository.js';
+import { FsProposalRepository } from './infrastructure/fs/FsProposalRepository.js';
+import { FsRunRepository } from './infrastructure/fs/FsRunRepository.js';
+import { FsSkillRegistry } from './infrastructure/fs/FsSkillRegistry.js';
+import { FsWorkspaceRepository } from './infrastructure/fs/FsWorkspaceRepository.js';
+import { WorkspaceRegistryFile } from './infrastructure/fs/WorkspaceRegistryFile.js';
+import { GoogleOAuth } from './infrastructure/oauth/GoogleOAuth.js';
+import { FsSecretStore } from './infrastructure/secrets/SecretStore.js';
+/**
+ * Production composition root: real filesystem persistence for workspaces /
+ * proposals / clarify / decisions, built-in skills loaded from `@braidhq/core`,
+ * Claude Code subprocess agent. Model storage uses Kuzu (embedded, zero-infra)
+ * per workspace at `<workspace>/.braid/model.kuzu`.
+ */
+export function composeFsApp(options = {}) {
+    const braidHome = options.braidHome ?? process.env.BRAID_HOME ?? join(homedir(), '.braid');
+    const apiUrl = options.apiUrl ?? 'http://localhost:4321';
+    const secretStore = new FsSecretStore(join(braidHome, 'secrets'));
+    const googleClientId = process.env.BRAID_GOOGLE_CLIENT_ID;
+    const googleClientSecret = process.env.BRAID_GOOGLE_CLIENT_SECRET;
+    const googleRedirect = process.env.BRAID_GOOGLE_REDIRECT_URI ?? `${apiUrl}/oauth/google/callback`;
+    const googleOAuth = googleClientId && googleClientSecret
+        ? new GoogleOAuth({ clientId: googleClientId, clientSecret: googleClientSecret, redirectUri: googleRedirect })
+        : undefined;
+    const registry = new WorkspaceRegistryFile(join(braidHome, 'workspaces.json'));
+    const workspaceRepository = new FsWorkspaceRepository({ registry });
+    const workspaceRoots = async () => {
+        const workspaces = await workspaceRepository.list();
+        return new Map(workspaces.map(ws => [ws.id, ws.rootPath]));
+    };
+    const proposalRepository = new FsProposalRepository({ workspaceRoots });
+    const clarifyRepository = new FsClarifyTicketRepository({ workspaceRoots });
+    const decisionRepository = new FsDecisionRepository({ workspaceRoots });
+    const modelRepository = new KuzuModelRepository({
+        resolveDbPath: async (workspaceId) => {
+            const roots = await workspaceRoots();
+            const root = roots.get(workspaceId);
+            if (!root)
+                throw new NotFoundError(`Workspace "${workspaceId}" not registered`);
+            return join(root, '.braid', 'model.kuzu');
+        },
+    });
+    const agentBinding = new ClaudeCodeAgentBinding({
+        id: 'claude-default',
+        kind: 'claude-code',
+        model: options.agentModel ?? 'opus',
+        effort: options.agentEffort ?? 'high',
+        extraArgs: [],
+        env: {},
+    });
+    const runRepository = new FsRunRepository();
+    const pluginRegistry = new PluginRegistry();
+    pluginRegistry.register(dddOntology);
+    pluginRegistry.register(new EvidenceValidator());
+    pluginRegistry.register(new OrphanEdgeValidator());
+    pluginRegistry.register(new OntologyTypeValidator(dddOntology));
+    pluginRegistry.register(new StructuralValidator(dddOntology));
+    pluginRegistry.register(new GitLoader());
+    if (googleOAuth) {
+        // GoogleDriveLoader requires OAuth to be configured. We resolve the
+        // access token per (workspaceId, sourceId): read stored tokens from
+        // the secret store, refresh if expired, persist the rotated access
+        // token, hand the bearer to the loader.
+        const oauth = googleOAuth;
+        pluginRegistry.register(new GoogleDriveLoader({
+            resolveAccessToken: async ({ workspaceId, sourceId }) => {
+                const key = `${workspaceId}--${sourceId}`;
+                const stored = await secretStore.read('oauth-google', key);
+                if (!stored) {
+                    throw new NotFoundError(`Google Drive source "${sourceId}" on workspace "${workspaceId}" is not connected. `
+                        + `Authorise via POST /oauth/google/start.`);
+                }
+                // 60-second skew so we don't hand out a token about to expire mid-request.
+                const stillValidUntil = new Date(stored.expiresAt).getTime() - 60_000;
+                if (Date.now() < stillValidUntil)
+                    return stored.accessToken;
+                const refreshed = await oauth.refreshAccessToken(stored.refreshToken);
+                await secretStore.write('oauth-google', key, {
+                    ...stored,
+                    accessToken: refreshed.accessToken,
+                    expiresAt: refreshed.expiresAt,
+                });
+                return refreshed.accessToken;
+            },
+        }));
+    }
+    // Built after pluginRegistry is populated so plugin-shipped SKILL.md
+    // files mount under the `plugin` skill origin alongside builtins.
+    const skillRegistry = new FsSkillRegistry({
+        builtinSkillsRoot: builtinSkillsRoot,
+        pluginRegistry,
+    });
+    const eventBus = new InMemoryWorkspaceEventBus();
+    const skillRunner = new SubprocessSkillRunner({
+        skillRegistry,
+        agentBinding,
+        apiUrl,
+        runRepository,
+        eventBus,
+        referenceDirs: [
+            { name: 'shared', path: join(builtinSkillsRoot, 'shared') },
+        ],
+    });
+    const deps = composeApp({
+        workspaceRepository,
+        proposalRepository,
+        clarifyRepository,
+        decisionRepository,
+        modelRepository,
+        skillRegistry,
+        skillRunner,
+        runRepository,
+        pluginRegistry,
+        eventBus,
+    });
+    return {
+        ...deps,
+        secretStore,
+        ...(googleOAuth ? { googleOAuth } : {}),
+    };
+}
+//# sourceMappingURL=composeFs.js.map

package/dist/composeFs.js.map

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

package/dist/composition.d.ts

@@ -0,0 +1,49 @@
+import type { ClarifyTicketRepository, Clock, DecisionRepository, ModelRepository, ProposalRepository, RunRepository, SkillRegistry, SkillRunner, WorkspaceEventBus, WorkspaceRepository } from '@braidhq/core';
+import type { GoogleOAuth } from './infrastructure/oauth/GoogleOAuth.js';
+import type { SecretStore } from './infrastructure/secrets/SecretStore.js';
+import { HITLService, ModelService, PluginRegistry, SourceLoaderRunner, ValidationService, WorkspaceService } from '@braidhq/core';
+export interface AppDependencies {
+    workspaceService: WorkspaceService;
+    hitlService: HITLService;
+    modelService: ModelService;
+    validationService: ValidationService;
+    sourceLoaderRunner: SourceLoaderRunner;
+    eventBus: WorkspaceEventBus;
+    pluginRegistry: PluginRegistry;
+    proposalRepository: ProposalRepository;
+    clarifyRepository: ClarifyTicketRepository;
+    decisionRepository: DecisionRepository;
+    modelRepository: ModelRepository;
+    workspaceRepository: WorkspaceRepository;
+    skillRegistry: SkillRegistry | undefined;
+    skillRunner: SkillRunner | undefined;
+    runRepository: RunRepository;
+    /** OAuth secret storage (file-based; pluggable for hosted deployments). */
+    secretStore?: SecretStore;
+    /**
+     * Google OAuth client. Undefined when env vars aren't set; routes
+     *  respond with 503 in that case.
+     */
+    googleOAuth?: GoogleOAuth;
+    clock: Clock;
+}
+export interface ComposeOptions {
+    clock?: Clock;
+    proposalRepository?: ProposalRepository;
+    clarifyRepository?: ClarifyTicketRepository;
+    decisionRepository?: DecisionRepository;
+    modelRepository?: ModelRepository;
+    workspaceRepository?: WorkspaceRepository;
+    pluginRegistry?: PluginRegistry;
+    skillRegistry?: SkillRegistry;
+    skillRunner?: SkillRunner;
+    runRepository?: RunRepository;
+    /**
+     * Pre-created event bus. Pass the same instance you wired into
+     * `SubprocessSkillRunner` so subscribers see runner events. Defaults
+     * to a fresh `InMemoryWorkspaceEventBus` for tests / in-memory boot.
+     */
+    eventBus?: WorkspaceEventBus;
+}
+export declare function composeApp(options?: ComposeOptions): AppDependencies;
+//# sourceMappingURL=composition.d.ts.map

package/dist/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,KAAK,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAA;AAC1E,OAAO,EACL,WAAW,EAOX,YAAY,EAEZ,cAAc,EACd,kBAAkB,EAElB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,WAAW,EAAE,WAAW,CAAA;IACxB,YAAY,EAAE,YAAY,CAAA;IAC1B,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,cAAc,EAAE,cAAc,CAAA;IAC9B,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,iBAAiB,EAAE,uBAAuB,CAAA;IAC1C,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,eAAe,EAAE,eAAe,CAAA;IAChC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAA;IACpC,aAAa,EAAE,aAAa,CAAA;IAC5B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,KAAK,EAAE,KAAK,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,iBAAiB,CAAC,EAAE,uBAAuB,CAAA;IAC3C,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IACzC,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC7B;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,eAAe,CA0CxE"}

package/dist/composition.js

@@ -0,0 +1,43 @@
+import { HITLService, InMemoryClarifyTicketRepository, InMemoryDecisionRepository, InMemoryModelRepository, InMemoryProposalRepository, InMemoryWorkspaceEventBus, InMemoryWorkspaceRepository, ModelService, noopRunRepository, PluginRegistry, SourceLoaderRunner, SystemClock, ValidationService, WorkspaceService, } from '@braidhq/core';
+export function composeApp(options = {}) {
+    const clock = options.clock ?? new SystemClock();
+    const proposalRepository = options.proposalRepository ?? new InMemoryProposalRepository();
+    const clarifyRepository = options.clarifyRepository ?? new InMemoryClarifyTicketRepository();
+    const decisionRepository = options.decisionRepository ?? new InMemoryDecisionRepository();
+    const modelRepository = options.modelRepository ?? new InMemoryModelRepository();
+    const workspaceRepository = options.workspaceRepository ?? new InMemoryWorkspaceRepository();
+    const pluginRegistry = options.pluginRegistry ?? new PluginRegistry();
+    const eventBus = options.eventBus ?? new InMemoryWorkspaceEventBus();
+    const workspaceService = new WorkspaceService({ workspaceRepository });
+    const modelService = new ModelService({ modelRepository });
+    const validationService = new ValidationService({ pluginRegistry });
+    const sourceLoaderRunner = new SourceLoaderRunner({ pluginRegistry, clock, eventBus });
+    const hitlService = new HITLService({
+        proposalRepository,
+        clarifyRepository,
+        decisionRepository,
+        modelRepository,
+        validationService,
+        clock,
+        eventBus,
+    });
+    return {
+        workspaceService,
+        hitlService,
+        modelService,
+        validationService,
+        sourceLoaderRunner,
+        eventBus,
+        pluginRegistry,
+        proposalRepository,
+        clarifyRepository,
+        decisionRepository,
+        modelRepository,
+        workspaceRepository,
+        skillRegistry: options.skillRegistry,
+        skillRunner: options.skillRunner,
+        runRepository: options.runRepository ?? noopRunRepository,
+        clock,
+    };
+}
+//# sourceMappingURL=composition.js.map

package/dist/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,WAAW,EACX,+BAA+B,EAC/B,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAA;AA+CtB,MAAM,UAAU,UAAU,CAAC,UAA0B,EAAE;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,WAAW,EAAE,CAAA;IAChD,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,IAAI,0BAA0B,EAAE,CAAA;IACzF,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,+BAA+B,EAAE,CAAA;IAC5F,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,IAAI,0BAA0B,EAAE,CAAA;IACzF,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,uBAAuB,EAAE,CAAA;IAChF,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,IAAI,2BAA2B,EAAE,CAAA;IAC5F,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,cAAc,EAAE,CAAA;IAErE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,yBAAyB,EAAE,CAAA;IACpE,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAA;IACtE,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC,CAAA;IAC1D,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAC,CAAA;IACnE,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IACtF,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;QAClC,kBAAkB;QAClB,iBAAiB;QACjB,kBAAkB;QAClB,eAAe;QACf,iBAAiB;QACjB,KAAK;QACL,QAAQ;KACT,CAAC,CAAA;IAEF,OAAO;QACL,gBAAgB;QAChB,WAAW;QACX,YAAY;QACZ,iBAAiB;QACjB,kBAAkB;QAClB,QAAQ;QACR,cAAc;QACd,kBAAkB;QAClB,iBAAiB;QACjB,kBAAkB;QAClB,eAAe;QACf,mBAAmB;QACnB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,iBAAiB;QACzD,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './app.js';
+export * from './composeFs.js';
+export * from './composition.js';
+export * from './middleware/error.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './app.js';
+export * from './composeFs.js';
+export * from './composition.js';
+export * from './middleware/error.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA"}

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

@@ -0,0 +1,8 @@
+import type { AgentBinding, AgentSpawnInput, SpawnInvocation } from '@braidhq/core';
+import type { AgentBindingDescriptor } from '@braidhq/schema';
+export declare class ClaudeCodeAgentBinding implements AgentBinding {
+    readonly descriptor: AgentBindingDescriptor;
+    constructor(descriptor: AgentBindingDescriptor);
+    resolveSpawn(input: AgentSpawnInput): SpawnInvocation;
+}
+//# sourceMappingURL=ClaudeCodeAgentBinding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeCodeAgentBinding.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/agent/ClaudeCodeAgentBinding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAG7D,qBAAa,sBAAuB,YAAW,YAAY;IAC7C,QAAQ,CAAC,UAAU,EAAE,sBAAsB;gBAAlC,UAAU,EAAE,sBAAsB;IAMvD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe;CA6CtD"}

package/dist/infrastructure/agent/ClaudeCodeAgentBinding.js

@@ -0,0 +1,62 @@
+import process from 'node:process';
+export class ClaudeCodeAgentBinding {
+    descriptor;
+    constructor(descriptor) {
+        this.descriptor = descriptor;
+        if (descriptor.kind !== 'claude-code') {
+            throw new Error(`ClaudeCodeAgentBinding expects kind="claude-code", got "${descriptor.kind}"`);
+        }
+    }
+    resolveSpawn(input) {
+        // When resuming, the prompt is just the user's follow-up text — claude
+        // already holds the conversation context and the original slash command.
+        const promptArg = input.resumeSessionId
+            ? input.args
+            : `/${input.manifest.frontmatter.name} ${input.args}`;
+        const baseArgs = [
+            '-p',
+            promptArg,
+            '--output-format',
+            'stream-json',
+            '--verbose',
+            '--dangerously-skip-permissions',
+            '--model',
+            this.descriptor.model,
+        ];
+        if (input.resumeSessionId) {
+            baseArgs.push('--resume', input.resumeSessionId);
+        }
+        if (this.descriptor.effort) {
+            baseArgs.push('--effort', this.descriptor.effort);
+        }
+        if (input.mcpConfigFile) {
+            baseArgs.push('--mcp-config', input.mcpConfigFile);
+        }
+        for (const dir of input.workspace.resolveAddDirs()) {
+            baseArgs.push('--add-dir', dir);
+        }
+        for (const extra of this.descriptor.extraArgs) {
+            baseArgs.push(extra);
+        }
+        const env = {
+            ...filterEnv(process.env),
+            ...this.descriptor.env,
+            BRAID_WORKSPACE: input.workspace.rootPath,
+            BRAID_WORKSPACE_ID: input.workspace.id,
+            BRAID_API_URL: input.apiUrl,
+        };
+        const invocation = input.mcpConfigFile
+            ? { bin: 'claude', args: baseArgs, env, mcpConfigFile: input.mcpConfigFile }
+            : { bin: 'claude', args: baseArgs, env };
+        return invocation;
+    }
+}
+function filterEnv(source) {
+    const result = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (typeof value === 'string')
+            result[key] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=ClaudeCodeAgentBinding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeCodeAgentBinding.js","sourceRoot":"","sources":["../../../src/infrastructure/agent/ClaudeCodeAgentBinding.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,MAAM,OAAO,sBAAsB;IACZ;IAArB,YAAqB,UAAkC;QAAlC,eAAU,GAAV,UAAU,CAAwB;QACrD,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,2DAA2D,UAAU,CAAC,IAAI,GAAG,CAAC,CAAA;QAChG,CAAC;IACH,CAAC;IAED,YAAY,CAAC,KAAsB;QACjC,uEAAuE;QACvE,yEAAyE;QACzE,MAAM,SAAS,GAAG,KAAK,CAAC,eAAe;YACrC,CAAC,CAAC,KAAK,CAAC,IAAI;YACZ,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAA;QACvD,MAAM,QAAQ,GAAa;YACzB,IAAI;YACJ,SAAS;YACT,iBAAiB;YACjB,aAAa;YACb,WAAW;YACX,gCAAgC;YAChC,SAAS;YACT,IAAI,CAAC,UAAU,CAAC,KAAK;SACtB,CAAA;QACD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;QAClD,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACnD,CAAC;QACD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;QACpD,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;QACjC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC;QAED,MAAM,GAAG,GAA2B;YAClC,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC;YACzB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG;YACtB,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;YACzC,kBAAkB,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE;YACtC,aAAa,EAAE,KAAK,CAAC,MAAM;SAC5B,CAAA;QAED,MAAM,UAAU,GAAoB,KAAK,CAAC,aAAa;YACrD,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;YAC5E,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;QAC1C,OAAO,UAAU,CAAA;IACnB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,MAAyB;IAC1C,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACvB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { AgentBinding, RunRepository, SkillEventListener, SkillRegistry, SkillRunner, SkillRunOptions, SkillRunSubscription, Workspace, WorkspaceEventBus } from '@braidhq/core';
+import type { AbsolutePath, 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/...`).
+ */
+export interface SkillReferenceDir {
+    readonly name: string;
+    readonly path: AbsolutePath;
+}
+export interface SubprocessSkillRunnerDeps {
+    readonly skillRegistry: SkillRegistry;
+    readonly agentBinding: AgentBinding;
+    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 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>;
+    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 now;
+}
+//# sourceMappingURL=SubprocessSkillRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SubprocessSkillRunner.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/agent/SubprocessSkillRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,YAAY,EAAyB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAcpE,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;IACrC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,sFAAsF;IACtF,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACrD,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC;;;;OAIG;IACH,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;IAC3D,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,wEAAwE;IACxE,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;IAgEtB,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;YAgFL,IAAI;YAiBJ,iBAAiB;YAkBjB,iBAAiB;YAQjB,eAAe;IAyB7B,OAAO,CAAC,GAAG;CAGZ"}