@silvermoon-work/task-builder 0.0.0 → 0.1.0-canary-261109-1

package/dist/node.js

@@ -0,0 +1,142 @@
+import { constants } from "node:fs";
+import { mkdir, open, readdir, realpath, rmdir, stat, unlink } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { Readable } from "node:stream";
+import { checkTreePath, listTree, treeError, } from "./tree.js";
+function inside(root, path) {
+    const distance = relative(root, path);
+    return (!distance || (!distance.startsWith(`..${sep}`) && distance !== ".." && !distance.includes(":")));
+}
+/** A live read-only view, not an atomic snapshot. Confined dependency links are followed. */
+export async function directoryTree(directory) {
+    const root = await realpath(resolve(directory));
+    if (!(await stat(root)).isDirectory())
+        throw treeError("ENOTDIR", root, "Input must be a directory");
+    const locate = async (path) => {
+        checkTreePath(path);
+        const target = await realpath(join(root, ...path.split("/")));
+        if (!inside(root, target))
+            throw treeError("EINVAL", path, "Link escapes input tree");
+        return target;
+    };
+    return Object.freeze({
+        async list(path, options = {}) {
+            options.signal?.throwIfAborted();
+            const entries = [];
+            for (const entry of await readdir(await locate(path), { withFileTypes: true })) {
+                options.signal?.throwIfAborted();
+                const child = path ? `${path}/${entry.name}` : entry.name;
+                const target = entry.isSymbolicLink() ? await locate(child) : undefined;
+                const info = target ? await stat(target) : entry;
+                if (!info.isFile() && !info.isDirectory())
+                    throw treeError("EINVAL", child, "Tree contains a special file");
+                entries.push({
+                    name: entry.name,
+                    kind: info.isDirectory() ? "directory" : "file",
+                    ...(target !== undefined ? { target: relative(root, target).split(sep).join("/") } : {}),
+                });
+            }
+            return entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        },
+        async read(path, options = {}) {
+            options.signal?.throwIfAborted();
+            const target = await locate(path);
+            if (!(await stat(target)).isFile())
+                throw treeError("EISDIR", path, "Expected a regular file");
+            const handle = await open(target, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+            return Readable.toWeb(handle.createReadStream({
+                highWaterMark: 65_536,
+                ...(options.signal ? { signal: options.signal } : {}),
+            }));
+        },
+    });
+}
+/** Write sequentially into a new directory; never replace an existing output. */
+export async function writeDirectory(tree, directory, options = {}) {
+    options.signal?.throwIfAborted();
+    const output = resolve(directory);
+    const parent = await realpath(dirname(output));
+    if (parent !== dirname(output))
+        throw new Error("Output parent must be canonical, without links.");
+    await mkdir(output, { recursive: false });
+    const files = [];
+    const directories = [output];
+    const write = async (path) => {
+        for (const entry of await listTree(tree, path, options)) {
+            options.signal?.throwIfAborted();
+            const child = path ? `${path}/${entry.name}` : entry.name;
+            const target = join(output, ...child.split("/"));
+            if (entry.kind === "directory") {
+                await mkdir(target);
+                directories.push(target);
+                await write(child);
+            }
+            else {
+                const handle = await open(target, "wx");
+                files.push(target);
+                let reader;
+                let complete = false;
+                try {
+                    reader = (await tree.read(child, options)).getReader();
+                    for (;;) {
+                        options.signal?.throwIfAborted();
+                        const item = await reader.read();
+                        if (item.done) {
+                            complete = true;
+                            break;
+                        }
+                        let offset = 0;
+                        while (offset < item.value.byteLength) {
+                            options.signal?.throwIfAborted();
+                            const { bytesWritten } = await handle.write(item.value, offset);
+                            if (!bytesWritten)
+                                throw new Error(`Output write made no progress: ${child}`);
+                            offset += bytesWritten;
+                        }
+                    }
+                }
+                finally {
+                    try {
+                        if (reader) {
+                            try {
+                                if (!complete)
+                                    await reader.cancel();
+                            }
+                            finally {
+                                reader.releaseLock();
+                            }
+                        }
+                    }
+                    finally {
+                        await handle.close();
+                    }
+                }
+            }
+        }
+    };
+    try {
+        await write("");
+        return files.map((file) => relative(output, file).split(sep).join("/")).sort();
+    }
+    catch (error) {
+        const errors = [error];
+        for (const file of [...files].reverse())
+            try {
+                await unlink(file);
+            }
+            catch (cleanupError) {
+                errors.push(cleanupError);
+            }
+        for (const directory of [...directories].reverse())
+            try {
+                await rmdir(directory);
+            }
+            catch (cleanupError) {
+                errors.push(cleanupError);
+            }
+        if (errors.length > 1)
+            throw new AggregateError(errors, "Build failed and output cleanup failed.");
+        throw error;
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/dist/streams.d.ts

@@ -0,0 +1,3 @@
+import { type ReadonlyFileTree, type ReadOptions } from "./tree.js";
+export declare function resourceStream(input: ReadonlyFileTree, source: string, path: string, binary: boolean, fileBytes: number, observe: (path: string, bytes: number) => void, options: ReadOptions): ReadableStream<Uint8Array>;
+//# sourceMappingURL=streams.d.ts.map

package/dist/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE/E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,EAC9C,OAAO,EAAE,WAAW,GACnB,cAAc,CAAC,UAAU,CAAC,CA6E5B"}

package/dist/streams.js

@@ -0,0 +1,84 @@
+import { createTaskTextNormalizer } from "@silvermoon-work/task-protocol";
+import { treeError } from "./tree.js";
+export function resourceStream(input, source, path, binary, fileBytes, observe, options) {
+    let reader;
+    let pending;
+    let stopped = false;
+    let bytes = 0;
+    const normalizer = binary ? undefined : createTaskTextNormalizer(path);
+    let removeAbort = () => { };
+    const close = async (reason) => {
+        stopped = true;
+        removeAbort();
+        if (!reader && pending)
+            reader = (await pending).getReader();
+        if (reader) {
+            try {
+                await reader.cancel(reason);
+            }
+            finally {
+                reader.releaseLock();
+                reader = undefined;
+            }
+        }
+    };
+    return new ReadableStream({
+        start(controller) {
+            const abort = () => {
+                controller.error(options.signal?.reason);
+                void close(options.signal?.reason).catch((error) => {
+                    // Cancellation errors are observable through the errored output stream.
+                    controller.error(error);
+                });
+            };
+            options.signal?.addEventListener("abort", abort, { once: true });
+            removeAbort = () => options.signal?.removeEventListener("abort", abort);
+            if (options.signal?.aborted)
+                abort();
+        },
+        async pull(controller) {
+            try {
+                options.signal?.throwIfAborted();
+                if (!reader) {
+                    pending = input.read(source, options);
+                    const stream = await pending;
+                    if (stopped)
+                        return;
+                    reader = stream.getReader();
+                    pending = undefined;
+                }
+                for (;;) {
+                    const item = await reader.read();
+                    if (stopped)
+                        return;
+                    options.signal?.throwIfAborted();
+                    if (item.done) {
+                        normalizer?.finish();
+                        observe(path, bytes);
+                        reader.releaseLock();
+                        reader = undefined;
+                        stopped = true;
+                        removeAbort();
+                        controller.close();
+                        return;
+                    }
+                    const output = normalizer ? normalizer.push(item.value) : item.value.slice();
+                    bytes += output.byteLength;
+                    if (bytes > fileBytes)
+                        throw treeError("capacity_exceeded", path, "Resource exceeds byte limit");
+                    observe(path, bytes);
+                    if (output.byteLength) {
+                        controller.enqueue(output);
+                        return;
+                    }
+                }
+            }
+            catch (error) {
+                controller.error(error);
+                await close(error);
+            }
+        },
+        cancel: close,
+    }, { highWaterMark: 0 });
+}
+//# sourceMappingURL=streams.js.map

package/dist/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"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"}

package/dist/tree.d.ts

@@ -0,0 +1,19 @@
+export interface TreeEntry {
+    readonly name: string;
+    readonly kind: "file" | "directory";
+    /** Optional canonical tree-relative target for a filesystem dependency alias. */
+    readonly target?: string;
+}
+export interface ReadOptions {
+    readonly signal?: AbortSignal;
+}
+export interface ReadonlyFileTree {
+    list(path: string, options?: ReadOptions): Promise<readonly TreeEntry[]>;
+    read(path: string, options?: ReadOptions): Promise<ReadableStream<Uint8Array>>;
+}
+export declare function treeError(code: string, path: string, message: string): NodeJS.ErrnoException;
+export declare function checkTreePath(path: string): void;
+export declare function listTree(tree: ReadonlyFileTree, path: string, options?: ReadOptions): Promise<readonly TreeEntry[]>;
+export declare function readBytes(tree: ReadonlyFileTree, path: string, limit: number, options?: ReadOptions, observe?: (bytes: number) => void): Promise<Uint8Array>;
+export declare function memoryFile(bytes: Uint8Array, options?: ReadOptions): import("stream/web").ReadableStream<Uint8Array<ArrayBufferLike>>;
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;CAChF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAE5F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAUhD;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAkB/B;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,EACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,UAAU,CAAC,CAkCrB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgB,oEAetE"}

package/dist/tree.js

@@ -0,0 +1,84 @@
+export function treeError(code, path, message) {
+    return Object.assign(new Error(`${message}: ${path || "."}`), { code, path });
+}
+export function checkTreePath(path) {
+    if (path !== "" &&
+        (path.startsWith("/") ||
+            path.includes("\\") ||
+            path.includes(":") ||
+            [...path].some((character) => character.charCodeAt(0) < 32) ||
+            path.split("/").some((part) => !part || part === "." || part === "..")))
+        throw treeError("EINVAL", path, "Expected a relative file-tree path");
+}
+export async function listTree(tree, path, options = {}) {
+    checkTreePath(path);
+    options.signal?.throwIfAborted();
+    const entries = await tree.list(path, options);
+    const names = new Set();
+    for (const entry of entries) {
+        checkTreePath(entry.name);
+        if (entry.target !== undefined)
+            checkTreePath(entry.target);
+        if (!entry.name ||
+            entry.name.includes("/") ||
+            names.has(entry.name) ||
+            !["file", "directory"].includes(entry.kind))
+            throw treeError("EINVAL", path, "Invalid or duplicate tree entry");
+        names.add(entry.name);
+    }
+    return [...entries].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}
+export async function readBytes(tree, path, limit, options = {}, observe) {
+    checkTreePath(path);
+    options.signal?.throwIfAborted();
+    const reader = (await tree.read(path, options)).getReader();
+    let abort = () => { };
+    const aborted = new Promise((_resolve, reject) => {
+        abort = () => reject(options.signal?.reason);
+    });
+    options.signal?.addEventListener("abort", abort, { once: true });
+    const chunks = [];
+    let length = 0;
+    let complete = false;
+    try {
+        for (;;) {
+            options.signal?.throwIfAborted();
+            const item = await Promise.race([reader.read(), aborted]);
+            options.signal?.throwIfAborted();
+            if (item.done) {
+                complete = true;
+                return Buffer.concat(chunks, length);
+            }
+            length += item.value.byteLength;
+            if (length > limit)
+                throw treeError("capacity_exceeded", path, "File exceeds byte limit");
+            observe?.(item.value.byteLength);
+            chunks.push(item.value.slice());
+        }
+    }
+    finally {
+        options.signal?.removeEventListener("abort", abort);
+        try {
+            if (!complete)
+                await reader.cancel();
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+export function memoryFile(bytes, options = {}) {
+    let sent = false;
+    return new ReadableStream({
+        pull(controller) {
+            options.signal?.throwIfAborted();
+            if (sent)
+                controller.close();
+            else {
+                sent = true;
+                controller.enqueue(bytes.slice());
+            }
+        },
+    }, { highWaterMark: 0 });
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"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"}

package/examples/echo/assets/greeting.txt

@@ -0,0 +1 @@
+Hello

package/examples/echo/src/contract.json

@@ -0,0 +1,15 @@
+{
+  "input": {
+    "type": "object",
+    "properties": { "text": { "type": "string" } },
+    "required": ["text"],
+    "additionalProperties": false
+  },
+  "result": {
+    "type": "object",
+    "properties": { "text": { "type": "string" } },
+    "required": ["text"],
+    "additionalProperties": false
+  },
+  "message": false
+}

package/examples/echo/src/main.ts

@@ -0,0 +1,18 @@
+import { runTask } from "@potential-guide/task-sdk";
+
+runTask<{ text: string }, { text: string }>(async (input, context) => {
+  const reader = context.bundle.read("resources/greeting.txt").getReader();
+  const decoder = new TextDecoder();
+  let greeting = "";
+  try {
+    for (;;) {
+      const item = await reader.read();
+      if (item.done) break;
+      greeting += decoder.decode(item.value, { stream: true });
+    }
+    greeting += decoder.decode();
+  } finally {
+    reader.releaseLock();
+  }
+  return { text: `${greeting.trim()} ${input.text}` };
+});

package/examples/echo/task.build.yaml

@@ -0,0 +1,12 @@
+name: Echo
+runtime:
+  minVersion: "22.13.0"
+source:
+  entry: src/main.ts
+  contract: src/contract.json
+  mode: explicit
+include:
+  - from: assets/**
+    to: resources/
+outDirectory: dist
+binary: []

package/package.json

@@ -1,13 +1,62 @@
 {
   "name": "@silvermoon-work/task-builder",
-  "version": "0.0.0",
-  "description": "Task builder for composing and configuring generic task pipelines. Bootstrap placeholder only.",
+  "version": "0.1.0-canary-261109-1",
+  "description": "Task Bundle builds from read-only file trees with streaming resources.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "bin": {
+    "task-builder": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "license": "MIT",
+  "dependencies": {
+    "@sinclair/typebox": "0.34.52",
+    "enhanced-resolve": "5.18.3",
+    "esbuild": "0.25.12",
+    "yaml": "2.9.1",
+    "@silvermoon-work/task-protocol": "0.1.0-canary-261109-2"
+  },
+  "devDependencies": {
+    "@potential-guide/task-sdk": "0.1.0-rc.2"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/silvermoon-work/task-engine.git"
+    "url": "git+https://github.com/silvermoon-work/task-engine.git",
+    "directory": "packages/task-builder"
   },
-  "publishConfig": {
-    "access": "public"
+  "homepage": "https://github.com/silvermoon-work/task-engine/tree/main/packages/task-builder#readme",
+  "bugs": {
+    "url": "https://github.com/silvermoon-work/task-engine/issues"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "node -e \"for (const path of ['dist', '.cache']) require('node:fs').rmSync(path, { recursive: true, force: true })\"",
+    "lint": "biome lint .",
+    "test": "tsx --test \"test/*.test.ts\"",
+    "typecheck": "tsc -b --pretty false"
   }
-}
+}