@capsule-run/sdk 0.1.0

package/dist/app.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Capsule SDK - Task Registry and TaskRunner
+ */
+export interface TaskInfo<T extends (...args: any[]) => any> {
+    func: T;
+    config: TaskConfig;
+}
+export interface TaskConfig {
+    name: string;
+    compute?: string;
+    ram?: string;
+    timeout?: string;
+    maxRetries?: number;
+}
+/**
+ * Register a task function by name with its configuration.
+ */
+export declare function registerTask<T extends (...args: any[]) => any>(name: string, func: T, config: TaskConfig): void;
+/**
+ * Get a registered task by name.
+ */
+export declare function getTask(name: string): ((...args: any[]) => any) | undefined;
+/**
+ * Get the configuration for a registered task.
+ */
+export declare function getTaskConfig(name: string): TaskConfig | undefined;
+/**
+ * Get all registered task names.
+ */
+export declare function getTaskNames(): string[];
+/**
+ * Implementation of the capsule:host/task-runner interface.
+ *
+ * This class is instantiated by capsule-core when the component is loaded.
+ * The Rust host calls `run(argsJson)` to execute a task.
+ */
+export declare class TaskRunner {
+    /**
+     * Execute a task with the given arguments.
+     * Returns Ok(result_json) on success, Err(error_message) on failure.
+     */
+    run(argsJson: string): Promise<string>;
+}
+export declare const exports: TaskRunner;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;IACzD,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC5D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,UAAU,GACjB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SAAS,CAE3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAcD;;;;;GAKG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAuC7C;AAED,eAAO,MAAM,OAAO,YAAmB,CAAC"}

package/dist/app.js

@@ -0,0 +1,75 @@
+/**
+ * Capsule SDK - Task Registry and TaskRunner
+ */
+const TASKS = new Map();
+/**
+ * Register a task function by name with its configuration.
+ */
+export function registerTask(name, func, config) {
+    TASKS.set(name, { func, config });
+}
+/**
+ * Get a registered task by name.
+ */
+export function getTask(name) {
+    return TASKS.get(name)?.func;
+}
+/**
+ * Get the configuration for a registered task.
+ */
+export function getTaskConfig(name) {
+    return TASKS.get(name)?.config;
+}
+/**
+ * Get all registered task names.
+ */
+export function getTaskNames() {
+    return Array.from(TASKS.keys());
+}
+/**
+ * Implementation of the capsule:host/task-runner interface.
+ *
+ * This class is instantiated by capsule-core when the component is loaded.
+ * The Rust host calls `run(argsJson)` to execute a task.
+ */
+export class TaskRunner {
+    /**
+     * Execute a task with the given arguments.
+     * Returns Ok(result_json) on success, Err(error_message) on failure.
+     */
+    async run(argsJson) {
+        try {
+            const data = JSON.parse(argsJson);
+            const taskName = data.task_name ?? "main";
+            const args = data.args ?? [];
+            const kwargs = data.kwargs ?? {};
+            let taskFunc = getTask(taskName);
+            if (!taskFunc && taskName !== "main") {
+                taskFunc = getTask("main");
+            }
+            if (!taskFunc && TASKS.size > 0) {
+                const firstTaskName = TASKS.keys().next().value;
+                if (firstTaskName) {
+                    taskFunc = getTask(firstTaskName);
+                }
+            }
+            if (!taskFunc) {
+                throw `No tasks or main() function found. Available tasks: ${getTaskNames().join(", ")}`;
+            }
+            const result = taskFunc(...args, kwargs);
+            if (result instanceof Promise) {
+                const asyncResult = await result;
+                return JSON.stringify({ result: asyncResult ?? null });
+            }
+            return JSON.stringify({ result: result ?? null });
+        }
+        catch (e) {
+            const errorMsg = e instanceof Error
+                ? `${e.message}\n${e.stack || ''}`
+                : String(e);
+            throw errorMsg;
+        }
+    }
+}
+export const exports = new TaskRunner();
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,MAAM,KAAK,GAA+B,IAAI,GAAG,EAAE,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,IAAO,EACP,MAAkB;IAElB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AAcD;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACrB;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,GAAa,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YAEjC,IAAI,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEjC,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACrC,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;YAED,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBAChD,IAAI,aAAa,EAAE,CAAC;oBAClB,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YAED,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,uDAAuD,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3F,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;YAEzC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC;gBACjC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,IAAI,IAAI,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,CAAC,YAAY,KAAK;gBACjC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE;gBAClC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACd,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/hostApi.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Capsule SDK - Host API Interface
+ *
+ * This module provides the interface to call host functions from JavaScript/TypeScript Wasm code.
+ * When running in WASM mode, it imports the auto-generated bindings from jco.
+ * When running locally, it provides mock implementations for testing.
+ */
+/**
+ * Check if running in WASM mode.
+ */
+export declare function isWasmMode(): boolean;
+/**
+ * Call the host's schedule_task function to create a new isolated task instance.
+ *
+ * This is the bridge between JavaScript code and the Rust host runtime.
+ */
+export declare function callHost(name: string, args: any[], config: Record<string, any>): string;
+//# sourceMappingURL=hostApi.d.ts.map

package/dist/hostApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostApi.d.ts","sourceRoot":"","sources":["../src/hostApi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,CAgBR"}

package/dist/hostApi.js

@@ -0,0 +1,59 @@
+/**
+ * Capsule SDK - Host API Interface
+ *
+ * This module provides the interface to call host functions from JavaScript/TypeScript Wasm code.
+ * When running in WASM mode, it imports the auto-generated bindings from jco.
+ * When running locally, it provides mock implementations for testing.
+ */
+let hostModule = null;
+let isWasmChecked = false;
+let isWasm = false;
+/**
+ * Lazily check if we're running in WASM mode.
+ */
+function checkWasm() {
+    if (!isWasmChecked) {
+        try {
+            const witBinding = globalThis["capsule:host/api"];
+            if (typeof witBinding !== "undefined" && typeof witBinding.scheduleTask === "function") {
+                hostModule = witBinding;
+                isWasm = true;
+            }
+            else {
+                isWasm = false;
+            }
+        }
+        catch (e) {
+            isWasm = false;
+        }
+        isWasmChecked = true;
+    }
+    return isWasm;
+}
+/**
+ * Check if running in WASM mode.
+ */
+export function isWasmMode() {
+    return checkWasm();
+}
+/**
+ * Call the host's schedule_task function to create a new isolated task instance.
+ *
+ * This is the bridge between JavaScript code and the Rust host runtime.
+ */
+export function callHost(name, args, config) {
+    if (checkWasm() && hostModule !== null) {
+        try {
+            const result = hostModule.scheduleTask(name, JSON.stringify(args), JSON.stringify(config));
+            return result;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e.message : String(e);
+            return JSON.stringify({ error: `Host call failed: ${error}` });
+        }
+    }
+    else {
+        return JSON.stringify({ result: `mock_result_for_${name}` });
+    }
+}
+//# sourceMappingURL=hostApi.js.map

package/dist/hostApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostApi.js","sourceRoot":"","sources":["../src/hostApi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,IAAI,UAAU,GAAQ,IAAI,CAAC;AAC3B,IAAI,aAAa,GAAG,KAAK,CAAC;AAC1B,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB;;GAEG;AACH,SAAS,SAAS;IAChB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,UAAU,GAAI,UAAkB,CAAC,kBAAkB,CAAC,CAAC;YAE3D,IAAI,OAAO,UAAU,KAAK,WAAW,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBACvF,UAAU,GAAG,UAAU,CAAC;gBACxB,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC;QACD,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,IAAW,EACX,MAA2B;IAE3B,IAAI,SAAS,EAAE,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CACpC,IAAI,EACJ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EACpB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CACvB,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,KAAK,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Capsule SDK - HTTP Client
+ *
+ * This module provides HTTP request functions by calling the host's HTTP implementation.
+ * In WASM mode, requests go through the Rust host.
+ * In local mode, uses native fetch for testing.
+ */
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    body?: string;
+    json?: any;
+}
+/**
+ * HTTP Response wrapper with convenient methods.
+ */
+export declare class Response {
+    readonly status: number;
+    readonly headers: Record<string, string>;
+    readonly body: string;
+    constructor(status: number, headers: Record<string, string>, body: string);
+    /**
+     * Parse response body as JSON.
+     */
+    json<T = any>(): T;
+    /**
+     * Get response body as text.
+     */
+    text(): string;
+    /**
+     * Check if response status is 2xx.
+     */
+    ok(): boolean;
+    toString(): string;
+}
+/**
+ * Make an HTTP GET request.
+ *
+ * @example
+ * ```typescript
+ * const response = http.get("https://api.github.com/zen");
+ * console.log(response.text());
+ * ```
+ */
+export declare function get(url: string, options?: Omit<RequestOptions, "body" | "json">): Promise<Response>;
+/**
+ * Make an HTTP POST request.
+ *
+ * @example
+ * ```typescript
+ * const response = http.post("https://api.example.com/data", {
+ *   json: { key: "value" }
+ * });
+ * ```
+ */
+export declare function post(url: string, options?: RequestOptions): Promise<Response>;
+/**
+ * Make an HTTP PUT request.
+ */
+export declare function put(url: string, options?: RequestOptions): Promise<Response>;
+/**
+ * Make an HTTP DELETE request.
+ */
+export declare function del(url: string, options?: Omit<RequestOptions, "body" | "json">): Promise<Response>;
+/**
+ * Make an HTTP PATCH request.
+ */
+export declare function patch(url: string, options?: RequestOptions): Promise<Response>;
+/**
+ * Make an HTTP HEAD request.
+ */
+export declare function head(url: string, options?: Omit<RequestOptions, "body" | "json">): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM;IAMzE;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;IAIlB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,EAAE,IAAI,OAAO;IAIb,QAAQ,IAAI,MAAM;CAGnB;AA+FD;;;;;;;;GAQG;AACH,wBAAsB,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAM,GAClD,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAM,GAClD,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,KAAK,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAM,GAClD,OAAO,CAAC,QAAQ,CAAC,CAEnB"}

package/dist/http.js

@@ -0,0 +1,154 @@
+/**
+ * Capsule SDK - HTTP Client
+ *
+ * This module provides HTTP request functions by calling the host's HTTP implementation.
+ * In WASM mode, requests go through the Rust host.
+ * In local mode, uses native fetch for testing.
+ */
+import { isWasmMode } from "./hostApi.js";
+/**
+ * HTTP Response wrapper with convenient methods.
+ */
+export class Response {
+    constructor(status, headers, body) {
+        this.status = status;
+        this.headers = headers;
+        this.body = body;
+    }
+    /**
+     * Parse response body as JSON.
+     */
+    json() {
+        return JSON.parse(this.body);
+    }
+    /**
+     * Get response body as text.
+     */
+    text() {
+        return this.body;
+    }
+    /**
+     * Check if response status is 2xx.
+     */
+    ok() {
+        return this.status >= 200 && this.status < 300;
+    }
+    toString() {
+        return `<Response [${this.status}]>`;
+    }
+}
+/**
+ * Internal function to make HTTP requests.
+ * In WASM mode: calls the host API
+ * In local mode: uses fetch
+ */
+async function makeRequest(method, url, options = {}) {
+    return isWasmMode()
+        ? makeHostRequest(method, url, options)
+        : makeLocalRequest(method, url, options);
+}
+/**
+ * Make HTTP request using native fetch (local mode only).
+ */
+async function makeLocalRequest(method, url, options = {}) {
+    const headers = { ...options.headers };
+    let body = options.body;
+    if (options.json !== undefined) {
+        body = JSON.stringify(options.json);
+        headers["Content-Type"] = "application/json";
+    }
+    const fetchOptions = {
+        method,
+        headers,
+    };
+    if (body !== undefined) {
+        fetchOptions.body = body;
+    }
+    const fetchResponse = await fetch(url, fetchOptions);
+    const responseText = await fetchResponse.text();
+    const responseHeaders = {};
+    fetchResponse.headers.forEach((value, key) => {
+        responseHeaders[key] = value;
+    });
+    return new Response(fetchResponse.status, responseHeaders, responseText);
+}
+/**
+ * Make HTTP request via the Rust host (WASM mode).
+ */
+function makeHostRequest(method, url, options = {}) {
+    try {
+        const hostModule = globalThis["capsule:host/api"];
+        if (!hostModule || !hostModule.httpRequest) {
+            throw new Error("Host HTTP API not available");
+        }
+        const headers = [];
+        const requestHeaders = options.headers || {};
+        for (const [key, value] of Object.entries(requestHeaders)) {
+            headers.push([key, value]);
+        }
+        let body = options.body;
+        if (options.json !== undefined) {
+            body = JSON.stringify(options.json);
+            headers.push(["Content-Type", "application/json"]);
+        }
+        const result = hostModule.httpRequest(method, url, headers, body);
+        const responseHeaders = {};
+        for (const [key, value] of result.headers) {
+            responseHeaders[key] = value;
+        }
+        return new Response(result.status, responseHeaders, result.body);
+    }
+    catch (error) {
+        throw new Error(`HTTP request failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Make an HTTP GET request.
+ *
+ * @example
+ * ```typescript
+ * const response = http.get("https://api.github.com/zen");
+ * console.log(response.text());
+ * ```
+ */
+export async function get(url, options = {}) {
+    return makeRequest("GET", url, options);
+}
+/**
+ * Make an HTTP POST request.
+ *
+ * @example
+ * ```typescript
+ * const response = http.post("https://api.example.com/data", {
+ *   json: { key: "value" }
+ * });
+ * ```
+ */
+export async function post(url, options = {}) {
+    return makeRequest("POST", url, options);
+}
+/**
+ * Make an HTTP PUT request.
+ */
+export async function put(url, options = {}) {
+    return makeRequest("PUT", url, options);
+}
+/**
+ * Make an HTTP DELETE request.
+ */
+export async function del(url, options = {}) {
+    return makeRequest("DELETE", url, options);
+}
+/**
+ * Make an HTTP PATCH request.
+ */
+export async function patch(url, options = {}) {
+    return makeRequest("PATCH", url, options);
+}
+/**
+ * Make an HTTP HEAD request.
+ */
+export async function head(url, options = {}) {
+    return makeRequest("HEAD", url, options);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Capsule SDK for JavaScript/TypeScript
+ *
+ * @example
+ * ```typescript
+ * import { task } from '@capsule/sdk';
+ *
+ * export const greet = task({
+ *   name: "greet",
+ *   compute: "LOW"
+ * }, (name: string): string => {
+ *   return `Hello, ${name}!`;
+ * });
+ * ```
+ */
+export { task, type TaskOptions } from "./task.js";
+export { TaskRunner, exports, type TaskConfig } from "./app.js";
+export * as http from "./http.js";
+export { isWasmMode } from "./hostApi.js";
+//# 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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Capsule SDK for JavaScript/TypeScript
+ *
+ * @example
+ * ```typescript
+ * import { task } from '@capsule/sdk';
+ *
+ * export const greet = task({
+ *   name: "greet",
+ *   compute: "LOW"
+ * }, (name: string): string => {
+ *   return `Hello, ${name}!`;
+ * });
+ * ```
+ */
+export { task } from "./task.js";
+export { TaskRunner, exports } from "./app.js";
+export * as http from "./http.js";
+export { isWasmMode } from "./hostApi.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAmB,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/task.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Capsule SDK - Task Wrapper
+ *
+ * Provides the `task` wrapper function for defining Capsule tasks
+ * in an idiomatic TypeScript way.
+ */
+export interface TaskOptions {
+    /** Task name (required) */
+    name: string;
+    /** Compute level: "LOW", "MEDIUM", or "HIGH" */
+    compute?: "LOW" | "MEDIUM" | "HIGH" | number;
+    /** RAM limit, e.g., "512MB", "2GB" */
+    ram?: string;
+    /**
+     * Timeout duration.
+     * String format: "30s", "5m", "2h" (e.g., "10s")
+     * Number format: milliseconds (e.g., 10000 for 10 seconds)
+     */
+    timeout?: string | number;
+    /** Maximum number of retries */
+    maxRetries?: number;
+}
+export declare function task<TArgs extends any[], TReturn>(options: TaskOptions, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAsDD,wBAAgB,IAAI,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EAC/C,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAC9B,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAoC7B"}

package/dist/task.js

@@ -0,0 +1,87 @@
+/**
+ * Capsule SDK - Task Wrapper
+ *
+ * Provides the `task` wrapper function for defining Capsule tasks
+ * in an idiomatic TypeScript way.
+ */
+import { registerTask } from "./app.js";
+import { isWasmMode, callHost } from "./hostApi.js";
+/**
+ * Define a Capsule task with configuration.
+ *
+ * @example
+ * ```typescript
+ * // String timeout format
+ * export const greet = task({
+ *   name: "greet",
+ *   compute: "LOW",
+ *   timeout: "10s"
+ * }, (name: string): string => {
+ *   return `Hello, ${name}!`;
+ * });
+ *
+ * // Numeric timeout format (milliseconds)
+ * export const process = task({
+ *   name: "process",
+ *   compute: "HIGH",
+ *   timeout: 30000  // 30 seconds
+ * }, (data: any): any => {
+ *   return processData(data);
+ * });
+ * ```
+ *
+ * In WASM mode:
+ * - The function is registered in the task registry with its config
+ * - When called from within a task, it schedules a new isolated instance
+ * - The host creates a new Wasm instance with resource limits
+ *
+ * In non-WASM mode:
+ * - The function executes directly
+ */
+/**
+ * Normalize timeout to string format for the Rust host.
+ *
+ * @param timeout - String duration ("10s", "5m") or number (milliseconds)
+ * @returns String format for host API, or undefined
+ */
+function normalizeTimeout(timeout) {
+    if (timeout === undefined)
+        return undefined;
+    if (typeof timeout === "number") {
+        return `${timeout}ms`;
+    }
+    return timeout;
+}
+export function task(options, fn) {
+    const taskName = options.name;
+    let compute = options.compute?.toString().toUpperCase() ?? "MEDIUM";
+    const taskConfig = {
+        name: taskName,
+        compute,
+        ram: options.ram,
+        timeout: normalizeTimeout(options.timeout),
+        maxRetries: options.maxRetries,
+    };
+    const wrapper = (...args) => {
+        if (!isWasmMode()) {
+            return fn(...args);
+        }
+        const resultJson = callHost(taskName, args, taskConfig);
+        try {
+            const result = JSON.parse(resultJson);
+            if (result.error) {
+                throw new Error(`Task ${taskName} failed: ${result.error}`);
+            }
+            return result.result;
+        }
+        catch (e) {
+            if (e instanceof SyntaxError) {
+                return resultJson;
+            }
+            throw e;
+        }
+    };
+    registerTask(taskName, fn, taskConfig);
+    return wrapper;
+}
+//# sourceMappingURL=task.js.map

package/dist/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAmB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAwBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,OAAyB;IACjD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,GAAG,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,OAAoB,EACpB,EAA+B;IAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9B,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC;IAEpE,MAAM,UAAU,GAAe;QAC7B,IAAI,EAAE,QAAQ;QACd,OAAO;QACP,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1C,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,GAAG,IAAW,EAAW,EAAE;QAC1C,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,MAAM,MAAM,GAAe,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,MAAM,CAAC,MAAiB,CAAC;QAClC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;gBAC7B,OAAO,UAAgC,CAAC;YAC1C,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;IAEF,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAEvC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@capsule-run/sdk",
+  "version": "0.1.0",
+  "description": "Capsule JavaScript SDK - run AI agent tasks in secure WASM sandboxes",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./capsule/app.js": {
+      "types": "./dist/app.d.ts",
+      "import": "./dist/app.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "webassembly",
+    "agents",
+    "isolation",
+    "llm",
+    "ai"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@bytecodealliance/jco": "^1.0.0",
+    "esbuild": "^0.27.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/src/app.ts

@@ -0,0 +1,116 @@
+/**
+ * Capsule SDK - Task Registry and TaskRunner
+ */
+
+export interface TaskInfo<T extends (...args: any[]) => any> {
+  func: T;
+  config: TaskConfig;
+}
+
+export interface TaskConfig {
+  name: string;
+  compute?: string;
+  ram?: string;
+  timeout?: string;
+  maxRetries?: number;
+}
+
+const TASKS: Map<string, TaskInfo<any>> = new Map();
+
+/**
+ * Register a task function by name with its configuration.
+ */
+export function registerTask<T extends (...args: any[]) => any>(
+  name: string,
+  func: T,
+  config: TaskConfig
+): void {
+  TASKS.set(name, { func, config });
+}
+
+/**
+ * Get a registered task by name.
+ */
+export function getTask(name: string): ((...args: any[]) => any) | undefined {
+  return TASKS.get(name)?.func;
+}
+
+/**
+ * Get the configuration for a registered task.
+ */
+export function getTaskConfig(name: string): TaskConfig | undefined {
+  return TASKS.get(name)?.config;
+}
+
+/**
+ * Get all registered task names.
+ */
+export function getTaskNames(): string[] {
+  return Array.from(TASKS.keys());
+}
+
+interface TaskArgs {
+  task_name?: string;
+  args?: any[];
+  kwargs?: Record<string, any>;
+}
+
+interface TaskResult {
+  result?: any;
+  error?: string;
+  traceback?: string;
+}
+
+/**
+ * Implementation of the capsule:host/task-runner interface.
+ *
+ * This class is instantiated by capsule-core when the component is loaded.
+ * The Rust host calls `run(argsJson)` to execute a task.
+ */
+export class TaskRunner {
+  /**
+   * Execute a task with the given arguments.
+   * Returns Ok(result_json) on success, Err(error_message) on failure.
+   */
+  async run(argsJson: string): Promise<string> {
+    try {
+      const data: TaskArgs = JSON.parse(argsJson);
+      const taskName = data.task_name ?? "main";
+      const args = data.args ?? [];
+      const kwargs = data.kwargs ?? {};
+
+      let taskFunc = getTask(taskName);
+
+      if (!taskFunc && taskName !== "main") {
+        taskFunc = getTask("main");
+      }
+
+      if (!taskFunc && TASKS.size > 0) {
+        const firstTaskName = TASKS.keys().next().value;
+        if (firstTaskName) {
+          taskFunc = getTask(firstTaskName);
+        }
+      }
+
+      if (!taskFunc) {
+        throw `No tasks or main() function found. Available tasks: ${getTaskNames().join(", ")}`;
+      }
+
+      const result = taskFunc(...args, kwargs);
+
+      if (result instanceof Promise) {
+        const asyncResult = await result;
+        return JSON.stringify({ result: asyncResult ?? null });
+      }
+
+      return JSON.stringify({ result: result ?? null });
+    } catch (e) {
+      const errorMsg = e instanceof Error
+        ? `${e.message}\n${e.stack || ''}`
+        : String(e);
+      throw errorMsg;
+    }
+  }
+}
+
+export const exports = new TaskRunner();

package/src/hostApi.ts

@@ -0,0 +1,67 @@
+/**
+ * Capsule SDK - Host API Interface
+ *
+ * This module provides the interface to call host functions from JavaScript/TypeScript Wasm code.
+ * When running in WASM mode, it imports the auto-generated bindings from jco.
+ * When running locally, it provides mock implementations for testing.
+ */
+
+let hostModule: any = null;
+let isWasmChecked = false;
+let isWasm = false;
+
+/**
+ * Lazily check if we're running in WASM mode.
+ */
+function checkWasm(): boolean {
+  if (!isWasmChecked) {
+    try {
+      const witBinding = (globalThis as any)["capsule:host/api"];
+
+      if (typeof witBinding !== "undefined" && typeof witBinding.scheduleTask === "function") {
+        hostModule = witBinding;
+        isWasm = true;
+      } else {
+        isWasm = false;
+      }
+    } catch (e) {
+      isWasm = false;
+    }
+    isWasmChecked = true;
+  }
+  return isWasm;
+}
+
+/**
+ * Check if running in WASM mode.
+ */
+export function isWasmMode(): boolean {
+  return checkWasm();
+}
+
+/**
+ * Call the host's schedule_task function to create a new isolated task instance.
+ *
+ * This is the bridge between JavaScript code and the Rust host runtime.
+ */
+export function callHost(
+  name: string,
+  args: any[],
+  config: Record<string, any>
+): string {
+  if (checkWasm() && hostModule !== null) {
+    try {
+      const result = hostModule.scheduleTask(
+        name,
+        JSON.stringify(args),
+        JSON.stringify(config)
+      );
+      return result;
+    } catch (e) {
+      const error = e instanceof Error ? e.message : String(e);
+      return JSON.stringify({ error: `Host call failed: ${error}` });
+    }
+  } else {
+    return JSON.stringify({ result: `mock_result_for_${name}` });
+  }
+}

package/src/http.ts

@@ -0,0 +1,221 @@
+/**
+ * Capsule SDK - HTTP Client
+ *
+ * This module provides HTTP request functions by calling the host's HTTP implementation.
+ * In WASM mode, requests go through the Rust host.
+ * In local mode, uses native fetch for testing.
+ */
+
+import { isWasmMode } from "./hostApi.js";
+
+export interface RequestOptions {
+  headers?: Record<string, string>;
+  body?: string;
+  json?: any;
+}
+
+/**
+ * HTTP Response wrapper with convenient methods.
+ */
+export class Response {
+  readonly status: number;
+  readonly headers: Record<string, string>;
+  readonly body: string;
+
+  constructor(status: number, headers: Record<string, string>, body: string) {
+    this.status = status;
+    this.headers = headers;
+    this.body = body;
+  }
+
+  /**
+   * Parse response body as JSON.
+   */
+  json<T = any>(): T {
+    return JSON.parse(this.body);
+  }
+
+  /**
+   * Get response body as text.
+   */
+  text(): string {
+    return this.body;
+  }
+
+  /**
+   * Check if response status is 2xx.
+   */
+  ok(): boolean {
+    return this.status >= 200 && this.status < 300;
+  }
+
+  toString(): string {
+    return `<Response [${this.status}]>`;
+  }
+}
+
+/**
+ * Internal function to make HTTP requests.
+ * In WASM mode: calls the host API
+ * In local mode: uses fetch
+ */
+async function makeRequest(
+  method: string,
+  url: string,
+  options: RequestOptions = {}
+): Promise<Response> {
+  return isWasmMode()
+    ? makeHostRequest(method, url, options)
+    : makeLocalRequest(method, url, options);
+}
+
+/**
+ * Make HTTP request using native fetch (local mode only).
+ */
+async function makeLocalRequest(
+  method: string,
+  url: string,
+  options: RequestOptions = {}
+): Promise<Response> {
+  const headers: Record<string, string> = { ...options.headers };
+  let body: string | undefined = options.body;
+
+  if (options.json !== undefined) {
+    body = JSON.stringify(options.json);
+    headers["Content-Type"] = "application/json";
+  }
+
+  const fetchOptions: RequestInit = {
+    method,
+    headers,
+  };
+
+  if (body !== undefined) {
+    fetchOptions.body = body;
+  }
+
+  const fetchResponse = await fetch(url, fetchOptions);
+  const responseText = await fetchResponse.text();
+
+  const responseHeaders: Record<string, string> = {};
+  fetchResponse.headers.forEach((value, key) => {
+    responseHeaders[key] = value;
+  });
+
+  return new Response(fetchResponse.status, responseHeaders, responseText);
+}
+
+/**
+ * Make HTTP request via the Rust host (WASM mode).
+ */
+function makeHostRequest(
+  method: string,
+  url: string,
+  options: RequestOptions = {}
+): Response {
+  try {
+    const hostModule = (globalThis as any)["capsule:host/api"];
+
+    if (!hostModule || !hostModule.httpRequest) {
+      throw new Error("Host HTTP API not available");
+    }
+
+    const headers: [string, string][] = [];
+    const requestHeaders = options.headers || {};
+
+    for (const [key, value] of Object.entries(requestHeaders)) {
+      headers.push([key, value]);
+    }
+
+    let body: string | undefined = options.body;
+
+    if (options.json !== undefined) {
+      body = JSON.stringify(options.json);
+      headers.push(["Content-Type", "application/json"]);
+    }
+
+    const result = hostModule.httpRequest(method, url, headers, body);
+
+    const responseHeaders: Record<string, string> = {};
+    for (const [key, value] of result.headers) {
+      responseHeaders[key] = value;
+    }
+
+    return new Response(result.status, responseHeaders, result.body);
+  } catch (error) {
+    throw new Error(`HTTP request failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+/**
+ * Make an HTTP GET request.
+ *
+ * @example
+ * ```typescript
+ * const response = http.get("https://api.github.com/zen");
+ * console.log(response.text());
+ * ```
+ */
+export async function get(
+  url: string,
+  options: Omit<RequestOptions, "body" | "json"> = {}
+): Promise<Response> {
+  return makeRequest("GET", url, options);
+}
+
+/**
+ * Make an HTTP POST request.
+ *
+ * @example
+ * ```typescript
+ * const response = http.post("https://api.example.com/data", {
+ *   json: { key: "value" }
+ * });
+ * ```
+ */
+export async function post(
+  url: string,
+  options: RequestOptions = {}
+): Promise<Response> {
+  return makeRequest("POST", url, options);
+}
+
+/**
+ * Make an HTTP PUT request.
+ */
+export async function put(
+  url: string,
+  options: RequestOptions = {}
+): Promise<Response> {
+  return makeRequest("PUT", url, options);
+}
+
+/**
+ * Make an HTTP DELETE request.
+ */
+export async function del(
+  url: string,
+  options: Omit<RequestOptions, "body" | "json"> = {}
+): Promise<Response> {
+  return makeRequest("DELETE", url, options);
+}
+
+/**
+ * Make an HTTP PATCH request.
+ */
+export async function patch(
+  url: string,
+  options: RequestOptions = {}
+): Promise<Response> {
+  return makeRequest("PATCH", url, options);
+}
+
+/**
+ * Make an HTTP HEAD request.
+ */
+export async function head(
+  url: string,
+  options: Omit<RequestOptions, "body" | "json"> = {}
+): Promise<Response> {
+  return makeRequest("HEAD", url, options);
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+/**
+ * Capsule SDK for JavaScript/TypeScript
+ *
+ * @example
+ * ```typescript
+ * import { task } from '@capsule/sdk';
+ *
+ * export const greet = task({
+ *   name: "greet",
+ *   compute: "LOW"
+ * }, (name: string): string => {
+ *   return `Hello, ${name}!`;
+ * });
+ * ```
+ */
+
+export { task, type TaskOptions } from "./task.js";
+export { TaskRunner, exports, type TaskConfig } from "./app.js";
+export * as http from "./http.js";
+export { isWasmMode } from "./hostApi.js";

package/src/task.ts

@@ -0,0 +1,119 @@
+/**
+ * Capsule SDK - Task Wrapper
+ *
+ * Provides the `task` wrapper function for defining Capsule tasks
+ * in an idiomatic TypeScript way.
+ */
+
+import { registerTask, type TaskConfig } from "./app.js";
+import { isWasmMode, callHost } from "./hostApi.js";
+
+export interface TaskOptions {
+  /** Task name (required) */
+  name: string;
+  /** Compute level: "LOW", "MEDIUM", or "HIGH" */
+  compute?: "LOW" | "MEDIUM" | "HIGH" | number;
+  /** RAM limit, e.g., "512MB", "2GB" */
+  ram?: string;
+  /**
+   * Timeout duration.
+   * String format: "30s", "5m", "2h" (e.g., "10s")
+   * Number format: milliseconds (e.g., 10000 for 10 seconds)
+   */
+  timeout?: string | number;
+  /** Maximum number of retries */
+  maxRetries?: number;
+}
+
+interface TaskResult {
+  result?: any;
+  error?: string;
+}
+
+/**
+ * Define a Capsule task with configuration.
+ *
+ * @example
+ * ```typescript
+ * // String timeout format
+ * export const greet = task({
+ *   name: "greet",
+ *   compute: "LOW",
+ *   timeout: "10s"
+ * }, (name: string): string => {
+ *   return `Hello, ${name}!`;
+ * });
+ *
+ * // Numeric timeout format (milliseconds)
+ * export const process = task({
+ *   name: "process",
+ *   compute: "HIGH",
+ *   timeout: 30000  // 30 seconds
+ * }, (data: any): any => {
+ *   return processData(data);
+ * });
+ * ```
+ *
+ * In WASM mode:
+ * - The function is registered in the task registry with its config
+ * - When called from within a task, it schedules a new isolated instance
+ * - The host creates a new Wasm instance with resource limits
+ *
+ * In non-WASM mode:
+ * - The function executes directly
+ */
+
+/**
+ * Normalize timeout to string format for the Rust host.
+ *
+ * @param timeout - String duration ("10s", "5m") or number (milliseconds)
+ * @returns String format for host API, or undefined
+ */
+function normalizeTimeout(timeout?: string | number): string | undefined {
+  if (timeout === undefined) return undefined;
+  if (typeof timeout === "number") {
+    return `${timeout}ms`;
+  }
+  return timeout;
+}
+
+export function task<TArgs extends any[], TReturn>(
+  options: TaskOptions,
+  fn: (...args: TArgs) => TReturn
+): (...args: TArgs) => TReturn {
+  const taskName = options.name;
+  let compute = options.compute?.toString().toUpperCase() ?? "MEDIUM";
+
+  const taskConfig: TaskConfig = {
+    name: taskName,
+    compute,
+    ram: options.ram,
+    timeout: normalizeTimeout(options.timeout),
+    maxRetries: options.maxRetries,
+  };
+
+  const wrapper = (...args: TArgs): TReturn => {
+    if (!isWasmMode()) {
+      return fn(...args);
+    }
+
+    const resultJson = callHost(taskName, args, taskConfig);
+
+    try {
+      const result: TaskResult = JSON.parse(resultJson);
+      if (result.error) {
+        throw new Error(`Task ${taskName} failed: ${result.error}`);
+      }
+      return result.result as TReturn;
+    } catch (e) {
+      if (e instanceof SyntaxError) {
+        return resultJson as unknown as TReturn;
+      }
+      throw e;
+    }
+  };
+
+  registerTask(taskName, fn, taskConfig);
+
+  return wrapper;
+}