@rkat/web 0.5.2 → 0.6.0

package/wasm/meerkat_web_runtime.d.ts

@@ -82,11 +82,18 @@ export function destroy_session(handle: number): void;
  */
 export function get_session_state(handle: number): string;
 
+/**
+ * Returns `true` if a JS-side external-auth resolver has been
+ * registered. Exposed to the browser so host pages can verify their
+ * registration before creating a session.
+ */
+export function has_external_auth_resolver(): boolean;
+
 /**
  * Primary bootstrap: parse a mobpack and create service infrastructure.
  *
  * `mobpack_bytes`: tar.gz mobpack archive.
- * `credentials_json`: `{ "api_key": "sk-...", "anthropic_api_key"?: "...", "openai_api_key"?: "...", "gemini_api_key"?: "...", "model"?: "claude-sonnet-4-5" }`
+ * `credentials_json`: `{ "anthropic_api_key"?: "...", "openai_api_key"?: "...", "gemini_api_key"?: "...", "model"?: "claude-sonnet-4-5" }`
  *
  * Stores an `EphemeralSessionService<FactoryAgentBuilder>` and a `MobMcpState`
  * in a `thread_local! RuntimeState` for subsequent mob/comms calls.
@@ -96,7 +103,7 @@ export function init_runtime(mobpack_bytes: Uint8Array, credentials_json: string
 /**
  * Advanced bare-bones bootstrap without a mobpack.
  *
- * `config_json`: `{ "api_key"?: "sk-...", "anthropic_api_key"?: "...", "openai_api_key"?: "...", "gemini_api_key"?: "...", "model"?: "claude-sonnet-4-5", "max_sessions"?: 64 }`
+ * `config_json`: `{ "anthropic_api_key"?: "...", "openai_api_key"?: "...", "gemini_api_key"?: "...", "model"?: "claude-sonnet-4-5", "max_sessions"?: 100000 }`
  */
 export function init_runtime_from_config(config_json: string): any;
 
@@ -108,7 +115,7 @@ export function inspect_mobpack(mobpack_bytes: Uint8Array): string;
 /**
  * Append runtime system context to an individual mob member's session.
  */
-export function mob_append_system_context(mob_id: string, meerkat_id: string, request_json: string): Promise<any>;
+export function mob_append_system_context(mob_id: string, agent_identity: string, request_json: string): Promise<any>;
 
 /**
  * Cancel an in-flight flow run.
@@ -135,14 +142,15 @@ export function mob_events(mob_id: string, after_cursor: number, limit: number):
 /**
  * Read flow run status.
  *
- * Returns JSON with run state and ledgers, or null if not found.
+ * Returns a generated `MobFlowStatusResult` JSON envelope whose `run` field
+ * carries run state and ledgers, or null when not found.
  */
 export function mob_flow_status(mob_id: string, run_id: string): Promise<any>;
 
 /**
  * Force-cancel an active mob member turn.
  */
-export function mob_force_cancel(mob_id: string, meerkat_id: string): Promise<void>;
+export function mob_force_cancel(mob_id: string, agent_identity: string): Promise<void>;
 
 /**
  * Fork a short-lived helper from an existing member and return its terminal result.
@@ -152,14 +160,15 @@ export function mob_fork_helper(mob_id: string, request_json: string): Promise<a
 /**
  * Perform a lifecycle action on a mob.
  *
- * `action`: one of "stop", "resume", "complete", "reset", "destroy".
+ * `action` is a compatibility string carrier that is immediately
+ * deserialized into the typed wire lifecycle action contract.
  */
 export function mob_lifecycle(mob_id: string, action: string): Promise<void>;
 
 /**
  * List all mobs.
  *
- * Returns JSON array of `{ mob_id, state }`.
+ * Returns a generated `MobListResult` JSON envelope.
  */
 export function mob_list(): Promise<any>;
 
@@ -171,16 +180,16 @@ export function mob_list(): Promise<any>;
 export function mob_list_members(mob_id: string): Promise<any>;
 
 /**
- * Send external work to a spawned meerkat through the canonical member path.
+ * Send external work to a spawned member through the canonical member path.
  *
  * Returns a JSON-encoded delivery receipt.
  */
-export function mob_member_send(mob_id: string, meerkat_id: string, request_json: string): Promise<string>;
+export function mob_member_send(mob_id: string, agent_identity: string, request_json: string): Promise<string>;
 
 /**
  * Read the current execution snapshot for a mob member.
  */
-export function mob_member_status(mob_id: string, meerkat_id: string): Promise<any>;
+export function mob_member_status(mob_id: string, agent_identity: string): Promise<any>;
 
 /**
  * Subscribe to a mob member's session event stream.
@@ -191,19 +200,19 @@ export function mob_member_status(mob_id: string, meerkat_id: string): Promise<a
  * The subscription captures ALL agent activity: text deltas, tool calls
  * (including comms send_message/peers), turn completions, etc.
  */
-export function mob_member_subscribe(mob_id: string, meerkat_id: string): Promise<number>;
+export function mob_member_subscribe(mob_id: string, agent_identity: string): Promise<number>;
 
 /**
- * Retire and re-spawn a meerkat with the same profile.
+ * Retire and re-spawn a member with the same profile.
  *
  * Returns JSON result envelope with receipt.
  */
-export function mob_respawn(mob_id: string, meerkat_id: string, initial_message?: string | null): Promise<any>;
+export function mob_respawn(mob_id: string, agent_identity: string, initial_message?: string | null): Promise<any>;
 
 /**
- * Retire a meerkat from a mob.
+ * Retire a member from a mob.
  */
-export function mob_retire(mob_id: string, meerkat_id: string): Promise<void>;
+export function mob_retire(mob_id: string, agent_identity: string): Promise<void>;
 
 /**
  * Start a configured flow run.
@@ -213,12 +222,12 @@ export function mob_retire(mob_id: string, meerkat_id: string): Promise<void>;
 export function mob_run_flow(mob_id: string, flow_id: string, params_json: string): Promise<any>;
 
 /**
- * Spawn one or more meerkats in a mob.
+ * Spawn one or more members in a mob.
  *
- * `specs_json`: JSON array of `{ "profile": "...", "meerkat_id": "...", "initial_message"?: "...",
+ * `specs_json`: JSON array of `{ "profile": "...", "agent_identity": "...", "initial_message"?: "...",
  *                "runtime_mode"?: "autonomous_host"|"turn_driven", "backend"?: "session"|"external" }`
  *
- * Returns JSON array of results per spec.
+ * Returns JSON array of typed result entries per spec.
  */
 export function mob_spawn(mob_id: string, specs_json: string): Promise<any>;
 
@@ -230,7 +239,7 @@ export function mob_spawn_helper(mob_id: string, request_json: string): Promise<
 /**
  * Get the status of a mob.
  *
- * Returns JSON with the mob state.
+ * Returns JSON with the generated mob status plus the legacy state projection.
  */
 export function mob_status(mob_id: string): Promise<any>;
 
@@ -241,13 +250,13 @@ export function mob_status(mob_id: string): Promise<any>;
  * buffered events. Each call returns all events since the last poll.
  *
  * Unlike `mob_member_subscribe` which streams a single member's agent events,
- * this streams [`AttributedEvent`]s tagged with source meerkat_id and profile
+ * this streams [`AttributedEvent`]s tagged with source runtime identity and role
  * for every member in the mob, automatically tracking roster changes.
  */
 export function mob_subscribe_events(mob_id: string): Promise<number>;
 
 /**
- * Unwire bidirectional trust between two meerkats.
+ * Unwire bidirectional trust between two members.
  */
 export function mob_unwire(mob_id: string, a: string, b: string): Promise<void>;
 
@@ -257,12 +266,12 @@ export function mob_unwire(mob_id: string, a: string, b: string): Promise<void>;
 export function mob_unwire_peer(mob_id: string, member: string, peer_json: string): Promise<void>;
 
 /**
- * Unwire a local meerkat from a local or external peer target.
+ * Unwire a local member from a local or external peer target.
  */
 export function mob_unwire_target(mob_id: string, local: string, target_json: string): Promise<void>;
 
 /**
- * Wire bidirectional trust between two meerkats.
+ * Wire bidirectional trust between two members.
  */
 export function mob_wire(mob_id: string, a: string, b: string): Promise<void>;
 
@@ -272,7 +281,7 @@ export function mob_wire(mob_id: string, a: string, b: string): Promise<void>;
 export function mob_wire_peer(mob_id: string, member: string, peer_json: string): Promise<void>;
 
 /**
- * Wire a local meerkat to a local or external peer target.
+ * Wire a local member to a local or external peer target.
  */
 export function mob_wire_target(mob_id: string, local: string, target_json: string): Promise<void>;
 
@@ -289,6 +298,8 @@ export function poll_events(handle: number): string;
  *
  * Returns a JSON array of event objects. Drains all buffered events
  * since the last poll. Non-blocking: returns `[]` if no new events.
+ * If any buffered event cannot be projected to JSON, returns a typed
+ * `serialize_error` instead of silently omitting the event.
  *
  * For per-member subscriptions (`mob_member_subscribe`), returns
  * `EventEnvelope<AgentEvent>` objects. For mob-wide subscriptions
@@ -297,6 +308,25 @@ export function poll_events(handle: number): string;
  */
 export function poll_subscription(handle: number): string;
 
+/**
+ * Register a JS-side external-auth resolver. The callback receives a
+ * structural auth binding reference argument (`{ realm, binding, profile? }`)
+ * and must return a Promise that resolves to a JSON-serializable
+ * `ResolvedAuthEnvelope` object.
+ *
+ * Lease-bearing credentials must use the typed object form:
+ * `{ kind: "inline_secret", secret, metadata, expires_at? }`.
+ * Structured failures should reject the Promise with a wire auth error
+ * object, e.g. `{ kind: "interactive_login_required" }` or
+ * `{ kind: "refresh_failed", detail }`.
+ *
+ * Subsequent registrations overwrite the previous one. Passing
+ * `undefined` clears the registration.
+ *
+ * Plan §Phase 4d.wasm.1.
+ */
+export function register_external_auth_resolver(callback: any): void;
+
 /**
  * Register a fire-and-forget tool from JavaScript.
  *
@@ -357,7 +387,7 @@ export function runtime_version(): string;
  * Only rejects (Err) for infrastructure errors (session not found, busy, etc).
  * Agent-level errors (LLM failure, timeout) resolve with `status: "failed"` + `error` field.
  */
-export function start_turn(handle: number, prompt: string, options_json: string): Promise<any>;
+export function start_turn(handle: number, prompt: string): Promise<any>;
 
 /**
  * Entry point invoked by JavaScript in a worker.
@@ -371,12 +401,14 @@ export function task_worker_entry_point(ptr: number): void;
  * mob boundaries by accessing each member's comms runtime through the shared
  * session service. Both members must have comms enabled.
  */
-export function wire_cross_mob(mob_a: string, meerkat_a: string, mob_b: string, meerkat_b: string): Promise<void>;
+export function wire_cross_mob(mob_a: string, agent_a: string, mob_b: string, agent_b: string): Promise<void>;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly has_external_auth_resolver: () => number;
+    readonly register_external_auth_resolver: (a: any) => [number, number];
     readonly append_system_context: (a: number, b: number, c: number) => any;
     readonly close_subscription: (a: number) => [number, number];
     readonly create_session: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -418,9 +450,11 @@ export interface InitOutput {
     readonly register_js_tool: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly register_tool_callback: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number];
     readonly runtime_version: () => [number, number];
-    readonly start_turn: (a: number, b: number, c: number, d: number, e: number) => any;
+    readonly start_turn: (a: number, b: number, c: number) => any;
     readonly wire_cross_mob: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
     readonly clear_tool_callbacks: () => void;
+    readonly __meerkat_agent_factory_policy_build_v3_22bac767e5ac2bbb: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+    readonly __meerkat_agent_factory_policy_bridge_token_is_valid_v1_22bac767e5ac2bbb: (a: number, b: number) => number;
     readonly __wbg_intounderlyingsource_free: (a: number, b: number) => void;
     readonly intounderlyingsource_cancel: (a: number) => void;
     readonly intounderlyingsource_pull: (a: number, b: any) => any;
@@ -435,13 +469,13 @@ export interface InitOutput {
     readonly intounderlyingbytesource_start: (a: number, b: any) => void;
     readonly intounderlyingbytesource_type: (a: number) => number;
     readonly task_worker_entry_point: (a: number) => [number, number];
-    readonly wasm_bindgen__closure__destroy__h106b5dbd8202a7df: (a: number, b: number) => void;
-    readonly wasm_bindgen__closure__destroy__h7f34be0b3a836172: (a: number, b: number) => void;
-    readonly wasm_bindgen__closure__destroy__h77919cec1c17ae69: (a: number, b: number) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h027fc7640278d6db: (a: number, b: number, c: any, d: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__hd13d9d6a8fb8d666: (a: number, b: number, c: any) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__hd7b55e518cfe0f3a: (a: number, b: number) => void;
-    readonly wasm_bindgen__convert__closures_____invoke__h7415d9853ffcc319: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__h8d4c756ab63d9770: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__h5aa0d731ff57d357: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__h973cae16c57d7463: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h000908a3022707e8: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h5b49a0460cf7b45a: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hc044ecd2c461ff5b: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__hf7f43c07d2237779: (a: number, b: number) => void;
     readonly __wbindgen_malloc_command_export: (a: number, b: number) => number;
     readonly __wbindgen_realloc_command_export: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store_command_export: (a: number) => void;