@rkat/sdk 0.6.4 → 0.6.6

package/dist/realtime.js

@@ -1,166 +0,0 @@
-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

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