@rkat/sdk 0.8.23 → 0.8.26

package/dist/client.js

@@ -122,6 +122,88 @@ function setIfDefined(payload, key, value) {
         payload[key] = value;
     }
 }
+function toWireContentBlock(block) {
+    if (block.type === "text")
+        return block;
+    if (block.type === "image") {
+        return block.source === "blob"
+            ? block
+            : { ...block, source: "inline" };
+    }
+    return block.source === "uri"
+        ? block
+        : { ...block, source: "inline" };
+}
+function toWireContentInput(content) {
+    return typeof content === "string"
+        ? content
+        : content.map(toWireContentBlock);
+}
+function toMutableWire(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => toMutableWire(item));
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, toMutableWire(item)]));
+    }
+    return value;
+}
+function toWirePeerRequestParams(params) {
+    const mutable = toMutableWire(params);
+    if (!("command" in params) ||
+        params.command !== "deliver_member_input") {
+        return mutable;
+    }
+    return {
+        ...mutable,
+        content: toWireContentInput(params.content),
+        injected_context: params.injected_context?.map(toWireContentInput),
+    };
+}
+function toWireCommsSendParams(sessionId, command) {
+    switch (command.kind) {
+        case "input":
+        case "peer_message":
+            return {
+                ...command,
+                session_id: sessionId,
+                blocks: command.blocks?.map(toWireContentBlock),
+            };
+        case "peer_request":
+            return {
+                ...command,
+                session_id: sessionId,
+                params: toWirePeerRequestParams(command.params),
+                blocks: command.blocks?.map(toWireContentBlock),
+            };
+        case "peer_lifecycle":
+        case "peer_response":
+            return { ...command, session_id: sessionId };
+    }
+}
+function toWireMobProfile(profile) {
+    const { resume_overrides, skills, ...rest } = profile;
+    const payload = { ...rest };
+    setIfDefined(payload, "resume_overrides", resume_overrides ? [...resume_overrides] : undefined);
+    setIfDefined(payload, "skills", skills ? [...skills] : undefined);
+    return payload;
+}
+function toWireMobDefinition(definition) {
+    const { models, flows, skills, ...rest } = definition;
+    const payload = {
+        ...rest,
+        profiles: Object.fromEntries(Object.entries(definition.profiles).map(([name, binding]) => [
+            name,
+            "realm_profile" in binding
+                ? { realm_profile: binding.realm_profile }
+                : toWireMobProfile(binding),
+        ])),
+    };
+    setIfDefined(payload, "models", models ? { ...models } : undefined);
+    setIfDefined(payload, "flows", flows ? { ...flows } : undefined);
+    setIfDefined(payload, "skills", skills ? { ...skills } : undefined);
+    return payload;
+}
 function mobSpawnPayload(mobId, spec) {
     const payload = {
         mob_id: mobId,
@@ -136,7 +218,7 @@ function mobSpawnPayload(mobId, spec) {
     setIfDefined(payload, "additional_instructions", spec.additionalInstructions);
     setIfDefined(payload, "placement", spec.placement);
     setIfDefined(payload, "binding", spec.binding);
-    setIfDefined(payload, "shell_env", spec.shellEnv);
+    setIfDefined(payload, "shell_env", spec.shellEnv ? { ...spec.shellEnv } : undefined);
     setIfDefined(payload, "auto_wire_parent", spec.autoWireParent);
     setIfDefined(payload, "launch_mode", spec.launchMode);
     setIfDefined(payload, "tool_access_policy", spec.toolAccessPolicy);
@@ -607,7 +689,7 @@ export class MeerkatClient {
             payload,
         };
         if (options?.blocks !== undefined) {
-            params.blocks = options.blocks;
+            params.blocks = options.blocks.map(toWireContentBlock);
         }
         return this.request("session/external_event", params);
     }
@@ -678,7 +760,8 @@ export class MeerkatClient {
         if (options?.modelName !== undefined) {
             params.model_name = options.modelName;
         }
-        return await this.request("session/export_atif", params);
+        const result = await this.request("session/export_atif", params);
+        return MeerkatClient.requireRecord(result, "result", "Invalid session/export_atif response");
     }
     async readSessionTranscriptRevision(sessionId, revision, options) {
         const params = {
@@ -1019,10 +1102,11 @@ export class MeerkatClient {
         return { tools };
     }
     async callScheduleTool(request) {
-        return this.request("schedule/call", {
+        const result = await this.request("schedule/call", {
             name: request.name,
             arguments: request.arguments ?? {},
         });
+        return MeerkatClient.requireRecord(result, "result", "Invalid schedule/call response");
     }
     async getWorkGraphItem(itemId, options) {
         const params = { id: itemId };
@@ -1067,7 +1151,9 @@ export class MeerkatClient {
     }
     async createMob(options) {
         this.requireCapability("mob");
-        const result = await this.request("mob/create", options);
+        const result = await this.request("mob/create", {
+            definition: toWireMobDefinition(options.definition),
+        });
         return new Mob(this, MeerkatClient.requireStringField(result, "mob_id", "Invalid mob/create response"));
     }
     mob(mobId) {
@@ -1129,7 +1215,7 @@ export class MeerkatClient {
         const result = await this.request("mob/member_send", {
             mob_id: mobId,
             agent_identity: agentIdentity,
-            content,
+            content: toWireContentInput(content),
             handling_mode: options?.handlingMode,
             render_metadata: options?.renderMetadata,
         });
@@ -1313,6 +1399,39 @@ export class MeerkatClient {
         };
     }
     // ─── Multi-host console verbs (phase 7, DEC-P7A-9) ────────────────────
+    /** Read one member's durable tool declaration and fresh convergence. */
+    async mobMemberToolDeclaration(mobId, agentIdentity) {
+        return this.request("mob/member_tool_declaration", {
+            mob_id: mobId,
+            agent_identity: agentIdentity,
+        });
+    }
+    /** Apply one revision-fenced durable member-tool declaration. */
+    async applyMobMemberToolDeclaration(mobId, agentIdentity, requestId, expectedIntentRevision, declaration, convergence) {
+        return this.request("mob/apply_member_tool_declaration", {
+            mob_id: mobId,
+            agent_identity: agentIdentity,
+            request_id: requestId,
+            expected_intent_revision: expectedIntentRevision,
+            declaration,
+            convergence,
+        });
+    }
+    /** Adopt one already-realized member under an explicit expected-absent declaration. */
+    async adoptMobMemberIdentityDeclaration(params) {
+        return this.request("mob/adopt_member_identity_declaration", params);
+    }
+    /** Continue blocked identity convergence under exact revision fences. */
+    async resolveMobIdentityConvergenceBlock(mobId, agentIdentity, requestId, expectedDesiredRevision, observedActiveRevision, convergence) {
+        return this.request("mob/resolve_identity_convergence_block", {
+            mob_id: mobId,
+            agent_identity: agentIdentity,
+            request_id: requestId,
+            expected_desired_revision: expectedDesiredRevision,
+            observed_active_revision: observedActiveRevision,
+            convergence,
+        });
+    }
     /**
      * Read a mob member transcript page by identity (`mob/member_history`).
      * One shape local and remote; the envelope carries typed placement +
@@ -1473,7 +1592,7 @@ export class MeerkatClient {
         const result = await this.request("mob/respawn", {
             mob_id: mobId,
             agent_identity: agentIdentity,
-            initial_message: initialMessage,
+            initial_message: initialMessage === undefined ? undefined : toWireContentInput(initialMessage),
         });
         const respawnContext = "Invalid mob/respawn response";
         const respawnRecord = MeerkatClient.requireRecord(result, "result", respawnContext);
@@ -1612,14 +1731,14 @@ export class MeerkatClient {
     async mobSubmitWork(args) {
         const params = {
             member_ref: args.memberRef,
-            content: args.content,
+            content: toWireContentInput(args.content),
             origin: args.origin ?? "external",
         };
         if (args.workRef !== undefined) {
             params.work_ref = args.workRef;
         }
         if (args.injectedContext !== undefined && args.injectedContext.length > 0) {
-            params.injected_context = args.injectedContext;
+            params.injected_context = args.injectedContext.map(toWireContentInput);
         }
         if (args.transientTurnContext !== undefined) {
             params.transient_turn_context = args.transientTurnContext;
@@ -1832,7 +1951,7 @@ export class MeerkatClient {
     async createMobProfile(name, profile) {
         const raw = await this.request("mob/profile/create", {
             name,
-            profile,
+            profile: toWireMobProfile(profile),
         });
         return MeerkatClient.parseMobProfileLookup(raw);
     }
@@ -1848,7 +1967,7 @@ export class MeerkatClient {
     async updateMobProfile(name, profile, expectedRevision) {
         const raw = await this.request("mob/profile/update", {
             name,
-            profile,
+            profile: toWireMobProfile(profile),
             expected_revision: expectedRevision,
         });
         return MeerkatClient.parseMobProfileLookup(raw);
@@ -1926,7 +2045,9 @@ export class MeerkatClient {
                 this.process.stdin.write(JSON.stringify(rpcRequest) + "\n");
                 return responsePromise;
             })()
-            : await this.request(openMethod, params);
+            : openMethod === "session/stream_open"
+                ? await this.request("session/stream_open", params)
+                : await this.request("mob/stream_open", params);
         const streamId = String(result.stream_id ?? "");
         if (!streamId) {
             throw new MeerkatError("INVALID_RESPONSE", `${openMethod} did not return stream_id`);
@@ -1947,7 +2068,12 @@ export class MeerkatClient {
             closeRemote: async (id) => {
                 // Await stream-close authority before tearing down local dispatch:
                 // a rejected close must leave the subscription delivering events.
-                await this.request(closeMethod, { stream_id: id });
+                if (closeMethod === "session/stream_close") {
+                    await this.request("session/stream_close", { stream_id: id });
+                }
+                else {
+                    await this.request("mob/stream_close", { stream_id: id });
+                }
                 this.streamQueues.delete(id);
             },
             parseEvent: parse,
@@ -2223,7 +2349,7 @@ export class MeerkatClient {
      * boundary.
      */
     async send(sessionId, command) {
-        const result = await this.request("comms/send", { session_id: sessionId, ...command });
+        const result = await this.request("comms/send", toWireCommsSendParams(sessionId, command));
         return MeerkatClient.parseCommsSendReceipt(result);
     }
     async peers(sessionId) {
@@ -4085,13 +4211,13 @@ export class MeerkatClient {
             case "message":
                 return {
                     type: "message",
-                    message: replacement.message,
+                    message: MeerkatClient.serializeTranscriptRewriteMessage(replacement.message),
                 };
             case "user_content_block":
                 return {
                     type: "user_content_block",
                     block_index: replacement.blockIndex,
-                    block: replacement.block,
+                    block: toWireContentBlock(replacement.block),
                 };
             case "assistant_block":
                 return {
@@ -4104,7 +4230,7 @@ export class MeerkatClient {
                     type: "tool_result_content_block",
                     result_index: replacement.resultIndex,
                     block_index: replacement.blockIndex,
-                    block: replacement.block,
+                    block: toWireContentBlock(replacement.block),
                 };
         }
         throw new Error(`Unsupported transcript replacement type: ${replacement.type}`);
@@ -4223,6 +4349,8 @@ export class MeerkatClient {
                     is_error: result.isError,
                 }));
             }
+            // SessionMessage.raw was accepted by the fail-closed transcript parser
+            // above; this branch only restores the exact snake_case wire spelling.
             return payload;
         }
         return { ...message };