veryfront 0.1.622 → 0.1.624

package/README.md

@@ -20,9 +20,9 @@ Purpose-built for TypeScript and React, Veryfront gives you everything you need
 
 - [**Skills**](https://veryfront.com/docs/code/guides/skills) - Project-level agent capabilities defined as `SKILL.md` files following the agentskills.io specification. Skills provide prompt augmentation, tool allowlists, and script execution.
 
-- [**Jobs & Cron Jobs**](https://veryfront.com/docs/code/guides/jobs) - Run durable project-scoped background work now or on a schedule through the Veryfront platform.
+- [**Runs**](https://veryfront.com/docs/code/guides/runs) - Run durable project-scoped task and workflow definitions through the Veryfront platform.
 
-- [**Tasks**](https://veryfront.com/docs/code/guides/tasks) - File-based background task definitions discovered automatically and executable via the jobs system.
+- [**Tasks**](https://veryfront.com/docs/code/guides/tasks) - File-based background task definitions discovered automatically and executable as task runs.
 
 - [**Multi-Agent**](https://veryfront.com/docs/code/guides/multi-agent) - Compose agents that delegate to each other as tools for complex, coordinated tasks. AG-UI control-plane for hosted agent orchestration.
 
@@ -83,7 +83,7 @@ veryfront/
 │   ├── chat/            # Chat UI components and streaming
 │   ├── discovery/       # Auto-discovery of tools, agents, workflows
 │   ├── sandbox/         # Ephemeral compute environments
-│   ├── jobs/            # Background jobs client
+│   ├── runs/            # Durable runs client
 │   ├── task/            # Task definitions and runner
 │   ├── channels/        # Control-plane agent routing
 │   ├── integrations/    # Third-party connector metadata

package/esm/cli/commands/knowledge/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,WAyC3B,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,WAwC3B,CAAC"}

package/esm/cli/commands/knowledge/command-help.js

@@ -35,8 +35,7 @@ export const knowledgeHelp = {
         "Primary subcommand: ingest",
         "`uploads/...` means a remote project upload; use `./uploads/...` or `/workspace/uploads/...` to force a local file",
         "`ingest` orchestrates upload resolution, parsing, and project file writes",
-        "Requires python3; install `docling` locally to match the sandbox parsing path for PDF, Office, and HTML sources",
-        "Supported PDF, Office, and HTML sources are parsed through `docling` when it is available",
-        "The Veryfront sandbox image includes `docling`, and knowledge ingest falls back to the built-in parser when `docling` is unavailable or extraction fails",
+        "Supported PDF, Office, and HTML sources are parsed through the built-in Kreuzberg document extension",
+        "Plain text, Markdown, JSON, CSV, TSV, and common code files are converted directly by the CLI",
     ],
 };

package/esm/cli/commands/knowledge/command.d.ts

@@ -8,32 +8,12 @@ type SafeParseResult<T> = {
         issues: unknown[];
     };
 };
-import { type CommandResult } from "../../../src/platform/index.js";
 import { type ApiClient } from "../../shared/config.js";
 import type { ParsedArgs } from "../../shared/types.js";
 import * as commandHelpers from "./command-helpers.js";
 import { type Logger } from "../../../src/utils/index.js";
+import { runKnowledgeParser } from "./parser.js";
 import { type KnowledgeIngestFailedFileResult, type KnowledgeIngestFileResult, type KnowledgeIngestSkippedFileResult } from "./result.js";
-export interface KnowledgeParserResult {
-    success: true;
-    source_path: string;
-    source_filename: string;
-    source_type: string;
-    slug: string;
-    sandbox_output_path: string;
-    suggested_project_path: string;
-    description: string;
-    title: string;
-    summary: string;
-    stats: Record<string, unknown>;
-    warnings: string[];
-}
-export interface KnowledgeParserInput {
-    filePath: string;
-    description?: string;
-    slug?: string;
-    sourceReference?: string;
-}
 type KnowledgeSource = {
     kind: "local";
     input: string;
@@ -79,31 +59,7 @@ export declare const buildSuggestedSlug: typeof commandHelpers.buildSuggestedSlu
 export declare const ensureUniqueSlugs: typeof commandHelpers.ensureUniqueSlugs;
 export declare const deriveKnowledgeRemotePath: typeof commandHelpers.deriveKnowledgeRemotePath;
 export declare const createKnowledgeIngestResult: typeof commandHelpers.createKnowledgeIngestResult;
-export declare function runKnowledgeParser(input: {
-    filePath: string;
-    outputDir: string;
-    description?: string;
-    slug?: string;
-    sourceReference?: string;
-    env?: Record<string, string>;
-}): Promise<KnowledgeParserResult>;
-export declare function executeKnowledgeParserCommand(input: {
-    scriptPath: string;
-    inputJsonPath: string;
-    outputJsonPath: string;
-    env?: Record<string, string>;
-}, deps?: {
-    runCommandFn?: (cmd: string, options: {
-        args: string[];
-        env?: Record<string, string>;
-        capture: true;
-    }) => Promise<CommandResult>;
-}): Promise<void>;
-export declare function runKnowledgeParsers(input: {
-    files: KnowledgeParserInput[];
-    outputDir: string;
-    env?: Record<string, string>;
-}): Promise<KnowledgeParserResult[]>;
+export { type KnowledgeParserInput, type KnowledgeParserResult, runKnowledgeParser, runKnowledgeParsers, } from "./parser.js";
 export declare function collectKnowledgeSources(options: Pick<KnowledgeIngestOptions, "sources" | "path" | "all" | "recursive">, deps: {
     client: ApiClient;
     projectSlug: string;
@@ -123,5 +79,4 @@ export declare function ingestResolvedSources(sources: KnowledgeSource[], option
     failed: KnowledgeIngestFailedFileResult[];
 }>;
 export declare function knowledgeCommand(args: ParsedArgs): Promise<void>;
-export {};
 //# sourceMappingURL=command.d.ts.map

package/esm/cli/commands/knowledge/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command.ts"],"names":[],"mappings":"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"}

package/esm/cli/commands/knowledge/command.js

@@ -1,6 +1,6 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { defineSchema, lazySchema } from "../../../src/schemas/index.js";
-import { createFileSystem, getEnv, runCommand } from "../../../src/platform/index.js";
+import { createFileSystem, getEnv } from "../../../src/platform/index.js";
 import { basename } from "../../../src/platform/compat/path/index.js";
 import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
 import { cliLogger } from "../../utils/index.js";
@@ -8,13 +8,13 @@ import { createApiClient, resolveConfigWithAuth } from "../../shared/config.js";
 import { getStringArg } from "../../shared/parsed-args.js";
 import { downloadUploadToFile, listAllUploads } from "../uploads/command.js";
 import { putRemoteFileFromLocal } from "../files/command.js";
-import { knowledgeIngestPythonSource } from "./parser-source.js";
 import * as commandHelpers from "./command-helpers.js";
-import { createJobUserLogger, serverLogger } from "../../../src/utils/index.js";
-import { writeJobResultIfConfigured } from "../../utils/write-job-result.js";
+import { createRunUserLogger, serverLogger } from "../../../src/utils/index.js";
+import { writeRunResultIfConfigured } from "../../utils/write-run-result.js";
 import { classifyKnowledgeSourcePath } from "./source-policy.js";
-import { buildKnowledgeIngestJobResult, } from "./result.js";
-const knowledgeJobLogger = serverLogger.component("knowledge-ingest");
+import { runKnowledgeParser } from "./parser.js";
+import { buildKnowledgeIngestRunResult, } from "./result.js";
+const knowledgeRunLogger = serverLogger.component("knowledge-ingest");
 const getKnowledgeIngestArgsSchema = defineSchema((v) => v.object({
     projectSlug: v.string().optional(),
     projectDir: v.string().optional(),
@@ -71,15 +71,15 @@ function printJson(value) {
 }
 function createKnowledgeIngestEventLogger() {
     const projectId = getEnv("TENANT_PROJECT_ID");
-    const jobId = getEnv("JOB_ID");
-    if (!projectId || !jobId) {
+    const runExecutionId = getEnv("RUN_EXECUTION_ID");
+    if (!projectId || !runExecutionId) {
         return null;
     }
-    return createJobUserLogger(knowledgeJobLogger, {
+    return createRunUserLogger(knowledgeRunLogger, {
         projectId,
-        jobId,
-        batchId: getEnv("JOB_BATCH_ID") ?? undefined,
-        jobTarget: getEnv("JOB_TARGET") ?? undefined,
+        runExecutionId: runExecutionId,
+        batchId: getEnv("RUN_BATCH_ID") ?? undefined,
+        runTarget: getEnv("RUN_TARGET") ?? undefined,
         task: "knowledge-ingest",
     });
 }
@@ -139,6 +139,7 @@ export const buildSuggestedSlug = commandHelpers.buildSuggestedSlug;
 export const ensureUniqueSlugs = commandHelpers.ensureUniqueSlugs;
 export const deriveKnowledgeRemotePath = commandHelpers.deriveKnowledgeRemotePath;
 export const createKnowledgeIngestResult = commandHelpers.createKnowledgeIngestResult;
+export { runKnowledgeParser, runKnowledgeParsers, } from "./parser.js";
 function resolveExplicitUploadPath(inputPath) {
     return commandHelpers.resolveExplicitUploadPath(inputPath);
 }
@@ -171,109 +172,6 @@ function classifyListedUploadsForKnowledge(uploads) {
 function buildSourceReference(source) {
     return commandHelpers.buildSourceReference(source);
 }
-export async function runKnowledgeParser(input) {
-    const [result] = await runKnowledgeParsers({
-        files: [{
-                filePath: input.filePath,
-                description: input.description,
-                slug: input.slug,
-                sourceReference: input.sourceReference,
-            }],
-        outputDir: input.outputDir,
-        env: input.env,
-    });
-    if (!result) {
-        throw new Error("knowledge ingest parser returned no results");
-    }
-    return result;
-}
-function isMissingPythonExecutableError(error) {
-    if (!(error instanceof Error)) {
-        return false;
-    }
-    const errorWithCode = error;
-    if (errorWithCode.code === "ENOENT") {
-        return true;
-    }
-    return error.name === "NotFound" ||
-        /\bENOENT\b/i.test(error.message) ||
-        /not found/i.test(error.message) ||
-        /no such file or directory/i.test(error.message);
-}
-export async function executeKnowledgeParserCommand(input, deps = {}) {
-    const runCommandFn = deps.runCommandFn ?? runCommand;
-    let result;
-    try {
-        result = await runCommandFn("python3", {
-            args: [
-                input.scriptPath,
-                "--input-json",
-                input.inputJsonPath,
-                "--output-json",
-                input.outputJsonPath,
-            ],
-            ...(input.env ? { env: input.env } : {}),
-            capture: true,
-        });
-    }
-    catch (error) {
-        if (isMissingPythonExecutableError(error)) {
-            throw new Error("python3 is required. Install python3 and the supported parser packages, or run the command inside the Veryfront sandbox.");
-        }
-        throw error;
-    }
-    if (result.success) {
-        return;
-    }
-    const stderr = result.stderr?.trim();
-    const stdout = result.stdout?.trim();
-    if (result.code === 1 && !stderr && !stdout) {
-        throw new Error("python3 is required. Install python3 and the supported parser packages, or run the command inside the Veryfront sandbox.");
-    }
-    throw new Error(stderr || stdout || "parser exited unsuccessfully");
-}
-export async function runKnowledgeParsers(input) {
-    if (!input.files.length) {
-        return [];
-    }
-    const tempDir = await dntShim.Deno.makeTempDir({ prefix: "veryfront-knowledge-parser-" });
-    const inputJsonPath = `${tempDir}/input.json`;
-    const outputJsonPath = `${tempDir}/output.json`;
-    const scriptPath = `${tempDir}/ingest_document_to_knowledge.py`;
-    try {
-        try {
-            await dntShim.Deno.writeTextFile(inputJsonPath, JSON.stringify({
-                files: input.files.map((file) => ({
-                    file_path: file.filePath,
-                    description: file.description,
-                    slug: file.slug,
-                    source_reference: file.sourceReference,
-                })),
-                output_dir: input.outputDir,
-            }));
-            await dntShim.Deno.writeTextFile(scriptPath, knowledgeIngestPythonSource);
-            await executeKnowledgeParserCommand({
-                scriptPath,
-                inputJsonPath,
-                outputJsonPath,
-                env: input.env,
-            });
-            const raw = await dntShim.Deno.readTextFile(outputJsonPath);
-            const parsed = JSON.parse(raw);
-            return Array.isArray(parsed) ? parsed : [parsed];
-        }
-        catch (error) {
-            if (error instanceof Error && error.message.startsWith("knowledge ingest parser failed")) {
-                throw error;
-            }
-            const message = error instanceof Error ? error.message : String(error);
-            throw new Error(`knowledge ingest parser failed: ${message}`);
-        }
-    }
-    finally {
-        await dntShim.Deno.remove(tempDir, { recursive: true }).catch(() => undefined);
-    }
-}
 export async function collectKnowledgeSources(options, deps) {
     const fs = createFileSystem();
     if (options.sources.length > 0) {
@@ -513,7 +411,7 @@ export async function knowledgeCommand(args) {
                         eventLogger,
                         uploadKnowledgeFile: (remotePath, localPath) => putRemoteFileFromLocal(client, config.projectSlug, remotePath, localPath),
                     });
-                    const jobResult = buildKnowledgeIngestJobResult({
+                    const runResult = buildKnowledgeIngestRunResult({
                         requestedCount,
                         sourceMode,
                         knowledgePath: options.knowledgePath,
@@ -525,28 +423,28 @@ export async function knowledgeCommand(args) {
                         phase: "completed",
                         progress_current: requestedCount,
                         progress_total: requestedCount,
-                        ingested_count: jobResult.summary.ingested_count,
-                        skipped_count: jobResult.summary.skipped_count,
-                        failed_count: jobResult.summary.failed_count,
+                        ingested_count: runResult.summary.ingested_count,
+                        skipped_count: runResult.summary.skipped_count,
+                        failed_count: runResult.summary.failed_count,
                     });
-                    await writeJobResultIfConfigured(jobResult);
+                    await writeRunResultIfConfigured(runResult);
                     if (options.json) {
-                        printJson(jobResult);
+                        printJson(runResult);
                         return;
                     }
-                    for (const result of jobResult.ingested) {
+                    for (const result of runResult.ingested) {
                         if (!options.quiet) {
                             cliLogger.info(`Ingested ${result.source} -> ${result.remotePath}`);
                             cliLogger.info(`  ${result.summary}`);
                         }
                     }
-                    for (const skipped of jobResult.skipped) {
+                    for (const skipped of runResult.skipped) {
                         if (!options.quiet) {
                             cliLogger.warn(`Skipped ${skipped.source}`);
                             cliLogger.warn(`  ${skipped.message}`);
                         }
                     }
-                    for (const failure of jobResult.failed) {
+                    for (const failure of runResult.failed) {
                         if (!options.quiet) {
                             cliLogger.error(`Failed ${failure.source}`);
                             cliLogger.error(`  ${failure.message}`);

package/esm/cli/commands/knowledge/parser.d.ts

@@ -0,0 +1,40 @@
+export interface KnowledgeParserResult {
+    success: true;
+    source_path: string;
+    source_filename: string;
+    source_type: string;
+    slug: string;
+    sandbox_output_path: string;
+    suggested_project_path: string;
+    description: string;
+    title: string;
+    summary: string;
+    stats: Record<string, unknown>;
+    warnings: string[];
+}
+export interface KnowledgeParserInput {
+    filePath: string;
+    description?: string;
+    slug?: string;
+    sourceReference?: string;
+}
+export type ExtractDocumentText = (input: {
+    filePath: string;
+    mimeType: string;
+}) => Promise<string>;
+export interface RunKnowledgeParsersDeps {
+    extractDocumentText?: ExtractDocumentText;
+}
+export declare function slugifyKnowledgeValue(value: string): string;
+export declare function runKnowledgeParser(input: {
+    filePath: string;
+    outputDir: string;
+    description?: string;
+    slug?: string;
+    sourceReference?: string;
+}, deps?: RunKnowledgeParsersDeps): Promise<KnowledgeParserResult>;
+export declare function runKnowledgeParsers(input: {
+    files: KnowledgeParserInput[];
+    outputDir: string;
+}, deps?: RunKnowledgeParsersDeps): Promise<KnowledgeParserResult[]>;
+//# sourceMappingURL=parser.d.ts.map

package/esm/cli/commands/knowledge/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/parser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,KAC1C,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAqFD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D;AAyPD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,EAAE,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgBrE;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,EAAE,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAoEvE"}