veryfront 0.1.996 → 0.1.997

package/esm/deno.d.ts

@@ -42,6 +42,7 @@ declare namespace _default {
         "./runs": string;
         "./skill": string;
         "./trigger": string;
+        "./task": string;
         "./schedule": string;
         "./webhook": string;
         "./mcp": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.996",
+    "version": "0.1.997",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {
@@ -98,6 +98,7 @@ export default {
         "./runs": "./src/runs/index.ts",
         "./skill": "./src/skill/index.ts",
         "./trigger": "./src/trigger/index.ts",
+        "./task": "./src/task/index.ts",
         "./schedule": "./src/schedule/index.ts",
         "./webhook": "./src/webhook/index.ts",
         "./mcp": "./src/mcp/index.ts",

package/esm/src/task/discovery.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Task Discovery
+ *
+ * Discovers task definitions from user's project `tasks/` directory.
+ * Follows the same patterns as workflow-discovery.ts.
+ *
+ * Scans:
+ * - tasks/*.ts - task definition files
+ * - tasks/**\/*.ts - nested task files
+ *
+ * Task files should export a task definition:
+ * ```typescript
+ * export default {
+ *   name: "Sync external data",
+ *   run: async (ctx) => {
+ *     console.log("Syncing data...")
+ *     return { synced: 42 }
+ *   }
+ * }
+ * ```
+ */
+import type { RuntimeAdapter } from "../platform/index.js";
+import type { VeryfrontConfig } from "../config/index.js";
+import type { TaskDefinition } from "./types.js";
+/**
+ * Discovered task info.
+ *
+ * @deprecated Use project runtime discovery helpers from `veryfront/task`
+ * instead. Runtime discovery keeps tasks, tools, agents, and cloud runs on the
+ * same project discovery path.
+ */
+export interface DiscoveredTask {
+    /** Task ID derived from file path (e.g., "sync-data" from tasks/sync-data.ts) */
+    id: string;
+    /** Human-readable name from task definition */
+    name: string;
+    /** File path where the task is defined */
+    filePath: string;
+    /** Export name (e.g., "default" or named export) */
+    exportName: string;
+    /** The task definition */
+    definition: TaskDefinition;
+}
+/**
+ * Options for file-based task discovery.
+ *
+ * @deprecated Use `discoverProjectTaskRuntime` instead.
+ */
+export interface TaskDiscoveryOptions {
+    /** Project directory */
+    projectDir: string;
+    /** Runtime adapter for filesystem operations */
+    adapter: RuntimeAdapter;
+    /** Veryfront config (for import maps, etc.) */
+    config?: VeryfrontConfig;
+    /** Base directory for tasks (default: "tasks") */
+    tasksDir?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Result of file-based task discovery.
+ *
+ * @deprecated Use `DiscoveryResult` from project runtime discovery instead.
+ */
+export interface TaskDiscoveryResult {
+    /** All discovered tasks */
+    tasks: DiscoveredTask[];
+    /** Errors encountered during discovery */
+    errors: Array<{
+        filePath: string;
+        error: string;
+    }>;
+}
+/**
+ * Derive task ID from file path (e.g., "tasks/sync-data.ts" -> "sync-data").
+ *
+ * @deprecated Use project runtime task IDs from `discoverProjectTaskRuntime`
+ * instead.
+ */
+export declare function deriveTaskId(filePath: string, tasksDir: string): string;
+/**
+ * Discover all tasks in a project with the legacy file-based path.
+ *
+ * @deprecated Use `discoverProjectTaskRuntime` instead.
+ */
+export declare function discoverTasks(options: TaskDiscoveryOptions): Promise<TaskDiscoveryResult>;
+/**
+ * Find a specific task by ID through the legacy file-based path.
+ *
+ * @deprecated Use `discoverProjectTaskRuntime` and `findProjectRuntimeTask`
+ * instead.
+ */
+export declare function findTaskById(taskId: string, options: TaskDiscoveryOptions): Promise<DiscoveredTask | null>;
+//# sourceMappingURL=discovery.d.ts.map

package/esm/src/task/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/src/task/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAajD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IAEX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IAEb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IAEjB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,gDAAgD;IAChD,OAAO,EAAE,cAAc,CAAC;IAExB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB,0CAA0C;IAC1C,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAwED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASvE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAiE9B;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAuChC"}

package/esm/src/task/discovery.js

@@ -0,0 +1,192 @@
+/**
+ * Task Discovery
+ *
+ * Discovers task definitions from user's project `tasks/` directory.
+ * Follows the same patterns as workflow-discovery.ts.
+ *
+ * Scans:
+ * - tasks/*.ts - task definition files
+ * - tasks/**\/*.ts - nested task files
+ *
+ * Task files should export a task definition:
+ * ```typescript
+ * export default {
+ *   name: "Sync external data",
+ *   run: async (ctx) => {
+ *     console.log("Syncing data...")
+ *     return { synced: 42 }
+ *   }
+ * }
+ * ```
+ */
+import { join } from "../../deps/jsr.io/@std/path/1.1.4/mod.js";
+import { logger as baseLogger } from "../utils/index.js";
+import { collectFiles } from "../utils/file-discovery.js";
+import { importDiscoveryModule } from "../discovery/module-import.js";
+import { isTaskDefinition } from "./types.js";
+const logger = baseLogger.component("task-discovery");
+const TASK_FILE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx"];
+const TASK_IGNORE_PATTERNS = [
+    "node_modules",
+    ".git",
+    "__tests__",
+    "*.test.*",
+    "*.spec.*",
+];
+function resolveTasksBaseDir(projectDir, tasksDir, config) {
+    const fsType = config?.fs?.type ?? "local";
+    return fsType === "github" || fsType === "veryfront-api" ? tasksDir : join(projectDir, tasksDir);
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function collectTaskFiles(baseDir, adapter) {
+    return await collectFiles({
+        baseDir,
+        extensions: [...TASK_FILE_EXTENSIONS],
+        recursive: true,
+        ignorePatterns: [...TASK_IGNORE_PATTERNS],
+        adapter,
+    });
+}
+function extractTaskExport(module) {
+    const defaultExport = module.default;
+    if (isTaskDefinition(defaultExport)) {
+        return { exportName: "default", definition: defaultExport };
+    }
+    for (const [exportName, value] of Object.entries(module)) {
+        if (exportName !== "default" && isTaskDefinition(value)) {
+            return { exportName, definition: value };
+        }
+    }
+    return null;
+}
+async function loadTaskFromFile(filePath, id, adapter, projectDir) {
+    const module = await importDiscoveryModule(filePath, {
+        adapter,
+        projectDir,
+    });
+    const taskExport = extractTaskExport(module);
+    if (!taskExport)
+        return null;
+    return {
+        id,
+        name: taskExport.definition.name || id,
+        filePath,
+        exportName: taskExport.exportName,
+        definition: taskExport.definition,
+    };
+}
+function logDiscoveredTask(task, debug) {
+    if (debug) {
+        logger.info(`Found task "${task.id}" in ${task.filePath} (export: ${task.exportName})`);
+    }
+}
+/**
+ * Derive task ID from file path (e.g., "tasks/sync-data.ts" -> "sync-data").
+ *
+ * @deprecated Use project runtime task IDs from `discoverProjectTaskRuntime`
+ * instead.
+ */
+export function deriveTaskId(filePath, tasksDir) {
+    // Remove the tasks dir prefix and extension
+    let relative = filePath;
+    const dirPrefix = tasksDir.endsWith("/") ? tasksDir : `${tasksDir}/`;
+    if (relative.startsWith(dirPrefix)) {
+        relative = relative.slice(dirPrefix.length);
+    }
+    // Remove extension
+    return relative.replace(/\.(ts|tsx|js|jsx)$/, "");
+}
+/**
+ * Discover all tasks in a project with the legacy file-based path.
+ *
+ * @deprecated Use `discoverProjectTaskRuntime` instead.
+ */
+export async function discoverTasks(options) {
+    const { projectDir, adapter, config, tasksDir = "tasks", debug = false, } = options;
+    const tasks = [];
+    const errors = [];
+    const baseDir = resolveTasksBaseDir(projectDir, tasksDir, config);
+    if (debug) {
+        logger.info(`Scanning ${baseDir} for tasks`);
+    }
+    try {
+        const dirExists = await adapter.fs.exists(baseDir);
+        if (!dirExists) {
+            if (debug) {
+                logger.info(`No tasks directory found at ${baseDir}`);
+            }
+            return { tasks, errors };
+        }
+        const files = await collectTaskFiles(baseDir, adapter);
+        if (debug) {
+            logger.info(`Found ${files.length} potential task files`);
+        }
+        for (const file of files) {
+            try {
+                const task = await loadTaskFromFile(file.path, deriveTaskId(file.path, baseDir), adapter, projectDir);
+                if (task) {
+                    tasks.push(task);
+                    logDiscoveredTask(task, debug);
+                }
+            }
+            catch (error) {
+                const errorMsg = toErrorMessage(error);
+                errors.push({ filePath: file.path, error: errorMsg });
+                if (debug) {
+                    logger.warn(`Failed to load ${file.path}: ${errorMsg}`);
+                }
+            }
+        }
+        if (debug) {
+            logger.info(`Discovered ${tasks.length} tasks`);
+        }
+        return { tasks, errors };
+    }
+    catch (error) {
+        const errorMsg = toErrorMessage(error);
+        logger.error(`Task discovery failed: ${errorMsg}`);
+        errors.push({ filePath: baseDir, error: errorMsg });
+        return { tasks, errors };
+    }
+}
+/**
+ * Find a specific task by ID through the legacy file-based path.
+ *
+ * @deprecated Use `discoverProjectTaskRuntime` and `findProjectRuntimeTask`
+ * instead.
+ */
+export async function findTaskById(taskId, options) {
+    const { projectDir, adapter, config, tasksDir = "tasks", debug = false, } = options;
+    const baseDir = resolveTasksBaseDir(projectDir, tasksDir, config);
+    try {
+        const dirExists = await adapter.fs.exists(baseDir);
+        if (!dirExists)
+            return null;
+        const files = await collectTaskFiles(baseDir, adapter);
+        for (const file of files) {
+            const id = deriveTaskId(file.path, baseDir);
+            if (id !== taskId)
+                continue;
+            try {
+                const task = await loadTaskFromFile(file.path, id, adapter, projectDir);
+                if (task) {
+                    logDiscoveredTask(task, debug);
+                    return task;
+                }
+            }
+            catch (error) {
+                const errorMsg = toErrorMessage(error);
+                if (debug) {
+                    logger.warn(`Failed to load ${file.path}: ${errorMsg}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        const errorMsg = toErrorMessage(error);
+        logger.error(`Task discovery failed while finding "${taskId}": ${errorMsg}`);
+    }
+    return null;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * Source-defined tasks for Veryfront projects.
+ *
+ * @module task
+ *
+ * @example Define a task in tasks/sync-data.ts
+ * ```ts
+ * import type { TaskContext } from "veryfront/task";
+ *
+ * export default {
+ *   name: "Sync external data",
+ *   async run(ctx: TaskContext) {
+ *     return { synced: 42 };
+ *   },
+ * };
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export type { TaskContext, TaskDefinition } from "./types.js";
+export { isTaskDefinition } from "./types.js";
+export { deriveTaskId, discoverTasks, findTaskById } from "./discovery.js";
+export type { DiscoveredTask, TaskDiscoveryOptions, TaskDiscoveryResult } from "./discovery.js";
+export { runTask } from "./runner.js";
+export type { RunnableTask, RunTaskOptions, TaskRunResult } from "./runner.js";
+export { discoverProjectTaskRuntime, findProjectRuntimeTask, formatProjectRuntimeDiscoveryErrors, listProjectRuntimeTasks, } from "./project-runtime.js";
+export type { ProjectTaskRuntimeOptions } from "./project-runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/task/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,yBAAyB,CAAC;AAEjC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,mCAAmC,EACnC,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/task/index.js

@@ -0,0 +1,22 @@
+/**
+ * Source-defined tasks for Veryfront projects.
+ *
+ * @module task
+ *
+ * @example Define a task in tasks/sync-data.ts
+ * ```ts
+ * import type { TaskContext } from "veryfront/task";
+ *
+ * export default {
+ *   name: "Sync external data",
+ *   async run(ctx: TaskContext) {
+ *     return { synced: 42 };
+ *   },
+ * };
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { isTaskDefinition } from "./types.js";
+export { deriveTaskId, discoverTasks, findTaskById } from "./discovery.js";
+export { runTask } from "./runner.js";
+export { discoverProjectTaskRuntime, findProjectRuntimeTask, formatProjectRuntimeDiscoveryErrors, listProjectRuntimeTasks, } from "./project-runtime.js";

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

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.996";
+export declare const VERSION = "0.1.997";
 //# 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.996";
+export const VERSION = "0.1.997";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.996",
+  "version": "0.1.997",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -149,6 +149,10 @@
       "import": "./esm/src/trigger/index.js",
       "types": "./esm/src/trigger/index.d.ts"
     },
+    "./task": {
+      "import": "./esm/src/task/index.js",
+      "types": "./esm/src/task/index.d.ts"
+    },
     "./schedule": {
       "import": "./esm/src/schedule/index.js",
       "types": "./esm/src/schedule/index.d.ts"