@potential-guide/task-sdk 0.0.0 → 0.1.0-rc.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shazhou-ww
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,79 @@
-# @potential-guide/task-sdk
+# Task SDK
 
-This 0.0.0 release is a bootstrap placeholder. Use version 0.1.0 or newer.
+`@potential-guide/task-sdk` provides only the generation-scoped Task Worker
+runtime (`runTask`, `RunFailure`) and callback/context types. Its only runtime
+dependency is `@potential-guide/task-protocol`.
+
+Build, artifact validation and publishing belong to
+[pguide task-bundle](../pguide-task-bundle/README.md), not the SDK.
+Use `task.build.yaml`, a TypeBox contract and a typed callback to generate the
+complete self-contained artifact. The SDK has no author-build scripts, tool subpaths
+or author examples; tooling fixtures live with the author CLI.
+
+New entries explicitly `import { runTask } from "@potential-guide/task-sdk"`
+and call `runTask(callback)`. The builder binds the verified declaration
+into the SDK, not through author configuration or
+`workerData`. A custom wrapper may delegate to `runTask` without builder
+recognition or configuration changes.
+The Engine validates input and business messages before dispatch, and validates
+checkpoint, complete and RunFailure result evidence before acceptance or storage.
+The Worker trusts those input/message checks; it contains no automatic business
+Schema validator, schema-runtime, projection engine, or Ajv dependency.
+Build-time contract, reference and budget checks remain in the author tools.
+
+The Engine also checks JSON shape, nesting/node and byte limits, and log/progress
+payloads. The SDK forwards host-validated input/messages and sends author outputs
+without walking or normalizing their payloads. Queue bounds, generation/Run routing,
+declaration equality, cancellation and resource streams remain in the SDK.
+Startup declaration comparison still uses canonical JSON; it is not business
+payload validation.
+
+IPC uses Node's structured clone: sendable non-JSON values (such as cycles,
+BigInt and Date) are rejected by the host. Values that cannot be cloned, such as
+functions, reject locally with `invalid_payload`; failed sends do not consume
+message IDs or pending credits. Structured clone may evaluate getters and normalize
+custom objects before the host sees them. Authors should send plain JSON data;
+the host validates the received representation, not the original object descriptors.
+Receiver byte limits govern acceptance, not the memory allocated while cloning
+or transporting a message.
+A rejected checkpoint remains a failed output even if the callback catches its
+promise. Rejected completion becomes a failure report; rejected failure evidence
+is re-reported using the host's error without that evidence. Normal completion or
+failure release follows an acknowledged terminal fact; cancellation retains its
+stopping/release path, and an unavailable terminal channel reports uncertainty.
+Custom hosts must implement the same full validation and negative-ACK lifecycle,
+not simply acknowledge every frame. Authors may import their own validators;
+those business dependencies remain bundled and are separately attributable.
+
+The host owns CID parsing, supported codec/hash checks, DAG verification and
+Bundle-relative path resolution. The Worker treats the host-verified CID as an
+opaque, nonempty string of at most 256 characters and echoes it in the ready
+handshake; it does not import a CID parser. Declaration equality is still checked
+against the build-locked binding, and the host must match the handshake against
+its verified Bundle before dispatching a Run.
+
+`context.log({level, message, fields?})` provides async typed diagnostic receipts,
+independent of business outputs. The sole **v1** declaration includes its dedicated
+channel; the project is unreleased and evolves v1 in place. Removed v2 and future
+schema URLs are rejected, not aliased. Disabled/custom-host diagnostics remain
+unavailable. See [Run Logs](../../docs/task-run-logs.md) and the author's
+[diagnostics example](../pguide-task-bundle/examples/low-level/check-diagnostics/callback.ts).
+
+`context.bundle.read(relativePath, {signal?})` always returns a standard
+`ReadableStream<Uint8Array>`. It is demand-driven, supports cancellation and
+surfaces creation/midstream errors. Buffer explicitly when needed:
+
+```ts
+const chunks: Uint8Array[] = [];
+for await (const chunk of context.bundle.read("resources/data.bin")) chunks.push(chunk);
+const bytes = Buffer.concat(chunks);
+```
+
+Resources belong to the current root; absolute paths, traversal and absent files
+fail. Do not locate resources with `__dirname`, `import.meta.url` or cwd:
+Workers may execute verified CommonJS source in memory without a Bundle directory.
+Bundle bytes are immutable. Runtime output belongs outside the Bundle.
+Workers are isolation/lifecycle boundaries, not security sandboxes.
+
+The generation-scoped message contract is documented in
+[`docs/task-bundle-worker.md`](https://github.com/shazhou-ww/potential-guide/blob/main/docs/task-bundle-worker.md).

package/dist/binding.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedTaskBundle } from "@potential-guide/task-protocol/worker";
+export interface TaskBinding {
+    declaration: ResolvedTaskBundle;
+}
+/** Replaced by the Bundle builder, never supplied by author code or workerData. */
+export declare const binding: TaskBinding | undefined;
+//# sourceMappingURL=binding.d.ts.map

package/dist/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,mFAAmF;AACnF,eAAO,MAAM,OAAO,EAAE,WAAW,GAAG,SAAqB,CAAC"}

package/dist/binding.js

@@ -0,0 +1,3 @@
+/** Replaced by the Bundle builder, never supplied by author code or workerData. */
+export const binding = undefined;
+//# sourceMappingURL=binding.js.map

package/dist/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAMA,mFAAmF;AACnF,MAAM,CAAC,MAAM,OAAO,GAA4B,SAAS,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { type Json, type RunContext } from "@potential-guide/task-protocol/worker";
+export interface TaskContext<Message extends Json = never> extends RunContext<Message> {
+    readonly bundle: {
+        read(path: string, options?: {
+            signal?: AbortSignal;
+        }): ReadableStream<Uint8Array>;
+    };
+}
+export type TaskCallback<Input = Json, Result = Json, Message extends Json = never> = (input: Input, context: TaskContext<Message>) => Promise<Result>;
+export type { RunContext, RunLogInput, RunLogReceipt, RunMessage, RunProgress, } from "@potential-guide/task-protocol/worker";
+export { RunFailure } from "@potential-guide/task-protocol/worker";
+/** Authors explicitly select this wrapper; the builder binds contracts, not startup. */
+export declare function runTask<Input = Json, Result = Json, Message extends Json = never>(callback: TaskCallback<Input, Result, Message>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,IAAI,EAGT,KAAK,UAAU,EAQhB,MAAM,uCAAuC,CAAC;AAG/C,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,IAAI,GAAG,KAAK,CAAE,SAAQ,UAAU,CAAC,OAAO,CAAC;IACpF,QAAQ,CAAC,MAAM,EAAE;QACf,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;KACpF,CAAC;CACH;AACD,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,SAAS,IAAI,GAAG,KAAK,IAAI,CACpF,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,KAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;AACrB,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAoCnE,wFAAwF;AACxF,wBAAgB,OAAO,CAAC,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,SAAS,IAAI,GAAG,KAAK,EAC/E,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAC7C,IAAI,CA8cN"}

package/dist/index.js

@@ -0,0 +1,499 @@
+import { parentPort, workerData } from "node:worker_threads";
+import { canonical, json, RunFailure, TaskError, taskSchemaUri, } from "@potential-guide/task-protocol/worker";
+import { binding } from "./binding.js";
+export { RunFailure } from "@potential-guide/task-protocol/worker";
+class Inbox {
+    capacity;
+    queue = [];
+    waiter;
+    closed = false;
+    constructor(capacity) {
+        this.capacity = capacity;
+    }
+    push(value) {
+        if (this.closed || this.queue.length >= this.capacity)
+            throw new Error("Task inbox unavailable.");
+        if (this.waiter) {
+            this.waiter({ done: false, value });
+            this.waiter = undefined;
+        }
+        else
+            this.queue.push(value);
+    }
+    close() {
+        this.closed = true;
+        this.queue = [];
+        this.waiter?.({ done: true, value: undefined });
+        this.waiter = undefined;
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const value = this.queue.shift();
+                if (value)
+                    return Promise.resolve({ done: false, value });
+                if (this.closed)
+                    return Promise.resolve({ done: true, value: undefined });
+                if (this.waiter)
+                    return Promise.reject(new Error("Task inbox has one consumer."));
+                return new Promise((resolve) => {
+                    this.waiter = resolve;
+                });
+            },
+        };
+    }
+}
+/** Authors explicitly select this wrapper; the builder binds contracts, not startup. */
+export function runTask(callback) {
+    if (!binding)
+        throw new Error("Task SDK requires a build-locked Bundle binding.");
+    const { declaration } = binding;
+    const port = parentPort;
+    if (!port || declaration.$schema !== taskSchemaUri)
+        throw new Error("Unsupported Task Worker.");
+    const config = workerData;
+    if (typeof config.generation !== "string" ||
+        !config.generation ||
+        !Number.isSafeInteger(config.maxInFlight) ||
+        config.maxInFlight <= 0 ||
+        !Number.isSafeInteger(config.maxPayloadBytes) ||
+        config.maxPayloadBytes <= 0 ||
+        typeof config.bundle?.cid !== "string" ||
+        !config.bundle.cid ||
+        config.bundle.cid.length > 256)
+        throw new Error("Invalid trusted Task Worker configuration.");
+    if (!config.bundle ||
+        canonical(json(config.bundle.declaration, 1_048_576)) !==
+            canonical(json(declaration, 1_048_576)))
+        throw new Error("Task Worker declaration differs from verified Bundle.");
+    const controller = new AbortController();
+    const inbox = new Inbox(config.maxInFlight);
+    const tasks = new Map();
+    const pending = new Map();
+    let sequence = 0;
+    let runId;
+    let finishing = false;
+    let queued = 0;
+    let cleanupUncertain = false;
+    let output = Promise.resolve();
+    let outputError;
+    let readSequence = 0;
+    const reads = new Map();
+    function readBundle(path, options = {}) {
+        const id = ++readSequence;
+        const signal = options.signal
+            ? AbortSignal.any([controller.signal, options.signal])
+            : controller.signal;
+        let cleanup = () => { };
+        const cancel = () => {
+            cleanup();
+            reads.get(id)?.reject(new DOMException("Bundle read canceled.", "AbortError"));
+            reads.delete(id);
+            port.postMessage({
+                generation: config.generation,
+                runId,
+                kind: "bundle-cancel",
+                readId: id,
+            });
+        };
+        return new ReadableStream({
+            start(stream) {
+                const abort = () => {
+                    cancel();
+                    stream.error(signal.reason);
+                };
+                cleanup = () => signal.removeEventListener("abort", abort);
+                if (signal.aborted) {
+                    stream.error(signal.reason);
+                    return;
+                }
+                signal.addEventListener("abort", abort, { once: true });
+            },
+            async pull(stream) {
+                try {
+                    if (finishing)
+                        throw new TaskError("run_finished", "Bundle stream is closed.");
+                    signal.throwIfAborted();
+                    const item = await new Promise((resolve, reject) => {
+                        reads.set(id, { resolve, reject });
+                        port.postMessage({
+                            generation: config.generation,
+                            runId,
+                            kind: "bundle-pull",
+                            readId: id,
+                            path,
+                        });
+                    });
+                    if (item.done) {
+                        cleanup();
+                        stream.close();
+                    }
+                    else if (item.chunk instanceof Uint8Array)
+                        stream.enqueue(item.chunk);
+                    else
+                        throw new TaskError("invalid_bundle", "Invalid Bundle stream chunk.");
+                }
+                catch (error) {
+                    cancel();
+                    stream.error(error);
+                }
+            },
+            cancel,
+        }, { highWaterMark: 0 });
+    }
+    let logSequence = 0;
+    const logPending = new Map();
+    let droppedLogs = 0;
+    let reportedDroppedLogs = 0;
+    let dropScheduled = false;
+    let dropReportingClosed = false;
+    let finalDropSent = false;
+    let dropPending;
+    function flushDroppedLogs() {
+        if (dropPending ||
+            dropReportingClosed ||
+            finishing ||
+            controller.signal.aborted ||
+            droppedLogs <= reportedDroppedLogs)
+            return;
+        const id = ++logSequence;
+        const count = droppedLogs;
+        const timer = setTimeout(() => {
+            // Keep the unknown in-flight identity: timeout cannot authorize another queued frame.
+            dropReportingClosed = true;
+        }, 1000);
+        dropPending = { id, count, timer };
+        try {
+            port.postMessage({
+                generation: config.generation,
+                runId,
+                kind: "log-drop",
+                logId: id,
+                count,
+            });
+        }
+        catch {
+            clearTimeout(timer);
+            dropPending = undefined;
+            dropReportingClosed = true;
+        }
+    }
+    function scheduleDroppedLogs() {
+        if (dropScheduled ||
+            dropPending ||
+            dropReportingClosed ||
+            finishing ||
+            controller.signal.aborted)
+            return;
+        dropScheduled = true;
+        queueMicrotask(() => {
+            dropScheduled = false;
+            flushDroppedLogs();
+        });
+    }
+    function finishDroppedLogs() {
+        if (finalDropSent || droppedLogs <= reportedDroppedLogs)
+            return;
+        finalDropSent = true;
+        // One terminal cumulative snapshot is bounded even when the ordinary acknowledgment is lost.
+        try {
+            port.postMessage({
+                generation: config.generation,
+                runId,
+                kind: "log-drop",
+                logId: ++logSequence,
+                count: droppedLogs,
+                final: true,
+            });
+        }
+        catch {
+            /* Disconnected tail remains unknown; required outputs never wait for this snapshot. */
+        }
+    }
+    function settleLogs() {
+        if (dropPending)
+            clearTimeout(dropPending.timer);
+        dropPending = undefined;
+        dropReportingClosed = true;
+        for (const operation of logPending.values()) {
+            clearTimeout(operation.timer);
+            operation.resolve({ state: "unavailable", reason: "channel" });
+        }
+        logPending.clear();
+    }
+    async function log(value) {
+        if (finishing || controller.signal.aborted)
+            return { state: "unavailable", reason: "channel" };
+        if (logPending.size >= Math.min(config.maxInFlight, 16)) {
+            droppedLogs = Math.min(Number.MAX_SAFE_INTEGER, droppedLogs + 1);
+            scheduleDroppedLogs();
+            return { state: "dropped", reason: "capacity" };
+        }
+        const id = logSequence + 1;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                logPending.delete(id);
+                resolve({ state: "unavailable", reason: "timeout" });
+            }, 1000);
+            logPending.set(id, { resolve, reject, timer });
+            try {
+                port.postMessage({
+                    generation: config.generation,
+                    runId,
+                    kind: "log",
+                    logId: id,
+                    value,
+                });
+                logSequence = id;
+            }
+            catch (error) {
+                clearTimeout(timer);
+                logPending.delete(id);
+                if (error instanceof Error && error.name === "DataCloneError")
+                    reject(new TaskError("invalid_payload", "Task payload cannot be cloned for IPC."));
+                else
+                    resolve({ state: "unavailable", reason: "channel" });
+            }
+        });
+    }
+    function request(kind, value) {
+        if (pending.size >= config.maxInFlight)
+            return Promise.reject(new Error("Task channel capacity exceeded."));
+        const id = sequence + 1;
+        const operation = new Promise((resolve, reject) => {
+            pending.set(id, { resolve, reject });
+        });
+        try {
+            port.postMessage({ generation: config.generation, runId, id, kind, value });
+            sequence = id;
+        }
+        catch (error) {
+            pending
+                .get(id)
+                ?.reject(error instanceof Error && error.name === "DataCloneError"
+                ? new TaskError("invalid_payload", "Task payload cannot be cloned for IPC.")
+                : error instanceof Error
+                    ? error
+                    : new Error("Task send failed."));
+            pending.delete(id);
+        }
+        return operation;
+    }
+    function enqueue(kind, value) {
+        if (finishing)
+            return Promise.reject(new TaskError("run_finished", "Task is finishing."));
+        if (queued >= config.maxInFlight)
+            return Promise.reject(new Error("Task channel capacity exceeded."));
+        queued++;
+        const operation = output
+            .then(() => request(kind, value))
+            .catch((error) => {
+            outputError ??= error;
+            throw error;
+        })
+            .finally(() => {
+            queued--;
+        });
+        output = operation;
+        void operation.catch(() => { });
+        return operation;
+    }
+    port.postMessage({
+        generation: config.generation,
+        kind: "ready",
+        value: {
+            $schema: declaration.$schema,
+            cid: config.bundle.cid,
+            inputSchema: declaration.inputSchema,
+            resultSchema: declaration.resultSchema,
+            messageSchema: declaration.messageSchema,
+        },
+    });
+    port.on("message", (envelope) => {
+        if (!envelope || envelope.generation !== config.generation)
+            return;
+        if (envelope.kind === "bundle-data") {
+            const read = reads.get(envelope.readId);
+            if (!read)
+                return;
+            reads.delete(envelope.readId);
+            if (envelope.error)
+                read.reject(new TaskError(envelope.error.code, envelope.error.message));
+            else
+                read.resolve(envelope);
+            return;
+        }
+        if (envelope.kind === "log-drop-ack") {
+            if (envelope.runId !== runId || !dropPending || envelope.logId !== dropPending.id)
+                return;
+            const operation = dropPending;
+            clearTimeout(operation.timer);
+            dropPending = undefined;
+            if (envelope.error || envelope.value?.state === "unavailable") {
+                dropReportingClosed = true;
+            }
+            else {
+                reportedDroppedLogs = operation.count;
+                dropReportingClosed = false;
+                scheduleDroppedLogs();
+            }
+            return;
+        }
+        if (envelope.kind === "log-ack") {
+            if (envelope.runId !== runId)
+                return;
+            const operation = logPending.get(envelope.logId);
+            if (!operation)
+                return;
+            logPending.delete(envelope.logId);
+            clearTimeout(operation.timer);
+            if (envelope.error)
+                operation.reject(new TaskError(envelope.error.code, envelope.error.message));
+            else
+                operation.resolve(envelope.value);
+            return;
+        }
+        if (envelope.kind === "ack") {
+            const operation = pending.get(envelope.id);
+            if (!operation)
+                return;
+            pending.delete(envelope.id);
+            if (envelope.error)
+                operation.reject(new TaskError(envelope.error.code, envelope.error.message));
+            else
+                operation.resolve();
+            return;
+        }
+        if (envelope.kind === "ping") {
+            port.postMessage({ generation: config.generation, kind: "pong" });
+            return;
+        }
+        if (envelope.runId !== runId && envelope.kind !== "run")
+            return;
+        if (envelope.kind === "cancel") {
+            port.postMessage({ generation: config.generation, runId, kind: "stopping" });
+            controller.abort();
+            settleLogs();
+            inbox.close();
+            for (const task of tasks.values())
+                task.abort();
+            return;
+        }
+        if (envelope.kind === "withdraw") {
+            const task = tasks.get(envelope.taskId) ?? new AbortController();
+            tasks.set(envelope.taskId, task);
+            task.abort();
+            return;
+        }
+        if (envelope.kind === "message") {
+            const message = envelope.value;
+            const task = tasks.get(message.taskId) ?? new AbortController();
+            tasks.set(message.taskId, task);
+            let confirmed = false;
+            const confirm = (state, reason) => {
+                if (confirmed || task.signal.aborted)
+                    return Promise.reject(new Error("Message unavailable."));
+                confirmed = true;
+                return enqueue("message-confirm", {
+                    taskId: message.taskId,
+                    messageId: message.messageId,
+                    state,
+                    ...(reason === undefined ? {} : { reason }),
+                });
+            };
+            inbox.push(Object.freeze({
+                messageId: message.messageId,
+                taskId: message.taskId,
+                caller: Object.freeze(message.caller),
+                signal: task.signal,
+                payload: message.payload,
+                accept: () => confirm("accepted"),
+                reject: (reason) => confirm("rejected", reason),
+            }));
+            return;
+        }
+        if (envelope.kind !== "run" || runId !== undefined)
+            return;
+        runId = envelope.runId;
+        const context = Object.freeze({
+            runId: envelope.runId,
+            ...(envelope.identity
+                ? { generation: envelope.identity.generation, startedAt: envelope.identity.startedAt }
+                : {}),
+            scope: envelope.scope,
+            signal: controller.signal,
+            messages: inbox,
+            bundle: Object.freeze({ read: readBundle }),
+            progress: (value) => enqueue("progress", value),
+            checkpoint: (value) => enqueue("checkpoint", value),
+            log,
+        });
+        const reportFailure = async (reason) => {
+            const error = reason;
+            cleanupUncertain ||=
+                error instanceof TaskError &&
+                    ["reclamation_failed", "reclamation_unknown"].includes(error.code);
+            const evidence = error instanceof RunFailure ? error.result : undefined;
+            const failure = (reason, result) => ({
+                code: reason instanceof TaskError ? reason.code.slice(0, 128) : "run_failed",
+                message: reason instanceof Error ? reason.message.slice(0, 512) : "Task callback failed.",
+                ...(result === undefined ? {} : { result }),
+            });
+            try {
+                await request("failed", failure(error, evidence));
+            }
+            catch (rejected) {
+                // A rejected evidence frame is not a terminal fact. Report the host's
+                // rejection without the rejected evidence before requesting release.
+                await request("failed", failure(rejected));
+            }
+        };
+        void (async () => {
+            try {
+                const value = await callback(envelope.input, context);
+                finishing = true;
+                finishDroppedLogs();
+                await output;
+                if (outputError !== undefined)
+                    throw outputError;
+                await request("complete", value);
+            }
+            catch (caught) {
+                finishing = true;
+                finishDroppedLogs();
+                await output.catch(() => { });
+                cleanupUncertain ||=
+                    caught instanceof TaskError &&
+                        ["reclamation_failed", "reclamation_unknown"].includes(caught.code);
+                const error = outputError ?? caught;
+                if (controller.signal.aborted &&
+                    error instanceof Error &&
+                    (error.name === "AbortError" ||
+                        (error instanceof TaskError && ["ABORT_ERR", "run_canceled"].includes(error.code))))
+                    return;
+                await reportFailure(error);
+            }
+        })().then(() => {
+            inbox.close();
+            controller.abort();
+            settleLogs();
+            for (const task of tasks.values())
+                task.abort();
+            port.postMessage({
+                generation: config.generation,
+                runId,
+                kind: cleanupUncertain ? "uncertain" : "released",
+            });
+            port.close();
+        }, () => {
+            inbox.close();
+            controller.abort();
+            settleLogs();
+            for (const task of tasks.values())
+                task.abort();
+            port.postMessage({ generation: config.generation, runId, kind: "uncertain" });
+            port.close();
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,14 +1,41 @@
 {
   "name": "@potential-guide/task-sdk",
-  "version": "0.0.0",
-  "description": "Build standalone Task Bundles and run their generation-scoped Worker protocol. Bootstrap placeholder only.",
+  "version": "0.1.0-rc.0",
+  "description": "Generation-scoped Task Worker runtime and author callback types.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "dependencies": {
+    "@potential-guide/task-protocol": "^0.1.0-rc.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/shazhou-ww/potential-guide.git",
     "directory": "packages/task-sdk"
   },
-  "publishConfig": {
-    "access": "public"
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "lint": "biome lint .",
+    "test": "tsx --test \"test/*.test.ts\"",
+    "typecheck": "tsc -b --pretty false"
   }
-}
+}