@rkat/sdk 0.4.5 → 0.4.7

package/dist/session.js

@@ -31,101 +31,110 @@ export class Session {
         this._ref = result.sessionRef;
         this._lastResult = result;
     }
-    // -- Identity -----------------------------------------------------------
-    /** The stable UUID for this session. */
     get id() {
         return this._id;
     }
-    /** Optional human-readable session reference. */
     get ref() {
         return this._ref;
     }
-    // -- Last result shortcuts ----------------------------------------------
-    /** The most recent {@link RunResult}. */
     get lastResult() {
         return this._lastResult;
     }
-    /** The assistant's text from the last turn. */
     get text() {
         return this._lastResult.text;
     }
-    /** Token usage from the last turn. */
     get usage() {
         return this._lastResult.usage;
     }
-    /** Number of LLM turns in the last run. */
     get turns() {
         return this._lastResult.turns;
     }
-    /** Number of tool calls in the last run. */
     get toolCalls() {
         return this._lastResult.toolCalls;
     }
-    /** Structured output from the last run, if requested. */
     get structuredOutput() {
         return this._lastResult.structuredOutput;
     }
-    // -- Multi-turn ---------------------------------------------------------
-    /** Run another turn on this session (non-streaming). */
     async turn(prompt, options) {
         const result = await this._client._startTurn(this._id, prompt, options);
         this._lastResult = result;
         return result;
     }
-    /**
-     * Run another turn on this session with streaming events.
-     *
-     * Returns an {@link EventStream} `AsyncIterable<AgentEvent>`.
-     *
-     * @example
-     * ```ts
-     * for await (const event of session.stream("prompt")) {
-     *   // ...
-     * }
-     * ```
-     */
     stream(prompt, options) {
         return this._client._startTurnStreaming(this._id, prompt, options, this);
     }
-    // -- Lifecycle ----------------------------------------------------------
-    /** Cancel the currently running turn, if any. */
     async interrupt() {
         await this._client._interrupt(this._id);
     }
-    /** Archive (remove) this session from the server. */
     async archive() {
         await this._client._archive(this._id);
     }
-    // -- Skills convenience -------------------------------------------------
-    /**
-     * Invoke a skill in this session.
-     *
-     * Accepts a {@link SkillKey} or a legacy string reference.
-     * Sends the structured `skill_refs` parameter to the runtime.
-     */
+    async history(options) {
+        return this._client.readSessionHistory(this._id, options);
+    }
+    async subscribeEvents() {
+        return this._client.subscribeSessionEvents(this._id);
+    }
     async invokeSkill(skillRef, prompt) {
         this._client.requireCapability("skills");
         return this.turn(prompt, { skillRefs: [skillRef] });
     }
-    // -- Comms convenience --------------------------------------------------
-    /** Send a comms command scoped to this session. */
     async send(command) {
-        return this._client._send(this._id, command);
+        const { session_id: _ignored, ...rest } = command;
+        return this._client._send(this._id, rest);
     }
-    /** List peers visible to this session's comms runtime. */
     async peers() {
         const result = await this._client._peers(this._id);
         return (result.peers ?? []);
     }
-    async openCommsStream(options) {
-        return this._client.openCommsStream(this._id, options);
+    toString() {
+        const ref = this._ref ? ` ref=${this._ref}` : "";
+        return `Session(id=${this._id}${ref})`;
     }
-    async sendAndStream(command) {
-        return this._client.sendAndStream(this._id, command);
+}
+/**
+ * A session created with `initial_turn: "deferred"`.
+ *
+ * No first turn has been executed yet. Use {@link startTurn} to run the first
+ * turn with optional per-turn overrides.
+ */
+export class DeferredSession {
+    _client;
+    _id;
+    _ref;
+    /** @internal — constructed by MeerkatClient, not directly. */
+    constructor(client, sessionId, sessionRef) {
+        this._client = client;
+        this._id = sessionId;
+        this._ref = sessionRef;
+    }
+    get id() {
+        return this._id;
+    }
+    get ref() {
+        return this._ref;
+    }
+    /**
+     * Run the first turn on this deferred session.
+     *
+     * Accepts per-turn overrides (model, provider, etc.) that are applied
+     * before the session is materialized.
+     */
+    async startTurn(prompt, options) {
+        return this._client._startTurn(this._id, prompt, options);
+    }
+    async interrupt() {
+        await this._client._interrupt(this._id);
+    }
+    async archive() {
+        await this._client._archive(this._id);
+    }
+    async history(options) {
+        return this._client.readSessionHistory(this._id, options);
     }
     toString() {
         const ref = this._ref ? ` ref=${this._ref}` : "";
-        return `Session(id=${this._id}${ref})`;
+        return `DeferredSession(id=${this._id}${ref})`;
     }
 }
 //# sourceMappingURL=session.js.map

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/streaming.d.ts

@@ -19,11 +19,17 @@ import type { StreamEvent } from "./events.js";
 import type { RunResult } from "./types.js";
 import type { Session } from "./session.js";
 /** @internal Queue with promise-based get(). */
-declare class AsyncQueue<T> {
+export declare class AsyncQueue<T> {
     private buffer;
     private waiters;
+    private nextWaiterId;
     put(item: T): void;
     get(): Promise<T>;
+    private _get;
+    waitForItemCancelable(): {
+        promise: Promise<void>;
+        cancel: () => void;
+    };
     tryGet(): T | undefined;
     get isEmpty(): boolean;
     failAll(error: Error): void;
@@ -58,23 +64,7 @@ export declare class EventStream implements AsyncIterable<StreamEvent> {
     collect(): Promise<RunResult>;
     /** Consume events, accumulate text deltas, return `[fullText, result]`. */
     collectText(): Promise<[string, RunResult]>;
+    private _drainLateEvents;
     private _finalise;
 }
-/**
- * Async iterable of raw comms stream notifications emitted via `comms/stream_event`.
- */
-export declare class CommsEventStream implements AsyncIterable<Record<string, unknown>> {
-    private readonly _streamId;
-    private readonly _eventQueue;
-    private readonly _onClose;
-    constructor(opts: {
-        streamId: string;
-        eventQueue: AsyncQueue<Record<string, unknown> | null>;
-        onClose: (streamId: string) => Promise<void>;
-    });
-    get streamId(): string;
-    [Symbol.asyncIterator](): AsyncGenerator<Record<string, unknown>, void, undefined>;
-    close(): Promise<void>;
-}
-export { AsyncQueue };
 //# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,gDAAgD;AAChD,cAAM,UAAU,CAAC,CAAC;IAChB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,OAAO,CAAiC;IAEhD,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAQlB,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IASjB,MAAM,IAAI,CAAC,GAAG,SAAS;IAIvB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAQ5B;AAKD;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,aAAa,CAAC,WAAW,CAAC;IAC5D,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6C;IACzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8C;IAC3E,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,8DAA8D;gBAClD,IAAI,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACvD,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC;QACzD,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB;IAQD,oCAAoC;IACpC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,wEAAwE;IACxE,IAAI,MAAM,IAAI,SAAS,CAQtB;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC;IA0C7E,+DAA+D;IACzD,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;IAOnC,2EAA2E;IACrE,WAAW,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAUjD,OAAO,CAAC,SAAS;CASlB;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6C;IACzE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;gBAEnD,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACvD,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9C;IAMD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IAQnF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAGD,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,gDAAgD;AAChD,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,OAAO,CAAkD;IACjE,OAAO,CAAC,YAAY,CAAK;IAEzB,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAalB,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;YAIH,IAAI;IAOlB,qBAAqB,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;IAqCvE,MAAM,IAAI,CAAC,GAAG,SAAS;IAIvB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAW5B;AAID;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,aAAa,CAAC,WAAW,CAAC;IAC5D,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6C;IACzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8C;IAC3E,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,8DAA8D;gBAClD,IAAI,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACvD,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC;QACzD,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB;IAQD,oCAAoC;IACpC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,wEAAwE;IACxE,IAAI,MAAM,IAAI,SAAS,CAQtB;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC;IA2C7E,+DAA+D;IACzD,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;IAOnC,2EAA2E;IACrE,WAAW,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAUlC,gBAAgB;IAgC/B,OAAO,CAAC,SAAS;CASlB"}

package/dist/streaming.js

@@ -18,24 +18,63 @@
 import { isTextDelta, parseEvent } from "./events.js";
 import { MeerkatError } from "./generated/errors.js";
 /** @internal Queue with promise-based get(). */
-class AsyncQueue {
+export class AsyncQueue {
     buffer = [];
     waiters = [];
+    nextWaiterId = 0;
     put(item) {
-        if (this.waiters.length > 0) {
-            this.waiters.shift()(item);
+        this.buffer.push(item);
+        if (this.waiters.length === 0) {
+            return;
         }
-        else {
-            this.buffer.push(item);
+        const waiters = this.waiters;
+        this.waiters = [];
+        for (const waiter of waiters) {
+            waiter.resolve();
         }
     }
     get() {
+        return this._get();
+    }
+    async _get() {
+        while (this.buffer.length === 0) {
+            await this.waitForItemCancelable().promise;
+        }
+        return this.buffer.shift();
+    }
+    waitForItemCancelable() {
         if (this.buffer.length > 0) {
-            return Promise.resolve(this.buffer.shift());
+            return {
+                promise: Promise.resolve(),
+                cancel: () => {
+                    // Already resolved from the buffer.
+                },
+            };
         }
-        return new Promise((resolve) => {
-            this.waiters.push(resolve);
+        const waiterId = this.nextWaiterId++;
+        let settled = false;
+        const promise = new Promise((resolve) => {
+            this.waiters.push({
+                id: waiterId,
+                resolve: () => {
+                    settled = true;
+                    resolve();
+                },
+            });
         });
+        return {
+            promise,
+            cancel: () => {
+                if (settled) {
+                    return;
+                }
+                const waiterIndex = this.waiters.findIndex((waiter) => waiter.id === waiterId);
+                if (waiterIndex >= 0) {
+                    this.waiters.splice(waiterIndex, 1);
+                }
+                settled = true;
+            },
+        };
     }
     tryGet() {
         return this.buffer.shift();
@@ -44,16 +83,18 @@ class AsyncQueue {
         return this.buffer.length === 0;
     }
     failAll(error) {
-        // Waiters receive a rejected promise; we wrap by rejecting in the next tick
-        for (const waiter of this.waiters) {
-            // Use a sentinel; callers handle it
-            waiter(undefined);
+        // Wake every current waiter with a sentinel so pending gets can complete.
+        for (let i = 0; i < Math.max(this.waiters.length, 1); i += 1) {
+            this.buffer.push(undefined);
         }
+        const waiters = this.waiters;
         this.waiters = [];
+        for (const waiter of waiters) {
+            waiter.resolve();
+        }
     }
 }
-/** Sentinel for end-of-stream. */
-const SENTINEL = Symbol("eos");
+const RESPONSE_DRAIN_GRACE_MS = 75;
 /**
  * Typed async iterable of {@link StreamEvent} objects from a running turn.
  *
@@ -96,30 +137,31 @@ export class EventStream {
         });
         while (true) {
             if (responseDone) {
-                // Drain remaining queued events
-                while (!this._eventQueue.isEmpty) {
-                    const raw = this._eventQueue.tryGet();
-                    if (raw == null)
-                        break;
-                    yield parseEvent(raw);
-                }
+                yield* this._drainLateEvents();
                 this._finalise(responseResult);
                 return;
             }
             // Race: next event vs response
-            const eventPromise = this._eventQueue.get();
+            const { promise: itemReady, cancel } = this._eventQueue.waitForItemCancelable();
             const result = await Promise.race([
-                eventPromise.then((raw) => ({ kind: "event", raw })),
+                itemReady.then(() => ({ kind: "event" })),
                 responseHandler.then(() => ({ kind: "response", raw: null })),
             ]);
             if (result.kind === "event") {
-                if (result.raw == null) {
+                const raw = this._eventQueue.tryGet();
+                if (raw === undefined) {
+                    continue;
+                }
+                if (raw === null) {
                     // Sentinel — stream ended
                     await responseHandler;
                     this._finalise(responseResult);
                     return;
                 }
-                yield parseEvent(result.raw);
+                yield parseEvent(raw);
+            }
+            else {
+                cancel();
             }
             // If response, loop back to the top which handles drain
         }
@@ -141,6 +183,34 @@ export class EventStream {
         }
         return [parts.join(""), this.result];
     }
+    async *_drainLateEvents() {
+        let deadline = Date.now() + RESPONSE_DRAIN_GRACE_MS;
+        while (true) {
+            let yieldedEvent = false;
+            while (!this._eventQueue.isEmpty) {
+                const raw = this._eventQueue.tryGet();
+                if (raw === undefined) {
+                    break;
+                }
+                if (raw === null) {
+                    return;
+                }
+                yieldedEvent = true;
+                yield parseEvent(raw);
+            }
+            if (yieldedEvent) {
+                deadline = Date.now() + RESPONSE_DRAIN_GRACE_MS;
+                continue;
+            }
+            const remainingMs = deadline - Date.now();
+            if (remainingMs <= 0) {
+                return;
+            }
+            await new Promise((resolve) => {
+                setTimeout(resolve, Math.min(remainingMs, 5));
+            });
+        }
+    }
     _finalise(rawResult) {
         this._result = this._parseResult(rawResult);
         if (!this._sessionId) {
@@ -151,33 +221,4 @@ export class EventStream {
         }
     }
 }
-/**
- * Async iterable of raw comms stream notifications emitted via `comms/stream_event`.
- */
-export class CommsEventStream {
-    _streamId;
-    _eventQueue;
-    _onClose;
-    constructor(opts) {
-        this._streamId = opts.streamId;
-        this._eventQueue = opts.eventQueue;
-        this._onClose = opts.onClose;
-    }
-    get streamId() {
-        return this._streamId;
-    }
-    async *[Symbol.asyncIterator]() {
-        while (true) {
-            const raw = await this._eventQueue.get();
-            if (raw == null)
-                return;
-            yield raw;
-        }
-    }
-    async close() {
-        await this._onClose(this._streamId);
-    }
-}
-// Re-export AsyncQueue for internal use by client
-export { AsyncQueue };
 //# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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

package/dist/subscription.d.ts

@@ -0,0 +1,23 @@
+import { AsyncQueue } from "./streaming.js";
+export declare class EventSubscription<T> implements AsyncIterable<T> {
+    private readonly streamId;
+    private readonly queue;
+    private readonly closeRemote;
+    private readonly parseEvent;
+    private readonly getTerminalOutcome;
+    private closed;
+    /** @internal */
+    constructor(opts: {
+        streamId: string;
+        queue: AsyncQueue<Record<string, unknown> | null>;
+        closeRemote: (streamId: string) => Promise<void>;
+        parseEvent: (raw: Record<string, unknown>) => T;
+        getTerminalOutcome: () => Record<string, unknown> | undefined;
+    });
+    get id(): string;
+    get isClosed(): boolean;
+    get terminalOutcome(): Record<string, unknown> | undefined;
+    close(): Promise<void>;
+    [Symbol.asyncIterator](): AsyncGenerator<T, void, undefined>;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../src/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,qBAAa,iBAAiB,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IACnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA4C;IAC/E,OAAO,CAAC,MAAM,CAAS;IAEvB,gBAAgB;gBACJ,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,kBAAkB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC/D;IAQD,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEzD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;CASpE"}

package/dist/subscription.js

@@ -0,0 +1,42 @@
+export class EventSubscription {
+    streamId;
+    queue;
+    closeRemote;
+    parseEvent;
+    getTerminalOutcome;
+    closed = false;
+    /** @internal */
+    constructor(opts) {
+        this.streamId = opts.streamId;
+        this.queue = opts.queue;
+        this.closeRemote = opts.closeRemote;
+        this.parseEvent = opts.parseEvent;
+        this.getTerminalOutcome = opts.getTerminalOutcome;
+    }
+    get id() {
+        return this.streamId;
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    get terminalOutcome() {
+        return this.getTerminalOutcome();
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.queue.put(null);
+        await this.closeRemote(this.streamId);
+    }
+    async *[Symbol.asyncIterator]() {
+        while (true) {
+            const raw = await this.queue.get();
+            if (raw == null) {
+                return;
+            }
+            yield this.parseEvent(raw);
+        }
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../src/subscription.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IACX,QAAQ,CAAS;IACjB,KAAK,CAA6C;IAClD,WAAW,CAAsC;IACjD,UAAU,CAAsC;IAChD,kBAAkB,CAA4C;IACvE,MAAM,GAAG,KAAK,CAAC;IAEvB,gBAAgB;IAChB,YAAY,IAMX;QACC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;IACpD,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACnC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -71,7 +71,97 @@ export interface SessionInfo {
     readonly totalTokens: number;
     readonly isActive: boolean;
 }
+export interface SessionToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly args: unknown;
+}
+export interface SessionToolResult {
+    readonly toolUseId: string;
+    readonly content: string;
+    readonly isError: boolean;
+}
+export interface SessionAssistantBlock {
+    readonly blockType: string;
+    readonly text?: string;
+    readonly id?: string;
+    readonly name?: string;
+    readonly args?: unknown;
+    readonly meta?: Record<string, unknown>;
+}
+export interface SessionMessage {
+    readonly role: string;
+    readonly content?: string;
+    readonly toolCalls: readonly SessionToolCall[];
+    readonly stopReason?: string;
+    readonly blocks: readonly SessionAssistantBlock[];
+    readonly results: readonly SessionToolResult[];
+}
+export interface SessionHistory {
+    readonly sessionId: string;
+    readonly sessionRef?: string;
+    readonly messageCount: number;
+    readonly offset: number;
+    readonly limit?: number;
+    readonly hasMore: boolean;
+    readonly messages: readonly SessionMessage[];
+}
 /** A runtime capability and its availability status. */
+export interface EventEnvelope<T = unknown> {
+    readonly timestamp_ms: number;
+    readonly source_id: string;
+    readonly seq: number;
+    readonly event_id: string;
+    readonly payload: T;
+}
+export interface AttributedEvent {
+    readonly source: string;
+    readonly profile: string;
+    readonly envelope: EventEnvelope;
+}
+export interface MobDefinition {
+    readonly id: string;
+    readonly profiles: Record<string, unknown>;
+    readonly wiring?: Record<string, unknown>;
+    readonly flows?: Record<string, unknown>;
+    readonly mcp_servers?: Record<string, unknown>;
+    readonly skills?: Record<string, unknown>;
+    readonly orchestrator?: unknown;
+    readonly backend?: unknown;
+}
+export interface SpawnSpec {
+    readonly profile: string;
+    readonly meerkatId: string;
+    readonly initialMessage?: string;
+    readonly runtimeMode?: "turn_driven" | "autonomous_host";
+    readonly backend?: "subagent" | "external";
+    readonly labels?: Record<string, string>;
+    readonly context?: Record<string, unknown>;
+    readonly resumeSessionId?: string;
+    readonly additionalInstructions?: string[];
+}
+export interface MobMember {
+    readonly meerkatId: string;
+    readonly profile: string;
+    readonly memberRef?: Record<string, unknown>;
+    readonly runtimeMode?: string;
+    readonly state?: string;
+    readonly wiredTo?: readonly string[];
+    readonly labels?: Record<string, string>;
+    readonly sessionId?: string;
+}
+export interface MobSummary {
+    readonly mobId: string;
+    readonly status: string;
+}
+export interface MobStatus {
+    readonly mobId: string;
+    readonly status: string;
+}
+export type MobLifecycleAction = "stop" | "resume" | "complete" | "destroy" | "reset";
+export interface MobFlowStatus {
+    readonly run?: Record<string, unknown> | null;
+}
 export interface Capability {
     readonly id: string;
     readonly description: string;
@@ -100,4 +190,23 @@ export interface SessionOptions {
     skillRefs?: SkillRef[];
     skillReferences?: string[];
 }
+/** 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;
+}
+/** Mob-wide attributed event emitted by member/mob observation streams. */
+export interface AttributedMobEvent {
+    readonly source: string;
+    readonly profile: string;
+    readonly envelope: AgentEventEnvelope;
+}
+/** Options for creating a mob through the RPC-backed SDK surface. */
+export interface MobCreateOptions {
+    prefab?: string;
+    definition?: Record<string, unknown>;
+}
 //# sourceMappingURL=types.d.ts.map