@dcyfr/ai 2.1.3 → 3.0.1

package/dist/ai/src/container/backend-factory.js

@@ -0,0 +1,169 @@
+/**
+ * Backend factory — create ContainerExecutionBackend instances by type.
+ * TLP:CLEAR
+ *
+ * Provides a unified entry-point so callers don't need to import individual
+ * backend classes directly. Also exports a failover wrapper that automatically
+ * falls back to a secondary backend when the primary is unhealthy.
+ *
+ * @module container/backend-factory
+ * @version 1.0.0
+ */
+import { LocalDockerBackend } from './local-docker-backend.js';
+import { RemoteDockerBackend } from './remote-docker-backend.js';
+import { KubernetesBackend } from './kubernetes-backend.js';
+import { readFileSync } from 'node:fs';
+import { z } from 'zod';
+import { ContainerResourceLimitsSchema, } from './types.js';
+export const AgentContainersConfigSchema = z
+    .object({
+    backend: z
+        .object({
+        type: z.enum(['local-docker', 'remote-docker', 'kubernetes', 'codespaces']).optional(),
+        defaultBackend: z
+            .enum(['local-docker', 'remote-docker', 'kubernetes', 'codespaces'])
+            .optional(),
+        localDocker: z
+            .object({
+            maxConcurrent: z.number().int().min(1).optional(),
+            defaultImage: z.string().min(1).optional(),
+        })
+            .passthrough()
+            .optional(),
+        remoteDocker: z
+            .object({
+            host: z.string().min(1).optional(),
+            tlsCertPath: z.string().optional(),
+            maxConcurrent: z.number().int().min(1).optional(),
+            defaultImage: z.string().min(1).optional(),
+        })
+            .passthrough()
+            .optional(),
+        kubernetes: z
+            .object({
+            namespace: z.string().min(1).optional(),
+            kubeConfigPath: z.string().optional(),
+            maxConcurrent: z.number().int().min(1).optional(),
+        })
+            .passthrough()
+            .optional(),
+    })
+        .partial()
+        .optional(),
+    defaults: z
+        .object({
+        agentImage: z.string().min(1).optional(),
+        baseBranch: z.string().min(1).optional(),
+        resourceLimits: ContainerResourceLimitsSchema.optional(),
+    })
+        .partial()
+        .optional(),
+    telemetry: z
+        .object({
+        enabled: z.boolean().optional(),
+        logDir: z.string().min(1).optional(),
+    })
+        .partial()
+        .optional(),
+})
+    .passthrough();
+/**
+ * Create a ContainerExecutionBackend of the given type.
+ *
+ * @param type - The backend variant to instantiate.
+ * @param options - Backend-specific constructor options.
+ */
+export function createBackend(type, options) {
+    switch (type) {
+        case 'local-docker':
+            return new LocalDockerBackend(options);
+        case 'remote-docker':
+            return new RemoteDockerBackend(options);
+        case 'kubernetes':
+            return new KubernetesBackend();
+        case 'codespaces':
+            throw new Error('CodespacesBackend not yet implemented');
+        default: {
+            const _exhaustive = type;
+            throw new Error(`Unknown backend type: ${String(_exhaustive)}`);
+        }
+    }
+}
+/**
+ * Create backend from parsed agent-containers config object.
+ * Supports both `backend.type` and legacy `backend.defaultBackend`.
+ */
+export function createBackendFromConfig(config) {
+    const validatedConfig = AgentContainersConfigSchema.parse(config);
+    const selected = validatedConfig.backend?.defaultBackend ?? validatedConfig.backend?.type ?? 'local-docker';
+    if (selected === 'local-docker') {
+        const options = {
+            ...(validatedConfig.backend?.localDocker ?? {}),
+            defaultImage: validatedConfig.backend?.localDocker?.defaultImage ?? validatedConfig.defaults?.agentImage,
+        };
+        return createBackend('local-docker', options);
+    }
+    if (selected === 'remote-docker') {
+        const options = {
+            ...(validatedConfig.backend?.remoteDocker ?? {}),
+            defaultImage: validatedConfig.backend?.remoteDocker?.defaultImage ??
+                validatedConfig.defaults?.agentImage,
+        };
+        return createBackend('remote-docker', options);
+    }
+    return createBackend(selected);
+}
+/**
+ * Load backend from config JSON file path.
+ */
+export function loadBackendFromConfigFile(filePath) {
+    const raw = readFileSync(filePath, 'utf8');
+    const config = AgentContainersConfigSchema.parse(JSON.parse(raw));
+    return createBackendFromConfig(config);
+}
+/**
+ * Wrap a primary backend with an automatic failover to a secondary backend.
+ *
+ * On each operation, the wrapper first checks the primary backend's health.
+ * If unavailable, the operation is transparently delegated to the fallback.
+ *
+ * @param primary   - The preferred backend.
+ * @param fallback  - Used when primary healthCheck returns `available: false`.
+ */
+export function createBackendWithFailover(primary, fallback) {
+    return new FailoverBackend(primary, fallback);
+}
+class FailoverBackend {
+    primary;
+    fallback;
+    backendType;
+    constructor(primary, fallback) {
+        this.primary = primary;
+        this.fallback = fallback;
+        this.backendType = primary.backendType;
+    }
+    async resolve() {
+        const health = await this.primary.healthCheck();
+        return health.available ? this.primary : this.fallback;
+    }
+    async healthCheck() {
+        return this.primary.healthCheck();
+    }
+    async provision(config) {
+        return (await this.resolve()).provision(config);
+    }
+    async *streamLogs(handle) {
+        const backend = await this.resolve();
+        yield* backend.streamLogs(handle);
+    }
+    async waitForExit(handle) {
+        return (await this.resolve()).waitForExit(handle);
+    }
+    async teardown(handle) {
+        return (await this.resolve()).teardown(handle);
+    }
+    async listActive() {
+        return (await this.resolve()).listActive();
+    }
+}
+//# sourceMappingURL=backend-factory.js.map

package/dist/ai/src/container/backend-factory.js.map

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

package/dist/ai/src/container/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Container execution module barrel export.
+ * TLP:CLEAR
+ *
+ * @module container
+ */
+export { LocalDockerBackend, type LocalDockerBackendOptions, } from './local-docker-backend.js';
+export { RemoteDockerBackend, type RemoteDockerBackendOptions, } from './remote-docker-backend.js';
+export { KubernetesBackend } from './kubernetes-backend.js';
+export { createBackend, createBackendFromConfig, loadBackendFromConfigFile, createBackendWithFailover, AgentContainersConfigSchema, type BackendOptions, type AgentContainersConfigLike, } from './backend-factory.js';
+export { AgentContainerDispatcher, type AgentContainerDispatcherOptions, type IssueDispatchInput, type TaskDispatchInput, type DispatchOptions, type DispatchRecord, } from './agent-container-dispatcher.js';
+export { DEFAULT_CONTAINER_RESOURCE_LIMITS, ContainerResourceLimitsSchema, AgentContainerConfigSchema, ContainerHandleSchema, ContainerProvisionError, ContainerConcurrencyLimitError, type ContainerResourceLimits, type AgentContainerConfig, type ContainerHandle, type ContainerLogEntry, type ContainerExecutionResult, type BackendHealthResult, type TeardownResult, type ContainerExecutionBackend, type ContainerBackendType, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/src/container/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/container/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,KAAK,cAAc,EACnB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/ai/src/container/index.js

@@ -0,0 +1,13 @@
+/**
+ * Container execution module barrel export.
+ * TLP:CLEAR
+ *
+ * @module container
+ */
+export { LocalDockerBackend, } from './local-docker-backend.js';
+export { RemoteDockerBackend, } from './remote-docker-backend.js';
+export { KubernetesBackend } from './kubernetes-backend.js';
+export { createBackend, createBackendFromConfig, loadBackendFromConfigFile, createBackendWithFailover, AgentContainersConfigSchema, } from './backend-factory.js';
+export { AgentContainerDispatcher, } from './agent-container-dispatcher.js';
+export { DEFAULT_CONTAINER_RESOURCE_LIMITS, ContainerResourceLimitsSchema, AgentContainerConfigSchema, ContainerHandleSchema, ContainerProvisionError, ContainerConcurrencyLimitError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/src/container/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/ai/src/container/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,GAEpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,GAG5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,GAMzB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,GAU/B,MAAM,YAAY,CAAC"}

package/dist/ai/src/container/kubernetes-backend.d.ts

@@ -0,0 +1,23 @@
+/**
+ * KubernetesBackend — stub implementation
+ * TLP:CLEAR
+ *
+ * Future backend for running agent containers as Kubernetes Jobs.
+ * All methods throw a NotImplementedError until activated.
+ *
+ * Activation guide: docs/guides/kubernetes-backend-activation.md
+ *
+ * @module container/kubernetes-backend
+ * @version 1.0.0
+ */
+import { type ContainerHandle, type ContainerLogEntry, type ContainerExecutionResult, type BackendHealthResult, type TeardownResult, type ContainerExecutionBackend, type AgentContainerConfig } from './types.js';
+export declare class KubernetesBackend implements ContainerExecutionBackend {
+    readonly backendType: "kubernetes";
+    healthCheck(): Promise<BackendHealthResult>;
+    provision(_config: AgentContainerConfig): Promise<ContainerHandle>;
+    streamLogs(_handle: ContainerHandle): AsyncIterable<ContainerLogEntry>;
+    waitForExit(_handle: ContainerHandle): Promise<ContainerExecutionResult>;
+    teardown(_handle: ContainerHandle): Promise<TeardownResult>;
+    listActive(): Promise<ContainerHandle[]>;
+}
+//# sourceMappingURL=kubernetes-backend.d.ts.map

package/dist/ai/src/container/kubernetes-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubernetes-backend.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/container/kubernetes-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAKpB,qBAAa,iBAAkB,YAAW,yBAAyB;IACjE,SAAgB,WAAW,EAAG,YAAY,CAAU;IAE9C,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAQ3C,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIjE,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,iBAAiB,CAAC;IAIvE,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIxE,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3D,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAG/C"}

package/dist/ai/src/container/kubernetes-backend.js

@@ -0,0 +1,39 @@
+/**
+ * KubernetesBackend — stub implementation
+ * TLP:CLEAR
+ *
+ * Future backend for running agent containers as Kubernetes Jobs.
+ * All methods throw a NotImplementedError until activated.
+ *
+ * Activation guide: docs/guides/kubernetes-backend-activation.md
+ *
+ * @module container/kubernetes-backend
+ * @version 1.0.0
+ */
+const NOT_IMPLEMENTED_MSG = 'KubernetesBackend not yet implemented — see docs/guides/kubernetes-backend-activation.md';
+export class KubernetesBackend {
+    backendType = 'kubernetes';
+    async healthCheck() {
+        return {
+            available: false,
+            backendType: this.backendType,
+            error: 'KubernetesBackend is a stub — not yet activated',
+        };
+    }
+    async provision(_config) {
+        throw new Error(NOT_IMPLEMENTED_MSG);
+    }
+    async *streamLogs(_handle) {
+        throw new Error(NOT_IMPLEMENTED_MSG);
+    }
+    async waitForExit(_handle) {
+        throw new Error(NOT_IMPLEMENTED_MSG);
+    }
+    async teardown(_handle) {
+        throw new Error(NOT_IMPLEMENTED_MSG);
+    }
+    async listActive() {
+        throw new Error(NOT_IMPLEMENTED_MSG);
+    }
+}
+//# sourceMappingURL=kubernetes-backend.js.map

package/dist/ai/src/container/kubernetes-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubernetes-backend.js","sourceRoot":"","sources":["../../../../packages/ai/src/container/kubernetes-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,MAAM,mBAAmB,GACvB,0FAA0F,CAAC;AAE7F,MAAM,OAAO,iBAAiB;IACZ,WAAW,GAAG,YAAqB,CAAC;IAEpD,KAAK,CAAC,WAAW;QACf,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,iDAAiD;SACzD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAA6B;QAC3C,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CAAC,OAAwB;QACxC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAwB;QACxC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/ai/src/container/local-docker-backend.d.ts

@@ -0,0 +1,77 @@
+/**
+ * LocalDockerBackend
+ * TLP:CLEAR
+ *
+ * ContainerExecutionBackend implementation backed by the local Docker daemon.
+ * Designed for workbench development and CI; production scale-out uses
+ * RemoteDockerBackend or KubernetesBackend (Phase 4).
+ *
+ * Concurrency: max 3 simultaneous containers (configurable via constructor).
+ * Each container gets an ephemeral name (dcyfr-agent-<uuid8>) so multiple
+ * concurrent runs never collide.
+ *
+ * @module container/local-docker-backend
+ * @version 1.0.0
+ * @date 2026-03-01
+ */
+import { type AgentContainerConfig, type ContainerHandle, type ContainerLogEntry, type ContainerExecutionResult, type BackendHealthResult, type TeardownResult, type ContainerExecutionBackend } from './types.js';
+export interface LocalDockerBackendOptions {
+    /**
+     * Maximum number of agent containers running simultaneously.
+     * Prevents CPU/memory exhaustion on the workbench.
+     * Default: 3.
+     */
+    maxConcurrent?: number;
+    /**
+     * Docker image tag to use when AgentContainerConfig.image is not set.
+     * Default: "dcyfr/agent:latest".
+     */
+    defaultImage?: string;
+    /**
+     * Extra Docker flags appended to every `docker run` invocation.
+     * Use sparingly — most flags are derived from AgentContainerConfig.
+     */
+    extraDockerFlags?: string[];
+}
+export declare class LocalDockerBackend implements ContainerExecutionBackend {
+    readonly backendType: "local-docker";
+    private readonly maxConcurrent;
+    private readonly defaultImage;
+    private readonly extraDockerFlags;
+    /**
+     * In-memory tracking of active containers keyed by containerId.
+     * This is intentionally simple — a process restart clears it.
+     * The delegation contract manager is the authoritative state store.
+     */
+    private readonly active;
+    private readonly secretDirs;
+    constructor(options?: LocalDockerBackendOptions);
+    healthCheck(): Promise<BackendHealthResult>;
+    provision(config: AgentContainerConfig): Promise<ContainerHandle>;
+    streamLogs(handle: ContainerHandle): AsyncIterable<ContainerLogEntry>;
+    waitForExit(handle: ContainerHandle): Promise<ContainerExecutionResult>;
+    teardown(handle: ContainerHandle): Promise<TeardownResult>;
+    listActive(): Promise<ContainerHandle[]>;
+    private generateContainerName;
+    private resolveResourceLimits;
+    private buildRunArgs;
+    private createGithubTokenSecret;
+    private cleanupSecret;
+    /**
+     * Gracefully stop a container:
+     * 1. `docker stop --time=10` (SIGTERM + 10s grace)
+     * 2. `docker kill` if stop fails
+     */
+    private stopContainer;
+    /**
+     * Resolve the real Docker container ID from its name.
+     * Docker assigns the ID asynchronously after container creation.
+     */
+    private resolveContainerId;
+    /**
+     * Return a copy of the config with the githubToken redacted.
+     * The redacted copy is stored on ContainerHandle (which may be serialized).
+     */
+    private redactConfig;
+}
+//# sourceMappingURL=local-docker-backend.d.ts.map

package/dist/ai/src/container/local-docker-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-docker-backend.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/container/local-docker-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAE/B,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAMD,qBAAa,kBAAmB,YAAW,yBAAyB;IAClE,QAAQ,CAAC,WAAW,EAAG,cAAc,CAAU;IAE/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;IAE5C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;gBAE5C,OAAO,GAAE,yBAA8B;IAQ7C,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAwB3C,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAyDhE,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAAC,iBAAiB,CAAC;IAyDtE,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAgEvE,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAoB1D,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAM9C,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,YAAY;IA8DpB,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,aAAa;IAUrB;;;;OAIG;YACW,aAAa;IAY3B;;;OAGG;YACW,kBAAkB;IAmBhC;;;OAGG;IACH,OAAO,CAAC,YAAY;CAMrB"}