veryfront 0.1.628 → 0.1.630

package/esm/src/server/handlers/request/project-run-execute.handler.js

@@ -0,0 +1,460 @@
+import * as dntShim from "../../../../_dnt.shims.js";
+import { CONTROL_PLANE_RUNS_PATH_PREFIX } from "../../../channels/control-plane.js";
+import { getEnvironmentConfig } from "../../../config/index.js";
+import { ControlPlaneRequestError, verifyControlPlaneRequest, } from "../../../internal-agents/control-plane-auth.js";
+import { INTERNAL_AGENT_CONTROL_PLANE_MAX_BODY_BYTES, InternalAgentRequestBodyTooLargeError, readInternalAgentRequestBody, } from "../../../internal-agents/request-body.js";
+import { getHostEnv } from "../../../platform/compat/process.js";
+import { findTaskById } from "../../../task/discovery.js";
+import { runTask } from "../../../task/runner.js";
+import { findWorkflowById } from "../../../workflow/discovery/index.js";
+import { createWorkflowClient, RedisBackend } from "../../../workflow/index.js";
+import { BaseHandler } from "../response/base.js";
+import { PRIORITY_MEDIUM_API } from "../../../utils/constants/index.js";
+const EXECUTE_PATH_REGEX = /^\/api\/control-plane\/runs\/([^/]+)\/execute$/;
+const DEFAULT_WORKFLOW_STATUS_POLL_INTERVAL_MS = 100;
+const DEFAULT_WORKFLOW_STATUS_TIMEOUT_MS = 15 * 60 * 1_000;
+const WORKFLOW_PERSISTENCE_REQUIRED_ERROR = "Workflow paused but runtime workflow persistence is not configured";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseRecord(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw new Error("Expected object");
+    return value;
+}
+function parseExecuteRequest(value, pathRunId) {
+    if (!isRecord(value))
+        throw new Error("Expected object");
+    const runId = value.runId;
+    const kind = value.kind;
+    const target = value.target;
+    const projectId = value.projectId;
+    if (typeof runId !== "string" || !runId)
+        throw new Error("Invalid runId");
+    if (runId !== pathRunId)
+        throw new Error("Run id does not match request path");
+    if (kind !== "task" && kind !== "workflow")
+        throw new Error("Invalid run kind");
+    if (typeof target !== "string" || !target)
+        throw new Error("Invalid target");
+    if (typeof projectId !== "string" || !projectId)
+        throw new Error("Invalid projectId");
+    if (kind === "task" && !target.startsWith("task:"))
+        throw new Error("Invalid task target");
+    if (kind === "workflow" && !target.startsWith("workflow:")) {
+        throw new Error("Invalid workflow target");
+    }
+    return {
+        runId,
+        kind,
+        target,
+        projectId,
+        config: parseRecord(value.config),
+        input: parseRecord(value.input),
+    };
+}
+function getRunId(pathname) {
+    return EXECUTE_PATH_REGEX.exec(pathname)?.[1] ?? null;
+}
+function stripTargetPrefix(target, prefix) {
+    return target.slice(prefix.length);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function createExecutionFailure(error, durationMs) {
+    return {
+        success: false,
+        error: errorMessage(error),
+        logs: null,
+        duration_ms: durationMs,
+    };
+}
+async function createRuntimeWorkflowClient(config) {
+    const redisUrl = getHostEnv("REDIS_URL")?.trim();
+    if (!redisUrl) {
+        return Object.assign(createWorkflowClient(config), {
+            statePersistence: "ephemeral",
+        });
+    }
+    const backend = new RedisBackend({ url: redisUrl, debug: config?.debug });
+    if (backend.initialize) {
+        await backend.initialize();
+    }
+    return Object.assign(createWorkflowClient({ backend, debug: config?.debug }), {
+        statePersistence: "durable",
+    });
+}
+async function executeTaskRun(request, ctx, deps) {
+    const taskId = stripTargetPrefix(request.target, "task:");
+    if (taskId === "knowledge-ingest") {
+        throw new Error("Knowledge ingest must be executed through the knowledge ingest executor");
+    }
+    const task = await deps.findTaskById(taskId, {
+        projectDir: ctx.projectDir,
+        adapter: ctx.adapter,
+        config: ctx.config,
+        debug: ctx.debug,
+    });
+    if (!task) {
+        return {
+            success: false,
+            error: `Task not found: ${taskId}`,
+            logs: null,
+            duration_ms: 0,
+        };
+    }
+    const result = await deps.runTask({
+        task,
+        config: request.config ?? {},
+        projectId: request.projectId,
+        debug: ctx.debug,
+    });
+    return {
+        success: result.success,
+        result: result.result,
+        error: result.error,
+        duration_ms: result.durationMs,
+        logs: null,
+    };
+}
+async function waitForWorkflowResult(client, runId, deps) {
+    const deadline = deps.now() + DEFAULT_WORKFLOW_STATUS_TIMEOUT_MS;
+    while (true) {
+        const run = await client.getRun(runId);
+        if (!run)
+            throw new Error(`Workflow run not found: ${runId}`);
+        if (run.status === "completed" ||
+            run.status === "failed" ||
+            run.status === "cancelled" ||
+            run.status === "waiting") {
+            return run;
+        }
+        if (deps.now() >= deadline) {
+            throw new Error(`Workflow run timed out: ${runId}`);
+        }
+        await deps.sleep(DEFAULT_WORKFLOW_STATUS_POLL_INTERVAL_MS);
+    }
+}
+async function executeWorkflowRun(request, ctx, deps) {
+    const startedAt = deps.now();
+    const workflowId = stripTargetPrefix(request.target, "workflow:");
+    const workflow = await deps.findWorkflowById(workflowId, {
+        projectDir: ctx.projectDir,
+        adapter: ctx.adapter,
+        config: ctx.config,
+        debug: ctx.debug,
+    });
+    if (!workflow) {
+        return {
+            success: false,
+            error: `Workflow not found: ${workflowId}`,
+            logs: null,
+            duration_ms: 0,
+        };
+    }
+    const client = await deps.createWorkflowClient({ debug: ctx.debug });
+    try {
+        client.register(workflow.definition);
+        const handle = await client.start(workflow.id, request.input ?? {}, { runId: request.runId });
+        const run = await waitForWorkflowResult(client, handle.runId, deps);
+        const durationMs = Math.max(0, deps.now() - startedAt);
+        if (run.status === "waiting") {
+            if (client.statePersistence !== "durable") {
+                return {
+                    success: false,
+                    error: WORKFLOW_PERSISTENCE_REQUIRED_ERROR,
+                    logs: null,
+                    duration_ms: durationMs,
+                };
+            }
+            return {
+                success: true,
+                result: run.output,
+                logs: null,
+                duration_ms: durationMs,
+            };
+        }
+        if (run.status === "completed") {
+            return {
+                success: true,
+                result: run.output,
+                logs: null,
+                duration_ms: durationMs,
+            };
+        }
+        return {
+            success: false,
+            result: run.output,
+            error: run.error?.message ?? `Workflow ended with status: ${run.status}`,
+            logs: null,
+            duration_ms: durationMs,
+        };
+    }
+    finally {
+        await client.destroy();
+    }
+}
+function createRuntimeApiClient(req, ctx) {
+    const apiUrl = getEnvironmentConfig().apiBaseUrl;
+    const token = req.headers.get("x-token") ?? ctx.proxyToken ?? ctx.requestContext?.token ?? "";
+    if (!token) {
+        throw new Error("Missing project runtime API token");
+    }
+    async function requestJson(method, path, body, params) {
+        const url = new URL(`${apiUrl}${path}`);
+        for (const [key, value] of Object.entries(params ?? {})) {
+            url.searchParams.set(key, value);
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: "application/json",
+                "Content-Type": "application/json",
+            },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`Veryfront API request failed: ${response.status} ${response.statusText}`);
+        }
+        if (response.status === 204)
+            return undefined;
+        return response.json();
+    }
+    return {
+        get(path, params) {
+            return requestJson("GET", path, undefined, params);
+        },
+        post(path, body) {
+            return requestJson("POST", path, body);
+        },
+        put(path, body) {
+            return requestJson("PUT", path, body);
+        },
+        patch(path, body) {
+            return requestJson("PATCH", path, body);
+        },
+        delete(path) {
+            return requestJson("DELETE", path);
+        },
+    };
+}
+function getStringArrayConfig(config, keys) {
+    for (const key of keys) {
+        const value = config[key];
+        if (Array.isArray(value)) {
+            return value.filter((item) => typeof item === "string" && item.length > 0);
+        }
+    }
+    return [];
+}
+function getStringConfig(config, keys) {
+    for (const key of keys) {
+        const value = config[key];
+        if (typeof value === "string" && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+async function resolveUploadIdsToPaths(client, projectReference, uploadIds) {
+    const paths = [];
+    for (const uploadId of uploadIds) {
+        const upload = await client.get(`/projects/${encodeURIComponent(projectReference)}/uploads/${encodeURIComponent(uploadId)}`);
+        if (!upload.path) {
+            throw new Error(`Upload not found: ${uploadId}`);
+        }
+        paths.push(upload.path);
+    }
+    return paths;
+}
+function createKnowledgeEventLogger(lines) {
+    const append = (level, message, metadata) => {
+        lines.push(JSON.stringify({ level, message, ...(metadata ?? {}) }));
+    };
+    const logger = {
+        info: (message, metadata) => append("info", message, metadata),
+        warn: (message, metadata) => append("warn", message, metadata),
+        error: (message, metadata) => append("error", message, metadata),
+        debug: (message, metadata) => append("debug", message, metadata),
+        async time(_label, fn) {
+            return fn();
+        },
+        child: () => logger,
+        component: () => logger,
+    };
+    return logger;
+}
+async function executeKnowledgeIngestRun(input) {
+    const startedAt = Date.now();
+    const config = input.request.config ?? {};
+    const client = createRuntimeApiClient(input.req, input.ctx);
+    const projectReference = input.ctx.projectSlug ?? input.request.projectId;
+    const outputDir = await dntShim.Deno.makeTempDir({ prefix: "veryfront-knowledge-run-" });
+    const logLines = [];
+    try {
+        const { buildKnowledgeIngestRunResult, } = await import("../../../../cli/commands/knowledge/result.js");
+        const { collectKnowledgeSources, ingestResolvedSources, resolveKnowledgeDownloadOutputDir, runKnowledgeParser, } = await import("../../../../cli/commands/knowledge/command.js");
+        const { downloadUploadToFile } = await import("../../../../cli/commands/uploads/command.js");
+        const { putRemoteFileFromLocal } = await import("../../../../cli/commands/files/command.js");
+        const uploadIds = getStringArrayConfig(config, ["upload_ids", "uploadIds"]);
+        const paths = getStringArrayConfig(config, ["paths", "upload_paths", "uploadPaths"]);
+        const uploadPaths = [
+            ...paths,
+            ...await resolveUploadIdsToPaths(client, projectReference, uploadIds),
+        ];
+        const pathPrefix = getStringConfig(config, [
+            "path_prefix",
+            "upload_prefix",
+            "pathPrefix",
+            "uploadPrefix",
+        ]);
+        const knowledgePath = getStringConfig(config, ["knowledge_path", "knowledgePath"]) ??
+            "knowledge";
+        const description = getStringConfig(config, ["description"]);
+        const recursive = config.recursive === undefined ? true : Boolean(config.recursive);
+        if (uploadPaths.length > 0 && pathPrefix) {
+            throw new Error("Use upload paths or upload prefix, not both.");
+        }
+        const options = {
+            projectSlug: projectReference,
+            projectDir: input.ctx.projectDir,
+            sources: uploadPaths,
+            path: pathPrefix,
+            all: pathPrefix !== undefined,
+            recursive,
+            outputDir,
+            knowledgePath,
+            description,
+            slug: getStringConfig(config, ["slug"]),
+            json: true,
+            quiet: true,
+        };
+        const downloadOutputDir = resolveKnowledgeDownloadOutputDir(outputDir);
+        const sourceMode = pathPrefix ? "path_prefix" : "explicit_sources";
+        const collection = await collectKnowledgeSources(options, {
+            client,
+            projectSlug: projectReference,
+            downloadUploads: (uploadTargets) => Promise.all(uploadTargets.map((uploadPath) => downloadUploadToFile(client, projectReference, uploadPath, downloadOutputDir))),
+        });
+        const requestedCount = collection.sources.length + collection.skipped.length;
+        if (requestedCount === 0) {
+            throw new Error("No supported knowledge sources were found.");
+        }
+        const results = await ingestResolvedSources(collection.sources, options, {
+            client,
+            projectSlug: projectReference,
+            outputDir,
+            runParser: runKnowledgeParser,
+            eventLogger: createKnowledgeEventLogger(logLines),
+            uploadKnowledgeFile: (remotePath, localPath) => putRemoteFileFromLocal(client, projectReference, remotePath, localPath),
+        });
+        const result = buildKnowledgeIngestRunResult({
+            requestedCount,
+            sourceMode,
+            knowledgePath,
+            ingested: results.ingested,
+            skipped: collection.skipped,
+            failed: results.failed,
+        });
+        const failedCount = result.summary.failed_count;
+        const ingestedCount = result.summary.ingested_count;
+        return {
+            success: failedCount === 0 && ingestedCount > 0,
+            result,
+            error: failedCount > 0
+                ? `${failedCount} knowledge source${failedCount === 1 ? "" : "s"} failed`
+                : ingestedCount === 0
+                    ? "No knowledge sources were ingested"
+                    : null,
+            logs: logLines.length > 0 ? logLines.join("\n") : null,
+            duration_ms: Date.now() - startedAt,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: errorMessage(error),
+            logs: logLines.length > 0 ? logLines.join("\n") : null,
+            duration_ms: Date.now() - startedAt,
+        };
+    }
+    finally {
+        await dntShim.Deno.remove(outputDir, { recursive: true }).catch(() => undefined);
+    }
+}
+const defaultDeps = {
+    findTaskById,
+    runTask,
+    findWorkflowById,
+    createWorkflowClient: createRuntimeWorkflowClient,
+    executeKnowledgeIngest: executeKnowledgeIngestRun,
+    sleep: (ms) => new Promise((resolve) => dntShim.setTimeout(resolve, ms)),
+    now: () => Date.now(),
+};
+export class ProjectRunExecuteHandler extends BaseHandler {
+    deps;
+    metadata = {
+        name: "ProjectRunExecuteHandler",
+        priority: PRIORITY_MEDIUM_API,
+        patterns: [
+            { pattern: CONTROL_PLANE_RUNS_PATH_PREFIX, prefix: true, method: "POST" },
+        ],
+    };
+    constructor(deps = defaultDeps) {
+        super();
+        this.deps = deps;
+    }
+    async handle(req, ctx) {
+        if (!this.shouldHandle(req, ctx)) {
+            return this.continue();
+        }
+        const runId = getRunId(new URL(req.url).pathname);
+        if (!runId) {
+            return this.continue();
+        }
+        return this.withProxyContext(ctx, async () => {
+            const builder = this.createResponseBuilder(ctx)
+                .withCORS(req, ctx.securityConfig?.cors)
+                .withSecurity(ctx.securityConfig ?? undefined, req);
+            try {
+                const rawBody = await readInternalAgentRequestBody(req, INTERNAL_AGENT_CONTROL_PLANE_MAX_BODY_BYTES);
+                const request = parseExecuteRequest(JSON.parse(rawBody), runId);
+                const claims = await verifyControlPlaneRequest(req, ctx, rawBody, {
+                    expectedSubject: runId,
+                    expectedSurface: "studio",
+                });
+                if (request.projectId !== claims.project_id ||
+                    (ctx.projectId !== undefined && request.projectId !== ctx.projectId)) {
+                    return this.respond(builder.json({ error: "Invalid control-plane signature" }, 401));
+                }
+                const startedAt = this.deps.now();
+                try {
+                    const response = request.kind === "task" && request.target === "task:knowledge-ingest"
+                        ? await this.deps.executeKnowledgeIngest({ request, ctx, req })
+                        : request.kind === "task"
+                            ? await executeTaskRun(request, ctx, this.deps)
+                            : await executeWorkflowRun(request, ctx, this.deps);
+                    return this.respond(builder.json(response, 200));
+                }
+                catch (error) {
+                    return this.respond(builder.json(createExecutionFailure(error, Math.max(0, this.deps.now() - startedAt)), 200));
+                }
+            }
+            catch (error) {
+                if (error instanceof InternalAgentRequestBodyTooLargeError) {
+                    return this.respond(builder.json({ error: error.message }, error.status));
+                }
+                if (error instanceof ControlPlaneRequestError) {
+                    return this.respond(builder.json({ error: error.message }, error.status));
+                }
+                if (error instanceof SyntaxError || error instanceof Error) {
+                    return this.respond(builder.json({ error: "Invalid project run execute request" }, 400));
+                }
+                return this.respond(builder.json({ error: "Invalid project run execute request" }, 400));
+            }
+        });
+    }
+}

package/esm/src/server/runtime-handler/index.d.ts

@@ -13,7 +13,7 @@ import type { Handler } from "../../types/index.js";
 import { ApiHandlerWrapper } from "../handlers/request/api/index.js";
 export { parseProxyEnvironment, type ProxyEnvironment } from "./proxy-environment.js";
 /** Handler names in registration order. */
-export declare const HANDLER_NAMES: readonly ["AuthHandler", "CsrfHandler", "HMRHandler", "CorsHandler", "HealthHandler", "MetricsHandler", "MemoryDebugHandler", "ClientLogHandler", "DevEndpointsHandler", "StylesCSSHandler", "DebugContextHandler", "OpenAPIHandler", "OpenAPIDocsHandler", "InternalAgentsListHandler", "AgentStreamHandler", "AgentRunResumeHandler", "AgentRunCancelHandler", "ChannelInvokeHandler", "DevDashboardHandler", "ProjectsHandler", "StudioBridgeModulesHandler", "ProdHydrationModuleHandler", "CSSHandler", "DevFileHandler", "SnippetHandler", "StaticHandler", "LibModulesHandler", "RSCHandler", "ModuleHandler", "ApiHandlerWrapper", "MarkdownPreviewHandler", "SSRHandler", "NotFoundHandler"];
+export declare const HANDLER_NAMES: readonly ["AuthHandler", "CsrfHandler", "HMRHandler", "CorsHandler", "HealthHandler", "MetricsHandler", "MemoryDebugHandler", "ClientLogHandler", "DevEndpointsHandler", "StylesCSSHandler", "DebugContextHandler", "OpenAPIHandler", "OpenAPIDocsHandler", "InternalAgentsListHandler", "AgentStreamHandler", "AgentRunResumeHandler", "AgentRunCancelHandler", "ProjectRunExecuteHandler", "ChannelInvokeHandler", "DevDashboardHandler", "ProjectsHandler", "StudioBridgeModulesHandler", "ProdHydrationModuleHandler", "CSSHandler", "DevFileHandler", "SnippetHandler", "StaticHandler", "LibModulesHandler", "RSCHandler", "ModuleHandler", "ApiHandlerWrapper", "MarkdownPreviewHandler", "SSRHandler", "NotFoundHandler"];
 /** Union of all registered handler names. */
 export type HandlerName = (typeof HANDLER_NAMES)[number];
 /**

package/esm/src/server/runtime-handler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAgCpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAgErE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,2CAA2C;AAC3C,eAAO,MAAM,aAAa,uqBAkChB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0CD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuB5D;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAibnE;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAgCpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAiErE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,2CAA2C;AAC3C,eAAO,MAAM,aAAa,msBAmChB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2CD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuB5D;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAibnE;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}

package/esm/src/server/runtime-handler/index.js

@@ -48,6 +48,7 @@ import { InternalAgentsListHandler } from "../handlers/request/internal-agents-l
 import { AgentStreamHandler } from "../handlers/request/agent-stream.handler.js";
 import { AgentRunResumeHandler } from "../handlers/request/agent-run-resume.handler.js";
 import { AgentRunCancelHandler } from "../handlers/request/agent-run-cancel.handler.js";
+import { ProjectRunExecuteHandler } from "../handlers/request/project-run-execute.handler.js";
 import { ChannelInvokeHandler } from "../handlers/request/channel-invoke.handler.js";
 import { DevDashboardHandler } from "../handlers/dev/dashboard/index.js";
 import { ProjectsHandler } from "../handlers/dev/projects/index.js";
@@ -89,6 +90,7 @@ export const HANDLER_NAMES = [
     "AgentStreamHandler",
     "AgentRunResumeHandler",
     "AgentRunCancelHandler",
+    "ProjectRunExecuteHandler",
     "ChannelInvokeHandler",
     "DevDashboardHandler",
     "ProjectsHandler",
@@ -125,6 +127,7 @@ const handlerFactories = {
     AgentStreamHandler: () => new AgentStreamHandler(),
     AgentRunResumeHandler: () => new AgentRunResumeHandler(),
     AgentRunCancelHandler: () => new AgentRunCancelHandler(),
+    ProjectRunExecuteHandler: () => new ProjectRunExecuteHandler(),
     ChannelInvokeHandler: () => new ChannelInvokeHandler(),
     DevDashboardHandler: () => new DevDashboardHandler(),
     ProjectsHandler: () => new ProjectsHandler(),

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.628";
+export declare const VERSION = "0.1.630";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.628";
+export const VERSION = "0.1.630";

package/esm/src/workflow/worker/executors/index.d.ts

@@ -6,8 +6,6 @@
  */
 export type { RunExecutionConfig, RunExecutionInfo, RunExecutionStatus, RunExecutor, } from "./types.js";
 export { isRunExecutor } from "./types.js";
-export { K8sRunExecutor } from "./k8s.js";
-export type { K8sClient, K8sRunExecutionSpec, K8sRunExecutionStatusResponse, K8sRunExecutorConfig, } from "./k8s.js";
 export { ProcessRunExecutor } from "./process.js";
 export type { ProcessRunExecutorConfig } from "./process.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/workflow/worker/executors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}

package/esm/src/workflow/worker/executors/index.js

@@ -5,7 +5,5 @@
  * environments.
  */
 export { isRunExecutor } from "./types.js";
-// K8s Executor
-export { K8sRunExecutor } from "./k8s.js";
 // Process Executor (local dev)
 export { ProcessRunExecutor } from "./process.js";

package/esm/src/workflow/worker/executors/types.d.ts

@@ -3,7 +3,6 @@
  *
  * Abstraction layer for executing workflow runs in isolated environments.
  * Implementations can target different runtimes:
- * - Kubernetes Jobs
  * - Docker containers
  * - Local processes
  * - Cloud Run / Lambda / Fargate
@@ -57,22 +56,6 @@ export interface RunExecutionInfo {
  * Abstracts the runtime environment for executing workflow runs.
  * Each implementation handles the specifics of its target platform.
  *
- * @example K8s
- * ```typescript
- * const executor = new K8sRunExecutor({
- *   namespace: "workflows",
- *   image: "my-app:latest",
- * });
- * ```
- *
- * @example Docker
- * ```typescript
- * const executor = new DockerRunExecutor({
- *   image: "my-app:latest",
- *   network: "workflow-network",
- * });
- * ```
- *
  * @example Local Process
  * ```typescript
  * const executor = new ProcessRunExecutor({
@@ -80,6 +63,13 @@ export interface RunExecutionInfo {
  *   args: ["run", "run-entrypoint.ts"],
  * });
  * ```
+ *
+ * @example Custom runtime target
+ * ```typescript
+ * const executor = new RuntimeTargetExecutor({
+ *   invokeUrl: "https://project.example.com/api/control-plane/runs",
+ * });
+ * ```
  */
 export interface RunExecutor {
     /**

package/esm/src/workflow/worker/executors/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,GAAG,EAAE,WAAW,CAAC;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,qBAAqB;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAE3B,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAEhB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhE;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAE7E;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAElE;;;OAGG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;OAGG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAS9D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,GAAG,EAAE,WAAW,CAAC;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,qBAAqB;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAE3B,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAEhB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhE;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAE7E;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAElE;;;OAGG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;OAGG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAS9D"}

package/esm/src/workflow/worker/executors/types.js

@@ -3,7 +3,6 @@
  *
  * Abstraction layer for executing workflow runs in isolated environments.
  * Implementations can target different runtimes:
- * - Kubernetes Jobs
  * - Docker containers
  * - Local processes
  * - Cloud Run / Lambda / Fargate

package/esm/src/workflow/worker/index.d.ts

@@ -3,22 +3,16 @@
  *
  * Provides distributed workflow execution support.
  *
- * Three execution profiles are available:
+ * Two execution profiles are available:
  *
  * 1. **WorkflowWorker** - In-process polling worker
  *    - Polls for stalled workflows and resumes them
  *    - Good for trusted code or single-tenant deployments
  *    - Simple setup, lower overhead
  *
- * 2. **WorkflowRunManager + K8sRunExecutor** - Kubernetes-resource-backed execution
- *    - Each workflow runs in an ephemeral container
- *    - Complete tenant isolation (no shared state)
- *    - Required for multi-tenant untrusted code execution
- *
- * 3. **WorkflowRunManager + ProcessRunExecutor** - Local process execution
+ * 2. **WorkflowRunManager + ProcessRunExecutor** - Local process execution
  *    - Spawns child processes for each workflow
  *    - Good for local development without K8s/Docker
- *    - Mirrors production behavior
  *
  * A workflow run can be backed by a run executor without introducing another
  * user-visible execution type.
@@ -26,7 +20,7 @@
 import "../../../_dnt.polyfills.js";
 export { createWorkflowWorker, type WorkerStats, type WorkerStatus, WorkflowWorker, type WorkflowWorkerConfig, } from "./workflow-worker.js";
 export { createWorkflowRunManager, type ManagerStats, type ManagerStatus, WorkflowRunManager, type WorkflowRunManagerConfig, } from "./run-manager.js";
-export { isRunExecutor, type K8sClient, type K8sRunExecutionSpec, type K8sRunExecutionStatusResponse, K8sRunExecutor, type K8sRunExecutorConfig, ProcessRunExecutor, type ProcessRunExecutorConfig, type RunExecutionConfig, type RunExecutionInfo, type RunExecutionStatus, type RunExecutor, } from "./executors/index.js";
+export { isRunExecutor, ProcessRunExecutor, type ProcessRunExecutorConfig, type RunExecutionConfig, type RunExecutionInfo, type RunExecutionStatus, type RunExecutor, } from "./executors/index.js";
 export { createWorkflowRunEntrypoint, type CreateWorkflowRunEntrypointOptions, EXIT_CODES, runWorkflowRun, type WorkflowRunEntrypointConfig, } from "./run-entrypoint.js";
 export { createDynamicWorkflowRunEntrypoint, type CreateDynamicWorkflowRunEntrypointOptions, DYNAMIC_EXIT_CODES, type DynamicWorkflowRunEntrypointConfig, runDynamicWorkflowRun, } from "./dynamic-run-entrypoint.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/workflow/worker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,cAAc,EACd,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,2BAA2B,EAC3B,KAAK,kCAAkC,EACvC,UAAU,EACV,cAAc,EACd,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,kCAAkC,EAClC,KAAK,yCAAyC,EAC9C,kBAAkB,EAClB,KAAK,kCAAkC,EACvC,qBAAqB,GACtB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,2BAA2B,EAC3B,KAAK,kCAAkC,EACvC,UAAU,EACV,cAAc,EACd,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,kCAAkC,EAClC,KAAK,yCAAyC,EAC9C,kBAAkB,EAClB,KAAK,kCAAkC,EACvC,qBAAqB,GACtB,MAAM,6BAA6B,CAAC"}