veryfront 0.1.996 → 0.1.998

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.998";
 //# 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.998";

package/esm/src/workflow/blob/local-storage.d.ts

@@ -0,0 +1,32 @@
+import type { BlobRef, BlobStorage, StoreBlobOptions } from "./types.js";
+export declare class LocalBlobStorage implements BlobStorage {
+    private rootDir;
+    private baseUrl?;
+    private fs;
+    private now;
+    constructor(rootDir: string, baseUrl?: string, options?: {
+        now?: () => Date;
+    });
+    private getPath;
+    private getMetadataPath;
+    put(data: string | Uint8Array | Blob | ReadableStream, options?: StoreBlobOptions): Promise<BlobRef>;
+    private normalizeToBytes;
+    getStream(id: string): Promise<ReadableStream | null>;
+    getText(id: string): Promise<string | null>;
+    getBytes(id: string): Promise<Uint8Array | null>;
+    delete(id: string): Promise<void>;
+    exists(id: string): Promise<boolean>;
+    stat(id: string): Promise<BlobRef | null>;
+    /**
+     * Enumerate every stored (non-expired) blob, newest first. Walks the same
+     * two-char-prefix partitions as {@link cleanupExpiredBlobs}, reading each
+     * `.meta.json` sidecar. Used by the chat upload handler's list endpoint.
+     */
+    list(): Promise<BlobRef[]>;
+    /**
+     * Cleans up all expired blobs from storage.
+     * This method should typically be run periodically by an external process.
+     */
+    cleanupExpiredBlobs(): Promise<void>;
+}
+//# sourceMappingURL=local-storage.d.ts.map

package/esm/src/workflow/blob/local-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/blob/local-storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMzE,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,GAAG,CAAa;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;IAO7E,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,eAAe;IAIjB,GAAG,CACP,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,cAAc,EACjD,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC;YA4BL,gBAAgB;IAwBxB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAarD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS3C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAShD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAe/C;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA0BhC;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB3C"}

package/esm/src/workflow/blob/local-storage.js

@@ -0,0 +1,179 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { dirname, join } from "../../platform/compat/path/index.js";
+import { createFileSystem } from "../../platform/compat/fs.js";
+import { agentLogger } from "../../utils/index.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
+const logger = agentLogger.component("local-blob-storage");
+export class LocalBlobStorage {
+    rootDir;
+    baseUrl;
+    fs;
+    now;
+    constructor(rootDir, baseUrl, options) {
+        this.rootDir = rootDir;
+        this.baseUrl = baseUrl;
+        this.fs = createFileSystem();
+        this.now = options?.now ?? (() => new Date());
+    }
+    getPath(id) {
+        // Partition by first 2 chars to avoid too many files in one dir
+        const prefix = id.slice(0, 2);
+        return join(this.rootDir, prefix, id);
+    }
+    getMetadataPath(id) {
+        return `${this.getPath(id)}.meta.json`;
+    }
+    async put(data, options = {}) {
+        const id = options.id ?? dntShim.crypto.randomUUID();
+        const filePath = this.getPath(id);
+        const metaPath = this.getMetadataPath(id);
+        await this.fs.mkdir(dirname(filePath), { recursive: true });
+        const { bytes, size } = await this.normalizeToBytes(data);
+        await this.fs.writeFile(filePath, bytes);
+        const createdAt = this.now();
+        const expiresAt = options.ttl ? new Date(createdAt.getTime() + options.ttl * 1000) : undefined;
+        const ref = {
+            __kind: "blob",
+            id,
+            size,
+            mimeType: options.mimeType ?? "application/octet-stream",
+            createdAt,
+            expiresAt,
+            metadata: options.metadata,
+            url: this.baseUrl ? `${this.baseUrl}/${id}` : undefined,
+        };
+        await this.fs.writeTextFile(metaPath, JSON.stringify(ref));
+        return ref;
+    }
+    async normalizeToBytes(data) {
+        if (typeof data === "string") {
+            const bytes = new TextEncoder().encode(data);
+            return { bytes, size: bytes.length };
+        }
+        if (data instanceof Uint8Array)
+            return { bytes: data, size: data.length };
+        if (data instanceof Blob) {
+            const bytes = new Uint8Array(await data.arrayBuffer());
+            return { bytes, size: data.size };
+        }
+        if (data instanceof ReadableStream) {
+            // Normalize stream to bytes for cross-runtime compatibility
+            const bytes = new Uint8Array(await new Response(data).arrayBuffer());
+            return { bytes, size: bytes.length };
+        }
+        throw INVALID_ARGUMENT.create({ detail: "Unsupported data type for LocalBlobStorage" });
+    }
+    async getStream(id) {
+        const bytes = await this.getBytes(id);
+        if (!bytes)
+            return null;
+        // Create a minimal cross-runtime ReadableStream from the bytes
+        return new ReadableStream({
+            start(controller) {
+                controller.enqueue(bytes);
+                controller.close();
+            },
+        });
+    }
+    async getText(id) {
+        try {
+            return await this.fs.readTextFile(this.getPath(id));
+        }
+        catch (_) {
+            /* expected: file not found returns null */
+            return null;
+        }
+    }
+    async getBytes(id) {
+        try {
+            return await this.fs.readFile(this.getPath(id));
+        }
+        catch (_) {
+            /* expected: file not found returns null */
+            return null;
+        }
+    }
+    async delete(id) {
+        try {
+            await this.fs.remove(this.getPath(id));
+            await this.fs.remove(this.getMetadataPath(id));
+        }
+        catch (_) {
+            /* expected: file may not exist during cleanup */
+        }
+    }
+    async exists(id) {
+        return this.fs.exists(this.getPath(id));
+    }
+    async stat(id) {
+        try {
+            const json = await this.fs.readTextFile(this.getMetadataPath(id));
+            const data = JSON.parse(json);
+            return {
+                ...data,
+                createdAt: new Date(data.createdAt),
+                expiresAt: data.expiresAt ? new Date(data.expiresAt) : undefined,
+            };
+        }
+        catch (_) {
+            /* expected: metadata file not found or invalid JSON */
+            return null;
+        }
+    }
+    /**
+     * Enumerate every stored (non-expired) blob, newest first. Walks the same
+     * two-char-prefix partitions as {@link cleanupExpiredBlobs}, reading each
+     * `.meta.json` sidecar. Used by the chat upload handler's list endpoint.
+     */
+    async list() {
+        const now = this.now();
+        const refs = [];
+        for (let i = 0; i < 256; i++) {
+            const prefix = i.toString(16).padStart(2, "0");
+            const prefixDir = join(this.rootDir, prefix);
+            try {
+                for await (const entry of this.fs.readDir(prefixDir)) {
+                    if (!entry.isFile || !entry.name.endsWith(".meta.json"))
+                        continue;
+                    const id = entry.name.replace(".meta.json", "");
+                    const ref = await this.stat(id);
+                    if (!ref)
+                        continue;
+                    if (ref.expiresAt && ref.expiresAt < now)
+                        continue;
+                    refs.push(ref);
+                }
+            }
+            catch (_) {
+                /* expected: partition directory may not exist yet */
+            }
+        }
+        return refs.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    /**
+     * Cleans up all expired blobs from storage.
+     * This method should typically be run periodically by an external process.
+     */
+    async cleanupExpiredBlobs() {
+        const now = this.now();
+        for (let i = 0; i < 256; i++) {
+            const prefix = i.toString(16).padStart(2, "0");
+            const prefixDir = join(this.rootDir, prefix);
+            try {
+                for await (const entry of this.fs.readDir(prefixDir)) {
+                    if (!entry.isFile || !entry.name.endsWith(".meta.json"))
+                        continue;
+                    const id = entry.name.replace(".meta.json", "");
+                    const blobRef = await this.stat(id);
+                    if (!blobRef?.expiresAt || blobRef.expiresAt >= now)
+                        continue;
+                    logger.debug(`Deleting expired blob: ${id}`);
+                    await this.delete(id);
+                }
+            }
+            catch (_) {
+                /* expected: directory may not exist yet */
+            }
+        }
+    }
+}

package/esm/src/workflow/blob/types.d.ts

@@ -27,5 +27,10 @@ export interface BlobStorage {
     delete(id: string): Promise<void>;
     exists(id: string): Promise<boolean>;
     stat(id: string): Promise<BlobRef | null>;
+    /**
+     * Enumerate stored blobs, newest first. Optional — only backends that can
+     * cheaply list (e.g. local disk) implement it; callers must feature-detect.
+     */
+    list?(): Promise<BlobRef[]>;
 }
 //# sourceMappingURL=types.d.ts.map

package/esm/src/workflow/blob/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/blob/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,cAAc,EACjD,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC3C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/blob/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,cAAc,EACjD,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC1C;;;OAGG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC7B"}

package/esm/src/workflow/blob/veryfront-cloud-storage.d.ts

@@ -25,6 +25,17 @@ export declare class VeryfrontCloudBlobStorage implements BlobStorage {
     delete(id: string): Promise<void>;
     exists(id: string): Promise<boolean>;
     stat(id: string): Promise<BlobRef | null>;
+    /**
+     * Enumerate blobs under this store's prefix, newest first. The list endpoint
+     * (`GET /projects/{slug}/uploads`) carries only paths — the original filename
+     * lives in each blob's sidecar — so ids are recovered from the `.blob` data
+     * paths and enriched via {@link stat} (one extra request per blob). Suitable
+     * for an uploads panel; not a hot path.
+     *
+     * Note: a single page is fetched. If the project accumulates more uploads than
+     * one page, pagination will need wiring here.
+     */
+    list(): Promise<BlobRef[]>;
     private resolveConfig;
     private assertSafeBlobId;
     private getDataPath;

package/esm/src/workflow/blob/veryfront-cloud-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"veryfront-cloud-storage.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/blob/veryfront-cloud-storage.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA0DzE,MAAM,WAAW,+BAA+B;IAC9C,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AA6FD,qBAAa,yBAA0B,YAAW,WAAW;IAC3D,OAAO,CAAC,MAAM,CAAkC;gBAEpC,MAAM,GAAE,+BAAoC;IAIlD,GAAG,CACP,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,cAAc,EACjD,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC;IAkEb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM3C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMhD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA0B/C,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,eAAe;YAKT,UAAU;YA2CV,iBAAiB;YAkBjB,YAAY;YAgBZ,cAAc;YAwBd,cAAc;YAuBd,kBAAkB;YASlB,WAAW;CAwC1B"}
+{"version":3,"file":"veryfront-cloud-storage.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/blob/veryfront-cloud-storage.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiEzE,MAAM,WAAW,+BAA+B;IAC9C,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AA6FD,qBAAa,yBAA0B,YAAW,WAAW;IAC3D,OAAO,CAAC,MAAM,CAAkC;gBAEpC,MAAM,GAAE,+BAAoC;IAIlD,GAAG,CACP,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,cAAc,EACjD,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC;IAkEb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM3C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMhD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA0B/C;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA2BhC,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,eAAe;YAKT,UAAU;YA2CV,iBAAiB;YAkBjB,YAAY;YAgBZ,cAAc;YAwBd,cAAc;YAuBd,kBAAkB;YASlB,WAAW;CAwC1B"}

package/esm/src/workflow/blob/veryfront-cloud-storage.js

@@ -30,6 +30,9 @@ const getUploadSignedUrlResponseSchema = defineSchema((v) => v.object({
     signed_url: v.string().url(),
     expires_at: v.string(),
 }));
+const getUploadListResponseSchema = defineSchema((v) => v.object({
+    data: v.array(v.object({ path: v.string().optional() }).passthrough()).optional(),
+}));
 const getBlobMetadataSchema = defineSchema((v) => v.object({
     version: v.literal(1),
     id: v.string(),
@@ -42,6 +45,7 @@ const getBlobMetadataSchema = defineSchema((v) => v.object({
 const UploadCreateResponseSchema = lazySchema(getUploadCreateResponseSchema);
 const UploadMetadataResponseSchema = lazySchema(getUploadMetadataResponseSchema);
 const UploadSignedUrlResponseSchema = lazySchema(getUploadSignedUrlResponseSchema);
+const UploadListResponseSchema = lazySchema(getUploadListResponseSchema);
 const BlobMetadataSchema = lazySchema(getBlobMetadataSchema);
 function normalizePrefix(prefix) {
     const value = (prefix ?? DEFAULT_PREFIX).trim().replace(/^\/+/, "");
@@ -216,6 +220,38 @@ export class VeryfrontCloudBlobStorage {
         const ref = mapUploadMetadataToRef(upload, id);
         return await attachSignedUrl(ref, dataPath, resolved, this.getDownloadUrl.bind(this));
     }
+    /**
+     * Enumerate blobs under this store's prefix, newest first. The list endpoint
+     * (`GET /projects/{slug}/uploads`) carries only paths — the original filename
+     * lives in each blob's sidecar — so ids are recovered from the `.blob` data
+     * paths and enriched via {@link stat} (one extra request per blob). Suitable
+     * for an uploads panel; not a hot path.
+     *
+     * Note: a single page is fetched. If the project accumulates more uploads than
+     * one page, pagination will need wiring here.
+     */
+    async list() {
+        const resolved = this.resolveConfig();
+        const raw = await this.requestJson("GET", `/projects/${encodeURIComponent(resolved.projectSlug)}/uploads`, resolved, { headers: { Accept: "application/json" }, allowNotFound: true });
+        if (!raw)
+            return [];
+        const parsed = UploadListResponseSchema.parse(raw);
+        const ids = [];
+        for (const item of parsed.data ?? []) {
+            const path = item.path;
+            // Only the data objects under our prefix — skip `.meta.json` sidecars and
+            // anything another store namespaced elsewhere.
+            if (!path || !path.startsWith(resolved.prefix) || !path.endsWith(DATA_SUFFIX))
+                continue;
+            const id = path.slice(resolved.prefix.length, path.length - DATA_SUFFIX.length);
+            if (SAFE_BLOB_ID_PATTERN.test(id))
+                ids.push(id);
+        }
+        const refs = await Promise.all(ids.map((id) => this.stat(id)));
+        return refs
+            .filter((ref) => ref !== null)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
     resolveConfig() {
         const apiBaseUrl = this.config.apiBaseUrl ?? getVeryfrontCloudBootstrap().apiBaseUrl;
         const apiToken = this.config.apiToken ?? getVeryfrontCloudAuthToken();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.996",
+  "version": "0.1.998",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -61,6 +61,10 @@
       "import": "./esm/src/chat/types.js",
       "types": "./esm/src/chat/types.d.ts"
     },
+    "./chat/uploads": {
+      "import": "./esm/src/chat/upload-handler.js",
+      "types": "./esm/src/chat/upload-handler.d.ts"
+    },
     "./markdown": {
       "import": "./esm/src/markdown/index.js",
       "types": "./esm/src/markdown/index.d.ts"
@@ -149,6 +153,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"

package/esm/src/react/components/chat/chat/components/uploads-panel.d.ts

@@ -1,20 +0,0 @@
-import * as React from "../../../../../../react/react.js";
-/** Public API contract for uploaded file. */
-export interface UploadedFile {
-    id: string;
-    name: string;
-    size?: number;
-    type?: string;
-    url?: string;
-}
-/** Props accepted by uploads panel. */
-export interface UploadsPanelProps {
-    uploads?: UploadedFile[];
-    onRemoveUpload?: (id: string) => void;
-    onAttach?: (files: FileList) => void;
-    attachAccept?: string;
-    className?: string;
-}
-/** Render uploads panel. */
-export declare function UploadsPanel({ uploads, onRemoveUpload, onAttach, attachAccept, className, }: UploadsPanelProps): React.ReactElement;
-//# sourceMappingURL=uploads-panel.d.ts.map

package/esm/src/react/components/chat/chat/components/uploads-panel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"uploads-panel.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/components/uploads-panel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,kCAAkC,CAAC;AAI1D,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,EAC3B,OAAY,EACZ,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CA8GxC"}