@rkat/web 0.4.13 → 0.5.0

package/wasm/meerkat_web_runtime.js

@@ -112,7 +112,7 @@ export class IntoUnderlyingSource {
 if (Symbol.dispose) IntoUnderlyingSource.prototype[Symbol.dispose] = IntoUnderlyingSource.prototype.free;
 
 /**
- * Append runtime system context to a direct session handle.
+ * Append runtime system context to a browser session handle.
  * @param {number} handle
  * @param {string} request_json
  * @returns {any}
@@ -148,11 +148,8 @@ export function close_subscription(handle) {
 /**
  * Create a session from a mobpack + config.
  *
- * Routes through `AgentFactory::build_agent()` with override-first
- * resource injection — same pipeline as all other meerkat surfaces.
- *
- * `config_json`: `{ "model": "...", "api_key": "sk-...", "max_tokens"?: N,
- *                    "comms_name"?: "...", "host_mode"?: true }`
+ * Allocates a real session through the initialized runtime-backed session
+ * service, then returns a browser-local session handle for convenience.
  * @param {Uint8Array} mobpack_bytes
  * @param {string} config_json
  * @returns {number}
@@ -170,12 +167,7 @@ export function create_session(mobpack_bytes, config_json) {
 }
 
 /**
- * Create a session without a mobpack — for standalone agent use.
- *
- * `config_json`: `{ "model": "...", "api_key": "sk-...", "system_prompt"?: "...",
- *                    "max_tokens"?: N, "additional_instructions"?: ["..."] }`
- *
- * Uses `register_tool_callback` tools if any were registered before this call.
+ * Create a standalone session through initialized runtime state.
  * @param {string} config_json
  * @returns {number}
  */
@@ -189,6 +181,19 @@ export function create_session_simple(config_json) {
     return ret[0] >>> 0;
 }
 
+/**
+ * Tear down the embedded runtime and release all local handles/subscriptions.
+ *
+ * Existing `Session`, `Mob`, and subscription handles become invalid after
+ * this call.
+ */
+export function destroy_runtime() {
+    const ret = wasm.destroy_runtime();
+    if (ret[1]) {
+        throw takeFromExternrefTable0(ret[0]);
+    }
+}
+
 /**
  * Remove a session.
  * @param {number} handle
@@ -374,10 +379,40 @@ export function mob_flow_status(mob_id, run_id) {
     return ret;
 }
 
+/**
+ * Force-cancel an active mob member turn.
+ * @param {string} mob_id
+ * @param {string} meerkat_id
+ * @returns {Promise<void>}
+ */
+export function mob_force_cancel(mob_id, meerkat_id) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(meerkat_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_force_cancel(ptr0, len0, ptr1, len1);
+    return ret;
+}
+
+/**
+ * Fork a short-lived helper from an existing member and return its terminal result.
+ * @param {string} mob_id
+ * @param {string} request_json
+ * @returns {Promise<any>}
+ */
+export function mob_fork_helper(mob_id, request_json) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_fork_helper(ptr0, len0, ptr1, len1);
+    return ret;
+}
+
 /**
  * Perform a lifecycle action on a mob.
  *
- * `action`: one of "stop", "resume", "complete", "destroy".
+ * `action`: one of "stop", "resume", "complete", "reset", "destroy".
  * @param {string} mob_id
  * @param {string} action
  * @returns {Promise<void>}
@@ -416,6 +451,41 @@ export function mob_list_members(mob_id) {
     return ret;
 }
 
+/**
+ * Send external work to a spawned meerkat through the canonical member path.
+ *
+ * Returns a JSON-encoded delivery receipt.
+ * @param {string} mob_id
+ * @param {string} meerkat_id
+ * @param {string} request_json
+ * @returns {Promise<string>}
+ */
+export function mob_member_send(mob_id, meerkat_id, request_json) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(meerkat_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(request_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_member_send(ptr0, len0, ptr1, len1, ptr2, len2);
+    return ret;
+}
+
+/**
+ * Read the current execution snapshot for a mob member.
+ * @param {string} mob_id
+ * @param {string} meerkat_id
+ * @returns {Promise<any>}
+ */
+export function mob_member_status(mob_id, meerkat_id) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(meerkat_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_member_status(ptr0, len0, ptr1, len1);
+    return ret;
+}
+
 /**
  * Subscribe to a mob member's session event stream.
  *
@@ -440,7 +510,7 @@ export function mob_member_subscribe(mob_id, meerkat_id) {
 /**
  * Retire and re-spawn a meerkat with the same profile.
  *
- * Returns JSON: `{ "meerkat_id", "status": "respawn_enqueued" }`
+ * Returns JSON result envelope with receipt.
  * @param {string} mob_id
  * @param {string} meerkat_id
  * @param {string | null} [initial_message]
@@ -493,42 +563,37 @@ export function mob_run_flow(mob_id, flow_id, params_json) {
 }
 
 /**
- * Send an external message to a spawned meerkat.
+ * Spawn one or more meerkats in a mob.
+ *
+ * `specs_json`: JSON array of `{ "profile": "...", "meerkat_id": "...", "initial_message"?: "...",
+ *                "runtime_mode"?: "autonomous_host"|"turn_driven", "backend"?: "session"|"external" }`
  *
- * Returns the session ID of the session that handled the turn.
+ * Returns JSON array of results per spec.
  * @param {string} mob_id
- * @param {string} meerkat_id
- * @param {string} message
- * @returns {Promise<string>}
+ * @param {string} specs_json
+ * @returns {Promise<any>}
  */
-export function mob_send_message(mob_id, meerkat_id, message) {
+export function mob_spawn(mob_id, specs_json) {
     const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
     const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passStringToWasm0(meerkat_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const ptr1 = passStringToWasm0(specs_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
     const len1 = WASM_VECTOR_LEN;
-    const ptr2 = passStringToWasm0(message, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
-    const len2 = WASM_VECTOR_LEN;
-    const ret = wasm.mob_send_message(ptr0, len0, ptr1, len1, ptr2, len2);
+    const ret = wasm.mob_spawn(ptr0, len0, ptr1, len1);
     return ret;
 }
 
 /**
- * Spawn one or more meerkats in a mob.
- *
- * `specs_json`: JSON array of `{ "profile": "...", "meerkat_id": "...", "initial_message"?: "...",
- *                "runtime_mode"?: "autonomous_host"|"turn_driven", "backend"?: "subagent"|"external" }`
- *
- * Returns JSON array of results per spec.
+ * Spawn a short-lived helper and return its terminal result.
  * @param {string} mob_id
- * @param {string} specs_json
+ * @param {string} request_json
  * @returns {Promise<any>}
  */
-export function mob_spawn(mob_id, specs_json) {
+export function mob_spawn_helper(mob_id, request_json) {
     const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
     const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passStringToWasm0(specs_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const ptr1 = passStringToWasm0(request_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
     const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.mob_spawn(ptr0, len0, ptr1, len1);
+    const ret = wasm.mob_spawn_helper(ptr0, len0, ptr1, len1);
     return ret;
 }
 
@@ -583,6 +648,42 @@ export function mob_unwire(mob_id, a, b) {
     return ret;
 }
 
+/**
+ * Unwire a local member from a local or external peer target.
+ * @param {string} mob_id
+ * @param {string} member
+ * @param {string} peer_json
+ * @returns {Promise<void>}
+ */
+export function mob_unwire_peer(mob_id, member, peer_json) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(member, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(peer_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_unwire_peer(ptr0, len0, ptr1, len1, ptr2, len2);
+    return ret;
+}
+
+/**
+ * Unwire a local meerkat from a local or external peer target.
+ * @param {string} mob_id
+ * @param {string} local
+ * @param {string} target_json
+ * @returns {Promise<void>}
+ */
+export function mob_unwire_target(mob_id, local, target_json) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(local, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(target_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_unwire_target(ptr0, len0, ptr1, len1, ptr2, len2);
+    return ret;
+}
+
 /**
  * Wire bidirectional trust between two meerkats.
  * @param {string} mob_id
@@ -601,6 +702,42 @@ export function mob_wire(mob_id, a, b) {
     return ret;
 }
 
+/**
+ * Wire a local member to a local or external peer target.
+ * @param {string} mob_id
+ * @param {string} member
+ * @param {string} peer_json
+ * @returns {Promise<void>}
+ */
+export function mob_wire_peer(mob_id, member, peer_json) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(member, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(peer_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_wire_peer(ptr0, len0, ptr1, len1, ptr2, len2);
+    return ret;
+}
+
+/**
+ * Wire a local meerkat to a local or external peer target.
+ * @param {string} mob_id
+ * @param {string} local
+ * @param {string} target_json
+ * @returns {Promise<void>}
+ */
+export function mob_wire_target(mob_id, local, target_json) {
+    const ptr0 = passStringToWasm0(mob_id, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(local, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(target_json, wasm.__wbindgen_malloc_command_export, wasm.__wbindgen_realloc_command_export);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.mob_wire_target(ptr0, len0, ptr1, len1, ptr2, len2);
+    return ret;
+}
+
 /**
  * Drain and return all pending agent events from the last turn(s).
  *
@@ -663,13 +800,13 @@ export function poll_subscription(handle) {
 /**
  * Register a fire-and-forget tool from JavaScript.
  *
- * Call this BEFORE `init_runtime` or `init_runtime_from_config`.
+ * Requires initialized runtime state.
  * When the agent calls this tool, `dispatch()` returns `"acknowledged"`
  * immediately and the agent loop continues without waiting.
  *
  * The host should watch `ToolCallRequested` events in the event stream to
  * capture the tool call arguments and act on them asynchronously. Any
- * response (e.g. human approval) should be sent back via `mob_send_message`.
+ * response (e.g. human approval) should be sent back via `mob_member_send`.
  *
  * Example (JS):
  * ```js
@@ -706,7 +843,7 @@ export function register_js_tool(name, description, schema_json) {
 /**
  * Register a tool implementation from JavaScript.
  *
- * Call this BEFORE `init_runtime` or `init_runtime_from_config`.
+ * Requires initialized runtime state.
  * The `callback` receives a JSON string of tool arguments and must return
  * a `Promise<string>` resolving to JSON `{"content": "...", "is_error": false}`.
  *
@@ -753,12 +890,12 @@ export function runtime_version() {
 }
 
 /**
- * Run a turn through the real meerkat agent loop via AgentFactory::build_agent().
+ * Run a turn through the runtime-backed session service.
  *
  * Returns JSON: `{ "text", "usage", "status", "session_id", "turns", "tool_calls" }`
  *
  * Convention: always resolves (Ok). Check `status` field for "completed" vs "failed".
- * Only rejects (Err) for infrastructure errors (session not found, build failure).
+ * Only rejects (Err) for infrastructure errors (session not found, busy, etc).
  * Agent-level errors (LLM failure, timeout) resolve with `status: "failed"` + `error` field.
  * @param {number} handle
  * @param {string} prompt
@@ -1262,17 +1399,17 @@ function __wbg_get_imports() {
             return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 1677, function: Function { arguments: [], shim_idx: 1678, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 1883, function: Function { arguments: [], shim_idx: 1884, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hd784b404a9939abd, wasm_bindgen__convert__closures_____invoke__ha3daf52f0a255ec1);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 4002, function: Function { arguments: [], shim_idx: 4003, ret: Unit, inner_ret: Some(Unit) }, mutable: false }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 4227, function: Function { arguments: [], shim_idx: 4228, ret: Unit, inner_ret: Some(Unit) }, mutable: false }) -> Externref`.
             const ret = makeClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h017fc47e7d3e6c2d, wasm_bindgen__convert__closures_____invoke__h33aeef803f4d26ad);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 4018, function: Function { arguments: [Externref], shim_idx: 4019, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 4243, function: Function { arguments: [Externref], shim_idx: 4244, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hbb4473811cf816f9, wasm_bindgen__convert__closures_____invoke__hbef0706bd8d01ba3);
             return ret;
         },

package/wasm/meerkat_web_runtime_bg.wasm.d.ts

@@ -5,6 +5,7 @@ export const append_system_context: (a: number, b: number, c: number) => [number
 export const close_subscription: (a: number) => [number, number];
 export const create_session: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const create_session_simple: (a: number, b: number) => [number, number, number];
+export const destroy_runtime: () => [number, number];
 export const destroy_session: (a: number) => [number, number];
 export const get_session_state: (a: number) => [number, number, number, number];
 export const init_runtime: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -15,19 +16,27 @@ export const mob_cancel_flow: (a: number, b: number, c: number, d: number) => an
 export const mob_create: (a: number, b: number) => any;
 export const mob_events: (a: number, b: number, c: number, d: number) => any;
 export const mob_flow_status: (a: number, b: number, c: number, d: number) => any;
+export const mob_force_cancel: (a: number, b: number, c: number, d: number) => any;
+export const mob_fork_helper: (a: number, b: number, c: number, d: number) => any;
 export const mob_lifecycle: (a: number, b: number, c: number, d: number) => any;
 export const mob_list: () => any;
 export const mob_list_members: (a: number, b: number) => any;
+export const mob_member_send: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+export const mob_member_status: (a: number, b: number, c: number, d: number) => any;
 export const mob_member_subscribe: (a: number, b: number, c: number, d: number) => any;
 export const mob_respawn: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
 export const mob_retire: (a: number, b: number, c: number, d: number) => any;
 export const mob_run_flow: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
-export const mob_send_message: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
 export const mob_spawn: (a: number, b: number, c: number, d: number) => any;
+export const mob_spawn_helper: (a: number, b: number, c: number, d: number) => any;
 export const mob_status: (a: number, b: number) => any;
 export const mob_subscribe_events: (a: number, b: number) => any;
 export const mob_unwire: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+export const mob_unwire_peer: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+export const mob_unwire_target: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
 export const mob_wire: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+export const mob_wire_peer: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
+export const mob_wire_target: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
 export const poll_events: (a: number) => [number, number, number, number];
 export const poll_subscription: (a: number) => [number, number, number, number];
 export const register_js_tool: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];

package/wasm/package.json

@@ -4,7 +4,7 @@
   "collaborators": [
     "Luka Crnkovic-Friis"
   ],
-  "version": "0.4.13",
+  "version": "0.5.0",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",