@cat-factory/worker 0.6.0

package/dist/infrastructure/ai/ContainerRepoScanner.js

@@ -0,0 +1,115 @@
+import {} from '@cat-factory/kernel';
+import { boardScanLogic } from '@cat-factory/orchestration';
+// Unlike `/run`, scan/bootstrap stay synchronous request/response. This caps how
+// long the Worker will wait so a wedged container can't block the caller forever;
+// the harness's shared git timeouts bound the underlying git operations too.
+const CONTAINER_SYNC_TIMEOUT_MS = 30 * 60_000;
+/** The role prompt the scanner agent runs under inside the container. */
+const SCAN_SYSTEM_PROMPT = 'You are a Domain-Driven Design architect mapping an existing repository. You have ' +
+    'a fresh, read-only clone. Decompose it into ONE top-level service and the modules ' +
+    'inside it, where each module is a DOMAIN — a cohesive area of the BUSINESS, in the ' +
+    'language of the problem space (a DDD bounded context / aggregate / subdomain). ' +
+    'Name modules after business concepts, not technical layers. ' +
+    'A module MUST represent a business capability or domain model (e.g. Billing, ' +
+    'Catalog, Ordering, Identity), NOT a technical layer or shape: "api", "routes", ' +
+    '"controllers", "utils", "helpers", "lib", "common", "config", "types", "models", ' +
+    '"db" and the like are NOT domains and MUST NOT be modules. ' +
+    'Group the genuinely non-business, technical/cross-cutting plumbing (persistence ' +
+    'wiring, HTTP/transport, logging, configuration, auth middleware, build/deploy, ' +
+    'shared utilities) into a SINGLE module named "infrastructure" rather than ' +
+    'scattering it into many technical modules. ' +
+    'Prefer organising code by domain (the ubiquitous language) over organising by ' +
+    'file type. Anchor every node to the codebase with explicit repo-relative ' +
+    'file/directory references. Keep names short and descriptive. ' +
+    'Respond with ONLY a JSON object of shape {"type","name","summary","references":[],' +
+    '"modules":[{"name","summary","references":[]}]} — no prose, no code fences.';
+/**
+ * A {@link RepoScanner} that performs the side-effecting half of a "scan
+ * repository" run: it spins up a per-run Cloudflare Container that clones the
+ * repository read-only, has the scanner agent decompose it into the canonical
+ * service → modules blueprint (with codebase references), and returns
+ * that structure. The agent's JSON is coerced into a well-formed tree here.
+ *
+ * Secrets never reach the container image: the per-run GitHub installation token
+ * and the model-locked LLM-proxy session token are minted here and handed over in
+ * the dispatch body, exactly as the implementation executor and bootstrapper do.
+ */
+export class ContainerRepoScanner {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async scan(request) {
+        const installation = await this.deps.installationRepository.getByWorkspace(request.workspaceId);
+        if (!installation || installation.deletedAt) {
+            throw new Error(`Workspace '${request.workspaceId}' is not connected to GitHub`);
+        }
+        if (!isProxyableProvider(this.deps.model.provider)) {
+            throw new Error(`Repository scanning needs a model the LLM proxy can serve ` +
+                `(Workers AI, or a direct OpenAI-compatible provider); ` +
+                `'${this.deps.model.provider}' is not supported.`);
+        }
+        const ghToken = await this.deps.mintInstallationToken(installation.installationId);
+        const sessionToken = await this.deps.sessionService.mint({
+            workspaceId: request.workspaceId,
+            executionId: `scan-${request.repo.owner}-${request.repo.name}`,
+            agentKind: 'architect',
+            provider: this.deps.model.provider,
+            model: this.deps.model.model,
+        });
+        const webBase = (this.deps.webBaseUrl ?? 'https://github.com').replace(/\/+$/, '');
+        const cloneUrl = `${webBase}/${request.repo.owner}/${request.repo.name}.git`;
+        const body = {
+            systemPrompt: SCAN_SYSTEM_PROMPT,
+            instructions: request.instructions || 'Map the repository into the blueprint structure.',
+            model: this.deps.model.model,
+            proxyBaseUrl: this.deps.proxyBaseUrl,
+            sessionToken,
+            ghToken,
+            repo: {
+                owner: request.repo.owner,
+                name: request.repo.name,
+                cloneUrl,
+            },
+            ...(this.deps.githubApiBase ? { githubApiBase: this.deps.githubApiBase } : {}),
+        };
+        // One container instance per repo scan (keyed by owner/name), mirroring the
+        // per-run implementation and bootstrap containers.
+        const key = `scan-${request.repo.owner}/${request.repo.name}`;
+        const stub = this.deps.container.get(this.deps.container.idFromName(key));
+        const res = await stub.fetch('http://container/scan', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(CONTAINER_SYNC_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            throw new Error(`Scan container failed (HTTP ${res.status}): ${await safeText(res)}`);
+        }
+        const result = (await res.json());
+        if (result.error)
+            throw new Error(`Scan failed: ${result.error}`);
+        const service = boardScanLogic.coerceService(result.service, request.repo.name);
+        if (!service) {
+            throw new Error('Scan produced no usable blueprint');
+        }
+        return { source: 'llm', service };
+    }
+}
+/** Providers the LLM proxy can serve (mirrors ContainerAgentExecutor). */
+function isProxyableProvider(provider) {
+    return (provider === 'workers-ai' ||
+        provider === 'qwen' ||
+        provider === 'deepseek' ||
+        provider === 'moonshot' ||
+        provider === 'openai');
+}
+async function safeText(res) {
+    try {
+        return (await res.text()).slice(0, 500);
+    }
+    catch {
+        return '(no body)';
+    }
+}
+//# sourceMappingURL=ContainerRepoScanner.js.map

package/dist/infrastructure/ai/ContainerRepoScanner.js.map

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

package/dist/infrastructure/ai/LlmFragmentSelector.d.ts

@@ -0,0 +1,2 @@
+export { LlmFragmentSelector, type LlmFragmentSelectorDependencies } from '@cat-factory/agents';
+//# sourceMappingURL=LlmFragmentSelector.d.ts.map

package/dist/infrastructure/ai/LlmFragmentSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmFragmentSelector.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ai/LlmFragmentSelector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,+BAA+B,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/infrastructure/ai/LlmFragmentSelector.js

@@ -0,0 +1,4 @@
+// Moved to the runtime-neutral @cat-factory/agents package (so the Node service runs
+// the same LLM fragment selector); re-exported here for existing Worker imports.
+export { LlmFragmentSelector } from '@cat-factory/agents';
+//# sourceMappingURL=LlmFragmentSelector.js.map

package/dist/infrastructure/ai/LlmFragmentSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmFragmentSelector.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/LlmFragmentSelector.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,iFAAiF;AACjF,OAAO,EAAE,mBAAmB,EAAwC,MAAM,qBAAqB,CAAA"}

package/dist/infrastructure/ai/RunnerJobClient.d.ts

@@ -0,0 +1,2 @@
+export { RunnerJobClient, type ResolveRunnerTransport } from '@cat-factory/server';
+//# sourceMappingURL=RunnerJobClient.d.ts.map

package/dist/infrastructure/ai/RunnerJobClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunnerJobClient.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ai/RunnerJobClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/infrastructure/ai/RunnerJobClient.js

@@ -0,0 +1,5 @@
+// Moved to the runtime-neutral @cat-factory/server package (so the Node service
+// drives container jobs through the same plumbing); re-exported here for existing
+// Worker imports (the bootstrapper + the implementation executor).
+export { RunnerJobClient } from '@cat-factory/server';
+//# sourceMappingURL=RunnerJobClient.js.map

package/dist/infrastructure/ai/RunnerJobClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunnerJobClient.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/RunnerJobClient.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAA+B,MAAM,qBAAqB,CAAA"}

package/dist/infrastructure/ai/WorkersAiLlmUpstream.d.ts

@@ -0,0 +1,28 @@
+import type { LlmInProcessRequest, LlmTokenUsage, LlmUpstream, LlmUpstreamEndpoint } from '@cat-factory/server';
+import type { Env } from '../env';
+export declare class WorkersAiLlmUpstream implements LlmUpstream {
+    private readonly env;
+    constructor(env: Env);
+    resolveOpenAiCompatible(provider: string): LlmUpstreamEndpoint | null;
+    runInProcess(request: LlmInProcessRequest): Promise<Response> | null;
+}
+/**
+ * Build the ordered OpenAI `chat.completion.chunk` payloads for a single, completed
+ * generation, replayed as a stream: a role chunk, ONE content chunk (only when there
+ * is text — never per-token, which is the doubling regression this guards against),
+ * the tool-call chunk (if any), the finish chunk, then a trailing usage-only chunk
+ * (matching `stream_options.include_usage`). The `[DONE]` sentinel is appended by the
+ * caller. Pure + synchronous so the streamed shape can be unit-tested without the
+ * `AI` binding or `generateText`.
+ */
+export declare function buildStreamChunks(meta: {
+    id: string;
+    created: number;
+    model: string;
+}, gen: {
+    text: string;
+    toolCalls: Array<Record<string, unknown>>;
+    finishReason: string;
+    usage: LlmTokenUsage;
+}): Array<Record<string, unknown>>;
+//# sourceMappingURL=WorkersAiLlmUpstream.d.ts.map

package/dist/infrastructure/ai/WorkersAiLlmUpstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkersAiLlmUpstream.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/ai/WorkersAiLlmUpstream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAY5B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AASjC,qBAAa,oBAAqB,YAAW,WAAW;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAhC,YAA6B,GAAG,EAAE,GAAG,EAAI;IAEzC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAEpE;IAED,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAWnE;CACF;AA6QD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACpD,GAAG,EAAE;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACzC,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,aAAa,CAAA;CACrB,GACA,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6BhC"}