@unicity-astrid/sdk 0.1.0

package/dist/runtime/bridge.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Bridge runtime — implements the four WIT guest exports
+ * (`astrid-hook-trigger`, `run`, `astrid-install`, `astrid-upgrade`) on top
+ * of the registry the decorators populated.
+ *
+ * The Rust SDK's `#[capsule]` macro generates this same logic at compile
+ * time. We do it at runtime: walk the registry, dispatch the action,
+ * load/save state for mutable handlers, publish results to IPC, and
+ * produce the `capsule-result` the kernel expects.
+ *
+ * Dispatch table mirrors `sdk-rust/astrid-sdk-macros/src/lib.rs:600–660`:
+ *   - `tool_describe`: aggregate schemas + descriptions, return as `data`.
+ *     Built lazily on first invocation, cached thereafter.
+ *   - `tool_execute_<name>`: parse `ToolExecuteRequest`, optionally load
+ *     state, run handler, publish result to `tool.v1.execute.<name>.result`,
+ *     optionally save state, return `{ action: "continue", data: undefined }`.
+ *   - any other action: check the interceptors map THEN the commands map.
+ *     Their results flow back via `capsule-result.data` directly (no IPC
+ *     publish), matching the Rust macro's behaviour for these paths.
+ *
+ * State key matches Rust: `__state`, JSON-encoded.
+ */
+export interface CapsuleResult {
+    action: string;
+    data: string | undefined;
+}
+export interface Bridge {
+    astridHookTrigger(action: string, payload: Uint8Array): CapsuleResult;
+    run(): void;
+    astridInstall(): void;
+    astridUpgrade(): void;
+}
+export declare function createBridge(): Bridge;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/runtime/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/runtime/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgBH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,aAAa,CAAC;IACtE,GAAG,IAAI,IAAI,CAAC;IACZ,aAAa,IAAI,IAAI,CAAC;IACtB,aAAa,IAAI,IAAI,CAAC;CACvB;AAkBD,wBAAgB,YAAY,IAAI,MAAM,CAyNrC"}

package/dist/runtime/bridge.js

@@ -0,0 +1,326 @@
+/**
+ * Bridge runtime — implements the four WIT guest exports
+ * (`astrid-hook-trigger`, `run`, `astrid-install`, `astrid-upgrade`) on top
+ * of the registry the decorators populated.
+ *
+ * The Rust SDK's `#[capsule]` macro generates this same logic at compile
+ * time. We do it at runtime: walk the registry, dispatch the action,
+ * load/save state for mutable handlers, publish results to IPC, and
+ * produce the `capsule-result` the kernel expects.
+ *
+ * Dispatch table mirrors `sdk-rust/astrid-sdk-macros/src/lib.rs:600–660`:
+ *   - `tool_describe`: aggregate schemas + descriptions, return as `data`.
+ *     Built lazily on first invocation, cached thereafter.
+ *   - `tool_execute_<name>`: parse `ToolExecuteRequest`, optionally load
+ *     state, run handler, publish result to `tool.v1.execute.<name>.result`,
+ *     optionally save state, return `{ action: "continue", data: undefined }`.
+ *   - any other action: check the interceptors map THEN the commands map.
+ *     Their results flow back via `capsule-result.data` directly (no IPC
+ *     publish), matching the Rust macro's behaviour for these paths.
+ *
+ * State key matches Rust: `__state`, JSON-encoded.
+ */
+import { getRegistration, } from "./registry.js";
+import * as kv from "../kv.js";
+import * as ipc from "../ipc.js";
+import * as log from "../log.js";
+import { getConfig } from "astrid:sys/host@1.0.0";
+const STATE_KEY = "__state";
+const decoder = new TextDecoder();
+function denied(reason) {
+    return { action: "deny", data: reason };
+}
+function cont(data) {
+    return { action: "continue", data };
+}
+export function createBridge() {
+    let toolDescribeCache;
+    function reg() {
+        const r = getRegistration();
+        if (r === undefined) {
+            throw new Error("No @capsule class registered. The build pipeline emits the entry " +
+                "module after the user's source so decorators have already fired — " +
+                "this means the user code never imported the SDK or never declared " +
+                "a @capsule class.");
+        }
+        return r;
+    }
+    function buildToolDescribe() {
+        const r = reg();
+        const tools = Array.from(r.tools.values()).map(toolToDescribeEntry);
+        return JSON.stringify({
+            tools,
+            description: r.description ?? "",
+        });
+    }
+    function loadInstance(r) {
+        const instance = new r.ctor();
+        const persisted = kv.get(STATE_KEY);
+        if (persisted !== undefined && typeof persisted === "object" && persisted !== null) {
+            Object.assign(instance, persisted);
+        }
+        return instance;
+    }
+    function persistInstance(instance) {
+        const snapshot = {};
+        for (const [key, value] of Object.entries(instance)) {
+            snapshot[key] = value;
+        }
+        kv.set(STATE_KEY, snapshot);
+    }
+    function getInstance(entry) {
+        const r = reg();
+        if (entry.mutable) {
+            return { instance: loadInstance(r), persist: true };
+        }
+        return { instance: new r.ctor(), persist: false };
+    }
+    function executeTool(entry, payload) {
+        let req;
+        try {
+            req = JSON.parse(decoder.decode(payload));
+        }
+        catch (e) {
+            return denied(`failed to parse tool execute payload: ${e.message}`);
+        }
+        const callId = req.call_id ?? "";
+        let instance;
+        let persist;
+        try {
+            ({ instance, persist } = getInstance(entry));
+        }
+        catch (e) {
+            publishToolError(entry.name, callId, `failed to load state: ${e.message}`);
+            return cont();
+        }
+        let resultPayload;
+        try {
+            const raw = invoke(instance, entry.methodName, req.arguments);
+            resultPayload = { content: stringifyResult(raw), isError: false };
+        }
+        catch (e) {
+            resultPayload = { content: e.message ?? String(e), isError: true };
+        }
+        if (persist && !resultPayload.isError) {
+            try {
+                persistInstance(instance);
+            }
+            catch (e) {
+                publishToolError(entry.name, callId, `failed to save state: ${e.message}`);
+                return cont();
+            }
+        }
+        publishToolResult(entry.name, callId, resultPayload.content, resultPayload.isError);
+        return cont();
+    }
+    /**
+     * Dispatch interceptor / command actions. Both kinds share the same
+     * return path: the handler's JSON-serialized result becomes
+     * `capsule-result.data`, the kernel reads it from the hook-trigger
+     * return value. `null` results yield `{ action: "continue", data: undefined }`
+     * so the interceptor chain keeps the original payload (mirrors Rust).
+     */
+    function executeHookHandler(entry, payload) {
+        let parsed = undefined;
+        if (payload.length > 0) {
+            try {
+                parsed = JSON.parse(decoder.decode(payload));
+            }
+            catch (e) {
+                return denied(`failed to parse payload: ${e.message}`);
+            }
+        }
+        let instance;
+        let persist;
+        try {
+            ({ instance, persist } = getInstance(entry));
+        }
+        catch (e) {
+            return denied(`failed to load state: ${e.message}`);
+        }
+        let resultJson;
+        try {
+            const raw = invoke(instance, entry.methodName, parsed);
+            resultJson = stringifyResult(raw);
+        }
+        catch (e) {
+            return denied(e.message ?? String(e));
+        }
+        if (persist) {
+            try {
+                persistInstance(instance);
+            }
+            catch (e) {
+                return denied(`failed to save state: ${e.message}`);
+            }
+        }
+        if (resultJson === "null")
+            return cont();
+        return cont(resultJson);
+    }
+    return {
+        astridHookTrigger(action, payload) {
+            try {
+                if (action === "tool_describe") {
+                    toolDescribeCache ??= buildToolDescribe();
+                    return cont(toolDescribeCache);
+                }
+                if (action.startsWith("tool_execute_")) {
+                    const name = action.slice("tool_execute_".length);
+                    const r = reg();
+                    const entry = r.tools.get(name);
+                    if (entry === undefined)
+                        return denied(`unknown tool: ${name}`);
+                    return executeTool(entry, payload);
+                }
+                const r = reg();
+                const interceptor = r.interceptors.get(action);
+                if (interceptor !== undefined) {
+                    return executeHookHandler(interceptor, payload);
+                }
+                const command = r.commands.get(action);
+                if (command !== undefined) {
+                    return executeHookHandler(command, payload);
+                }
+                return denied(`unknown hook action: ${action}`);
+            }
+            catch (e) {
+                return denied(`bridge panic in astridHookTrigger: ${e.message ?? String(e)}`);
+            }
+        },
+        run() {
+            try {
+                const r = reg();
+                if (r.runMethod === undefined) {
+                    // Non-runnable capsule: WIT requires the export, but it must
+                    // return immediately so the kernel doesn't think we're a daemon.
+                    return;
+                }
+                // Runnable capsule. Per Rust macro semantics, run() loads state but
+                // does NOT auto-persist (loops are infinite; explicit kv.set is
+                // the user's responsibility for runnable state).
+                const instance = loadInstance(r);
+                const raw = invoke(instance, r.runMethod, undefined);
+                // For a daemon-style loop, the handler should never resolve. If it
+                // does (or throws), surface via log and return.
+                if (raw instanceof Promise) {
+                    syncWait(raw);
+                }
+            }
+            catch (e) {
+                log.error(`run loop exited with error: ${e.message ?? String(e)}`);
+            }
+        },
+        astridInstall() {
+            try {
+                const r = reg();
+                if (r.installMethod === undefined)
+                    return;
+                const instance = new r.ctor();
+                invoke(instance, r.installMethod, undefined);
+                persistInstance(instance);
+            }
+            catch (e) {
+                log.error(`install hook failed: ${e.message ?? String(e)}`);
+            }
+        },
+        astridUpgrade() {
+            try {
+                const r = reg();
+                if (r.upgradeMethod === undefined)
+                    return;
+                const prevVersion = safeGetConfig("prev_version");
+                const instance = loadInstance(r);
+                invoke(instance, r.upgradeMethod, prevVersion);
+                persistInstance(instance);
+            }
+            catch (e) {
+                log.error(`upgrade hook failed: ${e.message ?? String(e)}`);
+            }
+        },
+    };
+}
+/**
+ * Call a registered method on an instance. The bridge always passes
+ * either zero or one argument; method signatures with more parameters
+ * are rejected at decorator time.
+ */
+function invoke(instance, methodName, arg) {
+    const method = instance[methodName];
+    if (typeof method !== "function") {
+        throw new Error(`method ${methodName} not found on capsule instance`);
+    }
+    const raw = arg === undefined
+        ? method.call(instance)
+        : method.call(instance, arg);
+    return raw instanceof Promise ? syncWait(raw) : raw;
+}
+function toolToDescribeEntry(entry) {
+    const schema = entry.inputSchema ?? { type: "object", properties: {} };
+    // Mirror schemars: `mutable` is a schema extension, not a top-level field.
+    const inputSchema = { ...schema, mutable: entry.mutable };
+    return {
+        name: entry.name,
+        description: entry.description ?? "",
+        input_schema: inputSchema,
+    };
+}
+function publishToolResult(name, callId, content, isError) {
+    const topic = `tool.v1.execute.${name}.result`;
+    ipc.publishJson(topic, {
+        type: "tool_execute_result",
+        call_id: callId,
+        result: { call_id: callId, content, is_error: isError },
+    });
+}
+function publishToolError(name, callId, message) {
+    publishToolResult(name, callId, message, true);
+}
+function stringifyResult(value) {
+    if (typeof value === "string")
+        return value;
+    if (value === undefined)
+        return "null";
+    try {
+        return JSON.stringify(value);
+    }
+    catch (e) {
+        throw new Error(`failed to serialize tool result: ${e.message}`);
+    }
+}
+function safeGetConfig(key) {
+    try {
+        return getConfig(key) ?? "";
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * StarlingMonkey runs the JS event loop to settle promises returned from
+ * exported functions before returning to the host. Sync handlers
+ * pass-through; async handlers whose promise hasn't resolved by the
+ * engine's microtask drain are surfaced as a clear error.
+ */
+function syncWait(promise) {
+    let settled = false;
+    let value;
+    let error;
+    promise.then((v) => {
+        settled = true;
+        value = v;
+    }, (e) => {
+        settled = true;
+        error = e;
+    });
+    if (!settled) {
+        throw new Error("Handler returned a Promise that did not settle synchronously. " +
+            "ComponentizeJS syncifies awaits backed by host imports it knows " +
+            "how to drive — pure setTimeout/setInterval will hang. Use only " +
+            "Astrid SDK calls inside handlers, or make the handler sync.");
+    }
+    if (error !== undefined)
+        throw error;
+    return value;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/runtime/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/runtime/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,eAAe,GAKhB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,SAAS,GAAG,SAAS,CAAC;AAoB5B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,SAAS,MAAM,CAAC,MAAc;IAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,IAAI,CAAC,IAAa;IACzB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,iBAAqC,CAAC;IAE1C,SAAS,GAAG;QACV,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,mEAAmE;gBACjE,oEAAoE;gBACpE,oEAAoE;gBACpE,mBAAmB,CACtB,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,SAAS,iBAAiB;QACxB,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,KAAK;YACL,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,YAAY,CAAC,CAAsB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,EAAE,CAAC,GAAG,CAA0B,SAAS,CAAC,CAAC;QAC7D,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACnF,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,SAAS,eAAe,CAAC,QAAgB;QACvC,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,WAAW,CAAC,KAA2B;QAC9C,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;QAChB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;IAED,SAAS,WAAW,CAAC,KAAgB,EAAE,OAAmB;QACxD,IAAI,GAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAuB,CAAC;QAClE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,yCAA0C,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAEjC,IAAI,QAAgB,CAAC;QACrB,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,yBAA0B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACtF,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,IAAI,aAAoD,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;YAC9D,aAAa,GAAG,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,aAAa,GAAG,EAAE,OAAO,EAAG,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChF,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,yBAA0B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtF,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAED,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QACpF,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,SAAS,kBAAkB,CACzB,KAAsC,EACtC,OAAmB;QAEnB,IAAI,MAAM,GAAY,SAAS,CAAC;QAChC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,IAAI,QAAgB,CAAC;QACrB,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,yBAA0B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACvD,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,MAAM,CAAE,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC,yBAA0B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,IAAI,UAAU,KAAK,MAAM;YAAE,OAAO,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,iBAAiB,CAAC,MAAc,EAAE,OAAmB;YACnD,IAAI,CAAC;gBACH,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;oBAC/B,iBAAiB,KAAK,iBAAiB,EAAE,CAAC;oBAC1C,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBACjC,CAAC;gBAED,IAAI,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;oBACvC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;oBAClD,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAChC,IAAI,KAAK,KAAK,SAAS;wBAAE,OAAO,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;oBAChE,OAAO,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACrC,CAAC;gBAED,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;gBAChB,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC/C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,OAAO,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAClD,CAAC;gBACD,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,CAAC;gBAED,OAAO,MAAM,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC,sCAAuC,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;QAED,GAAG;YACD,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;gBAChB,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC9B,6DAA6D;oBAC7D,iEAAiE;oBACjE,OAAO;gBACT,CAAC;gBACD,oEAAoE;gBACpE,gEAAgE;gBAChE,iDAAiD;gBACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;gBACjC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBACrD,mEAAmE;gBACnE,gDAAgD;gBAChD,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;oBAC3B,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CAAC,+BAAgC,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QAED,aAAa;YACX,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;gBAChB,IAAI,CAAC,CAAC,aAAa,KAAK,SAAS;oBAAE,OAAO;gBAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;gBAC7C,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CAAC,wBAAyB,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,aAAa;YACX,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;gBAChB,IAAI,CAAC,CAAC,aAAa,KAAK,SAAS;oBAAE,OAAO;gBAC1C,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;gBAClD,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;gBACjC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;gBAC/C,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CAAC,wBAAyB,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,QAAgB,EAAE,UAAkB,EAAE,GAAY;IAChE,MAAM,MAAM,GAAI,QAAoC,CAAC,UAAU,CAAC,CAAC;IACjE,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,UAAU,UAAU,gCAAgC,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,KAAK,SAAS;QAC3B,CAAC,CAAE,MAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrC,CAAC,CAAE,MAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACtD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAgB;IAC3C,MAAM,MAAM,GACV,KAAK,CAAC,WAAW,IAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAA8B,CAAC;IACvF,2EAA2E;IAC3E,MAAM,WAAW,GAA4B,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACnF,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,YAAY,EAAE,WAAW;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,MAAc,EAAE,OAAe,EAAE,OAAgB;IACxF,MAAM,KAAK,GAAG,mBAAmB,IAAI,SAAS,CAAC;IAC/C,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE;QACrB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE;KACxD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,MAAc,EAAE,OAAe;IACrE,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oCAAqC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAI,OAAmB;IACtC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,KAAoB,CAAC;IACzB,IAAI,KAAc,CAAC;IACnB,OAAO,CAAC,IAAI,CACV,CAAC,CAAC,EAAE,EAAE;QACJ,OAAO,GAAG,IAAI,CAAC;QACf,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;QACJ,OAAO,GAAG,IAAI,CAAC;QACf,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC,CACF,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gEAAgE;YAC9D,kEAAkE;YAClE,iEAAiE;YACjE,6DAA6D,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC;IACrC,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export { createBridge, type Bridge, type CapsuleResult } from "./bridge.js";
+export { registerCapsule, recordTool, recordInstall, recordUpgrade, getRegistration, __resetRegistry, type CapsuleRegistration, type ToolEntry, } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,eAAe,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,3 @@
+export { createBridge } from "./bridge.js";
+export { registerCapsule, recordTool, recordInstall, recordUpgrade, getRegistration, __resetRegistry, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmC,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,GAGhB,MAAM,eAAe,CAAC"}

package/dist/runtime/registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Module-scoped registry populated by the @capsule, @tool, @install,
+ * @upgrade, @interceptor, @command, @run decorators. The bridge reads from
+ * this registry to dispatch host export calls.
+ *
+ * Decorators run during class evaluation, which happens at module init.
+ * The bridge is constructed AFTER all decorators have populated the
+ * registry, so reads are safe.
+ */
+export type CapsuleConstructor = new () => object;
+export interface ToolEntry {
+    /** Name exposed to the LLM / kernel — matches `tool_execute_<name>` action. */
+    name: string;
+    /** TS method name on the class. */
+    methodName: string;
+    /** If true, the bridge loads state before and saves after on success. */
+    mutable: boolean;
+    /** Human-readable description from decorator or TSDoc. */
+    description: string | undefined;
+    /** JSON Schema for the tool's input. Built-time codegen fills this in. */
+    inputSchema: Record<string, unknown> | undefined;
+}
+export interface InterceptorEntry {
+    /** Topic pattern the interceptor reacts to (also the hook action name). */
+    topic: string;
+    methodName: string;
+    mutable: boolean;
+}
+export interface CommandEntry {
+    /** Command name (= hook action name, registered alongside interceptors). */
+    name: string;
+    methodName: string;
+    mutable: boolean;
+}
+export interface CapsuleRegistration {
+    ctor: CapsuleConstructor;
+    tools: Map<string, ToolEntry>;
+    interceptors: Map<string, InterceptorEntry>;
+    commands: Map<string, CommandEntry>;
+    installMethod: string | undefined;
+    upgradeMethod: string | undefined;
+    runMethod: string | undefined;
+    description: string | undefined;
+}
+export declare function registerCapsule(ctor: CapsuleConstructor, description?: string): void;
+/** Adopt any decorator entries buffered before @capsule fired. */
+export declare function adoptPending(ctor: CapsuleConstructor): void;
+export declare function recordTool(ctor: CapsuleConstructor, entry: ToolEntry): void;
+export declare function recordInterceptor(ctor: CapsuleConstructor, entry: InterceptorEntry): void;
+export declare function recordCommand(ctor: CapsuleConstructor, entry: CommandEntry): void;
+export declare function recordInstall(ctor: CapsuleConstructor, methodName: string): void;
+export declare function recordUpgrade(ctor: CapsuleConstructor, methodName: string): void;
+export declare function recordRun(ctor: CapsuleConstructor, methodName: string): void;
+/** Returns the registered capsule, or undefined if none has been declared. */
+export declare function getRegistration(): CapsuleRegistration | undefined;
+/** Test-only: reset the registry to a clean state. */
+export declare function __resetRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/runtime/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,kBAAkB,GAAG,UAAU,MAAM,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAiBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAYpF;AAqBD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAoB3D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAM3E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAMzF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAMjF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAMhF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAMhF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,IAAI,mBAAmB,GAAG,SAAS,CAEjE;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/runtime/registry.js

@@ -0,0 +1,129 @@
+/**
+ * Module-scoped registry populated by the @capsule, @tool, @install,
+ * @upgrade, @interceptor, @command, @run decorators. The bridge reads from
+ * this registry to dispatch host export calls.
+ *
+ * Decorators run during class evaluation, which happens at module init.
+ * The bridge is constructed AFTER all decorators have populated the
+ * registry, so reads are safe.
+ */
+let registration;
+function newRegistration(ctor, description) {
+    return {
+        ctor,
+        tools: new Map(),
+        interceptors: new Map(),
+        commands: new Map(),
+        installMethod: undefined,
+        upgradeMethod: undefined,
+        runMethod: undefined,
+        description,
+    };
+}
+export function registerCapsule(ctor, description) {
+    if (registration !== undefined && registration.ctor !== ctor) {
+        throw new Error(`Only one @capsule class may be registered per WASM module. ` +
+            `Already have ${registration.ctor.name}; refusing to register ${ctor.name}.`);
+    }
+    if (registration === undefined) {
+        registration = newRegistration(ctor, description);
+    }
+    else if (description !== undefined && registration.description === undefined) {
+        registration.description = description;
+    }
+}
+/**
+ * Decorators may run before `@capsule` if class fields appear before the
+ * class itself in source. Buffer pending entries on the constructor so the
+ * eventual @capsule call picks them up.
+ */
+const pendingByCtor = new WeakMap();
+function ensureRegistration(ctor) {
+    if (registration !== undefined && registration.ctor === ctor) {
+        return registration;
+    }
+    let pending = pendingByCtor.get(ctor);
+    if (pending === undefined) {
+        pending = newRegistration(ctor, undefined);
+        pendingByCtor.set(ctor, pending);
+    }
+    return pending;
+}
+/** Adopt any decorator entries buffered before @capsule fired. */
+export function adoptPending(ctor) {
+    if (registration === undefined || registration.ctor !== ctor)
+        return;
+    const pending = pendingByCtor.get(ctor);
+    if (pending === undefined)
+        return;
+    for (const [name, entry] of pending.tools)
+        registration.tools.set(name, entry);
+    for (const [topic, entry] of pending.interceptors)
+        registration.interceptors.set(topic, entry);
+    for (const [name, entry] of pending.commands)
+        registration.commands.set(name, entry);
+    if (pending.installMethod !== undefined && registration.installMethod === undefined) {
+        registration.installMethod = pending.installMethod;
+    }
+    if (pending.upgradeMethod !== undefined && registration.upgradeMethod === undefined) {
+        registration.upgradeMethod = pending.upgradeMethod;
+    }
+    if (pending.runMethod !== undefined && registration.runMethod === undefined) {
+        registration.runMethod = pending.runMethod;
+    }
+    if (pending.description !== undefined && registration.description === undefined) {
+        registration.description = pending.description;
+    }
+    pendingByCtor.delete(ctor);
+}
+export function recordTool(ctor, entry) {
+    const target = ensureRegistration(ctor);
+    if (target.tools.has(entry.name)) {
+        throw new Error(`@tool("${entry.name}") declared twice on ${ctor.name}.`);
+    }
+    target.tools.set(entry.name, entry);
+}
+export function recordInterceptor(ctor, entry) {
+    const target = ensureRegistration(ctor);
+    if (target.interceptors.has(entry.topic)) {
+        throw new Error(`@interceptor("${entry.topic}") declared twice on ${ctor.name}.`);
+    }
+    target.interceptors.set(entry.topic, entry);
+}
+export function recordCommand(ctor, entry) {
+    const target = ensureRegistration(ctor);
+    if (target.commands.has(entry.name)) {
+        throw new Error(`@command("${entry.name}") declared twice on ${ctor.name}.`);
+    }
+    target.commands.set(entry.name, entry);
+}
+export function recordInstall(ctor, methodName) {
+    const target = ensureRegistration(ctor);
+    if (target.installMethod !== undefined) {
+        throw new Error(`Only one @install method allowed on ${ctor.name}.`);
+    }
+    target.installMethod = methodName;
+}
+export function recordUpgrade(ctor, methodName) {
+    const target = ensureRegistration(ctor);
+    if (target.upgradeMethod !== undefined) {
+        throw new Error(`Only one @upgrade method allowed on ${ctor.name}.`);
+    }
+    target.upgradeMethod = methodName;
+}
+export function recordRun(ctor, methodName) {
+    const target = ensureRegistration(ctor);
+    if (target.runMethod !== undefined) {
+        throw new Error(`Only one @run method allowed on ${ctor.name}.`);
+    }
+    target.runMethod = methodName;
+}
+/** Returns the registered capsule, or undefined if none has been declared. */
+export function getRegistration() {
+    return registration;
+}
+/** Test-only: reset the registry to a clean state. */
+export function __resetRegistry() {
+    registration = undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/runtime/registry.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,36 @@
+/**
+ * OS runtime introspection + signaling. Mirrors `astrid_sdk::runtime`.
+ *
+ * Also surfaces {@link randomBytes} (cryptographically secure host entropy
+ * via `sys::random-bytes`) for capsules that need an audit-traced CSPRNG —
+ * `globalThis.crypto.getRandomValues` works inside StarlingMonkey but
+ * bypasses the host audit trail.
+ */
+/** Information about the caller that triggered the current execution. */
+export interface CallerContext {
+    /** UUID of the capsule that originated the IPC message. */
+    sourceId: string;
+    /** The acting principal (user ID), if available. */
+    principal: string | undefined;
+    /** ISO 8601 timestamp of the originating message. */
+    timestamp: string;
+}
+/**
+ * Signal that the capsule's run loop is ready. Call after setting up IPC
+ * subscriptions inside `@run`; the kernel waits for this before loading
+ * dependent capsules.
+ */
+export declare function signalReady(): void;
+/** Caller context for the current invocation. */
+export declare function caller(): CallerContext;
+/**
+ * Fill `length` bytes with cryptographically secure random data from the
+ * host's OS-level CSPRNG. Capped at 4096 bytes per call.
+ */
+export declare function randomBytes(length: number): Uint8Array;
+/**
+ * Kernel's Unix domain socket path, injected via the well-known
+ * `ASTRID_SOCKET_PATH` config key.
+ */
+export declare function socketPath(): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,iDAAiD;AACjD,wBAAgB,MAAM,IAAI,aAAa,CAOtC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAItD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CASnC"}