@rkat/web 0.4.1

package/dist/events.d.ts

@@ -0,0 +1,20 @@
+import type { EventEnvelope } from './types.js';
+type PollSubscriptionFn = (handle: number) => string;
+type CloseSubscriptionFn = (handle: number) => void;
+/** Wraps a WASM subscription handle with typed polling. */
+export declare class EventSubscription {
+    private handle;
+    private closed;
+    private pollFn;
+    private closeFn;
+    /** @internal — use Mob.subscribe() or Mob.subscribeAll() instead. */
+    constructor(handle: number, pollFn: PollSubscriptionFn, closeFn: CloseSubscriptionFn);
+    /** Poll for new events. Returns an empty array when no events are available. */
+    poll(): EventEnvelope[];
+    /** Close the subscription and release the handle. */
+    close(): void;
+    /** Whether this subscription has been closed. */
+    get isClosed(): boolean;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,KAAK,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AACrD,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpD,2DAA2D;AAC3D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAsB;IAErC,qEAAqE;gBAEnE,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,mBAAmB;IAO9B,gFAAgF;IAChF,IAAI,IAAI,aAAa,EAAE;IAOvB,qDAAqD;IACrD,KAAK,IAAI,IAAI;IAMb,iDAAiD;IACjD,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF"}

package/dist/events.js

@@ -0,0 +1,33 @@
+/** Wraps a WASM subscription handle with typed polling. */
+export class EventSubscription {
+    handle;
+    closed = false;
+    pollFn;
+    closeFn;
+    /** @internal — use Mob.subscribe() or Mob.subscribeAll() instead. */
+    constructor(handle, pollFn, closeFn) {
+        this.handle = handle;
+        this.pollFn = pollFn;
+        this.closeFn = closeFn;
+    }
+    /** Poll for new events. Returns an empty array when no events are available. */
+    poll() {
+        if (this.closed)
+            return [];
+        const json = this.pollFn(this.handle);
+        const parsed = JSON.parse(json);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    /** Close the subscription and release the handle. */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.closeFn(this.handle);
+    }
+    /** Whether this subscription has been closed. */
+    get isClosed() {
+        return this.closed;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAMA,2DAA2D;AAC3D,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAS;IACf,MAAM,GAAG,KAAK,CAAC;IACf,MAAM,CAAqB;IAC3B,OAAO,CAAsB;IAErC,qEAAqE;IACrE,YACE,MAAc,EACd,MAA0B,EAC1B,OAA4B;QAE5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,gFAAgF;IAChF,IAAI;QACF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,qDAAqD;IACrD,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { MeerkatRuntime } from './runtime.js';
+export type { WasmModule } from './runtime.js';
+export { Mob } from './mob.js';
+export { Session } from './session.js';
+export { EventSubscription } from './events.js';
+export { isKnownEvent } from './types.js';
+export type { RuntimeConfig, InitResult, SessionConfig, TurnOptions, TurnResult, Usage, MobDefinition, Profile, ToolConfig, WiringRules, RoleWiringRule, SpawnSpec, SpawnResult, MobMember, MobStatus, MobLifecycleAction, EventEnvelope, AgentEvent, TextDeltaEvent, TextCompleteEvent, ToolCallRequestedEvent, ToolResultReceivedEvent, TurnStartedEvent, TurnCompletedEvent, RunCompletedEvent, RunFailedEvent, ToolExecutionStartedEvent, ToolExecutionCompletedEvent, ReasoningDeltaEvent, ReasoningCompleteEvent, JsonSchema, ToolCallbackResult, ToolCallback, FlowStatus, } from './types.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,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,KAAK,EACL,aAAa,EACb,OAAO,EACP,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { MeerkatRuntime } from './runtime.js';
+export { Mob } from './mob.js';
+export { Session } from './session.js';
+export { EventSubscription } from './events.js';
+export { isKnownEvent } from './types.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,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/mob.d.ts

@@ -0,0 +1,67 @@
+import { EventSubscription } from './events.js';
+import type { SpawnSpec, SpawnResult, MobMember, MobStatus, MobLifecycleAction, FlowStatus, EventEnvelope } from './types.js';
+interface MobWasmBindings {
+    mob_spawn: (mobId: string, specs: string) => Promise<string>;
+    mob_retire: (mobId: string, meerkatId: string) => Promise<void>;
+    mob_wire: (mobId: string, a: string, b: string) => Promise<void>;
+    mob_unwire: (mobId: string, a: string, b: string) => Promise<void>;
+    mob_list_members: (mobId: string) => Promise<string>;
+    mob_send_message: (mobId: string, meerkatId: string, message: string) => Promise<void>;
+    mob_respawn: (mobId: string, meerkatId: string, initialMessage?: string) => Promise<void>;
+    mob_status: (mobId: string) => Promise<string>;
+    mob_lifecycle: (mobId: string, action: string) => Promise<void>;
+    mob_events: (mobId: string, afterCursor: string, limit: number) => Promise<string>;
+    mob_run_flow: (mobId: string, flowId: string, params: string) => Promise<string>;
+    mob_flow_status: (mobId: string, runId: string) => Promise<string>;
+    mob_cancel_flow: (mobId: string, runId: string) => Promise<void>;
+    mob_member_subscribe: (mobId: string, meerkatId: string) => number;
+    mob_subscribe_events: (mobId: string) => number;
+    mob_inject_and_subscribe: (mobId: string, meerkatId: string, message: string) => Promise<string>;
+    poll_subscription: (handle: number) => string;
+    close_subscription: (handle: number) => void;
+}
+/** A mob instance — a group of agents with shared orchestration. */
+export declare class Mob {
+    /** The mob's unique identifier. */
+    readonly mobId: string;
+    private bindings;
+    /** @internal — use MeerkatRuntime.createMob() instead. */
+    constructor(mobId: string, bindings: MobWasmBindings);
+    /** Spawn one or more agents into the mob. */
+    spawn(specs: SpawnSpec[]): Promise<SpawnResult[]>;
+    /** Retire an agent from the mob. */
+    retire(meerkatId: string): Promise<void>;
+    /** Wire two agents for comms trust. */
+    wire(a: string, b: string): Promise<void>;
+    /** Remove comms trust between two agents. */
+    unwire(a: string, b: string): Promise<void>;
+    /** List all members in the mob. */
+    listMembers(): Promise<MobMember[]>;
+    /** Send a message to a specific agent. */
+    sendMessage(meerkatId: string, message: string): Promise<void>;
+    /** Retire and re-spawn an agent with the same profile. */
+    respawn(meerkatId: string, initialMessage?: string): Promise<void>;
+    /** Get mob status. */
+    status(): Promise<MobStatus>;
+    /** Perform a lifecycle action (stop, resume, complete, destroy). */
+    lifecycle(action: MobLifecycleAction): Promise<void>;
+    /** Get mob events after a cursor. */
+    events(afterCursor?: string, limit?: number): Promise<EventEnvelope[]>;
+    /** Run a flow. Returns the run ID. */
+    runFlow(flowId: string, params?: Record<string, unknown>): Promise<string>;
+    /** Get flow status. */
+    flowStatus(runId: string): Promise<FlowStatus>;
+    /** Cancel a running flow. */
+    cancelFlow(runId: string): Promise<void>;
+    /** Subscribe to events for a specific member. */
+    subscribe(meerkatId: string): EventSubscription;
+    /** Subscribe to all mob-wide events. */
+    subscribeAll(): EventSubscription;
+    /** Send a message and subscribe to the interaction. Returns the interaction ID. */
+    injectAndSubscribe(meerkatId: string, message: string): Promise<{
+        interactionId: string;
+        subscription: EventSubscription;
+    }>;
+}
+export {};
+//# sourceMappingURL=mob.d.ts.map

package/dist/mob.d.ts.map

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

package/dist/mob.js

@@ -0,0 +1,89 @@
+import { EventSubscription } from './events.js';
+/** A mob instance — a group of agents with shared orchestration. */
+export class Mob {
+    /** The mob's unique identifier. */
+    mobId;
+    bindings;
+    /** @internal — use MeerkatRuntime.createMob() instead. */
+    constructor(mobId, bindings) {
+        this.mobId = mobId;
+        this.bindings = bindings;
+    }
+    /** Spawn one or more agents into the mob. */
+    async spawn(specs) {
+        const json = await this.bindings.mob_spawn(this.mobId, JSON.stringify(specs));
+        return JSON.parse(json);
+    }
+    /** Retire an agent from the mob. */
+    async retire(meerkatId) {
+        await this.bindings.mob_retire(this.mobId, meerkatId);
+    }
+    /** Wire two agents for comms trust. */
+    async wire(a, b) {
+        await this.bindings.mob_wire(this.mobId, a, b);
+    }
+    /** Remove comms trust between two agents. */
+    async unwire(a, b) {
+        await this.bindings.mob_unwire(this.mobId, a, b);
+    }
+    /** List all members in the mob. */
+    async listMembers() {
+        const json = await this.bindings.mob_list_members(this.mobId);
+        return JSON.parse(json);
+    }
+    /** Send a message to a specific agent. */
+    async sendMessage(meerkatId, message) {
+        await this.bindings.mob_send_message(this.mobId, meerkatId, message);
+    }
+    /** Retire and re-spawn an agent with the same profile. */
+    async respawn(meerkatId, initialMessage) {
+        await this.bindings.mob_respawn(this.mobId, meerkatId, initialMessage);
+    }
+    /** Get mob status. */
+    async status() {
+        const json = await this.bindings.mob_status(this.mobId);
+        return JSON.parse(json);
+    }
+    /** Perform a lifecycle action (stop, resume, complete, destroy). */
+    async lifecycle(action) {
+        await this.bindings.mob_lifecycle(this.mobId, action);
+    }
+    /** Get mob events after a cursor. */
+    async events(afterCursor = '', limit = 100) {
+        const json = await this.bindings.mob_events(this.mobId, afterCursor, limit);
+        return JSON.parse(json);
+    }
+    /** Run a flow. Returns the run ID. */
+    async runFlow(flowId, params = {}) {
+        const json = await this.bindings.mob_run_flow(this.mobId, flowId, JSON.stringify(params));
+        return JSON.parse(json);
+    }
+    /** Get flow status. */
+    async flowStatus(runId) {
+        const json = await this.bindings.mob_flow_status(this.mobId, runId);
+        return JSON.parse(json);
+    }
+    /** Cancel a running flow. */
+    async cancelFlow(runId) {
+        await this.bindings.mob_cancel_flow(this.mobId, runId);
+    }
+    /** Subscribe to events for a specific member. */
+    subscribe(meerkatId) {
+        const handle = this.bindings.mob_member_subscribe(this.mobId, meerkatId);
+        return new EventSubscription(handle, this.bindings.poll_subscription, this.bindings.close_subscription);
+    }
+    /** Subscribe to all mob-wide events. */
+    subscribeAll() {
+        const handle = this.bindings.mob_subscribe_events(this.mobId);
+        return new EventSubscription(handle, this.bindings.poll_subscription, this.bindings.close_subscription);
+    }
+    /** Send a message and subscribe to the interaction. Returns the interaction ID. */
+    async injectAndSubscribe(meerkatId, message) {
+        const json = await this.bindings.mob_inject_and_subscribe(this.mobId, meerkatId, message);
+        const interactionId = JSON.parse(json);
+        // Subscribe to the member's events to follow the interaction
+        const subscription = this.subscribe(meerkatId);
+        return { interactionId, subscription };
+    }
+}
+//# sourceMappingURL=mob.js.map

package/dist/mob.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,107 @@
+import { Mob } from './mob.js';
+import { Session } from './session.js';
+import type { RuntimeConfig, SessionConfig, MobDefinition, JsonSchema, ToolCallback, MobStatus } from './types.js';
+/**
+ * The wasm-bindgen module type.
+ *
+ * This mirrors the exports from `meerkat_web_runtime.js` generated by wasm-pack.
+ * We use a structural type so the wrapper compiles without the actual WASM build
+ * artifacts present.
+ */
+export interface WasmModule {
+    default: () => Promise<unknown>;
+    runtime_version: () => string;
+    init_runtime: (mobpackBytes: Uint8Array, credentialsJson: string) => string;
+    init_runtime_from_config: (configJson: string) => string;
+    register_tool_callback: (name: string, description: string, schemaJson: string, callback: (args: string) => Promise<string>) => void;
+    clear_tool_callbacks: () => void;
+    create_session_simple: (configJson: string) => number;
+    create_session: (mobpackBytes: Uint8Array, configJson: string) => number;
+    start_turn: (handle: number, prompt: string, optionsJson: string) => Promise<string>;
+    get_session_state: (handle: number) => string;
+    destroy_session: (handle: number) => void;
+    poll_events: (handle: number) => string;
+    inspect_mobpack: (mobpackBytes: Uint8Array) => string;
+    mob_create: (definitionJson: string) => Promise<string>;
+    mob_status: (mobId: string) => Promise<string>;
+    mob_list: () => Promise<string>;
+    mob_lifecycle: (mobId: string, action: string) => Promise<void>;
+    mob_events: (mobId: string, afterCursor: string, limit: number) => Promise<string>;
+    mob_spawn: (mobId: string, specsJson: string) => Promise<string>;
+    mob_retire: (mobId: string, meerkatId: string) => Promise<void>;
+    mob_wire: (mobId: string, a: string, b: string) => Promise<void>;
+    mob_unwire: (mobId: string, a: string, b: string) => Promise<void>;
+    mob_list_members: (mobId: string) => Promise<string>;
+    mob_send_message: (mobId: string, meerkatId: string, message: string) => Promise<void>;
+    mob_respawn: (mobId: string, meerkatId: string, initialMessage?: string) => Promise<void>;
+    mob_inject_and_subscribe: (mobId: string, meerkatId: string, message: string) => Promise<string>;
+    mob_run_flow: (mobId: string, flowId: string, paramsJson: string) => Promise<string>;
+    mob_flow_status: (mobId: string, runId: string) => Promise<string>;
+    mob_cancel_flow: (mobId: string, runId: string) => Promise<void>;
+    mob_member_subscribe: (mobId: string, meerkatId: string) => number;
+    mob_subscribe_events: (mobId: string) => number;
+    poll_subscription: (handle: number) => string;
+    close_subscription: (handle: number) => void;
+    wire_cross_mob: (mobA: string, meerkatA: string, mobB: string, meerkatB: string) => Promise<void>;
+    comms_peers: (sessionId: string) => Promise<string>;
+    comms_send: (sessionId: string, paramsJson: string) => Promise<string>;
+}
+/** Entry point for the Meerkat WASM runtime in the browser. */
+export declare class MeerkatRuntime {
+    private wasm;
+    private constructor();
+    /**
+     * Initialize the WASM runtime with the given configuration.
+     *
+     * @param wasm - The WASM module (import from the wasm-pack output).
+     * @param config - Runtime configuration including API keys and provider URLs.
+     * @returns An initialized {@link MeerkatRuntime} instance.
+     *
+     * @example
+     * ```typescript
+     * import * as wasm from '@rkat/web/wasm/meerkat_web_runtime.js';
+     *
+     * const runtime = await MeerkatRuntime.init(wasm, {
+     *   anthropicApiKey: 'sk-...',
+     *   model: 'claude-sonnet-4-5',
+     * });
+     * ```
+     */
+    static init(wasm: WasmModule, config: RuntimeConfig): Promise<MeerkatRuntime>;
+    /**
+     * Initialize from a mobpack archive.
+     *
+     * @param wasm - The WASM module.
+     * @param mobpackBytes - The tar.gz mobpack archive bytes.
+     * @param config - Credentials and optional overrides.
+     */
+    static initFromMobpack(wasm: WasmModule, mobpackBytes: Uint8Array, config: RuntimeConfig): Promise<MeerkatRuntime>;
+    /**
+     * Register a tool callback on the WASM module.
+     *
+     * **Must be called before {@link init} or {@link initFromMobpack}** because
+     * the tool dispatcher is built during initialization.
+     *
+     * @param wasm - The WASM module (same one passed to init).
+     * @param name - Tool name.
+     * @param description - Human-readable tool description.
+     * @param schema - JSON Schema for tool input.
+     * @param callback - Receives tool arguments as JSON string, returns result.
+     */
+    static registerTool(wasm: WasmModule, name: string, description: string, schema: JsonSchema, callback: ToolCallback): void;
+    /** Clear all registered tool callbacks on the WASM module. */
+    static clearTools(wasm: WasmModule): void;
+    /** Create a mob from a definition. */
+    createMob(definition: MobDefinition): Promise<Mob>;
+    /** List all active mobs. */
+    listMobs(): Promise<MobStatus[]>;
+    /** Wire two agents across different mobs for cross-mob comms. */
+    wireCrossMob(mobA: string, meerkatA: string, mobB: string, meerkatB: string): Promise<void>;
+    /** Create a direct (non-mob) session. */
+    createSession(config: SessionConfig): Session;
+    /** Inspect a mobpack archive without loading it. */
+    inspectMobpack(mobpackBytes: Uint8Array): unknown;
+    /** Get the WASM runtime version string. */
+    get version(): 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":"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"}

package/dist/runtime.js

@@ -0,0 +1,171 @@
+import { Mob } from './mob.js';
+import { Session } from './session.js';
+/** Expected WASM runtime version — must match the compiled binary. */
+const EXPECTED_VERSION = '0.4.1';
+/**
+ * Convert a camelCase config object to the snake_case expected by WASM.
+ *
+ * Only converts known top-level keys to avoid mangling nested data.
+ */
+function toWasmConfig(config) {
+    return {
+        api_key: config.apiKey,
+        anthropic_api_key: config.anthropicApiKey,
+        openai_api_key: config.openaiApiKey,
+        gemini_api_key: config.geminiApiKey,
+        model: config.model,
+        max_sessions: config.maxSessions,
+        base_url: config.baseUrl,
+        anthropic_base_url: config.anthropicBaseUrl,
+        openai_base_url: config.openaiBaseUrl,
+        gemini_base_url: config.geminiBaseUrl,
+    };
+}
+function sessionToWasm(config) {
+    return {
+        model: config.model,
+        api_key: config.apiKey,
+        system_prompt: config.systemPrompt,
+        max_tokens: config.maxTokens,
+        base_url: config.baseUrl,
+        anthropic_base_url: config.anthropicBaseUrl,
+        openai_base_url: config.openaiBaseUrl,
+        gemini_base_url: config.geminiBaseUrl,
+        comms_name: config.commsName,
+        host_mode: config.hostMode,
+        labels: config.labels,
+        additional_instructions: config.additionalInstructions,
+        app_context: config.appContext,
+    };
+}
+/** Entry point for the Meerkat WASM runtime in the browser. */
+export class MeerkatRuntime {
+    wasm;
+    constructor(wasm) {
+        this.wasm = wasm;
+    }
+    /**
+     * Initialize the WASM runtime with the given configuration.
+     *
+     * @param wasm - The WASM module (import from the wasm-pack output).
+     * @param config - Runtime configuration including API keys and provider URLs.
+     * @returns An initialized {@link MeerkatRuntime} instance.
+     *
+     * @example
+     * ```typescript
+     * import * as wasm from '@rkat/web/wasm/meerkat_web_runtime.js';
+     *
+     * const runtime = await MeerkatRuntime.init(wasm, {
+     *   anthropicApiKey: 'sk-...',
+     *   model: 'claude-sonnet-4-5',
+     * });
+     * ```
+     */
+    static async init(wasm, config) {
+        // Initialize the WASM module (loads the .wasm binary)
+        await wasm.default();
+        // Version check: ensure JS wrapper and WASM binary are from the same build
+        const wasmVersion = wasm.runtime_version();
+        if (wasmVersion !== EXPECTED_VERSION) {
+            throw new Error(`WASM runtime version mismatch: expected ${EXPECTED_VERSION}, got ${wasmVersion}. ` +
+                'Clear browser cache or rebuild the WASM runtime.');
+        }
+        const configJson = JSON.stringify(toWasmConfig(config));
+        const resultJson = wasm.init_runtime_from_config(configJson);
+        const result = JSON.parse(resultJson);
+        if (result.status !== 'initialized') {
+            throw new Error(`Runtime initialization failed: ${resultJson}`);
+        }
+        return new MeerkatRuntime(wasm);
+    }
+    /**
+     * Initialize from a mobpack archive.
+     *
+     * @param wasm - The WASM module.
+     * @param mobpackBytes - The tar.gz mobpack archive bytes.
+     * @param config - Credentials and optional overrides.
+     */
+    static async initFromMobpack(wasm, mobpackBytes, config) {
+        await wasm.default();
+        const wasmVersion = wasm.runtime_version();
+        if (wasmVersion !== EXPECTED_VERSION) {
+            throw new Error(`WASM runtime version mismatch: expected ${EXPECTED_VERSION}, got ${wasmVersion}. ` +
+                'Clear browser cache or rebuild the WASM runtime.');
+        }
+        const credentialsJson = JSON.stringify(toWasmConfig(config));
+        const resultJson = wasm.init_runtime(mobpackBytes, credentialsJson);
+        const result = JSON.parse(resultJson);
+        if (result.status !== 'initialized') {
+            throw new Error(`Runtime initialization failed: ${resultJson}`);
+        }
+        return new MeerkatRuntime(wasm);
+    }
+    /**
+     * Register a tool callback on the WASM module.
+     *
+     * **Must be called before {@link init} or {@link initFromMobpack}** because
+     * the tool dispatcher is built during initialization.
+     *
+     * @param wasm - The WASM module (same one passed to init).
+     * @param name - Tool name.
+     * @param description - Human-readable tool description.
+     * @param schema - JSON Schema for tool input.
+     * @param callback - Receives tool arguments as JSON string, returns result.
+     */
+    static registerTool(wasm, name, description, schema, callback) {
+        wasm.register_tool_callback(name, description, JSON.stringify(schema), async (args) => JSON.stringify(await callback(args)));
+    }
+    /** Clear all registered tool callbacks on the WASM module. */
+    static clearTools(wasm) {
+        wasm.clear_tool_callbacks();
+    }
+    /** Create a mob from a definition. */
+    async createMob(definition) {
+        const json = await this.wasm.mob_create(JSON.stringify(definition));
+        const mobId = JSON.parse(json);
+        return new Mob(mobId, {
+            mob_spawn: this.wasm.mob_spawn,
+            mob_retire: this.wasm.mob_retire,
+            mob_wire: this.wasm.mob_wire,
+            mob_unwire: this.wasm.mob_unwire,
+            mob_list_members: this.wasm.mob_list_members,
+            mob_send_message: this.wasm.mob_send_message,
+            mob_respawn: this.wasm.mob_respawn,
+            mob_status: this.wasm.mob_status,
+            mob_lifecycle: this.wasm.mob_lifecycle,
+            mob_events: this.wasm.mob_events,
+            mob_run_flow: this.wasm.mob_run_flow,
+            mob_flow_status: this.wasm.mob_flow_status,
+            mob_cancel_flow: this.wasm.mob_cancel_flow,
+            mob_member_subscribe: this.wasm.mob_member_subscribe,
+            mob_subscribe_events: this.wasm.mob_subscribe_events,
+            mob_inject_and_subscribe: this.wasm.mob_inject_and_subscribe,
+            poll_subscription: this.wasm.poll_subscription,
+            close_subscription: this.wasm.close_subscription,
+        });
+    }
+    /** List all active mobs. */
+    async listMobs() {
+        const json = await this.wasm.mob_list();
+        return JSON.parse(json);
+    }
+    /** Wire two agents across different mobs for cross-mob comms. */
+    async wireCrossMob(mobA, meerkatA, mobB, meerkatB) {
+        await this.wasm.wire_cross_mob(mobA, meerkatA, mobB, meerkatB);
+    }
+    /** Create a direct (non-mob) session. */
+    createSession(config) {
+        const handle = this.wasm.create_session_simple(JSON.stringify(sessionToWasm(config)));
+        return new Session(handle, this.wasm.start_turn, this.wasm.get_session_state, this.wasm.destroy_session, this.wasm.poll_events);
+    }
+    /** Inspect a mobpack archive without loading it. */
+    inspectMobpack(mobpackBytes) {
+        const json = this.wasm.inspect_mobpack(mobpackBytes);
+        return JSON.parse(json);
+    }
+    /** Get the WASM runtime version string. */
+    get version() {
+        return this.wasm.runtime_version();
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,29 @@
+import type { TurnOptions, TurnResult, EventEnvelope } from './types.js';
+type StartTurnFn = (handle: number, prompt: string, options_json: string) => Promise<string>;
+type GetSessionStateFn = (handle: number) => string;
+type DestroySessionFn = (handle: number) => void;
+type PollEventsFn = (handle: number) => string;
+/** A direct (non-mob) agent session. */
+export declare class Session {
+    /** @internal — WASM session handle. */
+    readonly handle: number;
+    private startTurnFn;
+    private getStateFn;
+    private destroyFn;
+    private pollFn;
+    private destroyed;
+    /** @internal — use MeerkatRuntime.createSession() instead. */
+    constructor(handle: number, startTurnFn: StartTurnFn, getStateFn: GetSessionStateFn, destroyFn: DestroySessionFn, pollFn: PollEventsFn);
+    /** Run a turn through the agent loop. */
+    turn(prompt: string, options?: TurnOptions): Promise<TurnResult>;
+    /** Get the current session state. */
+    getState(): unknown;
+    /** Poll buffered agent events from the last turn. */
+    pollEvents(): EventEnvelope[];
+    /** Destroy the session and release resources. */
+    destroy(): void;
+    /** Whether this session has been destroyed. */
+    get isDestroyed(): boolean;
+}
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGzE,KAAK,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7F,KAAK,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AACpD,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AACjD,KAAK,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAE/C,wCAAwC;AACxC,qBAAa,OAAO;IAClB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,SAAS,CAAS;IAE1B,8DAA8D;gBAE5D,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,YAAY;IAStB,yCAAyC;IACnC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAWtE,qCAAqC;IACrC,QAAQ,IAAI,OAAO;IAKnB,qDAAqD;IACrD,UAAU,IAAI,aAAa,EAAE;IAO7B,iDAAiD;IACjD,OAAO,IAAI,IAAI;IAMf,+CAA+C;IAC/C,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF"}