@kortix/sdk 0.12.8 → 0.13.0

package/dist/core/session/send-queue.d.ts

@@ -1,70 +0,0 @@
-/**
- * One prompt at a time, in the order they were written.
- *
- * Sending while the agent is mid-run used to be fire-and-hope: the prompt went
- * out immediately and whatever the runtime did with it was invisible. The
- * reported symptom was "sending also without upload feels janky while agent is
- * working" — nothing on screen distinguished "waiting its turn" from "lost".
- *
- * This holds a prompt until the session is idle, then dispatches it. Ordering
- * is guaranteed HERE rather than assumed of the server, which matters because
- * the endpoint Kortix currently uses (`/session/{id}/prompt_async`) makes no
- * documented promise about what happens to a prompt that arrives mid-run. The
- * runtime does have a durable native queue (`delivery: 'queue'` on the v2
- * `/api/session/{id}/prompt` route, with `session.next.prompt.admitted` to
- * confirm promotion) — moving to it is the better long-term answer and is
- * tracked separately. Until then the queue lives here, with the one honest
- * caveat that a queue in a tab dies with the tab.
- *
- * Framework-free and timer-free: `isBusy` is injected and draining is driven by
- * the caller telling it the session went idle. Nothing here polls.
- *
- * **Superseded for host use by `./message-queue`.** This module owns dispatch
- * (it holds closures and calls them), which is exactly what a host cannot
- * persist, reorder, or edit — a `dispatch` closure does not survive a page
- * reload. `message-queue.ts` keeps the same one-at-a-time and never-jump-the-
- * line guarantees but expresses them as pure transitions over serializable
- * data, so the queue can be stored, reordered, and rewritten by the user.
- *
- * This module stays exported and tested: it is published API. New host code
- * should reach for `message-queue` instead.
- */
-/** Where a queued send has got to. Drives the label on the user's bubble. */
-export type SendPhase = 'queued' | 'sending' | 'sent' | 'failed';
-export interface QueuedSend {
-    /** The optimistic message this send belongs to. */
-    messageId: string;
-    /** Actually put it on the wire. Rejects on failure. */
-    dispatch: () => Promise<void>;
-}
-export interface SendQueueOptions {
-    /** Is the session mid-run right now? */
-    isBusy: (sessionId: string) => boolean;
-    /** Report a phase change so a host can render it. */
-    onPhase?: (sessionId: string, messageId: string, phase: SendPhase) => void;
-}
-export interface SendQueue {
-    /**
-     * Send now if the session is idle, otherwise hold it.
-     *
-     * Returns the phase the message entered, so a caller can render without
-     * waiting for the `onPhase` callback to come back around.
-     */
-    submit: (sessionId: string, item: QueuedSend) => 'queued' | 'sending';
-    /**
-     * The session finished a run. Dispatch the next held prompt, if any.
-     *
-     * Called by whatever observes session status — deliberately not a poll, and
-     * deliberately not a subscription this module owns, so it stays framework-
-     * free and testable without fake timers.
-     */
-    drain: (sessionId: string) => void;
-    /** Abandon a specific held send (the user discarded it). */
-    cancel: (sessionId: string, messageId: string) => boolean;
-    /** Abandon everything held for a session (it closed, or was cleared). */
-    clear: (sessionId: string) => void;
-    /** Message ids still waiting, oldest first. */
-    pending: (sessionId: string) => string[];
-}
-export declare function createSendQueue(options: SendQueueOptions): SendQueue;
-//# sourceMappingURL=send-queue.d.ts.map

package/dist/core/session/send-queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"send-queue.d.ts","sourceRoot":"","sources":["../../../src/core/session/send-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,QAAQ,GAAG,SAAS,CAAC;IACtE;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,4DAA4D;IAC5D,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,yEAAyE;IACzE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,+CAA+C;IAC/C,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAC1C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAgFpE"}

package/dist/core/session/send-queue.js

@@ -1,116 +0,0 @@
-/**
- * One prompt at a time, in the order they were written.
- *
- * Sending while the agent is mid-run used to be fire-and-hope: the prompt went
- * out immediately and whatever the runtime did with it was invisible. The
- * reported symptom was "sending also without upload feels janky while agent is
- * working" — nothing on screen distinguished "waiting its turn" from "lost".
- *
- * This holds a prompt until the session is idle, then dispatches it. Ordering
- * is guaranteed HERE rather than assumed of the server, which matters because
- * the endpoint Kortix currently uses (`/session/{id}/prompt_async`) makes no
- * documented promise about what happens to a prompt that arrives mid-run. The
- * runtime does have a durable native queue (`delivery: 'queue'` on the v2
- * `/api/session/{id}/prompt` route, with `session.next.prompt.admitted` to
- * confirm promotion) — moving to it is the better long-term answer and is
- * tracked separately. Until then the queue lives here, with the one honest
- * caveat that a queue in a tab dies with the tab.
- *
- * Framework-free and timer-free: `isBusy` is injected and draining is driven by
- * the caller telling it the session went idle. Nothing here polls.
- *
- * **Superseded for host use by `./message-queue`.** This module owns dispatch
- * (it holds closures and calls them), which is exactly what a host cannot
- * persist, reorder, or edit — a `dispatch` closure does not survive a page
- * reload. `message-queue.ts` keeps the same one-at-a-time and never-jump-the-
- * line guarantees but expresses them as pure transitions over serializable
- * data, so the queue can be stored, reordered, and rewritten by the user.
- *
- * This module stays exported and tested: it is published API. New host code
- * should reach for `message-queue` instead.
- */
-export function createSendQueue(options) {
-    const { isBusy, onPhase } = options;
-    const queues = new Map();
-    /** Sessions with a dispatch in flight, so `drain` never doubles up. */
-    const inFlight = new Set();
-    const phase = (sessionId, messageId, next) => {
-        onPhase?.(sessionId, messageId, next);
-    };
-    const run = (sessionId, item) => {
-        inFlight.add(sessionId);
-        phase(sessionId, item.messageId, 'sending');
-        void item
-            .dispatch()
-            .then(() => {
-            phase(sessionId, item.messageId, 'sent');
-        })
-            .catch(() => {
-            // A failed send must not wedge everything written after it. The
-            // message keeps its own `failed` phase (the host offers a retry);
-            // the queue moves on.
-            phase(sessionId, item.messageId, 'failed');
-        })
-            .finally(() => {
-            inFlight.delete(sessionId);
-            // The run this send started has not begun yet — `drain` is driven by
-            // the session going idle, and it is about to go busy. Only pull the
-            // next item if the session never became busy at all (e.g. the send
-            // failed outright), otherwise the idle transition will do it.
-            if (!isBusy(sessionId))
-                drain(sessionId);
-        });
-    };
-    const drain = (sessionId) => {
-        if (inFlight.has(sessionId))
-            return;
-        if (isBusy(sessionId))
-            return;
-        const queue = queues.get(sessionId);
-        if (!queue || queue.length === 0)
-            return;
-        const next = queue.shift();
-        if (queue.length === 0)
-            queues.delete(sessionId);
-        if (next)
-            run(sessionId, next);
-    };
-    return {
-        submit: (sessionId, item) => {
-            if (!isBusy(sessionId) && !inFlight.has(sessionId)) {
-                const queue = queues.get(sessionId);
-                // Never jump the line: if anything is already waiting, this one waits
-                // behind it even though the session happens to be idle this instant.
-                if (!queue || queue.length === 0) {
-                    run(sessionId, item);
-                    return 'sending';
-                }
-            }
-            const queue = queues.get(sessionId);
-            if (queue)
-                queue.push(item);
-            else
-                queues.set(sessionId, [item]);
-            phase(sessionId, item.messageId, 'queued');
-            return 'queued';
-        },
-        drain,
-        cancel: (sessionId, messageId) => {
-            const queue = queues.get(sessionId);
-            if (!queue)
-                return false;
-            const index = queue.findIndex((q) => q.messageId === messageId);
-            if (index === -1)
-                return false;
-            queue.splice(index, 1);
-            if (queue.length === 0)
-                queues.delete(sessionId);
-            return true;
-        },
-        clear: (sessionId) => {
-            queues.delete(sessionId);
-        },
-        pending: (sessionId) => (queues.get(sessionId) ?? []).map((q) => q.messageId),
-    };
-}
-//# sourceMappingURL=send-queue.js.map

package/dist/core/session/send-queue.js.map

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