@rkat/web 0.4.1

package/dist/session.js

@@ -0,0 +1,56 @@
+/** A direct (non-mob) agent session. */
+export class Session {
+    /** @internal — WASM session handle. */
+    handle;
+    startTurnFn;
+    getStateFn;
+    destroyFn;
+    pollFn;
+    destroyed = false;
+    /** @internal — use MeerkatRuntime.createSession() instead. */
+    constructor(handle, startTurnFn, getStateFn, destroyFn, pollFn) {
+        this.handle = handle;
+        this.startTurnFn = startTurnFn;
+        this.getStateFn = getStateFn;
+        this.destroyFn = destroyFn;
+        this.pollFn = pollFn;
+    }
+    /** Run a turn through the agent loop. */
+    async turn(prompt, options) {
+        if (this.destroyed)
+            throw new Error('Session has been destroyed');
+        const opts = options
+            ? JSON.stringify({
+                additional_instructions: options.additionalInstructions,
+            })
+            : '{}';
+        const json = await this.startTurnFn(this.handle, prompt, opts);
+        return JSON.parse(json);
+    }
+    /** Get the current session state. */
+    getState() {
+        if (this.destroyed)
+            throw new Error('Session has been destroyed');
+        return JSON.parse(this.getStateFn(this.handle));
+    }
+    /** Poll buffered agent events from the last turn. */
+    pollEvents() {
+        if (this.destroyed)
+            return [];
+        const json = this.pollFn(this.handle);
+        const parsed = JSON.parse(json);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    /** Destroy the session and release resources. */
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.destroyFn(this.handle);
+    }
+    /** Whether this session has been destroyed. */
+    get isDestroyed() {
+        return this.destroyed;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAQA,wCAAwC;AACxC,MAAM,OAAO,OAAO;IAClB,uCAAuC;IAC9B,MAAM,CAAS;IAEhB,WAAW,CAAc;IACzB,UAAU,CAAoB;IAC9B,SAAS,CAAmB;IAC5B,MAAM,CAAe;IACrB,SAAS,GAAG,KAAK,CAAC;IAE1B,8DAA8D;IAC9D,YACE,MAAc,EACd,WAAwB,EACxB,UAA6B,EAC7B,SAA2B,EAC3B,MAAoB;QAEpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,OAAqB;QAC9C,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;gBACb,uBAAuB,EAAE,OAAO,CAAC,sBAAsB;aACxD,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;IACxC,CAAC;IAED,qCAAqC;IACrC,QAAQ;QACN,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,qDAAqD;IACrD,UAAU;QACR,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC9B,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,iDAAiD;IACjD,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,+CAA+C;IAC/C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,278 @@
+/** Configuration for {@link MeerkatRuntime.init}. */
+export interface RuntimeConfig {
+    /** Backward-compat single API key (treated as Anthropic fallback). */
+    apiKey?: string;
+    /** Anthropic API key. */
+    anthropicApiKey?: string;
+    /** OpenAI API key. */
+    openaiApiKey?: string;
+    /** Gemini API key. */
+    geminiApiKey?: string;
+    /** Default model for new sessions. */
+    model?: string;
+    /** Maximum concurrent sessions. Default: 64. */
+    maxSessions?: number;
+    /** Backward-compat single base URL (mapped to default model's provider). */
+    baseUrl?: string;
+    /** Anthropic base URL (e.g. for proxy deployments). */
+    anthropicBaseUrl?: string;
+    /** OpenAI base URL. */
+    openaiBaseUrl?: string;
+    /** Gemini base URL. */
+    geminiBaseUrl?: string;
+}
+/** Result from runtime initialization. */
+export interface InitResult {
+    status: 'initialized';
+    model: string;
+    providers: string[];
+    max_sessions?: number;
+}
+/** Configuration for creating a direct (non-mob) session. */
+export interface SessionConfig {
+    /** LLM model identifier. */
+    model: string;
+    /** API key for the model's provider. */
+    apiKey: string;
+    /** System prompt. */
+    systemPrompt?: string;
+    /** Max tokens per response. Default: 4096. */
+    maxTokens?: number;
+    /** Backward-compat single base URL. */
+    baseUrl?: string;
+    /** Anthropic base URL. */
+    anthropicBaseUrl?: string;
+    /** OpenAI base URL. */
+    openaiBaseUrl?: string;
+    /** Gemini base URL. */
+    geminiBaseUrl?: string;
+    /** Enable comms for this session. */
+    commsName?: string;
+    /** Whether this session runs in host mode. */
+    hostMode?: boolean;
+    /** Application-defined labels. */
+    labels?: Record<string, string>;
+    /** Additional instruction sections appended to the system prompt. */
+    additionalInstructions?: string[];
+    /** Opaque application context. */
+    appContext?: unknown;
+}
+/** Options for a single turn. */
+export interface TurnOptions {
+    /** Additional instructions for this turn only. */
+    additionalInstructions?: string[];
+}
+/** Result of a turn execution. */
+export interface TurnResult {
+    response: string;
+    usage: Usage;
+    tool_calls: number;
+}
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+}
+/**
+ * Mob definition passed to {@link MeerkatRuntime.createMob}.
+ *
+ * Matches Rust `MobDefinition` in `meerkat-mob/src/definition.rs`.
+ */
+export interface MobDefinition {
+    id: string;
+    profiles: Record<string, Profile>;
+    /** Wiring rules for automatic peer connections. */
+    wiring?: WiringRules;
+    /** Named flow definitions. */
+    flows?: Record<string, unknown>;
+    /** Named MCP server configurations. */
+    mcp_servers?: Record<string, unknown>;
+    /** Named skill sources. */
+    skills?: Record<string, unknown>;
+    /** Orchestrator configuration. */
+    orchestrator?: unknown;
+    /** Backend selection config. */
+    backend?: unknown;
+}
+/**
+ * Profile template for spawning agents.
+ *
+ * Matches Rust `Profile` in `meerkat-mob/src/profile.rs`.
+ * Note: there is NO `system_prompt` field — prompts are built from skills.
+ */
+export interface Profile {
+    /** LLM model name (e.g. "claude-sonnet-4-5"). */
+    model: string;
+    /** Skill references to load. */
+    skills?: string[];
+    /** Tool configuration. */
+    tools?: ToolConfig;
+    /** Human-readable role description visible to peers. */
+    peer_description?: string;
+    /** Whether this agent can receive turns from external callers. */
+    external_addressable?: boolean;
+    /** Runtime mode: 'turn_driven' or 'autonomous_host'. */
+    runtime_mode?: string;
+    /** Max peer-count threshold for inline peer lifecycle notifications. */
+    max_inline_peer_notifications?: number;
+    /** JSON Schema for structured output extraction. */
+    output_schema?: unknown;
+    /** Provider-specific parameters (e.g. thinking_budget, reasoning_effort). */
+    provider_params?: unknown;
+}
+/** Tool configuration for a profile. Matches Rust `ToolConfig`. */
+export interface ToolConfig {
+    /** Enable built-in tools (file read, etc.). */
+    builtins?: boolean;
+    /** Enable shell execution tool. */
+    shell?: boolean;
+    /** Enable comms tools (peer messaging). */
+    comms?: boolean;
+    /** Enable memory/semantic search tools. */
+    memory?: boolean;
+    /** Enable mob management tools (spawn, retire, wire, unwire, list). */
+    mob?: boolean;
+    /** Enable shared task list tools. */
+    mob_tasks?: boolean;
+    /** MCP server names this profile connects to. */
+    mcp?: string[];
+    /** Named Rust tool bundles (re-registered at mob construction time). */
+    rust_bundles?: string[];
+}
+/** Wiring rules controlling automatic peer connections. */
+export interface WiringRules {
+    /** Automatically wire every spawned agent to the orchestrator. */
+    auto_wire_orchestrator?: boolean;
+    /** Fan-out wiring rules between profile roles. */
+    role_wiring?: RoleWiringRule[];
+}
+/** Wiring rule between two profile roles. */
+export interface RoleWiringRule {
+    /** First profile name. */
+    a: string;
+    /** Second profile name. */
+    b: string;
+}
+/** Spawn specification for a single agent within a mob. */
+export interface SpawnSpec {
+    profile: string;
+    meerkat_id: string;
+    runtime_mode?: 'turn_driven' | 'autonomous_host';
+    initial_message?: string;
+    labels?: Record<string, string>;
+}
+/** Result of a spawn operation. */
+export interface SpawnResult {
+    meerkat_id: string;
+    status: string;
+}
+/** A mob member entry from listMembers. */
+export interface MobMember {
+    meerkat_id: string;
+    profile: string;
+    status: string;
+}
+/** Mob status. */
+export interface MobStatus {
+    mob_id: string;
+    status: string;
+    member_count: number;
+}
+/** Mob lifecycle actions. */
+export type MobLifecycleAction = 'stop' | 'resume' | 'complete' | 'destroy';
+/** Envelope wrapping an agent event with metadata. */
+export interface EventEnvelope {
+    session_id?: string;
+    meerkat_id?: string;
+    cursor?: string;
+    event: AgentEvent | {
+        type: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Known agent event types (discriminated union on `type`).
+ *
+ * Matches Rust `AgentEvent` with `#[serde(tag = "type", rename_all = "snake_case")]`.
+ */
+export type AgentEvent = TextDeltaEvent | TextCompleteEvent | ToolCallRequestedEvent | ToolResultReceivedEvent | TurnStartedEvent | TurnCompletedEvent | RunCompletedEvent | RunFailedEvent | ToolExecutionStartedEvent | ToolExecutionCompletedEvent | ReasoningDeltaEvent | ReasoningCompleteEvent;
+export interface TextDeltaEvent {
+    type: 'text_delta';
+    delta: string;
+}
+export interface TextCompleteEvent {
+    type: 'text_complete';
+    content: string;
+}
+export interface ToolCallRequestedEvent {
+    type: 'tool_call_requested';
+    id: string;
+    name: string;
+    args: unknown;
+}
+export interface ToolResultReceivedEvent {
+    type: 'tool_result_received';
+    id: string;
+    name: string;
+    is_error: boolean;
+}
+export interface TurnStartedEvent {
+    type: 'turn_started';
+    turn_number: number;
+}
+export interface TurnCompletedEvent {
+    type: 'turn_completed';
+    stop_reason: string;
+    usage: Usage;
+}
+export interface RunCompletedEvent {
+    type: 'run_completed';
+    session_id: string;
+    result: string;
+    usage: Usage;
+}
+export interface RunFailedEvent {
+    type: 'run_failed';
+    session_id: string;
+    error: string;
+}
+export interface ToolExecutionStartedEvent {
+    type: 'tool_execution_started';
+    id: string;
+    name: string;
+}
+export interface ToolExecutionCompletedEvent {
+    type: 'tool_execution_completed';
+    id: string;
+    name: string;
+    result: string;
+    is_error: boolean;
+    duration_ms: number;
+}
+export interface ReasoningDeltaEvent {
+    type: 'reasoning_delta';
+    delta: string;
+}
+export interface ReasoningCompleteEvent {
+    type: 'reasoning_complete';
+    content: string;
+}
+/** Type guard for known event types. */
+export declare function isKnownEvent(event: {
+    type: string;
+}): event is AgentEvent;
+/** JSON schema object for tool input. */
+export type JsonSchema = Record<string, unknown>;
+/** Result returned from a tool callback. */
+export interface ToolCallbackResult {
+    content: string;
+    is_error: boolean;
+}
+/** A tool callback function. */
+export type ToolCallback = (args: string) => Promise<ToolCallbackResult>;
+/** Status of a running flow. */
+export interface FlowStatus {
+    run_id: string;
+    status: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,11 @@
+// ─── Bootstrap config ───────────────────────────────────────────
+/** Type guard for known event types. */
+export function isKnownEvent(event) {
+    return [
+        'text_delta', 'text_complete', 'tool_call_requested', 'tool_result_received',
+        'turn_started', 'turn_completed', 'run_completed', 'run_failed',
+        'tool_execution_started', 'tool_execution_completed',
+        'reasoning_delta', 'reasoning_complete',
+    ].includes(event.type);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAqPnE,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,OAAO;QACL,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB;QAC5E,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY;QAC/D,wBAAwB,EAAE,0BAA0B;QACpD,iBAAiB,EAAE,oBAAoB;KACxC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@rkat/web",
+  "version": "0.4.1",
+  "description": "Browser SDK for Meerkat agent runtime (WASM)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "rkat-web-proxy": "./proxy/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./proxy": {
+      "import": "./proxy/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "wasm",
+    "proxy"
+  ],
+  "scripts": {
+    "build:wasm": "RUSTFLAGS='--cfg getrandom_backend=\"wasm_js\"' wasm-pack build ../../meerkat-web-runtime --target web --out-dir ../../sdks/web/wasm",
+    "build:ts": "tsc",
+    "build": "npm run build:wasm && npm run build:ts",
+    "prepublishOnly": "npm run build",
+    "test": "tsc --noEmit -p tests/tsconfig.json"
+  },
+  "license": "MIT OR Apache-2.0",
+  "devDependencies": {
+    "typescript": "^5.5"
+  }
+}

package/proxy/cli.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * Standalone CLI for the @rkat/web provider proxy.
+ *
+ * Usage:
+ *   ANTHROPIC_API_KEY=sk-... npx @rkat/web proxy
+ *   ANTHROPIC_API_KEY=sk-... npx @rkat/web proxy --port 3100
+ *   ANTHROPIC_API_KEY=sk-... npx @rkat/web proxy --port 3100 --cors-origin http://localhost:5173
+ */
+
+import { startProxy } from './index.mjs';
+
+function parseArgs(args) {
+  const opts = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--port' && args[i + 1]) {
+      opts.port = parseInt(args[i + 1], 10);
+      i++;
+    } else if (args[i] === '--cors-origin' && args[i + 1]) {
+      opts.allowOrigin = args[i + 1];
+      i++;
+    } else if (args[i] === '--help' || args[i] === '-h') {
+      console.log(`@rkat/web proxy — auth-injecting reverse proxy for LLM providers
+
+Usage:
+  npx @rkat/web proxy [options]
+
+Options:
+  --port <number>         Port to listen on (default: 3100, or PORT env var)
+  --cors-origin <origin>  CORS allowed origin (default: *)
+  -h, --help              Show this help
+
+Environment variables:
+  ANTHROPIC_API_KEY       Anthropic API key (enables /anthropic/* routes)
+  OPENAI_API_KEY          OpenAI API key (enables /openai/* routes)
+  GEMINI_API_KEY          Gemini API key (enables /gemini/* routes)
+  PORT                    Port to listen on (overridden by --port)
+
+The WASM client uses per-provider base URLs to point at this proxy:
+  anthropicBaseUrl: 'http://localhost:3100/anthropic'
+  openaiBaseUrl:    'http://localhost:3100/openai'
+  geminiBaseUrl:    'http://localhost:3100/gemini'
+`);
+      process.exit(0);
+    }
+  }
+  return opts;
+}
+
+const opts = parseArgs(process.argv.slice(2));
+startProxy(opts);