@braidhq/server 0.0.1 → 0.2.0

package/dist/routes/skills.js

@@ -1,42 +1,244 @@
-import { SkillId as SkillIdSchema } from '@braidhq/schema';
-import { zValidator } from '@hono/zod-validator';
-import { Hono } from 'hono';
-import { z } from 'zod';
+import { createLogger, ValidationError } from '@braidhq/core';
+import { SkillId as SkillIdSchema, SkillManifest, SkillRunId, SourceId } from '@braidhq/schema';
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
+import { extractBearerToken } from '../middleware/auth.js';
+import { requirePermission } from '../middleware/workspaceAccess.js';
 import { getWorkspaceId } from '../middleware/workspaceId.js';
+import { NotFoundResponse, WorkspaceIdParam } from './_shared.js';
 import { loadWorkspaceById } from './helpers.js';
-const RunBodySchema = z.object({
+const SourceUnitRef = z.object({
+    sourceId: SourceId,
+    path: z.string().min(1),
+}).openapi('SourceUnitRef');
+const RunBody = z.object({
     args: z.string().default(''),
-    /** Continue an existing claude conversation (from a prior session-started event). */
+    // Continue a prior claude conversation from a session-started event.
     resumeSessionId: z.string().min(1).optional(),
+    // Identifies the source unit this run will process,
+    // so the server records an observation against it after a clean run.
+    // Studio sends this when the user picks a `source-intent` option.
+    // Only `ddd:extract` consumes it today, other skills ignore it.
+    sourceUnit: SourceUnitRef.optional(),
+}).openapi('SkillRunBody');
+const SkillIdParam = WorkspaceIdParam.extend({
+    skillId: SkillIdSchema.openapi({ param: { name: 'skillId', in: 'path' } }),
+});
+const SkillListResponse = z.object({
+    items: z.array(SkillManifest),
+}).openapi('SkillListResponse');
+const RunCreatedResponse = z.object({
+    runId: SkillRunId,
+}).openapi('RunCreatedResponse');
+const listSkillsRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listSkills',
+    summary: 'List skills available in a workspace (builtin + plugin + workspace + extension overlays).',
+    tags: ['skills'],
+    request: { params: WorkspaceIdParam },
+    responses: {
+        200: {
+            description: 'The skill list.',
+            content: { 'application/json': { schema: SkillListResponse } },
+        },
+    },
+});
+const getSkillRoute = createRoute({
+    method: 'get',
+    path: '/{skillId}',
+    operationId: 'getSkill',
+    summary: 'Fetch a single skill manifest by id.',
+    tags: ['skills'],
+    request: { params: SkillIdParam },
+    responses: {
+        200: {
+            description: 'The skill manifest.',
+            content: { 'application/json': { schema: SkillManifest } },
+        },
+        404: NotFoundResponse,
+    },
+});
+const runSkillRoute = createRoute({
+    method: 'post',
+    path: '/{skillId}/run',
+    operationId: 'runSkill',
+    summary: 'Fire-and-forget run of a skill. Returns the runId to subscribe to via SSE.',
+    description: 'The subprocess + event drain runs in the background. Events are persisted to JSONL and broadcast to subscribers regardless of whether the client stays connected. Tail progress via GET /workspaces/{workspaceId}/runs/{runId}/events.',
+    tags: ['skills'],
+    request: {
+        params: SkillIdParam,
+        body: { content: { 'application/json': { schema: RunBody } } },
+    },
+    responses: {
+        202: {
+            description: 'The accepted run id.',
+            content: { 'application/json': { schema: RunCreatedResponse } },
+        },
+        403: {
+            description: 'Caller is not permitted to run this skill in this workspace.',
+            content: { 'application/problem+json': { schema: z.object({}).passthrough() } },
+        },
+        404: NotFoundResponse,
+    },
 });
 export function createSkillsRouter(deps) {
-    const router = new Hono();
-    router.get('/', async (context) => {
+    const router = new OpenAPIHono();
+    // skill.run is the only capability needing a per-request resource,
+    // the skill manifest.
+    // The builder fetches workspace and manifest once,
+    // then hands the result to the policy check.
+    router.use('/:skillId/run', requirePermission('skill.run', async (context) => {
+        const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
+        const skillId = SkillIdSchema.parse(context.req.param('skillId'));
+        const manifest = await deps.skillRegistry.get(workspace, skillId);
+        return { skill: manifest.toData().frontmatter, skillId };
+    }));
+    router.openapi(listSkillsRoute, async (context) => {
         const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
         const manifests = await deps.skillRegistry.list(workspace);
         return context.json({
             items: manifests.map(manifest => manifest.toData()),
-        });
+        }, 200);
     });
-    router.get('/:skillId', async (context) => {
+    router.openapi(getSkillRoute, async (context) => {
         const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
-        const skillId = SkillIdSchema.parse(context.req.param('skillId'));
+        const { skillId } = context.req.valid('param');
         const manifest = await deps.skillRegistry.get(workspace, skillId);
-        return context.json(manifest.toData());
+        return context.json(manifest.toData(), 200);
     });
-    // Fire-and-forget run. The subprocess + event drain runs in the background;
-    // events are persisted to JSONL and broadcast to subscribers regardless of
-    // whether the client stays connected. The client tails progress via
-    // `GET /workspaces/:ws/runs/:runId/events`, which can be opened and closed
-    // freely without affecting the run.
-    router.post('/:skillId/run', zValidator('json', RunBodySchema), async (context) => {
+    router.openapi(runSkillRoute, async (context) => {
         const workspace = await loadWorkspaceById(getWorkspaceId(context), deps.workspaceRepository);
-        const skillId = SkillIdSchema.parse(context.req.param('skillId'));
-        const { args, resumeSessionId } = context.req.valid('json');
-        const options = resumeSessionId ? { resumeSessionId } : undefined;
+        const { skillId } = context.req.valid('param');
+        const { args, resumeSessionId, sourceUnit } = context.req.valid('json');
+        const callerToken = extractBearerToken(context);
+        const options = {
+            ...(resumeSessionId ? { resumeSessionId } : {}),
+            ...(callerToken ? { callerToken } : {}),
+        };
+        const perUnitSkillId = resolvePerUnitSkillId(deps.pluginRegistry, workspace);
+        if (sourceUnit) {
+            // The sourceUnit applies only to the ontology's per-unit step,
+            // so reject it for any other skill.
+            // Otherwise the run-skill route advertises support uniformly,
+            // then silently drops it for every skill except extract.
+            if (!perUnitSkillId || skillId !== perUnitSkillId) {
+                throw new ValidationError(perUnitSkillId
+                    ? `The \`sourceUnit\` field is only accepted for "${perUnitSkillId}", the active ontology's per-unit skill.`
+                    : `The \`sourceUnit\` field is not accepted, the active ontology declares no per-unit skill.`);
+            }
+            // Reject a sourceUnit whose sourceId is not an intent source here.
+            // Recording against a ghost sourceId would pollute the ledger,
+            // and confuse the Reactor and BatchService diff.
+            const known = workspace.sources.find(s => s.id === sourceUnit.sourceId && s.role === 'intent');
+            if (!known)
+                throw new ValidationError(`Source-unit id "${sourceUnit.sourceId}" does not name an intent source in workspace "${workspace.id}"`);
+        }
         const runId = await deps.skillRunner.start(workspace, skillId, args, options);
+        // The observation hook runs in the background,
+        // so the route still returns 202 promptly.
+        // Any failure (skill error, cancel, repository write) is logged,
+        // but does not bubble up to the client.
+        if (sourceUnit && perUnitSkillId && skillId === perUnitSkillId) {
+            void recordObservationOnSuccess({
+                runner: deps.skillRunner,
+                runRepository: deps.runRepository,
+                sourceUnitObservationService: deps.sourceUnitObservationService,
+                workspace,
+                runId,
+                sourceUnit,
+            });
+        }
         return context.json({ runId }, 202);
     });
     return router;
 }
+function resolvePerUnitSkillId(pluginRegistry, workspace) {
+    const ontology = pluginRegistry.findOntology(workspace.productManifest.ontologyId);
+    return ontology?.batch?.perUnit?.skillId;
+}
+const recordLogger = createLogger('skills.recordObservation');
+// Stop waiting after this many ms, even if no terminal event arrives.
+// Real ddd:extract runs settle in seconds to minutes.
+// This backstops orphan subscriptions on crashed runners,
+// or upstream queues that quietly drop events.
+const OBSERVATION_TIMEOUT_MS = 60 * 60 * 1000;
+// Subscribe to a run and wait for it to terminate.
+// Record a SourceUnitObservation only if it exits cleanly (code 0).
+// On cancellation, non-zero exit, error, or timeout,
+// the previously recorded state is left untouched.
+//
+// Two race-safety measures matter here.
+// First, we subscribe before checking `isActive`.
+// A run finishing between those steps would miss the terminal event,
+// so we backfill from the persisted RunRecord exit code.
+// Second, the Promise has a hard timeout.
+// A run that never emits a terminal event cannot leak the closure.
+async function recordObservationOnSuccess(params) {
+    const { runner, runRepository, sourceUnitObservationService, workspace, runId, sourceUnit } = params;
+    const workspaceId = workspace.id;
+    try {
+        const outcome = await waitForTerminalOutcome(runner, runRepository, workspace, runId);
+        if (outcome !== 'success')
+            return;
+        await sourceUnitObservationService.recordObservation(workspaceId, sourceUnit.sourceId, sourceUnit.path, runId);
+    }
+    catch (err) {
+        recordLogger.warn({
+            runId,
+            workspaceId,
+            sourceId: sourceUnit.sourceId,
+            path: sourceUnit.path,
+            err: err instanceof Error ? err.message : String(err),
+        }, 'failed to record observation after ddd:extract run');
+    }
+}
+async function waitForTerminalOutcome(runner, runRepository, workspace, runId) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let timeout;
+        // Subscribe first, so future events from a still-active run reach us.
+        // Checking `isActive` first would race.
+        // A run finishing between the two steps would miss the terminal event.
+        const sub = runner.subscribe(runId, (event) => {
+            if (event.type === 'completed')
+                settle(event.exitCode === 0 ? 'success' : 'failure');
+            else if (event.type === 'error')
+                settle('failure');
+        });
+        function settle(outcome) {
+            if (settled)
+                return;
+            settled = true;
+            sub.unsubscribe();
+            if (timeout)
+                clearTimeout(timeout);
+            resolve(outcome);
+        }
+        // Backfill for an already-finished run.
+        // Its subscription never receives a terminal event,
+        // because the runner clears subscribers when drain exits.
+        // Read the persisted RunRecord instead.
+        if (!runner.isActive(runId)) {
+            ;
+            (async () => {
+                try {
+                    const records = await runRepository.listRecords(workspace);
+                    const record = records.find(r => r.runId === runId);
+                    if (record?.exitCode !== undefined)
+                        settle(record.exitCode === 0 ? 'success' : 'failure');
+                    else
+                        settle('failure');
+                }
+                catch {
+                    settle('failure');
+                }
+            })();
+        }
+        // Timeout backstop. .unref() lets Node exit while the timer pends.
+        // Observation recording is best-effort,
+        // not a reason to hold the process open.
+        timeout = setTimeout(() => settle('failure'), OBSERVATION_TIMEOUT_MS);
+        timeout.unref?.();
+    });
+}
 //# sourceMappingURL=skills.js.map

package/dist/routes/skills.js.map

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

package/dist/routes/sourceLoaders.d.ts

@@ -0,0 +1,7 @@
+import type { PluginRegistry } from '@braidhq/core';
+import { OpenAPIHono } from '@hono/zod-openapi';
+export interface SourceLoadersRouterDeps {
+    pluginRegistry: PluginRegistry;
+}
+export declare function createSourceLoadersRouter(deps: SourceLoadersRouterDeps): OpenAPIHono;
+//# sourceMappingURL=sourceLoaders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLoaders.d.ts","sourceRoot":"","sources":["../../src/routes/sourceLoaders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EAAe,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE5D,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,cAAc,CAAA;CAC/B;AAiBD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,uBAAuB,GAAG,WAAW,CAcpF"}

package/dist/routes/sourceLoaders.js

@@ -0,0 +1,30 @@
+import { ListSourceLoadersResponse } from '@braidhq/schema';
+import { createRoute, OpenAPIHono } from '@hono/zod-openapi';
+const listSourceLoadersRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listSourceLoaders',
+    summary: 'List source-loader plugins registered on this server.',
+    description: 'Studio uses this to populate its loader dropdown without hardcoding `git / github / gdrive`. The list reflects what `composeFsApp` registered plus any `extraSourceLoaderPlugins` the caller passed in. The `manual` choice in the Studio UI is not a plugin and is not returned here.',
+    tags: ['plugins'],
+    responses: {
+        200: {
+            description: 'Source-loader plugins currently registered.',
+            content: { 'application/json': { schema: ListSourceLoadersResponse } },
+        },
+    },
+});
+export function createSourceLoadersRouter(deps) {
+    const router = new OpenAPIHono();
+    router.openapi(listSourceLoadersRoute, (context) => {
+        const plugins = deps.pluginRegistry.sourceLoaders();
+        const loaders = plugins.map(plugin => ({
+            kind: plugin.kind,
+            pluginId: plugin.id,
+            webhook: plugin.webhook !== undefined,
+        }));
+        return context.json(ListSourceLoadersResponse.parse({ loaders }), 200);
+    });
+    return router;
+}
+//# sourceMappingURL=sourceLoaders.js.map

package/dist/routes/sourceLoaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLoaders.js","sourceRoot":"","sources":["../../src/routes/sourceLoaders.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAM5D,MAAM,sBAAsB,GAAG,WAAW,CAAC;IACzC,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,WAAW,EAAE,mBAAmB;IAChC,OAAO,EAAE,uDAAuD;IAChE,WAAW,EAAE,wRAAwR;IACrS,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,6CAA6C;YAC1D,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE,EAAE;SACvE;KACF;CACF,CAAC,CAAA;AAEF,MAAM,UAAU,yBAAyB,CAAC,IAA6B;IACrE,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAA;IAEhC,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,EAAE;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAA;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS;SACtC,CAAC,CAAC,CAAA;QACH,OAAO,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/routes/sourceUnitObservations.d.ts

@@ -0,0 +1,20 @@
+import type { IntentLister, SourceUnitDigest, SourceUnitObservationService, WorkspaceService } from '@braidhq/core';
+import { OpenAPIHono } from '@hono/zod-openapi';
+export interface SourceUnitObservationsRouterDeps {
+    sourceUnitObservationService: SourceUnitObservationService;
+    /**
+     * Optional `(workspaceService, intentLister, digest)` triple.
+     * When all three are present, the router exposes the `:sourceId/diff` route.
+     * When any is missing, the route is simply not registered,
+     * so callers see a 404 from Hono's router.
+     * That matches the unsupported-operation semantics,
+     * other partially-wired surfaces follow (Batch, Skills).
+     */
+    diffSupport?: {
+        workspaceService: WorkspaceService;
+        intentLister: IntentLister;
+        digest: SourceUnitDigest;
+    };
+}
+export declare function createSourceUnitObservationsRouter(deps: SourceUnitObservationsRouterDeps): OpenAPIHono;
+//# sourceMappingURL=sourceUnitObservations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceUnitObservations.d.ts","sourceRoot":"","sources":["../../src/routes/sourceUnitObservations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGnH,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAkB/D,MAAM,WAAW,gCAAgC;IAC/C,4BAA4B,EAAE,4BAA4B,CAAA;IAC1D;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE;QACZ,gBAAgB,EAAE,gBAAgB,CAAA;QAClC,YAAY,EAAE,YAAY,CAAA;QAC1B,MAAM,EAAE,gBAAgB,CAAA;KACzB,CAAA;CACF;AA0CD,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,gCAAgC,GAAG,WAAW,CAgCtG"}

package/dist/routes/sourceUnitObservations.js

@@ -0,0 +1,80 @@
+import { computeSourceDiff } from '@braidhq/core';
+import { SourceId, SourceUnitDiff, SourceUnitObservation } from '@braidhq/schema';
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
+import { getWorkspaceId } from '../middleware/workspaceId.js';
+import { NotFoundResponse, ValidationFailureResponse, WorkspaceIdParam } from './_shared.js';
+const ListQuery = z.object({
+    sourceId: SourceId.optional().openapi({ description: 'Restrict to one source.' }),
+});
+const ListResponse = z.object({
+    items: z.array(SourceUnitObservation),
+}).openapi('SourceUnitObservationListResponse');
+const SourceIdParam = WorkspaceIdParam.extend({
+    sourceId: SourceId.openapi({ param: { name: 'sourceId', in: 'path' } }),
+});
+const DiffResponse = SourceUnitDiff.openapi('SourceUnitDiffResponse');
+const listRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listSourceUnitObservations',
+    summary: 'List recorded observations per source unit for a workspace.',
+    description: 'Returns the framework\'s current view of each source unit '
+        + 'last seen by an extract run. One entry per (sourceId, path). Used '
+        + 'by Studio to display per-unit freshness and by Reactor to compute '
+        + 'what needs re-extraction.',
+    tags: ['source-unit-states'],
+    request: {
+        params: WorkspaceIdParam,
+        query: ListQuery,
+    },
+    responses: {
+        200: {
+            description: 'The recorded observations.',
+            content: { 'application/json': { schema: ListResponse } },
+        },
+        400: ValidationFailureResponse,
+    },
+});
+const diffRoute = createRoute({
+    method: 'get',
+    path: '/{sourceId}/diff',
+    operationId: 'getSourceUnitDiff',
+    summary: 'Diff a source\'s current units on disk against the recorded ledger.',
+    description: 'Returns the partition (`new`, `changed`, `unchanged`, `orphaned`) the Reactor uses internally to decide what to re-extract. Studio\'s Actions form consumes the same shape to render per-option badges on the source-intent picker.',
+    tags: ['source-unit-states'],
+    request: { params: SourceIdParam },
+    responses: {
+        200: {
+            description: 'The diff partition.',
+            content: { 'application/json': { schema: DiffResponse } },
+        },
+        404: NotFoundResponse,
+    },
+});
+export function createSourceUnitObservationsRouter(deps) {
+    const router = new OpenAPIHono();
+    router.openapi(listRoute, async (context) => {
+        const workspaceId = getWorkspaceId(context);
+        const { sourceId } = context.req.valid('query');
+        const items = sourceId
+            ? await deps.sourceUnitObservationService.listBySource(workspaceId, sourceId)
+            : await deps.sourceUnitObservationService.listByWorkspace(workspaceId);
+        return context.json({ items: [...items] }, 200);
+    });
+    if (deps.diffSupport) {
+        const { workspaceService, intentLister, digest } = deps.diffSupport;
+        router.openapi(diffRoute, async (context) => {
+            const workspaceId = getWorkspaceId(context);
+            const { sourceId } = context.req.valid('param');
+            const workspace = await workspaceService.findById(workspaceId);
+            const diff = await computeSourceDiff({
+                intentLister,
+                digest,
+                sourceUnitObservationService: deps.sourceUnitObservationService,
+            }, workspace, sourceId);
+            return context.json(diff, 200);
+        });
+    }
+    return router;
+}
+//# sourceMappingURL=sourceUnitObservations.js.map

package/dist/routes/sourceUnitObservations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceUnitObservations.js","sourceRoot":"","sources":["../../src/routes/sourceUnitObservations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE5F,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;CAClF,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACtC,CAAC,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAA;AAE/C,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;CACxE,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;AAmBrE,MAAM,SAAS,GAAG,WAAW,CAAC;IAC5B,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,WAAW,EAAE,4BAA4B;IACzC,OAAO,EAAE,6DAA6D;IACtE,WAAW,EAAE,4DAA4D;UACrE,oEAAoE;UACpE,oEAAoE;UACpE,2BAA2B;IAC/B,IAAI,EAAE,CAAC,oBAAoB,CAAC;IAC5B,OAAO,EAAE;QACP,MAAM,EAAE,gBAAgB;QACxB,KAAK,EAAE,SAAS;KACjB;IACD,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,4BAA4B;YACzC,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE;SAC1D;QACD,GAAG,EAAE,yBAAyB;KAC/B;CACF,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG,WAAW,CAAC;IAC5B,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,mBAAmB;IAChC,OAAO,EAAE,qEAAqE;IAC9E,WAAW,EAAE,qOAAqO;IAClP,IAAI,EAAE,CAAC,oBAAoB,CAAC;IAC5B,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;IAClC,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,qBAAqB;YAClC,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE;SAC1D;QACD,GAAG,EAAE,gBAAgB;KACtB;CACF,CAAC,CAAA;AAEF,MAAM,UAAU,kCAAkC,CAAC,IAAsC;IACvF,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAA;IAEhC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC1C,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC/C,MAAM,KAAK,GAAG,QAAQ;YACpB,CAAC,CAAC,MAAM,IAAI,CAAC,4BAA4B,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC;YAC7E,CAAC,CAAC,MAAM,IAAI,CAAC,4BAA4B,CAAC,eAAe,CAAC,WAAW,CAAC,CAAA;QACxE,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAA;QACnE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1C,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;YAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC/C,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YAC9D,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAClC;gBACE,YAAY;gBACZ,MAAM;gBACN,4BAA4B,EAAE,IAAI,CAAC,4BAA4B;aAChE,EACD,SAAS,EACT,QAAQ,CACT,CAAA;YACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAChC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/routes/sourceWebhooks.d.ts

@@ -0,0 +1,26 @@
+import type { PluginRegistry, SourceLoaderRunner, WorkspaceService } from '@braidhq/core';
+import type { SecretStore } from '../infrastructure/secrets/SecretStore.js';
+import { OpenAPIHono } from '@hono/zod-openapi';
+import { Hono } from 'hono';
+export interface GithubWebhookReceiverDeps {
+    readonly workspaceService: WorkspaceService;
+    readonly sourceLoaderRunner: SourceLoaderRunner;
+    readonly secretStore: SecretStore;
+    readonly pluginRegistry: PluginRegistry;
+}
+export declare function createGithubWebhookReceiver(deps: GithubWebhookReceiverDeps): Hono;
+export interface SourceWebhooksAdminDeps {
+    readonly workspaceService: WorkspaceService;
+    readonly secretStore: SecretStore;
+    readonly pluginRegistry: PluginRegistry;
+    /**
+     * Base URL under which the public webhook receiver is reachable.
+     * Required so the admin response can return an absolute URL,
+     * that the user pastes straight into GitHub's webhook settings.
+     * When unset (composeApp in tests), the admin endpoints return 503.
+     * Better than returning a relative path Studio would render verbatim.
+     */
+    readonly apiUrl?: string;
+}
+export declare function createSourceWebhooksAdminRouter(deps: SourceWebhooksAdminDeps): OpenAPIHono;
+//# sourceMappingURL=sourceWebhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceWebhooks.d.ts","sourceRoot":"","sources":["../../src/routes/sourceWebhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAElB,gBAAgB,EACjB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAK3E,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AA0C3B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;CACxC;AA6FD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAgFjF;AAYD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AA2DD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,uBAAuB,GAAG,WAAW,CAoC1F"}