@neta-art/cohub 1.8.0 → 1.10.0

package/dist/session-patch-reducer.js

@@ -1,432 +0,0 @@
-const blockSubPathPattern = /^\/message\/content\/blocks\/(\d+)\/(.+)$/;
-const blockPathPattern = /^\/message\/content\/blocks\/(\d+)$/;
-const blockMetaPathPattern = /^\/message\/content\/blocks\/(\d+)\/_meta$/;
-const TERMINAL_PATCH_STATUSES = new Set(["completed", "failed", "interrupted"]);
-const isTerminalPatchStatus = (status) => TERMINAL_PATCH_STATUSES.has(status);
-const createIdleState = (input) => ({
-    spaceId: input.spaceId ?? null,
-    sessionId: input.sessionId,
-    status: "idle",
-    contentBlocks: [],
-    anchorUserMessageId: null,
-    patchSeq: 0,
-    turnId: null,
-    appendPath: null,
-});
-function cloneBlock(block) {
-    return structuredClone(block);
-}
-function getStreamIndex(block) {
-    const value = block._meta?.streamIndex;
-    return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function blockIdentityCompatible(prev, next) {
-    if (prev.type !== next.type)
-        return false;
-    if (prev.type === "tool_use" && next.type === "tool_use")
-        return prev.id === next.id && prev.name === next.name;
-    if (prev.type === "tool_result" && next.type === "tool_result")
-        return prev.tool_use_id === next.tool_use_id;
-    return true;
-}
-function findBlockByStreamIndex(blocks, streamIndex) {
-    return blocks.findIndex((block) => getStreamIndex(block) === streamIndex);
-}
-function findBlockForReplacement(blocks, streamIndex, nextBlock) {
-    const compatibleIndex = blocks.findIndex((block) => getStreamIndex(block) === streamIndex && blockIdentityCompatible(block, nextBlock));
-    if (compatibleIndex >= 0)
-        return compatibleIndex;
-    const sameStreamIndex = blocks.findIndex((block) => getStreamIndex(block) === streamIndex);
-    if (sameStreamIndex >= 0 && nextBlock.type !== "tool_use" && nextBlock.type !== "tool_result")
-        return sameStreamIndex;
-    return -1;
-}
-function sortBlocksByStreamIndex(blocks) {
-    return [...blocks].sort((a, b) => {
-        const aIndex = getStreamIndex(a);
-        const bIndex = getStreamIndex(b);
-        if (aIndex == null && bIndex == null)
-            return 0;
-        if (aIndex == null)
-            return 1;
-        if (bIndex == null)
-            return -1;
-        return aIndex - bIndex;
-    });
-}
-function isContentBlock(value) {
-    return Boolean(value && typeof value === "object" && "type" in value);
-}
-function isPlainObject(value) {
-    return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-function decodePointerSegments(encoded) {
-    if (!encoded)
-        return [];
-    return encoded.split("/").map((s) => s.replace(/~1/g, "/").replace(/~0/g, "~"));
-}
-function ensureTextLikeBlock(blocks, streamIndex, field) {
-    const existingIndex = findBlockByStreamIndex(blocks, streamIndex);
-    const existing = existingIndex >= 0 ? blocks[existingIndex] : undefined;
-    if (field === "text") {
-        if (existing?.type === "text")
-            return existing;
-        const block = {
-            type: "text",
-            text: "",
-            _meta: { streamIndex },
-        };
-        blocks.push(block);
-        return block;
-    }
-    if (existing?.type === "thinking")
-        return existing;
-    const block = {
-        type: "thinking",
-        thinking: "",
-        _meta: { streamIndex },
-    };
-    blocks.push(block);
-    return block;
-}
-function getOrCreateBlockForSubpath(blocks, streamIndex, firstSegment) {
-    const idx = findBlockByStreamIndex(blocks, streamIndex);
-    if (idx >= 0)
-        return blocks[idx] ?? null;
-    if (firstSegment === "text") {
-        return ensureTextLikeBlock(blocks, streamIndex, "text");
-    }
-    if (firstSegment === "thinking") {
-        return ensureTextLikeBlock(blocks, streamIndex, "thinking");
-    }
-    return null;
-}
-function setDeepOnContentBlock(root, segments, value) {
-    if (segments.length === 0)
-        return false;
-    let cur = root;
-    for (let i = 0; i < segments.length - 1; i++) {
-        const k = segments[i];
-        if (k === undefined)
-            return false;
-        if (!isPlainObject(cur))
-            return false;
-        const next = cur[k];
-        if (next === undefined)
-            return false;
-        cur = next;
-    }
-    const last = segments[segments.length - 1];
-    if (last === undefined)
-        return false;
-    if (!isPlainObject(cur))
-        return false;
-    const toAssign = value !== null && typeof value === "object"
-        ? structuredClone(value)
-        : value;
-    cur[last] = toAssign;
-    return true;
-}
-function appendDeepOnContentBlock(root, segments, suffix) {
-    if (segments.length === 0)
-        return false;
-    let cur = root;
-    for (let i = 0; i < segments.length - 1; i++) {
-        const k = segments[i];
-        if (k === undefined)
-            return false;
-        if (!isPlainObject(cur))
-            return false;
-        const next = cur[k];
-        if (next === undefined)
-            return false;
-        cur = next;
-    }
-    const last = segments[segments.length - 1];
-    if (last === undefined)
-        return false;
-    if (!isPlainObject(cur))
-        return false;
-    const parent = cur;
-    const leaf = parent[last];
-    if (typeof leaf !== "string")
-        return false;
-    parent[last] = leaf + suffix;
-    return true;
-}
-function resolveBlockForSubpath(blocks, streamIndex, firstSegment) {
-    const idx = findBlockByStreamIndex(blocks, streamIndex);
-    if (idx >= 0)
-        return blocks[idx] ?? null;
-    return getOrCreateBlockForSubpath(blocks, streamIndex, firstSegment);
-}
-function applyReplaceAtBlockSubpath(blocks, streamIndex, encodedTail, value) {
-    const segs = decodePointerSegments(encodedTail);
-    if (segs.length === 0)
-        return false;
-    const block = resolveBlockForSubpath(blocks, streamIndex, segs[0] ?? "");
-    if (!block)
-        return false;
-    return setDeepOnContentBlock(block, segs, value);
-}
-function applyAppendAtBlockSubpath(blocks, streamIndex, encodedTail, suffix) {
-    if (typeof suffix !== "string")
-        return false;
-    const segs = decodePointerSegments(encodedTail);
-    if (segs.length === 0)
-        return false;
-    const block = resolveBlockForSubpath(blocks, streamIndex, segs[0] ?? "");
-    if (!block)
-        return false;
-    return appendDeepOnContentBlock(block, segs, suffix);
-}
-function appendPatchStreamValue(blocks, path, value) {
-    const m = path.match(blockSubPathPattern);
-    if (!m)
-        return false;
-    return applyAppendAtBlockSubpath(blocks, Number(m[1]), m[2] ?? "", value);
-}
-function applyPatchOpsToBlocks(current, ops, initialAppendPath) {
-    const next = current.map(cloneBlock);
-    let anchorUserMessageId;
-    let appendPath = initialAppendPath;
-    let failed = false;
-    for (const op of ops) {
-        if (!op.o && !op.p) {
-            if (!appendPath || !appendPatchStreamValue(next, appendPath, op.v)) {
-                failed = true;
-                break;
-            }
-            continue;
-        }
-        if (op.o === "merge" && op.p === "/message/metadata") {
-            const anchor = op.v.anchorUserMessageId;
-            if (typeof anchor === "string" && anchor.trim()) {
-                anchorUserMessageId = anchor;
-            }
-            continue;
-        }
-        if (op.o === "append") {
-            if (typeof op.p !== "string" || !appendPatchStreamValue(next, op.p, op.v)) {
-                failed = true;
-                break;
-            }
-            appendPath = op.p;
-            continue;
-        }
-        if (op.o === "merge") {
-            const match = op.p.match(blockMetaPathPattern);
-            if (!match)
-                continue;
-            const streamIndex = Number(match[1]);
-            const blockIndex = findBlockByStreamIndex(next, streamIndex);
-            const block = blockIndex >= 0 ? next[blockIndex] : undefined;
-            if (!block)
-                continue;
-            block._meta = { ...(block._meta ?? {}), ...op.v };
-            continue;
-        }
-        if (op.o === "replace") {
-            const sub = op.p.match(blockSubPathPattern);
-            if (sub?.[2] && typeof op.p === "string") {
-                const streamIndex = Number(sub[1]);
-                const encodedTail = sub[2];
-                if (applyReplaceAtBlockSubpath(next, streamIndex, encodedTail, op.v)) {
-                    continue;
-                }
-                failed = true;
-                break;
-            }
-        }
-        if (op.o === "replace" || op.o === "add") {
-            const match = op.p.match(blockPathPattern);
-            if (!match || !isContentBlock(op.v))
-                continue;
-            const streamIndex = Number(match[1]);
-            const block = cloneBlock(op.v);
-            block._meta = { ...(block._meta ?? {}), streamIndex };
-            const blockIndex = findBlockForReplacement(next, streamIndex, block);
-            if (blockIndex >= 0) {
-                next[blockIndex] = block;
-            }
-            else {
-                next.push(block);
-            }
-            continue;
-        }
-        if (op.o === "remove") {
-            const match = op.p.match(blockPathPattern);
-            if (!match)
-                continue;
-            const blockIndex = findBlockByStreamIndex(next, Number(match[1]));
-            if (blockIndex >= 0)
-                next.splice(blockIndex, 1);
-        }
-    }
-    return {
-        failed,
-        contentBlocks: sortBlocksByStreamIndex(next),
-        anchorUserMessageId,
-        appendPath,
-    };
-}
-export class SessionPatchReducer {
-    states = new Map();
-    key(input) {
-        return `${input.spaceId ?? ""}:${input.sessionId}`;
-    }
-    get(input) {
-        const key = this.key(input);
-        return this.states.get(key) ?? createIdleState(input);
-    }
-    start(input) {
-        const state = {
-            ...this.get(input),
-            status: "pending",
-            contentBlocks: [],
-            anchorUserMessageId: null,
-            patchSeq: 0,
-            turnId: input.turnId ?? null,
-            appendPath: null,
-        };
-        this.states.set(this.key(input), state);
-        return state;
-    }
-    replaceTurnId(input) {
-        const current = this.get(input);
-        const state = {
-            ...current,
-            turnId: input.nextTurnId,
-        };
-        this.states.set(this.key(input), state);
-        return state;
-    }
-    complete(input) {
-        const current = this.get(input);
-        const state = {
-            ...current,
-            turnId: input.turnId ?? current.turnId,
-            status: "completed",
-            contentBlocks: [],
-            anchorUserMessageId: null,
-        };
-        this.states.set(this.key(input), state);
-        return state;
-    }
-    fail(input) {
-        const current = this.get(input);
-        const state = {
-            ...current,
-            turnId: input.turnId ?? current.turnId,
-            status: "failed",
-            contentBlocks: [],
-            anchorUserMessageId: null,
-        };
-        this.states.set(this.key(input), state);
-        return state;
-    }
-    interrupt(input) {
-        const current = this.get(input);
-        const state = {
-            ...current,
-            turnId: input.turnId ?? current.turnId,
-            status: "interrupted",
-            contentBlocks: [],
-            anchorUserMessageId: null,
-            appendPath: null,
-        };
-        this.states.set(this.key(input), state);
-        return state;
-    }
-    reset(input) {
-        this.states.delete(this.key(input));
-    }
-    applySnapshot(input) {
-        const current = this.get(input);
-        const inputTurnId = input.turnId ?? null;
-        const currentTurnId = current.turnId;
-        const isDifferentKnownTurn = Boolean(currentTurnId && inputTurnId && currentTurnId !== inputTurnId);
-        const isTerminalSameTurn = isTerminalPatchStatus(current.status) && Boolean(currentTurnId) && currentTurnId === inputTurnId;
-        if (isTerminalSameTurn || (!isDifferentKnownTurn && input.seq < current.patchSeq)) {
-            return { applied: false, reason: "duplicate", state: current };
-        }
-        const state = {
-            ...current,
-            spaceId: input.spaceId ?? current.spaceId ?? null,
-            sessionId: input.sessionId,
-            status: "streaming",
-            contentBlocks: sortBlocksByStreamIndex(input.contentBlocks.map(cloneBlock)),
-            anchorUserMessageId: input.anchorUserMessageId ?? current.anchorUserMessageId ?? null,
-            patchSeq: input.seq,
-            turnId: inputTurnId ?? current.turnId ?? null,
-            appendPath: input.appendPath ?? null,
-        };
-        this.states.set(this.key(input), state);
-        return { applied: true, state };
-    }
-    resetAll() {
-        this.states.clear();
-    }
-    applyEvent(event) {
-        return this.applyPatch({
-            spaceId: event.spaceId,
-            sessionId: event.sessionId,
-            turnId: event.payload.turnId,
-            seq: event.payload.seq,
-            baseSeq: event.payload.baseSeq,
-            ops: event.payload.ops,
-            anchorUserMessageId: event.payload.anchorUserMessageId,
-        });
-    }
-    applyPatch(input) {
-        const current = this.get(input);
-        const currentTurnId = current.turnId;
-        const inputTurnId = input.turnId ?? null;
-        const isDifferentKnownTurn = Boolean(currentTurnId && inputTurnId && currentTurnId !== inputTurnId);
-        const isFreshKnownTurn = isDifferentKnownTurn && input.baseSeq === 0;
-        const currentSeq = isFreshKnownTurn ? 0 : current.patchSeq;
-        const isSameTurnKeyframe = Boolean(currentTurnId &&
-            inputTurnId &&
-            currentTurnId === inputTurnId &&
-            input.baseSeq === 0 &&
-            input.seq >= currentSeq);
-        const isTerminalSameTurn = isTerminalPatchStatus(current.status) &&
-            Boolean(currentTurnId) &&
-            currentTurnId === inputTurnId;
-        if (isTerminalSameTurn) {
-            return { applied: false, reason: "duplicate", state: current };
-        }
-        if (isDifferentKnownTurn && !isFreshKnownTurn) {
-            return { applied: false, reason: "version_mismatch", state: current };
-        }
-        if (!isSameTurnKeyframe && input.seq <= currentSeq) {
-            return { applied: false, reason: "duplicate", state: current };
-        }
-        if (!isSameTurnKeyframe && input.baseSeq !== currentSeq) {
-            return { applied: false, reason: "version_mismatch", state: current };
-        }
-        const startingFresh = input.baseSeq === 0 || isFreshKnownTurn || isSameTurnKeyframe;
-        const baseBlocks = startingFresh ? [] : current.contentBlocks;
-        const patched = applyPatchOpsToBlocks(baseBlocks, input.ops, startingFresh ? null : current.appendPath);
-        if (patched.failed) {
-            return { applied: false, reason: "version_mismatch", state: current };
-        }
-        const next = {
-            ...current,
-            spaceId: input.spaceId ?? current.spaceId ?? null,
-            sessionId: input.sessionId,
-            status: "streaming",
-            contentBlocks: patched.contentBlocks,
-            anchorUserMessageId: patched.anchorUserMessageId ??
-                input.anchorUserMessageId ??
-                current.anchorUserMessageId ??
-                null,
-            patchSeq: input.seq,
-            turnId: input.turnId ?? current.turnId ?? null,
-            appendPath: patched.appendPath,
-        };
-        this.states.set(this.key(next), next);
-        return { applied: true, state: next };
-    }
-}
-export const createSessionPatchReducer = () => new SessionPatchReducer();

package/dist/transport.d.ts

@@ -1,40 +0,0 @@
-import type { CohubEnvironment } from "./environment.js";
-import type { WebsocketClientOptions } from "./websocket.js";
-export type Fetch = typeof globalThis.fetch;
-type RequestInitWithFetch = RequestInit & {
-    fetch?: Fetch;
-};
-export type RawHttpResponse = {
-    response: Response;
-    blob(): Promise<Blob>;
-    arrayBuffer(): Promise<ArrayBuffer>;
-    text(): Promise<string>;
-};
-export type CohubClientOptions = {
-    env?: CohubEnvironment;
-    baseUrl?: string;
-    getAccessToken?: () => Promise<string | null> | string | null;
-    onUnauthorized?: () => Promise<void> | void;
-    setStoredAuthToken?: (token: string) => void;
-    clearStoredAuthToken?: () => void;
-    fetch?: Fetch;
-    websocket?: WebsocketClientOptions;
-};
-export declare class HttpError extends Error {
-    readonly status: number;
-    readonly body: unknown;
-    constructor(message: string, status: number, body: unknown);
-}
-export declare class HttpTransport {
-    private readonly baseUrl;
-    private readonly fetcher;
-    private readonly getAccessToken?;
-    private readonly onUnauthorized?;
-    constructor(options?: CohubClientOptions);
-    private withAuthorization;
-    private send;
-    request<T>(path: string, init?: RequestInitWithFetch): Promise<T>;
-    raw(path: string, init?: RequestInitWithFetch): Promise<RawHttpResponse>;
-    blob(path: string, init?: RequestInitWithFetch): Promise<Blob>;
-}
-export {};

package/dist/transport.js

@@ -1,78 +0,0 @@
-import { resolveApiBaseUrl } from "./environment.js";
-const responseBodyForError = async (response) => {
-    const contentType = response.headers.get("content-type") ?? "";
-    return contentType.includes("application/json")
-        ? await response.json().catch(() => null)
-        : await response.text().catch(() => response.statusText);
-};
-const messageFromErrorBody = (body, fallback) => typeof body === "string" ? body : JSON.stringify(body ?? null) || fallback;
-export class HttpError extends Error {
-    status;
-    body;
-    constructor(message, status, body) {
-        super(message);
-        this.name = "HttpError";
-        this.status = status;
-        this.body = body;
-    }
-}
-export class HttpTransport {
-    baseUrl;
-    fetcher;
-    getAccessToken;
-    onUnauthorized;
-    constructor(options = {}) {
-        this.baseUrl = resolveApiBaseUrl(options);
-        this.fetcher = options.fetch ?? fetch;
-        this.getAccessToken = options.getAccessToken;
-        this.onUnauthorized = options.onUnauthorized;
-    }
-    async withAuthorization(init) {
-        const headers = new Headers(init?.headers);
-        const token = this.getAccessToken ? await this.getAccessToken() : null;
-        if (token) {
-            headers.set("Authorization", `Bearer ${token}`);
-        }
-        else {
-            headers.delete("Authorization");
-        }
-        return {
-            ...init,
-            headers,
-        };
-    }
-    async send(path, init) {
-        const fetcher = init?.fetch ?? this.fetcher;
-        const url = this.baseUrl ? `${this.baseUrl}${path}` : path;
-        const response = await fetcher(url, await this.withAuthorization(init));
-        if (response.status === 401) {
-            await this.onUnauthorized?.();
-            throw new HttpError("unauthorized", 401, null);
-        }
-        if (!response.ok) {
-            const body = await responseBodyForError(response);
-            throw new HttpError(messageFromErrorBody(body, response.statusText), response.status, body);
-        }
-        return response;
-    }
-    async request(path, init) {
-        const response = await this.send(path, init);
-        if (response.status === 204) {
-            return null;
-        }
-        return response.json();
-    }
-    async raw(path, init) {
-        const response = await this.send(path, init);
-        return {
-            response,
-            blob: () => response.blob(),
-            arrayBuffer: () => response.arrayBuffer(),
-            text: () => response.text(),
-        };
-    }
-    async blob(path, init) {
-        const raw = await this.raw(path, init);
-        return raw.blob();
-    }
-}