@cat-factory/server 0.64.3 → 0.65.2

package/dist/preview/previewJobBuilder.js

@@ -0,0 +1,89 @@
+import { ConflictError, NotFoundError, PREVIEW_HARNESS_JOB_ID } from '@cat-factory/kernel';
+import { boundServiceFrameIds, indexLiveServiceEnvUrls, resolveFrontendBindings, } from '@cat-factory/orchestration';
+import { buildFrontendInfraSpec } from '../agents/prompts.js';
+// Builds the harness `mode: 'preview'` job for a `frontend` frame — the server-layer half of
+// slice 5c. It mirrors the slice of `ContainerAgentExecutor.buildJobBody` a preview needs
+// (resolve the frame's repo + a GitHub token + a proxy session token, then the frontend infra
+// spec) but runs NO agent, so it carries none of the model-routing / prompt machinery. The
+// facade wires this next to where it builds the ContainerAgentExecutor (same seams); the
+// runtime-neutral PreviewService drives the resulting plan through a PreviewTransport.
+/** The git origin (clone URL + provider) for a preview's repo; defaults to github.com. */
+const githubRepoOrigin = (repo) => ({
+    cloneUrl: `https://github.com/${repo.owner}/${repo.name}.git`,
+    provider: 'github',
+});
+/**
+ * Resolve the branch a preview is built from (the `frontendConfig.branch`):
+ *   - `default` / absent → the repo's default branch (the baseline).
+ *   - `{ kind: 'task', fromTaskBlockId }` → that task's PR branch when it has one, else the
+ *     repo default (the branch may not exist on the remote yet — never point the clone at a ref
+ *     that isn't there).
+ */
+async function resolveBranch(branch, repo, workspaceId, blockRepository) {
+    if (!branch || branch.kind === 'default')
+        return repo.baseBranch;
+    const task = await blockRepository.get(workspaceId, branch.fromTaskBlockId);
+    return task?.pullRequest?.branch ?? repo.baseBranch;
+}
+/**
+ * Build the {@link BuildPreviewJob} seam for a facade. Throws a `NotFoundError` for an unknown
+ * frame, a `ConflictError` for a non-`frontend` frame / one without a `frontendConfig`, or a
+ * `ConflictError` when no repo is connected — all mapped to a clean 4xx by the controller.
+ */
+export function makePreviewJobBuilder(deps) {
+    return async ({ workspaceId, frameId }) => {
+        const frame = await deps.blockRepository.get(workspaceId, frameId);
+        if (!frame)
+            throw new NotFoundError('frame', frameId);
+        if (frame.level !== 'frame' || frame.type !== 'frontend' || !frame.frontendConfig) {
+            throw new ConflictError('A browsable preview is only available for a frontend frame with a frontend config.');
+        }
+        const config = frame.frontendConfig;
+        // Resolve each backend binding to a live service env URL (else WireMock) — the SAME
+        // frame-keyed, single-read resolution the UI-test flow uses (no per-binding point read).
+        const serviceFrameIds = boundServiceFrameIds(config);
+        const handles = deps.environmentRegistryRepository && serviceFrameIds.size > 0
+            ? await deps.environmentRegistryRepository.listByWorkspace(workspaceId)
+            : [];
+        const bindings = resolveFrontendBindings(config, indexLiveServiceEnvUrls(handles, serviceFrameIds));
+        const infra = buildFrontendInfraSpec({ config, bindings });
+        const servePort = infra.servePort;
+        const repo = await deps.resolveRepoTarget(workspaceId, frameId);
+        if (!repo) {
+            throw new ConflictError('No connected GitHub repository was found for this frontend frame.');
+        }
+        const ghToken = await deps.mintInstallationToken(repo.installationId);
+        const origin = (deps.resolveRepoOrigin ?? githubRepoOrigin)(repo);
+        const branch = await resolveBranch(config.branch, repo, workspaceId, deps.blockRepository);
+        // A preview runs no agent, so the session is model-agnostic and never used for an LLM
+        // call — it exists only to satisfy the harness's auth parser (proxyBaseUrl + sessionToken).
+        const sessionToken = await deps.sessionService.mint({
+            workspaceId,
+            executionId: `preview-${frameId}`,
+            agentKind: 'preview',
+            provider: 'none',
+            model: 'none',
+        });
+        const spec = {
+            jobId: PREVIEW_HARNESS_JOB_ID,
+            mode: 'preview',
+            harness: 'pi',
+            proxyBaseUrl: deps.proxyBaseUrl,
+            sessionToken,
+            ghToken,
+            repo: {
+                owner: repo.owner,
+                name: repo.name,
+                baseBranch: repo.baseBranch,
+                cloneUrl: origin.cloneUrl,
+                provider: origin.provider,
+                ...(repo.serviceDirectory ? { serviceDirectory: repo.serviceDirectory } : {}),
+            },
+            branch,
+            infra,
+            ...(deps.githubApiBase ? { githubApiBase: deps.githubApiBase } : {}),
+        };
+        return { jobId: PREVIEW_HARNESS_JOB_ID, spec, servePort };
+    };
+}
+//# sourceMappingURL=previewJobBuilder.js.map

package/dist/preview/previewJobBuilder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/server",
-  "version": "0.64.3",
+  "version": "0.65.2",
   "description": "Runtime-neutral HTTP layer for the Agent Architecture Board: the Hono controllers, middleware (auth/authz/CORS/error), request helpers and the gateway seams shared by every deployment facade (Cloudflare Worker, Node service).",
   "repository": {
     "type": "git",
@@ -30,13 +30,13 @@
     "hono": "^4.12.27",
     "pino": "^10.3.1",
     "valibot": "^1.4.2",
-    "@cat-factory/contracts": "0.78.0",
-    "@cat-factory/integrations": "0.52.1",
-    "@cat-factory/agents": "0.26.0",
-    "@cat-factory/prompt-fragments": "0.9.33",
-    "@cat-factory/orchestration": "0.55.0",
-    "@cat-factory/spend": "0.10.63",
-    "@cat-factory/kernel": "0.68.0"
+    "@cat-factory/agents": "0.26.4",
+    "@cat-factory/integrations": "0.53.2",
+    "@cat-factory/contracts": "0.80.1",
+    "@cat-factory/kernel": "0.69.2",
+    "@cat-factory/orchestration": "0.57.1",
+    "@cat-factory/prompt-fragments": "0.9.37",
+    "@cat-factory/spend": "0.10.67"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",