@rkat/sdk 0.5.2 → 0.6.0

package/dist/realtime.js

@@ -0,0 +1,166 @@
+import { MeerkatError } from "./generated/errors.js";
+import { AsyncQueue } from "./streaming.js";
+import WebSocket from "ws";
+export class RealtimeConnection {
+    socket;
+    frames = new AsyncQueue();
+    constructor(socket) {
+        this.socket = socket;
+        this.socket.on("message", (data) => {
+            const payload = typeof data === "string"
+                ? data
+                : (Buffer.isBuffer(data) ? data.toString("utf8") : String(data));
+            this.frames.put(JSON.parse(payload));
+        });
+        this.socket.on("close", () => {
+            this.frames.put(null);
+        });
+    }
+    static async open(openInfo, options) {
+        const role = options?.role ?? "primary";
+        const turningMode = options?.turningMode ?? "provider_managed";
+        const socket = await new Promise((resolve, reject) => {
+            const ws = new WebSocket(openInfo.ws_url);
+            ws.once("open", () => resolve(ws));
+            ws.once("error", (error) => reject(error));
+        });
+        const connection = new RealtimeConnection(socket);
+        await connection.sendFrame({
+            type: "channel.open",
+            protocol_version: openInfo.default_protocol_version,
+            open_token: openInfo.open_token,
+            role,
+            turning_mode: turningMode,
+        });
+        const opened = await connection.nextFrame();
+        if (opened === null) {
+            throw new MeerkatError("REALTIME_OPEN_FAILED", "realtime websocket closed before channel.open completed");
+        }
+        const openedRecord = opened;
+        if (openedRecord.type === "channel.error") {
+            throw new MeerkatError("REALTIME_OPEN_FAILED", String(openedRecord.message ?? "realtime websocket rejected channel.open"));
+        }
+        if (openedRecord.type !== "channel.opened") {
+            throw new MeerkatError("INVALID_RESPONSE", `Expected channel.opened after channel.open, got ${String(openedRecord.type)}`);
+        }
+        return connection;
+    }
+    async sendFrame(frame) {
+        await new Promise((resolve, reject) => {
+            this.socket.send(JSON.stringify(frame), (error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+    async sendInput(chunk) {
+        await this.sendFrame({
+            type: "channel.input",
+            chunk,
+        });
+    }
+    async commitTurn() {
+        await this.sendFrame({ type: "channel.commit_turn" });
+    }
+    async interrupt() {
+        await this.sendFrame({ type: "channel.interrupt" });
+    }
+    async close() {
+        await this.sendFrame({ type: "channel.close" });
+    }
+    async nextFrame() {
+        return this.frames.get();
+    }
+}
+export class RealtimeChannel {
+    client;
+    // The wire target that crosses the RPC boundary. Carries identity
+    // directly for `mob_member` channels (W3-H); the server resolves the
+    // current bridge session on every tick from the MobMachine's
+    // canonical member-session map, so the SDK never pins a session id.
+    target;
+    role;
+    turningMode;
+    reconnectPolicy;
+    constructor(client, target, options) {
+        this.client = client;
+        this.target = target;
+        this.role = options?.role ?? "primary";
+        this.turningMode = options?.turningMode ?? "provider_managed";
+        this.reconnectPolicy = options?.reconnectPolicy;
+    }
+    static session(client, sessionId, options) {
+        return new RealtimeChannel(client, { type: "session_target", session_id: sessionId }, options);
+    }
+    static mobMember(client, mobId, agentIdentity, options) {
+        // W3-H: identity is a first-class wire fact. The channel target is
+        // `mob_member { mob_id, agent_identity }`; the server resolves the
+        // current bridge session from the MobMachine's canonical member-session
+        // map on every tick, so respawn rotates the bridge session without
+        // any SDK round-trip or session-id pin.
+        return new RealtimeChannel(client, { type: "mob_member", mob_id: mobId, agent_identity: agentIdentity }, options);
+    }
+    wireReconnectPolicy() {
+        if (!this.reconnectPolicy) {
+            return undefined;
+        }
+        return { ...this.reconnectPolicy };
+    }
+    openRequest() {
+        return {
+            target: { ...this.target },
+            role: this.role,
+            turning_mode: this.turningMode,
+            reconnect_policy: this.wireReconnectPolicy(),
+        };
+    }
+    async openInfo() {
+        return this.client.realtimeOpenInfo(this.openRequest());
+    }
+    async status() {
+        return this.client.realtimeStatus({ target: { ...this.target } });
+    }
+    async capabilities() {
+        return this.client.realtimeCapabilities({ target: { ...this.target } });
+    }
+    async connectWithOpenInfo(openInfo) {
+        if (JSON.stringify(openInfo.target) !== JSON.stringify(this.target)) {
+            throw new MeerkatError("INVALID_RESPONSE", "realtime/open_info returned a target that does not match the requested channel target");
+        }
+        return RealtimeConnection.open(openInfo, {
+            role: this.role,
+            turningMode: this.turningMode,
+        });
+    }
+    async connect(options) {
+        const conn = await this.connectWithOpenInfo(await this.openInfo());
+        const wait = options?.waitForAttachment ?? true;
+        if (wait) {
+            const timeoutMs = options?.attachmentTimeoutMs ?? 30_000;
+            const deadline = Date.now() + timeoutMs;
+            let attached = false;
+            while (Date.now() < deadline) {
+                try {
+                    const st = await this.status();
+                    if (st.status.state === "ready") {
+                        attached = true;
+                        break;
+                    }
+                }
+                catch {
+                    // status may fail transiently during attachment
+                }
+                await new Promise((r) => setTimeout(r, 250));
+            }
+            if (!attached) {
+                conn.close();
+                throw new MeerkatError("REALTIME_ATTACHMENT_TIMEOUT", `realtime transport did not reach ready state within ${timeoutMs}ms`);
+            }
+        }
+        return conn;
+    }
+}
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

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

package/dist/session.d.ts

@@ -18,7 +18,7 @@
  * }
  * ```
  */
-import type { AgentEventEnvelope, CommsSendReceipt, ContentBlock, RunResult, SessionHistory, SessionIngressOptions, SkillRef, TurnOptions } from "./types.js";
+import type { AgentEventEnvelope, CommsCommand, CommsSendReceipt, ContentBlock, PeerCorrelationId, PeerId, PeerResponseTerminalOptions, RunResult, SessionHistory, SessionIngressOptions, SkillRef, TurnOptions } from "./types.js";
 import type { MeerkatClient } from "./client.js";
 import type { EventStream } from "./streaming.js";
 import type { EventSubscription } from "./subscription.js";
@@ -49,16 +49,19 @@ export declare class Session {
     injectContext(text: string, options?: SessionIngressOptions): Promise<{
         status: string;
     }>;
+    sendExternalEvent(eventType: string, payload: unknown, options?: {
+        blocks?: ContentBlock[];
+    }): Promise<Record<string, unknown>>;
+    sendPeerResponseTerminal(peerId: PeerId, requestId: PeerCorrelationId, status: "completed" | "failed" | "cancelled", result: unknown, options?: PeerResponseTerminalOptions): Promise<Record<string, unknown>>;
     subscribeEvents(): Promise<EventSubscription<AgentEventEnvelope>>;
     invokeSkill(skillRef: SkillRef, prompt: string | ContentBlock[]): Promise<RunResult>;
-    send(command: Record<string, unknown>): Promise<CommsSendReceipt>;
+    send(command: CommsCommand): Promise<CommsSendReceipt>;
     peers(): Promise<Array<Record<string, unknown>>>;
     toString(): string;
 }
 /** Turn-time override options for deferred sessions. */
 export interface DeferredTurnOptions {
     skillRefs?: SkillRef[];
-    skillReferences?: string[];
     flowToolOverlay?: TurnOptions["flowToolOverlay"];
     additionalInstructions?: TurnOptions["additionalInstructions"];
     keepAlive?: TurnOptions["keepAlive"];
@@ -101,6 +104,10 @@ export declare class DeferredSession {
     injectContext(text: string, options?: SessionIngressOptions): Promise<{
         status: string;
     }>;
+    sendExternalEvent(eventType: string, payload: unknown, options?: {
+        blocks?: ContentBlock[];
+    }): Promise<Record<string, unknown>>;
+    sendPeerResponseTerminal(peerId: PeerId, requestId: PeerCorrelationId, status: "completed" | "failed" | "cancelled", result: unknown, options?: PeerResponseTerminalOptions): Promise<Record<string, unknown>>;
     toString(): string;
 }
 //# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -75,16 +75,27 @@ export class Session {
     async injectContext(text, options) {
         return this._client.injectContext(this._id, text, options);
     }
+    async sendExternalEvent(eventType, payload, options) {
+        return this._client.sendExternalEvent(this._id, eventType, payload, options);
+    }
+    async sendPeerResponseTerminal(peerId, requestId, status, result, options) {
+        return this._client.sendPeerResponseTerminal(this._id, peerId, requestId, status, result, options);
+    }
     async subscribeEvents() {
         return this._client.subscribeSessionEvents(this._id);
     }
     async invokeSkill(skillRef, prompt) {
         this._client.requireCapability("skills");
+        if (skillRef === null ||
+            typeof skillRef !== "object" ||
+            typeof skillRef.sourceUuid !== "string" ||
+            typeof skillRef.skillName !== "string") {
+            throw new Error("Skill references must be SkillKey objects");
+        }
         return this.turn(prompt, { skillRefs: [skillRef] });
     }
     async send(command) {
-        const { session_id: _ignored, ...rest } = command;
-        return this._client._send(this._id, rest);
+        return this._client._send(this._id, command);
     }
     async peers() {
         const result = await this._client._peers(this._id);
@@ -141,6 +152,12 @@ export class DeferredSession {
     async injectContext(text, options) {
         return this._client.injectContext(this._id, text, options);
     }
+    async sendExternalEvent(eventType, payload, options) {
+        return this._client.sendExternalEvent(this._id, eventType, payload, options);
+    }
+    async sendPeerResponseTerminal(peerId, requestId, status, result, options) {
+        return this._client.sendPeerResponseTerminal(this._id, peerId, requestId, status, result, options);
+    }
     toString() {
         const ref = this._ref ? ` ref=${this._ref}` : "";
         return `DeferredSession(id=${this._id}${ref})`;

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -3,8 +3,23 @@
  *
  * These replace the `Wire*` prefixed generated types.
  */
-import type { Usage } from "./events.js";
-export type { Usage } from "./events.js";
+import type { MobBackendConfigInput, MobEventRouterConfigInput, MobFlowSpecInput, MobLimitsSpecInput, MobOrchestratorInput, MobSkillSourceInput, MobSpawnPolicyInput, MobSupervisorSpecInput, MobToolConfigInput, MobTopologySpecInput, MobTurnStartParams, MobWiringRulesInput, WireBudgetSplitPolicy, WireAuthBindingRef, WireContentInput, WireMemberLaunchMode, WireMobBackendKind, WireMobProfile, WireMobRuntimeMode, WireRuntimeBinding, WireToolAccessPolicy, WireToolFilter } from "./generated/types.js";
+import type { TurnTerminalCauseKind, Usage } from "./events.js";
+export type { TurnTerminalCauseKind, Usage } from "./events.js";
+declare const peerIdBrand: unique symbol;
+declare const peerCorrelationIdBrand: unique symbol;
+/** Canonical comms routing identity for a peer. */
+export type PeerId = string & {
+    readonly [peerIdBrand]: "PeerId";
+};
+/** Canonical request/response correlation identity for peer interactions. */
+export type PeerCorrelationId = string & {
+    readonly [peerCorrelationIdBrand]: "PeerCorrelationId";
+};
+/** Presentation-only metadata for terminal peer responses. */
+export interface PeerResponseTerminalOptions {
+    readonly displayName?: string;
+}
 /** Warning emitted when structured output doesn't match a provider's schema. */
 export interface SchemaWarning {
     readonly provider: string;
@@ -41,8 +56,8 @@ export interface SkillKey {
     readonly sourceUuid: string;
     readonly skillName: string;
 }
-/** A skill reference — either a {@link SkillKey} or a legacy string. */
-export type SkillRef = SkillKey | string;
+/** A structured skill reference. */
+export type SkillRef = SkillKey;
 /** Inline image content accepted by input-bearing APIs. */
 export interface InlineImageBlock {
     readonly type: "image";
@@ -91,10 +106,28 @@ export interface RunResult {
     readonly turns: number;
     readonly toolCalls: number;
     readonly usage: Usage;
+    readonly terminalCauseKind?: TurnTerminalCauseKind;
     readonly structuredOutput?: unknown;
+    readonly extractionError?: ExtractionError;
     readonly schemaWarnings?: readonly SchemaWarning[];
     readonly skillDiagnostics?: SkillRuntimeDiagnostics;
 }
+export interface ExtractionError {
+    readonly lastOutput: string;
+    readonly attempts: number;
+    readonly reason: string;
+}
+export type HelpExecutionMode = "explain_only" | "plan_execution";
+export interface HelpOptions {
+    readonly prompt?: string;
+    readonly executionMode?: HelpExecutionMode;
+    readonly model?: string;
+    readonly provider?: string;
+    readonly maxTokens?: number;
+}
+export interface HelpRequest extends HelpOptions {
+    readonly question: string;
+}
 /** Session metadata shape used by `listSessions()` and `readSession()`. */
 export interface SessionInfo {
     readonly sessionId: string;
@@ -125,10 +158,17 @@ export interface SessionAssistantBlock {
     readonly id?: string;
     readonly name?: string;
     readonly args?: unknown;
+    readonly imageId?: string;
+    readonly blobId?: string;
+    readonly mediaType?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly revisedPrompt?: Record<string, unknown>;
     readonly meta?: Record<string, unknown>;
 }
 export interface SessionMessage {
     readonly role: string;
+    readonly createdAt: string;
     readonly content?: ContentInput;
     readonly toolCalls: readonly SessionToolCall[];
     readonly stopReason?: string;
@@ -158,7 +198,6 @@ export interface SessionIngressOptions {
 /** Per-turn options for normal turns and deferred first turns. */
 export interface TurnOptions {
     readonly skillRefs?: SkillRef[];
-    readonly skillReferences?: string[];
     readonly flowToolOverlay?: TurnToolOverlay;
     readonly additionalInstructions?: string[];
     readonly keepAlive?: boolean;
@@ -170,8 +209,24 @@ export interface TurnOptions {
     readonly structuredOutputRetries?: number;
     readonly providerParams?: Record<string, unknown>;
 }
+export type EventSourceIdentity = {
+    readonly type: "session";
+    readonly sessionId: string;
+} | {
+    readonly type: "runtime";
+    readonly runtimeId: string;
+} | {
+    readonly type: "interaction";
+    readonly interactionId: string;
+} | {
+    readonly type: "callback";
+} | {
+    readonly type: "external";
+    readonly sourceId: string;
+};
 export interface EventEnvelope<T = unknown> {
     readonly timestamp_ms: number;
+    readonly source: EventSourceIdentity;
     readonly source_id: string;
     readonly seq: number;
     readonly event_id: string;
@@ -179,67 +234,71 @@ export interface EventEnvelope<T = unknown> {
 }
 export interface AttributedEvent {
     readonly source: string;
-    readonly profile: string;
+    readonly sourceFenceToken?: number;
+    readonly role: string;
     readonly envelope: EventEnvelope;
 }
 /** Public mob definition input for host-side `mob/create`. */
-export interface MobToolConfig {
-    readonly builtins?: boolean;
-    readonly shell?: boolean;
-    readonly comms?: boolean;
-    readonly memory?: boolean;
-    readonly mob?: boolean;
-    readonly mob_tasks?: boolean;
-    readonly schedule?: boolean;
-    readonly mcp?: readonly string[];
-}
+export type MobToolConfig = MobToolConfigInput;
 export interface MobProfile {
     readonly model: string;
     readonly skills?: readonly string[];
     readonly tools?: MobToolConfig;
     readonly peer_description?: string;
     readonly external_addressable?: boolean;
-    readonly backend?: "session" | "external";
-    readonly runtime_mode?: "autonomous_host" | "turn_driven";
+    readonly backend?: WireMobBackendKind;
+    readonly runtime_mode?: WireMobRuntimeMode;
     readonly max_inline_peer_notifications?: number;
-    readonly output_schema?: Record<string, unknown>;
-    readonly provider_params?: Record<string, unknown>;
+    readonly output_schema?: unknown;
+    readonly provider_params?: unknown;
 }
 export type MobProfileBinding = MobProfile | {
     readonly realm_profile: string;
 };
 export interface MobDefinition {
     readonly id: string;
-    readonly orchestrator?: {
-        readonly profile: string;
-    };
+    readonly orchestrator?: MobOrchestratorInput;
     readonly profiles: Readonly<Record<string, MobProfileBinding>>;
-    readonly mcp_servers?: Readonly<Record<string, Record<string, unknown>>>;
-    readonly wiring?: Record<string, unknown>;
-    readonly flows?: Record<string, unknown>;
-    readonly skills?: Record<string, unknown>;
-    readonly backend?: Record<string, unknown>;
-    readonly topology?: Record<string, unknown>;
-    readonly supervisor?: Record<string, unknown>;
-    readonly limits?: Record<string, unknown>;
-    readonly spawn_policy?: Record<string, unknown>;
-    readonly event_router?: Record<string, unknown>;
-}
-export interface SpawnSpec {
+    readonly wiring?: MobWiringRulesInput;
+    readonly flows?: Readonly<Record<string, MobFlowSpecInput>>;
+    readonly skills?: Readonly<Record<string, MobSkillSourceInput>>;
+    readonly backend?: MobBackendConfigInput;
+    readonly topology?: MobTopologySpecInput;
+    readonly supervisor?: MobSupervisorSpecInput;
+    readonly limits?: MobLimitsSpecInput;
+    readonly spawn_policy?: MobSpawnPolicyInput;
+    readonly event_router?: MobEventRouterConfigInput;
+}
+export interface SpawnManySpec {
     readonly profile: string;
-    readonly meerkatId: string;
-    readonly initialMessage?: string | ContentBlock[];
-    readonly runtimeMode?: "turn_driven" | "autonomous_host";
-    readonly backend?: "session" | "external";
+    readonly agentIdentity: string;
+    readonly initialMessage?: WireContentInput;
+    readonly runtimeMode?: WireMobRuntimeMode;
+    readonly backend?: WireMobBackendKind;
     readonly labels?: Record<string, string>;
-    readonly context?: Record<string, unknown>;
-    readonly resumeSessionId?: string;
+    readonly context?: unknown;
     readonly additionalInstructions?: string[];
+    readonly authBinding?: WireAuthBindingRef;
+}
+export interface SpawnSpec extends SpawnManySpec {
+    readonly binding?: WireRuntimeBinding;
+    readonly shellEnv?: Readonly<Record<string, string>>;
+    readonly autoWireParent?: boolean;
+    readonly launchMode?: WireMemberLaunchMode;
+    readonly toolAccessPolicy?: WireToolAccessPolicy;
+    readonly budgetSplitPolicy?: WireBudgetSplitPolicy;
+    readonly inheritedToolFilter?: WireToolFilter;
+    readonly overrideProfile?: WireMobProfile;
+}
+export interface MobSpawnResult {
+    readonly mobId: string;
+    readonly agentIdentity: string;
+    readonly memberRef: MobMemberRef;
 }
 export interface MobMember {
-    readonly meerkatId: string;
+    readonly agentIdentity: string;
+    readonly memberRef: MobMemberRef;
     readonly profile: string;
-    readonly memberRef?: Record<string, unknown>;
     readonly peerId?: string;
     readonly externalPeerSpecs?: Readonly<Record<string, Record<string, unknown>>>;
     readonly runtimeMode?: string;
@@ -249,8 +308,6 @@ export interface MobMember {
     readonly status?: string;
     readonly error?: string;
     readonly isFinal?: boolean;
-    readonly currentSessionId?: string;
-    readonly sessionId?: string;
 }
 export interface MobSummary {
     readonly mobId: string;
@@ -261,14 +318,33 @@ export interface MobStatus {
     readonly status: string;
 }
 export type MobLifecycleAction = "stop" | "resume" | "complete" | "destroy" | "reset";
+/**
+ * Server-resolved opaque handle for a mob member. Treat as an opaque token:
+ * app code never constructs or inspects these — they come back from
+ * `mob/ensure_member`, `mob/spawn_helper`, `mob/fork_helper`, and member
+ * list surfaces, and are passed back on work-lane and member-targeted
+ * calls.
+ */
+export type MobMemberRef = string;
 export interface MobFlowStatus {
     readonly run?: Record<string, unknown> | null;
 }
-export interface MobSpawnManyResultEntry {
-    readonly ok: boolean;
-    readonly memberRef?: Record<string, unknown>;
-    readonly sessionId?: string;
-    readonly error?: string;
+type MobTurnStartWireOptions = Omit<MobTurnStartParams, "mob_id" | "agent_identity" | "prompt">;
+export interface MobTurnStartOptions {
+    readonly skillRefs?: SkillRef[];
+    readonly flowToolOverlay?: TurnToolOverlay;
+    readonly additionalInstructions?: MobTurnStartWireOptions["additional_instructions"];
+    readonly keepAlive?: MobTurnStartWireOptions["keep_alive"];
+    readonly model?: MobTurnStartWireOptions["model"];
+    readonly provider?: MobTurnStartWireOptions["provider"];
+    readonly maxTokens?: MobTurnStartWireOptions["max_tokens"];
+    readonly systemPrompt?: MobTurnStartWireOptions["system_prompt"];
+    readonly outputSchema?: MobTurnStartWireOptions["output_schema"];
+    readonly structuredOutputRetries?: MobTurnStartWireOptions["structured_output_retries"];
+    readonly providerParams?: MobTurnStartWireOptions["provider_params"];
+    readonly clearProviderParams?: MobTurnStartWireOptions["clear_provider_params"];
+    readonly authBinding?: MobTurnStartWireOptions["auth_binding"];
+    readonly clearAuthBinding?: MobTurnStartWireOptions["clear_auth_binding"];
 }
 export interface MobEventsOptions {
     readonly afterCursor?: number;
@@ -315,6 +391,48 @@ export interface CommsSendReceipt extends Record<string, unknown> {
     readonly interactionId?: string;
     readonly inputId?: string;
 }
+export type CommsHandlingMode = "queue" | "steer";
+export type CommsInputSource = "tcp" | "uds" | "stdin" | "webhook" | "rpc";
+export type CommsInputStreamMode = "none" | "reserve_interaction";
+export type CommsResponseStatus = "accepted" | "completed" | "failed";
+export interface CommsInputCommand {
+    kind: "input";
+    body: string;
+    source?: CommsInputSource;
+    stream?: CommsInputStreamMode;
+    handling_mode?: CommsHandlingMode;
+    allow_self_session?: boolean;
+}
+export interface CommsPeerMessageCommand {
+    kind: "peer_message";
+    to: string;
+    body: string;
+    handling_mode?: CommsHandlingMode;
+}
+export interface CommsPeerLifecycleCommand {
+    kind: "peer_lifecycle";
+    to: string;
+    lifecycle_kind: "mob.peer_added" | "mob.peer_retired" | "mob.peer_unwired";
+    params?: unknown;
+}
+export interface CommsPeerRequestCommand {
+    kind: "peer_request";
+    to: string;
+    intent: string;
+    params?: Record<string, unknown>;
+    handling_mode?: CommsHandlingMode;
+    stream?: CommsInputStreamMode;
+}
+export interface CommsPeerResponseCommand {
+    kind: "peer_response";
+    to: string;
+    in_reply_to: string;
+    status: CommsResponseStatus;
+    result?: unknown;
+    handling_mode?: CommsHandlingMode;
+}
+/** Typed comms/send command — serde-tagged on `kind`. */
+export type CommsCommand = CommsInputCommand | CommsPeerMessageCommand | CommsPeerLifecycleCommand | CommsPeerRequestCommand | CommsPeerResponseCommand;
 export type ModelTier = "recommended" | "supported";
 export interface ModelProfile {
     readonly modelFamily: string;
@@ -457,9 +575,8 @@ export interface SessionOptions {
     peerMeta?: Record<string, unknown>;
     budgetLimits?: Record<string, unknown>;
     providerParams?: Record<string, unknown>;
-    preloadSkills?: string[];
+    preloadSkills?: SkillRef[];
     skillRefs?: SkillRef[];
-    skillReferences?: string[];
     labels?: Readonly<Record<string, string>>;
     additionalInstructions?: readonly string[];
     appContext?: unknown;
@@ -468,11 +585,12 @@ export interface SessionOptions {
 }
 /** Explicit standalone session-event envelope. */
 export interface AgentEventEnvelope {
-    readonly eventId: string;
-    readonly sourceId: string;
-    readonly seq: number;
-    readonly timestampMs: number;
-    readonly payload: import("./events.js").AgentEvent;
+    readonly eventId?: string;
+    readonly source?: EventSourceIdentity;
+    readonly sourceId?: string;
+    readonly seq?: number;
+    readonly timestampMs?: number;
+    readonly payload?: import("./events.js").AgentEvent;
 }
 /** Mob-wide attributed event emitted by member/mob observation streams. */
 export interface AttributedMobEvent {