@braidhq/server 0.0.1 → 0.2.0

package/dist/routes/reactorCycles.js

@@ -0,0 +1,60 @@
+import { NotFoundError } from '@braidhq/core';
+import { ReactorCycle, ReactorCycleId } from '@braidhq/schema';
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
+import { getWorkspaceId } from '../middleware/workspaceId.js';
+import { NotFoundResponse, WorkspaceIdParam } from './_shared.js';
+const CycleIdParam = WorkspaceIdParam.extend({
+    cycleId: ReactorCycleId.openapi({ param: { name: 'cycleId', in: 'path' } }),
+});
+const ListResponse = z.object({
+    items: z.array(ReactorCycle),
+}).openapi('ReactorCycleListResponse');
+const listRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listReactorCycles',
+    summary: 'List reactor passes for a workspace, newest first.',
+    description: 'One entry per reactor cycle. The full timeline (units + checkpoint) is on each entry, so the Activity page does not need a second round-trip to render the list.',
+    tags: ['reactor'],
+    request: { params: WorkspaceIdParam },
+    responses: {
+        200: {
+            description: 'The reactor passes recorded for this workspace.',
+            content: { 'application/json': { schema: ListResponse } },
+        },
+    },
+});
+const getRoute = createRoute({
+    method: 'get',
+    path: '/{cycleId}',
+    operationId: 'getReactorCycle',
+    summary: 'Fetch one reactor cycle by id.',
+    description: 'The Activity page subscribes to the workspace event stream and refreshes this endpoint whenever a `reactor.unit.*` or `reactor.checkpoint.*` event fires for the open cycle.',
+    tags: ['reactor'],
+    request: { params: CycleIdParam },
+    responses: {
+        200: {
+            description: 'The cycle record.',
+            content: { 'application/json': { schema: ReactorCycle } },
+        },
+        404: NotFoundResponse,
+    },
+});
+export function createReactorCyclesRouter(deps) {
+    const router = new OpenAPIHono();
+    router.openapi(listRoute, async (context) => {
+        const workspaceId = getWorkspaceId(context);
+        const passes = await deps.reactorCycleRepository.listByWorkspace(workspaceId);
+        return context.json({ items: [...passes] }, 200);
+    });
+    router.openapi(getRoute, async (context) => {
+        const workspaceId = getWorkspaceId(context);
+        const { cycleId } = context.req.valid('param');
+        const cycle = await deps.reactorCycleRepository.load(workspaceId, cycleId);
+        if (!cycle)
+            throw new NotFoundError(`Reactor cycle "${cycleId}" not found for workspace "${workspaceId}"`);
+        return context.json(cycle, 200);
+    });
+    return router;
+}
+//# sourceMappingURL=reactorCycles.js.map

package/dist/routes/reactorCycles.js.map

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

package/dist/routes/runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/routes/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACpB,MAAM,eAAe,CAAA;AAItB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAM3B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;CAClD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAyE3D"}
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/routes/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACpB,MAAM,eAAe,CAAA;AAItB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAO3B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;CAClD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAkI3D"}

package/dist/routes/runs.js

@@ -1,8 +1,9 @@
-import { NotFoundError } from '@braidhq/core';
+import { ConflictError, NotFoundError, ValidationError } from '@braidhq/core';
 import { SkillRunId } from '@braidhq/schema';
 import { Hono } from 'hono';
 import { streamSSE } from 'hono/streaming';
-import { createAsyncQueue } from '../infrastructure/agent/asyncQueue.js';
+import { z } from 'zod';
+import { createAsyncQueue } from '../infrastructure/skill/asyncQueue.js';
 import { getWorkspaceId } from '../middleware/workspaceId.js';
 import { loadWorkspaceById } from './helpers.js';
 export function createRunsRouter(deps) {
@@ -12,9 +13,10 @@ export function createRunsRouter(deps) {
         const items = await deps.runRepository.listRecords(workspace);
         return context.json({ items });
     });
-    // Replay the persisted JSONL log and, if the run is still active, tail new
-    // events as they arrive. Clients can open / close / reopen this stream
-    // freely; the underlying subprocess and event log are not affected.
+    // Replay the persisted JSONL log,
+    // and if the run is still active, tail new events as they arrive.
+    // Clients can open, close, and reopen this stream freely,
+    // the underlying subprocess and event log are untouched.
     router.get('/:runId/events', async (context) => {
         const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
         const runId = SkillRunId.parse(context.req.param('runId'));
@@ -25,9 +27,10 @@ export function createRunsRouter(deps) {
                 }
                 return;
             }
-            // Subscribe BEFORE reading JSONL. positionAtSubscribe is the snapshot of
-            // how many events were already persisted, so we read exactly that many
-            // from disk and rely on the live listener for everything from there on.
+            // Subscribe BEFORE reading JSONL.
+            // The positionAtSubscribe count snapshots how many events were persisted,
+            // so we read exactly that many from disk,
+            // and rely on the live listener for everything after.
             const queue = createAsyncQueue();
             const { unsubscribe, positionAtSubscribe } = deps.skillRunner.subscribe(runId, (event) => {
                 queue.push(event);
@@ -53,9 +56,9 @@ export function createRunsRouter(deps) {
             }
         });
     });
-    // SIGTERM the underlying claude subprocess. The drain loop emits a
-    // `completed` event with the actual exit code, which the SSE tailers
-    // receive normally. 404 if the run already finished.
+    // SIGTERM the underlying claude subprocess.
+    // The drain loop emits a `completed` event with the real exit code,
+    // which the SSE tailers receive normally. 404 if the run already finished.
     router.post('/:runId/cancel', async (context) => {
         const runId = SkillRunId.parse(context.req.param('runId'));
         await deps.skillRunner.cancel(runId);
@@ -64,10 +67,61 @@ export function createRunsRouter(deps) {
     router.delete('/sessions/:sessionId', async (context) => {
         const sessionId = context.req.param('sessionId');
         if (!sessionId)
-            throw new NotFoundError('sessionId is required');
+            throw new NotFoundError('Query parameter sessionId is required');
         await deps.skillRunner.forgetSession(sessionId);
+        // `?purge=true` also drops the persisted run records and event logs,
+        // matching the workspace-level `?purge=true` pattern.
+        // Used by the Studio's per-conversation Delete action.
+        // Without purge it keeps the lightweight `forgetSession` semantics,
+        // which "New conversation" relies on.
+        if (context.req.query('purge') === 'true') {
+            const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
+            const all = await deps.runRepository.listRecords(workspace);
+            const targets = all.filter(r => r.sessionId === sessionId).map(r => r.runId);
+            const active = targets.find(id => deps.skillRunner.isActive(id));
+            if (active)
+                throw new ConflictError(`Cannot delete session "${sessionId}": run "${active}" is still active`);
+            await deps.runRepository.deleteRecords(workspace, targets);
+        }
         return context.body(null, 204);
     });
+    // Single-run delete, used by orphan Conversations rows,
+    // that have no sessionId to anchor against.
+    // Refuses to touch an in-flight run.
+    router.delete('/:runId', async (context) => {
+        const runId = SkillRunId.parse(context.req.param('runId'));
+        if (deps.skillRunner.isActive(runId))
+            throw new ConflictError(`Run "${runId}" is still active`);
+        const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
+        await deps.runRepository.deleteRecords(workspace, [runId]);
+        return context.body(null, 204);
+    });
+    const SessionPatchBody = z.object({
+        // `null` clears the custom title (UI falls back to the first prompt).
+        title: z.string().min(1).max(200).nullable(),
+    });
+    router.get('/sessions', async (context) => {
+        const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
+        const items = await deps.runRepository.listSessionMetadata(workspace);
+        return context.json({ items });
+    });
+    router.patch('/sessions/:sessionId', async (context) => {
+        const sessionId = context.req.param('sessionId');
+        if (!sessionId)
+            throw new NotFoundError('Query parameter sessionId is required');
+        const body = await context.req.json().catch(() => null);
+        const parsed = SessionPatchBody.safeParse(body);
+        if (!parsed.success)
+            throw new ValidationError(parsed.error.issues.map(i => i.message).join('; '));
+        const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
+        const metadata = {
+            sessionId,
+            title: parsed.data.title,
+            updatedAt: new Date().toISOString(),
+        };
+        await deps.runRepository.saveSessionMetadata(workspace, metadata);
+        return context.json(metadata);
+    });
     return router;
 }
 //# sourceMappingURL=runs.js.map

package/dist/routes/runs.js.map

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

package/dist/routes/skillInputOptions.d.ts

@@ -0,0 +1,10 @@
+import type { ClarificationRepository, ModelRepository, PluginRegistry, WorkspaceRepository } from '@braidhq/core';
+import { OpenAPIHono } from '@hono/zod-openapi';
+export interface SkillInputOptionsRouterDeps {
+    readonly modelRepository: ModelRepository;
+    readonly clarificationRepository: ClarificationRepository;
+    readonly workspaceRepository: WorkspaceRepository;
+    readonly pluginRegistry: PluginRegistry;
+}
+export declare function createSkillInputOptionsRouter(deps: SkillInputOptionsRouterDeps): OpenAPIHono;
+//# sourceMappingURL=skillInputOptions.d.ts.map

package/dist/routes/skillInputOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillInputOptions.d.ts","sourceRoot":"","sources":["../../src/routes/skillInputOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,cAAc,EAAa,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAG7H,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAkD/D,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,CAAA;IACzD,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;IACjD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;CACxC;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,2BAA2B,GAAG,WAAW,CAgB5F"}

package/dist/routes/skillInputOptions.js

@@ -0,0 +1,159 @@
+import { SkillInputOptionsResponse, SourceId } from '@braidhq/schema';
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
+import { listIntentItems } from '../infrastructure/source/intentScan.js';
+import { getWorkspaceId } from '../middleware/workspaceId.js';
+import { WorkspaceIdParam } from './_shared.js';
+import { loadWorkspaceById } from './helpers.js';
+/**
+ * Studio-facing endpoint that resolves a skill input provider kind,
+ * declared in a SKILL.md frontmatter, to the current option list,
+ * for a given workspace.
+ * The typed Actions form uses it to populate pickers,
+ * backed by `graph-node`, `source-intent`, or `clarify` (not static).
+ * Read-only, and lives alongside other Studio-metadata routes.
+ * Mounted under `/workspaces/:workspaceId/skill-input-options`.
+ */
+const ProviderKind = z.enum(['graph-node', 'source-intent', 'clarify']);
+const QuerySchema = z.object({
+    kind: ProviderKind.openapi({ param: { name: 'kind', in: 'query' } }),
+    // JSON-encoded filter object whose shape depends on the provider.
+    // graph-node uses `{ types?, statuses?, renderHint?: { container? } }`,
+    // source-intent uses `{ loaderKind? }`,
+    // and clarify uses `{ status?: pending | answered | applied | skipped }`.
+    //
+    // Query-string-encoded JSON keeps the schema simple,
+    // while letting each provider carry a different filter shape.
+    // Studio is the only intended caller.
+    // Humans drafting URLs by hand will rarely need it.
+    filter: z.string().optional().openapi({ param: { name: 'filter', in: 'query' } }),
+});
+const route = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listSkillInputOptions',
+    summary: 'Resolve a skill input provider to its current option list (Studio form helper).',
+    tags: ['skills'],
+    request: {
+        params: WorkspaceIdParam,
+        query: QuerySchema,
+    },
+    responses: {
+        200: {
+            description: 'Option list (possibly empty when the workspace has nothing matching the filter).',
+            content: { 'application/json': { schema: SkillInputOptionsResponse } },
+        },
+    },
+});
+export function createSkillInputOptionsRouter(deps) {
+    const router = new OpenAPIHono();
+    router.openapi(route, async (context) => {
+        const workspaceId = getWorkspaceId(context);
+        const workspace = await loadWorkspaceById(workspaceId, deps.workspaceRepository);
+        const { kind, filter } = context.req.valid('query');
+        const parsedFilter = filter
+            ? safeParseJson(filter)
+            : {};
+        const items = await resolveProvider(kind, parsedFilter, workspace, deps);
+        return context.json({ items }, 200);
+    });
+    return router;
+}
+async function resolveProvider(kind, filter, workspace, deps) {
+    switch (kind) {
+        case 'graph-node':
+            return resolveGraphNode(filter, workspace, deps);
+        case 'source-intent':
+            return resolveSourceIntent(filter, workspace);
+        case 'clarify':
+            return resolveClarification(filter, workspace.id, deps.clarificationRepository);
+    }
+}
+async function resolveGraphNode(filter, workspace, deps) {
+    const types = Array.isArray(filter.types) ? filter.types : undefined;
+    const statuses = Array.isArray(filter.statuses) ? filter.statuses : undefined;
+    const renderHint = isRecord(filter.renderHint) ? filter.renderHint : undefined;
+    const wantContainerOnly = renderHint?.container === true;
+    let typesToInclude = types;
+    if (wantContainerOnly) {
+        // Container-ness is an ontology concern.
+        // Its node-type descriptors carry `renderHint.container`.
+        // Intersect with any explicit `types` filter so both axes compose.
+        const ontology = deps.pluginRegistry.requireOntology(workspace.productManifest.ontologyId);
+        const containerTypeIds = ontology.nodeTypes
+            .filter(descriptor => descriptor.renderHint?.container === true)
+            .map(descriptor => descriptor.id);
+        typesToInclude = typesToInclude
+            ? typesToInclude.filter(t => containerTypeIds.includes(t))
+            : containerTypeIds;
+    }
+    const snapshot = await deps.modelRepository.load(workspace.id);
+    const matched = snapshot.nodes.filter((node) => {
+        if (typesToInclude && !typesToInclude.includes(node.type))
+            return false;
+        if (statuses && !statuses.includes(node.status))
+            return false;
+        return true;
+    });
+    return matched.map(node => ({
+        value: node.id,
+        label: node.name,
+        ...(node.description ? { description: firstLine(node.description) } : {}),
+    }));
+}
+async function resolveSourceIntent(filter, workspace) {
+    const loaderKindFilter = typeof filter.loaderKind === 'string' ? filter.loaderKind : undefined;
+    const items = await listIntentItems(workspace);
+    return items
+        .filter((item) => {
+        if (!loaderKindFilter)
+            return true;
+        const source = workspace.sources.find(s => s.id === item.sourceId);
+        return source?.kind === 'filesystem' && source.loader?.kind === loaderKindFilter;
+    })
+        .map((item) => {
+        // Use safeParse here.
+        // A hand-edited PRODUCT.md may carry an invalid sourceId,
+        // which should not 500 the whole dropdown.
+        // Drop the field on parse failure so the option still shows up.
+        const parsed = SourceId.safeParse(item.sourceId);
+        return {
+            value: item.value,
+            label: item.label,
+            description: item.sourceName,
+            ...(parsed.success ? { sourceId: parsed.data } : {}),
+        };
+    });
+}
+async function resolveClarification(filter, workspaceId, clarificationRepository) {
+    const status = typeof filter.status === 'string' ? filter.status : undefined;
+    const tickets = await clarificationRepository.list({
+        workspaceId,
+        ...(status ? { statuses: [status] } : {}),
+    });
+    return tickets.map(ticket => ({
+        value: ticket.id,
+        label: truncate(ticket.question, 80),
+        description: ticket.status,
+    }));
+}
+function safeParseJson(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function firstLine(text) {
+    const trimmed = text.trim();
+    const nl = trimmed.indexOf('\n');
+    return nl === -1 ? truncate(trimmed, 120) : truncate(trimmed.slice(0, nl), 120);
+}
+function truncate(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+}
+//# sourceMappingURL=skillInputOptions.js.map

package/dist/routes/skillInputOptions.js.map

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

package/dist/routes/skills.d.ts

@@ -1,9 +1,27 @@
-import type { SkillRegistry, SkillRunner, WorkspaceRepository } from '@braidhq/core';
-import { Hono } from 'hono';
+import type { PluginRegistry, RunRepository, SkillRegistry, SkillRunner, SourceUnitObservationService, WorkspaceRepository } from '@braidhq/core';
+import { OpenAPIHono } from '@hono/zod-openapi';
 export interface SkillsRouterDeps {
     readonly skillRegistry: SkillRegistry;
     readonly skillRunner: SkillRunner;
     readonly workspaceRepository: WorkspaceRepository;
+    /**
+     * Records a SourceUnitObservation after a successful per-unit run,
+     * named by the active ontology's `perUnit.skillId` binding.
+     */
+    readonly sourceUnitObservationService: SourceUnitObservationService;
+    /**
+     * Backfills a run's terminal exit state.
+     * A run can finish after `skillRunner.start` returns,
+     * but before the hook subscribes, missing the terminal event.
+     * Without it the hook only listens forward, so that race leaks silently.
+     */
+    readonly runRepository: RunRepository;
+    /**
+     * Resolves the active ontology for the workspace,
+     * so the route reads its `batch.perUnit.skillId`,
+     * instead of hard-coding the extract skill.
+     */
+    readonly pluginRegistry: PluginRegistry;
 }
-export declare function createSkillsRouter(deps: SkillsRouterDeps): Hono;
+export declare function createSkillsRouter(deps: SkillsRouterDeps): OpenAPIHono;
 //# sourceMappingURL=skills.d.ts.map

package/dist/routes/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/routes/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACpB,MAAM,eAAe,CAAA;AAItB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAW3B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;CAClD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAiC/D"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/routes/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EACX,4BAA4B,EAE5B,mBAAmB,EACpB,MAAM,eAAe,CAAA;AAItB,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAmC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;IACjD;;;OAGG;IACH,QAAQ,CAAC,4BAA4B,EAAE,4BAA4B,CAAA;IACnE;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;CACxC;AAyDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAiFtE"}