veryfront 0.1.623 → 0.1.625

package/esm/src/runs/runs-client.js

@@ -0,0 +1,181 @@
+import { getVeryfrontCloudBootstrap } from "../platform/cloud/resolver.js";
+import { requestWithRetry, } from "../platform/adapters/veryfront-api-client/retry-handler.js";
+import { API_CLIENT_ERROR } from "../platform/adapters/veryfront-api-client/types.js";
+import { CancelRunResponseSchema, CreateRunResponseSchema, RunEventListSchema, RunListSchema, RunSchema, } from "./schemas.js";
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_INITIAL_RETRY_DELAY_MS = 1_000;
+const DEFAULT_MAX_RETRY_DELAY_MS = 10_000;
+const DEFAULT_KNOWLEDGE_INGEST_RUN_NAME = "Ingest knowledge";
+function toQueryParams(values) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(values)) {
+        if (value != null) {
+            params.set(key, String(value));
+        }
+    }
+    return params;
+}
+function withQuery(path, params) {
+    const query = params.toString();
+    return query.length > 0 ? `${path}?${query}` : path;
+}
+function runtimeTargetBody(input) {
+    return {
+        runtime_target_kind: input.runtimeTargetKind,
+        runtime_target_environment_id: input.runtimeTargetEnvironmentId,
+        runtime_target_branch_id: input.runtimeTargetBranchId,
+    };
+}
+/** Public client for canonical durable runs. */
+export class VeryfrontRunsClient {
+    config;
+    retryConfig;
+    requestToken;
+    requestProjectReference;
+    knowledge;
+    constructor(config = {}) {
+        this.config = config;
+        this.retryConfig = {
+            maxRetries: config.retry?.maxRetries ?? DEFAULT_MAX_RETRIES,
+            initialDelay: config.retry?.initialDelay ?? DEFAULT_INITIAL_RETRY_DELAY_MS,
+            maxDelay: config.retry?.maxDelay ?? DEFAULT_MAX_RETRY_DELAY_MS,
+        };
+        this.knowledge = {
+            ingestByUploadIds: (input) => this.ingestKnowledgeByUploadIds(input),
+            ingestByUploadPaths: (input) => this.ingestKnowledgeByUploadPaths(input),
+            ingestByUploadPrefix: (input) => this.ingestKnowledgeByUploadPrefix(input),
+        };
+    }
+    setRequestToken(token) {
+        this.requestToken = token;
+    }
+    clearRequestToken() {
+        this.requestToken = undefined;
+    }
+    setProjectReference(projectReference) {
+        this.requestProjectReference = projectReference;
+    }
+    clearProjectReference() {
+        this.requestProjectReference = undefined;
+    }
+    createTaskRun(input) {
+        const { projectId, publicId, parentRunId, name, target, batchId, config, timeoutSeconds, backoffLimit, ...runtimeTarget } = input;
+        return this.requestJson("/runs", CreateRunResponseSchema, {
+            method: "POST",
+            body: {
+                kind: "task",
+                owner: { kind: "project", id: projectId },
+                public_id: publicId,
+                parent_run_id: parentRunId,
+                request: {
+                    name,
+                    target,
+                    batch_id: batchId,
+                    ...runtimeTargetBody(runtimeTarget),
+                    config,
+                    timeout_seconds: timeoutSeconds,
+                    backoff_limit: backoffLimit,
+                },
+            },
+        });
+    }
+    createWorkflowRun(input) {
+        const { projectId, publicId, parentRunId, workflowId, target, input: workflowInput, startMode, ...runtimeTarget } = input;
+        return this.requestJson("/runs", CreateRunResponseSchema, {
+            method: "POST",
+            body: {
+                kind: "workflow",
+                owner: { kind: "project", id: projectId },
+                public_id: publicId,
+                parent_run_id: parentRunId,
+                request: {
+                    workflow_id: workflowId,
+                    target,
+                    ...runtimeTargetBody(runtimeTarget),
+                    input: workflowInput,
+                    start_mode: startMode,
+                },
+            },
+        });
+    }
+    async list(options = {}) {
+        const { projectReference, cursor, limit } = options;
+        return await this.requestJson(withQuery(`/projects/${encodeURIComponent(this.resolveProjectReference(projectReference))}/runs`, toQueryParams({ cursor, limit })), RunListSchema);
+    }
+    get(runId) {
+        return this.requestJson(`/runs/${encodeURIComponent(runId)}`, RunSchema);
+    }
+    events(runId, options = {}) {
+        const { afterEventId, limit } = options;
+        return this.requestJson(withQuery(`/runs/${encodeURIComponent(runId)}/events`, toQueryParams({ after_event_id: afterEventId, limit })), RunEventListSchema);
+    }
+    cancel(runId) {
+        return this.requestJson(`/runs/${encodeURIComponent(runId)}/cancel`, CancelRunResponseSchema, {
+            method: "POST",
+        });
+    }
+    ingestKnowledgeByUploadIds(input) {
+        const { uploadIds, ...options } = input;
+        return this.createTaskRun({
+            ...options,
+            name: options.name ?? DEFAULT_KNOWLEDGE_INGEST_RUN_NAME,
+            target: "task:knowledge-ingest",
+            config: { upload_ids: uploadIds },
+        });
+    }
+    ingestKnowledgeByUploadPaths(input) {
+        const { uploadPaths, ...options } = input;
+        return this.createTaskRun({
+            ...options,
+            name: options.name ?? DEFAULT_KNOWLEDGE_INGEST_RUN_NAME,
+            target: "task:knowledge-ingest",
+            config: { paths: uploadPaths },
+        });
+    }
+    ingestKnowledgeByUploadPrefix(input) {
+        const { uploadPrefix, ...options } = input;
+        return this.createTaskRun({
+            ...options,
+            name: options.name ?? DEFAULT_KNOWLEDGE_INGEST_RUN_NAME,
+            target: "task:knowledge-ingest",
+            config: { path_prefix: uploadPrefix },
+        });
+    }
+    resolveApiUrl() {
+        return this.config.apiUrl ?? getVeryfrontCloudBootstrap().apiBaseUrl;
+    }
+    resolveAuthToken() {
+        const token = this.requestToken ?? this.config.authToken ??
+            getVeryfrontCloudBootstrap().apiToken;
+        if (token) {
+            return token;
+        }
+        throw API_CLIENT_ERROR.create({
+            detail: "Runs auth not configured. Set VERYFRONT_API_TOKEN, provide request-scoped Veryfront credentials, or pass authToken explicitly.",
+            status: 401,
+        });
+    }
+    resolveProjectReference(projectReference) {
+        const resolved = projectReference ?? this.requestProjectReference ??
+            this.config.projectReference ??
+            getVeryfrontCloudBootstrap().projectSlug;
+        if (resolved) {
+            return resolved;
+        }
+        throw API_CLIENT_ERROR.create({
+            detail: "Runs project reference not configured. Pass projectReference explicitly, set VERYFRONT_PROJECT_SLUG, or provide request-scoped Veryfront project context.",
+            status: 400,
+        });
+    }
+    async requestJson(path, schema, options = {}) {
+        const raw = await requestWithRetry(`${this.resolveApiUrl()}${path}`, this.resolveAuthToken(), this.retryConfig, {
+            method: options.method,
+            body: options.body == null ? undefined : JSON.stringify(options.body),
+        });
+        return schema.parse(raw);
+    }
+}
+/** Create a runs client. */
+export function createRunsClient(config) {
+    return new VeryfrontRunsClient(config);
+}

package/esm/src/{jobs → runs}/runtime-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-env.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/runtime-env.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAuChE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBxB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAOpC"}
+{"version":3,"file":"runtime-env.d.ts","sourceRoot":"","sources":["../../../src/src/runs/runtime-env.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAuChE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBxB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAOpC"}

package/esm/src/{jobs → runs}/runtime-env.js

@@ -1,5 +1,5 @@
 import { logger as baseLogger } from "../utils/index.js";
-const logger = baseLogger.component("job-runtime-env");
+const logger = baseLogger.component("run-runtime-env");
 export const INJECTED_TASK_ENV_JSON = "VERYFRONT_TASK_ENV_JSON";
 const UNSAFE_INJECTED_ENV_KEYS = new Set(["__proto__", "constructor", "prototype"]);
 const RESERVED_TASK_ENV_KEYS = new Set([
@@ -12,7 +12,7 @@ const RESERVED_TASK_ENV_KEYS = new Set([
     "VERYFRONT_BRANCH_REF",
     "VERYFRONT_API_USER",
     "VERYFRONT_API_PASS",
-    "VERYFRONT_JOB_RESULT_PATH",
+    "VERYFRONT_RUN_RESULT_PATH",
     INJECTED_TASK_ENV_JSON,
 ]);
 function isReservedTaskEnvKey(key) {

package/esm/src/runs/schemas.d.ts

@@ -0,0 +1,236 @@
+import type { InferSchema } from "../extensions/schema/index.js";
+export declare const getRunKindSchema: () => import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+export declare const getRunStatusSchema: () => import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+export declare const getRunOwnerSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+    id: import("../internal-agents/schema.js").Schema<string>;
+}>>;
+export declare const getRunSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    run_id: import("../internal-agents/schema.js").Schema<string>;
+    kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+    status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+    owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+        id: import("../internal-agents/schema.js").Schema<string>;
+    }>>;
+    parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+    root_run_id: import("../internal-agents/schema.js").Schema<string>;
+    waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+    metadata: import("../internal-agents/schema.js").Schema<unknown>;
+    created_at: import("../internal-agents/schema.js").Schema<string>;
+    started_at: import("../internal-agents/schema.js").Schema<string | null>;
+    completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+}>>;
+export declare const getCreateRunResponseSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    accepted: import("../internal-agents/schema.js").Schema<boolean>;
+    duplicate: import("../internal-agents/schema.js").Schema<boolean | undefined>;
+    run: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        run_id: import("../internal-agents/schema.js").Schema<string>;
+        kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+        status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+        owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+            kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+            id: import("../internal-agents/schema.js").Schema<string>;
+        }>>;
+        parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+        root_run_id: import("../internal-agents/schema.js").Schema<string>;
+        waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+        metadata: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+        started_at: import("../internal-agents/schema.js").Schema<string | null>;
+        completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+export declare const getCancelRunResponseSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    cancelled: import("../internal-agents/schema.js").Schema<boolean>;
+    run: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        run_id: import("../internal-agents/schema.js").Schema<string>;
+        kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+        status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+        owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+            kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+            id: import("../internal-agents/schema.js").Schema<string>;
+        }>>;
+        parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+        root_run_id: import("../internal-agents/schema.js").Schema<string>;
+        waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+        metadata: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+        started_at: import("../internal-agents/schema.js").Schema<string | null>;
+        completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+export declare const getRunEventSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    event_id: import("../internal-agents/schema.js").Schema<number>;
+    event_type: import("../internal-agents/schema.js").Schema<string>;
+    payload: import("../internal-agents/schema.js").Schema<unknown>;
+    created_at: import("../internal-agents/schema.js").Schema<string>;
+}>>;
+export declare const getPageInfoSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    self: import("../internal-agents/schema.js").Schema<string | null>;
+    first: import("../internal-agents/schema.js").Schema<null>;
+    next: import("../internal-agents/schema.js").Schema<string | null>;
+    prev: import("../internal-agents/schema.js").Schema<string | null>;
+}>>;
+export declare const getRunEventListSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    data: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        event_id: import("../internal-agents/schema.js").Schema<number>;
+        event_type: import("../internal-agents/schema.js").Schema<string>;
+        payload: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+    }>[]>;
+    page_info: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        self: import("../internal-agents/schema.js").Schema<string | null>;
+        first: import("../internal-agents/schema.js").Schema<null>;
+        next: import("../internal-agents/schema.js").Schema<string | null>;
+        prev: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+export declare const getRunListSchema: () => import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    data: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        run_id: import("../internal-agents/schema.js").Schema<string>;
+        kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+        status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+        owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+            kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+            id: import("../internal-agents/schema.js").Schema<string>;
+        }>>;
+        parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+        root_run_id: import("../internal-agents/schema.js").Schema<string>;
+        waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+        metadata: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+        started_at: import("../internal-agents/schema.js").Schema<string | null>;
+        completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+    }>[]>;
+    page_info: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        self: import("../internal-agents/schema.js").Schema<string | null>;
+        first: import("../internal-agents/schema.js").Schema<null>;
+        next: import("../internal-agents/schema.js").Schema<string | null>;
+        prev: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+/** Zod schema for a canonical durable run. */
+export declare const RunSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    run_id: import("../internal-agents/schema.js").Schema<string>;
+    kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+    status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+    owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+        id: import("../internal-agents/schema.js").Schema<string>;
+    }>>;
+    parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+    root_run_id: import("../internal-agents/schema.js").Schema<string>;
+    waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+    metadata: import("../internal-agents/schema.js").Schema<unknown>;
+    created_at: import("../internal-agents/schema.js").Schema<string>;
+    started_at: import("../internal-agents/schema.js").Schema<string | null>;
+    completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+}>>;
+/** Zod schema for a create-run response. */
+export declare const CreateRunResponseSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    accepted: import("../internal-agents/schema.js").Schema<boolean>;
+    duplicate: import("../internal-agents/schema.js").Schema<boolean | undefined>;
+    run: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        run_id: import("../internal-agents/schema.js").Schema<string>;
+        kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+        status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+        owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+            kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+            id: import("../internal-agents/schema.js").Schema<string>;
+        }>>;
+        parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+        root_run_id: import("../internal-agents/schema.js").Schema<string>;
+        waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+        metadata: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+        started_at: import("../internal-agents/schema.js").Schema<string | null>;
+        completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+/** Zod schema for a cancel-run response. */
+export declare const CancelRunResponseSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    cancelled: import("../internal-agents/schema.js").Schema<boolean>;
+    run: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        run_id: import("../internal-agents/schema.js").Schema<string>;
+        kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+        status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+        owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+            kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+            id: import("../internal-agents/schema.js").Schema<string>;
+        }>>;
+        parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+        root_run_id: import("../internal-agents/schema.js").Schema<string>;
+        waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+        metadata: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+        started_at: import("../internal-agents/schema.js").Schema<string | null>;
+        completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+/** Zod schema for a run event. */
+export declare const RunEventSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    event_id: import("../internal-agents/schema.js").Schema<number>;
+    event_type: import("../internal-agents/schema.js").Schema<string>;
+    payload: import("../internal-agents/schema.js").Schema<unknown>;
+    created_at: import("../internal-agents/schema.js").Schema<string>;
+}>>;
+/** Zod schema for a paginated run-event response. */
+export declare const RunEventListSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    data: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        event_id: import("../internal-agents/schema.js").Schema<number>;
+        event_type: import("../internal-agents/schema.js").Schema<string>;
+        payload: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+    }>[]>;
+    page_info: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        self: import("../internal-agents/schema.js").Schema<string | null>;
+        first: import("../internal-agents/schema.js").Schema<null>;
+        next: import("../internal-agents/schema.js").Schema<string | null>;
+        prev: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+/** Zod schema for a paginated project-run response. */
+export declare const RunListSchema: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+    data: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        run_id: import("../internal-agents/schema.js").Schema<string>;
+        kind: import("../internal-agents/schema.js").Schema<"agent" | "task" | "workflow">;
+        status: import("../internal-agents/schema.js").Schema<"waiting" | "failed" | "completed" | "pending" | "cancelled" | "running">;
+        owner: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+            kind: import("../internal-agents/schema.js").Schema<"project" | "conversation">;
+            id: import("../internal-agents/schema.js").Schema<string>;
+        }>>;
+        parent_run_id: import("../internal-agents/schema.js").Schema<string | null>;
+        root_run_id: import("../internal-agents/schema.js").Schema<string>;
+        waiting_reason: import("../internal-agents/schema.js").Schema<string | null>;
+        metadata: import("../internal-agents/schema.js").Schema<unknown>;
+        created_at: import("../internal-agents/schema.js").Schema<string>;
+        started_at: import("../internal-agents/schema.js").Schema<string | null>;
+        completed_at: import("../internal-agents/schema.js").Schema<string | null>;
+    }>[]>;
+    page_info: import("../internal-agents/schema.js").Schema<import("../extensions/schema/schema-validator.js").InferShape<{
+        self: import("../internal-agents/schema.js").Schema<string | null>;
+        first: import("../internal-agents/schema.js").Schema<null>;
+        next: import("../internal-agents/schema.js").Schema<string | null>;
+        prev: import("../internal-agents/schema.js").Schema<string | null>;
+    }>>;
+}>>;
+/** Canonical durable run kind. */
+export type RunKind = InferSchema<ReturnType<typeof getRunKindSchema>>;
+/** Canonical durable run status. */
+export type RunStatus = InferSchema<ReturnType<typeof getRunStatusSchema>>;
+/** Canonical durable run owner. */
+export type RunOwner = InferSchema<ReturnType<typeof getRunOwnerSchema>>;
+/** Canonical durable run. */
+export type Run = InferSchema<ReturnType<typeof getRunSchema>>;
+/** Response returned when a run is accepted. */
+export type CreateRunResponse = InferSchema<ReturnType<typeof getCreateRunResponseSchema>>;
+/** Response returned when a run is cancelled. */
+export type CancelRunResponse = InferSchema<ReturnType<typeof getCancelRunResponseSchema>>;
+/** Event emitted by a run. */
+export type RunEvent = InferSchema<ReturnType<typeof getRunEventSchema>>;
+/** Paginated run event response. */
+export type RunEventList = InferSchema<ReturnType<typeof getRunEventListSchema>>;
+/** Paginated project run response. */
+export type RunList = InferSchema<ReturnType<typeof getRunListSchema>>;
+//# sourceMappingURL=schemas.d.ts.map

package/esm/src/runs/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/src/runs/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,eAAO,MAAM,gBAAgB,oFAAsE,CAAC;AAEpG,eAAO,MAAM,kBAAkB,+HAE9B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;GAK7B,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;GAcxB,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;GAMtC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;GAKtC,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;GAO7B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;GAO7B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;GAKjC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;GAK5B,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;GAA2B,CAAC;AAClD,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;GAAyC,CAAC;AAC9E,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;GAAyC,CAAC;AAC9E,kCAAkC;AAClC,eAAO,MAAM,cAAc;;;;;GAAgC,CAAC;AAC5D,qDAAqD;AACrD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;GAAoC,CAAC;AACpE,uDAAuD;AACvD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;GAA+B,CAAC;AAE1D,kCAAkC;AAClC,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AACvE,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAC3E,mCAAmC;AACnC,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AACzE,6BAA6B;AAC7B,MAAM,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAC/D,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC;AAC3F,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC;AAC3F,8BAA8B;AAC9B,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AACzE,oCAAoC;AACpC,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AACjF,sCAAsC;AACtC,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC"}

package/esm/src/runs/schemas.js

@@ -0,0 +1,61 @@
+import { defineSchema, lazySchema } from "../schemas/index.js";
+export const getRunKindSchema = defineSchema((v) => v.enum(["agent", "workflow", "task"]));
+export const getRunStatusSchema = defineSchema((v) => v.enum(["pending", "running", "waiting", "completed", "failed", "cancelled"]));
+export const getRunOwnerSchema = defineSchema((v) => v.object({
+    kind: v.enum(["conversation", "project"]),
+    id: v.string(),
+}));
+export const getRunSchema = defineSchema((v) => v.object({
+    run_id: v.string(),
+    kind: getRunKindSchema(),
+    status: getRunStatusSchema(),
+    owner: getRunOwnerSchema(),
+    parent_run_id: v.string().nullable(),
+    root_run_id: v.string(),
+    waiting_reason: v.string().nullable(),
+    metadata: v.unknown().nullable(),
+    created_at: v.string(),
+    started_at: v.string().nullable(),
+    completed_at: v.string().nullable(),
+}));
+export const getCreateRunResponseSchema = defineSchema((v) => v.object({
+    accepted: v.boolean(),
+    duplicate: v.boolean().optional(),
+    run: getRunSchema(),
+}));
+export const getCancelRunResponseSchema = defineSchema((v) => v.object({
+    cancelled: v.boolean(),
+    run: getRunSchema(),
+}));
+export const getRunEventSchema = defineSchema((v) => v.object({
+    event_id: v.number(),
+    event_type: v.string(),
+    payload: v.unknown(),
+    created_at: v.string(),
+}));
+export const getPageInfoSchema = defineSchema((v) => v.object({
+    self: v.string().nullable(),
+    first: v.literal(null),
+    next: v.string().nullable(),
+    prev: v.string().nullable(),
+}));
+export const getRunEventListSchema = defineSchema((v) => v.object({
+    data: v.array(getRunEventSchema()),
+    page_info: getPageInfoSchema(),
+}));
+export const getRunListSchema = defineSchema((v) => v.object({
+    data: v.array(getRunSchema()),
+    page_info: getPageInfoSchema(),
+}));
+/** Zod schema for a canonical durable run. */
+export const RunSchema = lazySchema(getRunSchema);
+/** Zod schema for a create-run response. */
+export const CreateRunResponseSchema = lazySchema(getCreateRunResponseSchema);
+/** Zod schema for a cancel-run response. */
+export const CancelRunResponseSchema = lazySchema(getCancelRunResponseSchema);
+/** Zod schema for a run event. */
+export const RunEventSchema = lazySchema(getRunEventSchema);
+/** Zod schema for a paginated run-event response. */
+export const RunEventListSchema = lazySchema(getRunEventListSchema);
+/** Zod schema for a paginated project-run response. */
+export const RunListSchema = lazySchema(getRunListSchema);

package/esm/src/security/deno-permissions.d.ts

@@ -12,10 +12,10 @@
  */
 export declare const SERVER_PERMISSIONS: readonly ["--allow-read", "--allow-write", "--allow-net", "--allow-env", "--allow-run", "--allow-sys", "--unstable-worker-options", "--unstable-net"];
 /**
- * WORKFLOW_JOB — `ProcessJobExecutor` (RESTRICTED).
+ * WORKFLOW_RUN — `ProcessRunExecutor` (RESTRICTED).
  * Runs user-authored code — no `--allow-run`, `--allow-ffi`, or `--allow-sys`.
  */
-export declare const WORKFLOW_JOB_PERMISSIONS: readonly ["--allow-read", "--allow-write", "--allow-net", "--allow-env"];
+export declare const WORKFLOW_RUN_PERMISSIONS: readonly ["--allow-read", "--allow-write", "--allow-net", "--allow-env"];
 /**
  * BUILD_HELPER — manifest generators, framework source prep.
  * Only needs filesystem + env access.

package/esm/src/security/deno-permissions.js

@@ -21,10 +21,10 @@ export const SERVER_PERMISSIONS = [
     "--unstable-net",
 ];
 /**
- * WORKFLOW_JOB — `ProcessJobExecutor` (RESTRICTED).
+ * WORKFLOW_RUN — `ProcessRunExecutor` (RESTRICTED).
  * Runs user-authored code — no `--allow-run`, `--allow-ffi`, or `--allow-sys`.
  */
-export const WORKFLOW_JOB_PERMISSIONS = [
+export const WORKFLOW_RUN_PERMISSIONS = [
     "--allow-read",
     "--allow-write",
     "--allow-net",

package/esm/src/security/index.d.ts

@@ -24,5 +24,5 @@ export { createValidator, PathValidationError, sanitizePathForDisplay, validateP
 export type { ValidationLevel, ValidationOptions, ValidationResult } from "./path-validation.js";
 export { createSecureFs, SecureFs, SECURITY_VIOLATION, wrapAdapterWithSecurity, } from "./secure-fs.js";
 export type { SecureFsConfig, SecurityContext, SecurityEvent } from "./secure-fs.js";
-export { BUILD_HELPER_PERMISSIONS, SERVER_PERMISSIONS, WORKFLOW_JOB_PERMISSIONS, } from "./deno-permissions.js";
+export { BUILD_HELPER_PERMISSIONS, SERVER_PERMISSIONS, WORKFLOW_RUN_PERMISSIONS, } from "./deno-permissions.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/security/index.js

@@ -16,4 +16,4 @@ export { applyCORSHeaders, applyCORSHeadersSync, cors, corsSimple, DEFAULT_HEADE
 export { applySecurityHeaders, buildCacheControl, CACHE_DURATIONS, createResponseBuilder, generateNonce, getSecurityHeader, ResponseBuilder, } from "./http/response/index.js";
 export { createValidator, PathValidationError, sanitizePathForDisplay, validatePath, validatePathSync, ValidationPresets, } from "./path-validation.js";
 export { createSecureFs, SecureFs, SECURITY_VIOLATION, wrapAdapterWithSecurity, } from "./secure-fs.js";
-export { BUILD_HELPER_PERMISSIONS, SERVER_PERMISSIONS, WORKFLOW_JOB_PERMISSIONS, } from "./deno-permissions.js";
+export { BUILD_HELPER_PERMISSIONS, SERVER_PERMISSIONS, WORKFLOW_RUN_PERMISSIONS, } from "./deno-permissions.js";

package/esm/src/server/build-app-route-renderer.d.ts

@@ -12,5 +12,7 @@ export declare function renderAppRouteToHTML(args: {
     pageFile: string;
     contentSourceId: string;
     reactVersion?: string;
+    stylesheetHref?: string;
+    includePreviewStylesheet?: boolean;
 }): Promise<string>;
 //# sourceMappingURL=build-app-route-renderer.d.ts.map

package/esm/src/server/build-app-route-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-app-route-renderer.d.ts","sourceRoot":"","sources":["../../../src/src/server/build-app-route-renderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAgDnE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFlB"}
+{"version":3,"file":"build-app-route-renderer.d.ts","sourceRoot":"","sources":["../../../src/src/server/build-app-route-renderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiEnE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,OAAO,CAAC,MAAM,CAAC,CAgHlB"}