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

package/dist/init.js

@@ -0,0 +1,100 @@
+import { taskSchemaUri, validateTaskBundle } from "@silvermoon-work/task-protocol";
+import { stringify } from "yaml";
+import { memoryTree } from "./tree.js";
+/** Generate an owned template tree only; never touch a directory or install dependencies. */
+export function createTaskProject(options = {}) {
+    const name = options.name ?? "task-project";
+    if (name.length > 214 ||
+        ["node_modules", "favicon.ico"].includes(name) ||
+        !/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/.test(name))
+        throw new Error("Task project name must be a valid lowercase npm package name.");
+    const taskName = options.taskName ?? "Echo";
+    const minVersion = options.minRuntimeVersion ?? "22.13.0";
+    const sdkVersion = options.sdkVersion ?? "0.1.0-rc.2";
+    if (!sdkVersion.trim() || [...sdkVersion].some((char) => char.charCodeAt(0) < 32))
+        throw new Error("Dependency specifiers must be nonempty without control characters.");
+    validateTaskBundle({
+        $schema: taskSchemaUri,
+        name: taskName,
+        runtime: { type: "node", minVersion },
+        entry: "worker.cjs",
+        include: ["task.yaml", "worker.cjs"],
+        binary: [],
+        inputSchema: { type: "object" },
+        resultSchema: true,
+        messageSchema: false,
+    });
+    const textId = "https://task.invalid/echo/text";
+    const files = {
+        "package.json": `${JSON.stringify({
+            name,
+            version: "0.0.0",
+            private: true,
+            type: "module",
+            engines: { node: ">=22.13.0" },
+            dependencies: { "@potential-guide/task-sdk": sdkVersion },
+        }, null, 2)}\n`,
+        ".gitignore": "node_modules/\ndist/\nbundle.car\nbundle.cid\n.verification/\n",
+        "task.build.yaml": stringify({
+            name: taskName,
+            runtime: { minVersion },
+            source: { entry: "src/main.ts", contract: "src/contract.json", mode: "explicit" },
+            include: [{ from: "assets/**", to: "resources/" }],
+            outDirectory: "dist",
+            binary: [],
+        }),
+        "src/contract.json": `${JSON.stringify({
+            input: {
+                type: "object",
+                properties: { text: { $ref: textId } },
+                required: ["text"],
+                additionalProperties: false,
+            },
+            result: {
+                type: "object",
+                properties: {
+                    text: { $ref: textId },
+                    bytes: { type: "integer", minimum: 0 },
+                    chunks: { type: "integer", minimum: 1 },
+                },
+                required: ["text", "bytes", "chunks"],
+                additionalProperties: false,
+            },
+            message: false,
+            schemas: { text: { $id: textId, type: "string", minLength: 1 } },
+        }, null, 2)}\n`,
+        "src/helper.ts": `export function greet(prefix: string, text: string): string {
+  return \`\${prefix.trim()} \${text}\`;
+}
+`,
+        "src/main.ts": `import { runTask } from "@potential-guide/task-sdk";
+import { greet } from "./helper.js";
+
+runTask<{ text: string }, { text: string; bytes: number; chunks: number }>(
+  async (input, context) => {
+    const reader = context.bundle.read("resources/greeting.txt").getReader();
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let prefix = "";
+    let bytes = 0;
+    let chunks = 0;
+    try {
+      for (;;) {
+        const item = await reader.read();
+        if (item.done) break;
+        prefix += decoder.decode(item.value, { stream: true });
+        bytes += item.value.byteLength;
+        chunks++;
+      }
+      prefix += decoder.decode();
+    } finally {
+      reader.releaseLock();
+    }
+    return { text: greet(prefix, input.text), bytes, chunks };
+  },
+);
+`,
+        "assets/greeting.txt": "Hello\n",
+    };
+    return memoryTree(new Map(Object.entries(files).map(([path, text]) => [path, Buffer.from(text)])));
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.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) : Uint8Array.from(item.value);
+                    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,24 @@
+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>>;
+export type FileReader = (options: ReadOptions) => Promise<ReadableStream<Uint8Array>> | ReadableStream<Uint8Array>;
+export declare function fileTree(files: ReadonlyMap<string, FileReader>): ReadonlyFileTree;
+export declare function memoryTree(files: ReadonlyMap<string, Uint8Array>): ReadonlyFileTree;
+export declare function streamChunks(stream: ReadableStream<Uint8Array>, options?: ReadOptions, observe?: (bytes: number) => void): AsyncGenerator<Uint8Array>;
+export declare function iteratorStream(iterator: AsyncIterator<Uint8Array>, options?: ReadOptions, release?: () => Promise<void>): ReadableStream<Uint8Array>;
+//# 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,CAarB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgB,oEAetE;AACD,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AAEtE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,gBAAgB,CA2CjF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,gBAAgB,CASnF;AAED,wBAAuB,YAAY,CACjC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,GAAE,WAAgB,EACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,cAAc,CAAC,UAAU,CAAC,CA8B5B;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,OAAO,GAAE,WAAgB,EACzB,OAAO,GAAE,MAAM,OAAO,CAAC,IAAI,CAAkB,GAC5C,cAAc,CAAC,UAAU,CAAC,CA6C5B"}

package/dist/tree.js

@@ -0,0 +1,196 @@
+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 chunks = [];
+    let length = 0;
+    for await (const chunk of streamChunks(await tree.read(path, options), options, (bytes) => {
+        length += bytes;
+        if (length > limit)
+            throw treeError("capacity_exceeded", path, "File exceeds byte limit");
+        observe?.(bytes);
+    })) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks, length);
+}
+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(Uint8Array.from(bytes));
+            }
+        },
+    }, { highWaterMark: 0 });
+}
+export function fileTree(files) {
+    const readers = new Map(files);
+    const directories = new Map([["", new Map()]]);
+    for (const path of readers.keys()) {
+        checkTreePath(path);
+        if (!path)
+            throw treeError("EINVAL", path, "File path must not be empty");
+        const parts = path.split("/");
+        let parent = "";
+        for (const [index, name] of parts.entries()) {
+            const directory = index < parts.length - 1;
+            const children = directories.get(parent);
+            if (!children)
+                throw treeError("EINVAL", parent, "Missing parent directory");
+            const previous = children.get(name);
+            const kind = directory ? "directory" : "file";
+            if (previous && previous.kind !== kind)
+                throw treeError("EINVAL", path, "File/directory collision");
+            children.set(name, { name, kind });
+            if (directory) {
+                parent = parent ? `${parent}/${name}` : name;
+                if (!directories.has(parent))
+                    directories.set(parent, new Map());
+            }
+        }
+    }
+    return Object.freeze({
+        async list(path, options = {}) {
+            checkTreePath(path);
+            options.signal?.throwIfAborted();
+            const children = directories.get(path);
+            if (!children)
+                throw treeError(readers.has(path) ? "ENOTDIR" : "ENOENT", path, "Directory not found");
+            return [...children.values()]
+                .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))
+                .map((entry) => Object.freeze({ ...entry }));
+        },
+        async read(path, options = {}) {
+            checkTreePath(path);
+            options.signal?.throwIfAborted();
+            const read = readers.get(path);
+            if (!read)
+                throw treeError(directories.has(path) ? "EISDIR" : "ENOENT", path, "File not found");
+            return read(options);
+        },
+    });
+}
+export function memoryTree(files) {
+    return fileTree(new Map([...files].map(([path, bytes]) => {
+        const owned = Uint8Array.from(bytes);
+        return [path, (options) => memoryFile(owned, options)];
+    })));
+}
+export async function* streamChunks(stream, options = {}, observe) {
+    const reader = stream.getReader();
+    let complete = false;
+    let abort = () => { };
+    const aborted = new Promise((_resolve, reject) => {
+        abort = () => reject(options.signal?.reason);
+    });
+    options.signal?.addEventListener("abort", abort, { once: true });
+    try {
+        for (;;) {
+            options.signal?.throwIfAborted();
+            const item = await Promise.race([reader.read(), aborted]);
+            options.signal?.throwIfAborted();
+            if (item.done) {
+                complete = true;
+                return;
+            }
+            if (!(item.value instanceof Uint8Array))
+                throw new Error("File streams require Uint8Array chunks.");
+            observe?.(item.value.byteLength);
+            yield Uint8Array.from(item.value);
+        }
+    }
+    finally {
+        options.signal?.removeEventListener("abort", abort);
+        try {
+            if (!complete)
+                await reader.cancel();
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+export function iteratorStream(iterator, options = {}, release = async () => { }) {
+    let stopped = false;
+    let removeAbort = () => { };
+    let cleanup;
+    const close = () => {
+        cleanup ??= (async () => {
+            stopped = true;
+            removeAbort();
+            try {
+                await iterator.return?.();
+            }
+            finally {
+                await release();
+            }
+        })();
+        return cleanup;
+    };
+    return new ReadableStream({
+        start(controller) {
+            const abort = () => {
+                controller.error(options.signal?.reason);
+                void close().catch((error) => 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();
+                const item = await iterator.next();
+                if (stopped)
+                    return;
+                if (item.done) {
+                    await close();
+                    controller.close();
+                }
+                else
+                    controller.enqueue(item.value);
+            }
+            catch (error) {
+                controller.error(error);
+                await close();
+            }
+        },
+        cancel: close,
+    }, { 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,75 @@
 {
   "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-2",
+  "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"
+    },
+    "./tree": {
+      "types": "./dist/tree.d.ts",
+      "import": "./dist/tree.js"
+    },
+    "./init": {
+      "types": "./dist/init.d.ts",
+      "import": "./dist/init.js"
+    },
+    "./car": {
+      "types": "./dist/car.d.ts",
+      "import": "./dist/car.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples/echo/src",
+    "examples/echo/assets",
+    "examples/echo/task.build.yaml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "license": "MIT",
+  "dependencies": {
+    "@ipld/car": "5.4.6",
+    "@ipld/dag-pb": "4.2.0",
+    "@sinclair/typebox": "0.34.52",
+    "enhanced-resolve": "5.18.3",
+    "esbuild": "0.25.12",
+    "multiformats": "14.0.5",
+    "ipfs-unixfs-importer": "17.1.1",
+    "ipfs-unixfs-exporter": "16.2.3",
+    "yaml": "2.9.1",
+    "@silvermoon-work/task-protocol": "0.1.0-canary-261109-2"
+  },
+  "devDependencies": {
+    "@potential-guide/pguide-task-bundle": "0.1.0-rc.2",
+    "@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"
   }
-}
+}