@neta-art/cohub 1.3.0 → 1.4.0

package/dist/apis/spaces.d.ts

@@ -2,7 +2,7 @@ import type { SpacePublicEndpoints } from "@neta-art/cohub-protocol/ports";
 import type { WebsocketClient, WebsocketEventPayload } from "../websocket.js";
 import type { HttpTransport, Fetch } from "../transport.js";
 import { type SessionPatchApplyResult } from "../session-patch-reducer.js";
-import type { CheckpointRecord, ContentBlock, SessionMessageResponse, SessionMessagesPaginatedResponse, SessionMessagesResponse, SessionTurnResponse, SessionTurnIndexResponse, SessionTurnWindowResponse, SessionTurnsPaginatedResponse, SessionTurnSignedUrlsResponse, SessionRecord, SpaceAccessPolicy, SpaceBootstrapSource, SpaceChannelBindingInput, SpaceCheckpointDetailResponse, SpaceCreateResponse, SpaceEnvInput, SpaceFsFileResponse, SpaceFsMoveInput, SpaceFsTreeResponse, SpaceFsUploadResponse, SpaceUsageResponse, SpaceFsWriteFileInput, SpaceMarkKind, SpaceMarkListItem, SpaceMarkResourceType, SpaceMember, SpaceRecord, SpaceRole, SpaceSessionsResponse } from "../types.js";
+import type { CheckpointRecord, ContentBlock, SessionMessageResponse, SessionMessagesPaginatedResponse, SessionMessagesResponse, SessionTurnResponse, SessionTurnStreamSnapshotResponse, SessionTurnIndexResponse, SessionTurnWindowResponse, SessionTurnsPaginatedResponse, SessionTurnSignedUrlsResponse, SessionRecord, SpaceAccessPolicy, SpaceBootstrapSource, SpaceChannelBindingInput, SpaceCheckpointDetailResponse, SpaceCreateResponse, SpaceEnvInput, SpaceFsCompleteUploadInput, SpaceFsCompleteUploadResponse, SpaceFsCreateUploadInput, SpaceFsCreateUploadResponse, SpaceFsFileResponse, SpaceFsMoveInput, SpaceFsTreeResponse, SpaceFsUploadResponse, SpaceUsageResponse, SpaceFsWriteFileInput, SpaceMarkKind, SpaceMarkListItem, SpaceMarkResourceType, SpaceMember, SpaceRecord, SpaceRole, SpaceSessionsResponse } from "../types.js";
 import { SpaceInvitationsApi } from "./invitations.js";
 export type SessionSubscriptionHandlers = {
     patch?: (event: WebsocketEventPayload) => void;
@@ -75,6 +75,8 @@ export declare class SpaceFilesApi {
         toPath: string;
     }>;
     upload(files: File[], dir?: string): Promise<SpaceFsUploadResponse>;
+    createUpload(input: SpaceFsCreateUploadInput): Promise<SpaceFsCreateUploadResponse>;
+    completeUpload(uploadId: string, input: SpaceFsCompleteUploadInput): Promise<SpaceFsCompleteUploadResponse>;
 }
 declare class SessionMessagesClient {
     private readonly transport;
@@ -117,6 +119,7 @@ declare class SessionTurnsClient {
         before?: number;
         after?: number;
     }, customFetch?: Fetch): Promise<SessionTurnWindowResponse>;
+    streamSnapshot(customFetch?: Fetch): Promise<SessionTurnStreamSnapshotResponse>;
     get(turnId: string, customFetch?: Fetch): Promise<SessionTurnResponse>;
     signedUrls(turnId: string, objectKeys: string[]): Promise<SessionTurnSignedUrlsResponse>;
 }

package/dist/apis/spaces.js

@@ -169,6 +169,20 @@ export class SpaceFilesApi {
             body: formData,
         });
     }
+    createUpload(input) {
+        return this.transport.request(`/api/spaces/${this.spaceId}/fs/uploads`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(input),
+        });
+    }
+    completeUpload(uploadId, input) {
+        return this.transport.request(`/api/spaces/${this.spaceId}/fs/uploads/${uploadId}/complete`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(input),
+        });
+    }
 }
 class SessionMessagesClient {
     transport;
@@ -273,6 +287,9 @@ class SessionTurnsClient {
         const query = params.toString();
         return this.transport.request(`/api/sessions/${this.sessionId}/turns/window${query ? `?${query}` : ""}`, { fetch: customFetch });
     }
+    streamSnapshot(customFetch) {
+        return this.transport.request(`/api/sessions/${this.sessionId}/turns/stream-snapshot`, { fetch: customFetch });
+    }
     get(turnId, customFetch) {
         return this.transport.request(`/api/sessions/${this.sessionId}/turns/${turnId}`, { fetch: customFetch });
     }

package/dist/apis/tasks.d.ts

@@ -1,11 +1,9 @@
 import type { HttpTransport } from "../transport.js";
-import type { CreateScheduledTaskInput, TaskRunRecord } from "../types.js";
+import type { CreateScheduledTaskInput, TaskRunDetailResponse, TaskRunRecord } from "../types.js";
 export declare class TasksApi {
     private readonly transport;
     constructor(transport: HttpTransport);
-    get(taskRunId: string): Promise<{
-        run: TaskRunRecord;
-    }>;
+    get(taskRunId: string): Promise<TaskRunDetailResponse>;
     list(filters?: {
         cronJobId?: string;
         spaceId?: string;

package/dist/apis/user.d.ts

@@ -1,12 +1,18 @@
 import { type HttpTransport, type Fetch } from "../transport.js";
-import type { UserRulesResponse, UserSshKey } from "../types.js";
+import type { MeResponse, UserProfile, UserRulesResponse, UserSshKey } from "../types.js";
 export declare class UserApi {
     private readonly transport;
     private readonly transportBaseUrl;
     private readonly setStoredAuthToken?;
     private readonly clearStoredAuthToken?;
     constructor(transport: HttpTransport, transportBaseUrl: string, setStoredAuthToken?: ((token: string) => void) | undefined, clearStoredAuthToken?: (() => void) | undefined);
-    getMe(customFetch?: Fetch): Promise<unknown>;
+    getMe(customFetch?: Fetch): Promise<MeResponse>;
+    updateProfile(input: {
+        displayName?: string;
+        avatarUrl?: string | null;
+    }): Promise<{
+        profile: UserProfile;
+    }>;
     getRules(customFetch?: Fetch): Promise<UserRulesResponse>;
     setAuthToken(token: string): Promise<any>;
     clearAuthToken(): Promise<null>;

package/dist/apis/user.js

@@ -13,6 +13,13 @@ export class UserApi {
     getMe(customFetch) {
         return this.transport.request("/api/me", { fetch: customFetch });
     }
+    updateProfile(input) {
+        return this.transport.request("/api/me/profile", {
+            method: "PATCH",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(input),
+        });
+    }
     getRules(customFetch) {
         return this.transport.request("/api/me/rules", {
             method: "GET",

package/dist/session-patch-reducer.d.ts

@@ -28,6 +28,13 @@ export type SessionPatchApplyResult = {
     reason: "duplicate" | "version_mismatch" | "invalid";
     state: SessionPatchState;
 };
+export type SessionPatchSnapshotInput = SessionPatchKeyInput & {
+    turnId?: string | null;
+    seq: number;
+    contentBlocks: ContentBlock[];
+    anchorUserMessageId?: string | null;
+    appendPath?: string | null;
+};
 type SessionPatchKeyInput = {
     spaceId?: string | null;
     sessionId: string;
@@ -44,6 +51,7 @@ export declare class SessionPatchReducer {
     complete(input: SessionPatchKeyInput): SessionPatchState;
     fail(input: SessionPatchKeyInput): SessionPatchState;
     reset(input: SessionPatchKeyInput): void;
+    applySnapshot(input: SessionPatchSnapshotInput): SessionPatchApplyResult;
     resetAll(): void;
     applyEvent(event: SessionTurnPatchEvent): SessionPatchApplyResult;
     applyPatch(input: SessionPatchApplyInput): SessionPatchApplyResult;

package/dist/session-patch-reducer.js

@@ -1,7 +1,6 @@
-const blockTextPathPattern = /^\/message\/content\/blocks\/(\d+)\/(text|thinking)$/;
+const blockSubPathPattern = /^\/message\/content\/blocks\/(\d+)\/(.+)$/;
 const blockPathPattern = /^\/message\/content\/blocks\/(\d+)$/;
 const blockMetaPathPattern = /^\/message\/content\/blocks\/(\d+)\/_meta$/;
-const blockSignaturePathPattern = /^\/message\/content\/blocks\/(\d+)\/signature$/;
 const createIdleState = (input) => ({
     spaceId: input.spaceId ?? null,
     sessionId: input.sessionId,
@@ -38,6 +37,14 @@ function sortBlocksByStreamIndex(blocks) {
 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;
@@ -62,21 +69,103 @@ function ensureTextLikeBlock(blocks, streamIndex, field) {
     blocks.push(block);
     return block;
 }
-function appendTextLikeValue(blocks, path, value) {
-    const match = path.match(blockTextPathPattern);
-    if (!match || typeof value !== "string")
+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;
-    const streamIndex = Number(match[1]);
-    const field = match[2];
-    const block = ensureTextLikeBlock(blocks, streamIndex, field);
-    if (field === "text" && block.type === "text") {
-        block.text += value;
+    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;
     }
-    if (field === "thinking" && block.type === "thinking") {
-        block.thinking += value;
+    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;
@@ -84,7 +173,7 @@ function applyPatchOpsToBlocks(current, ops, initialAppendPath) {
     let failed = false;
     for (const op of ops) {
         if (!op.o && !op.p) {
-            if (!appendPath || !appendTextLikeValue(next, appendPath, op.v)) {
+            if (!appendPath || !appendPatchStreamValue(next, appendPath, op.v)) {
                 failed = true;
                 break;
             }
@@ -98,7 +187,7 @@ function applyPatchOpsToBlocks(current, ops, initialAppendPath) {
             continue;
         }
         if (op.o === "append") {
-            if (!appendTextLikeValue(next, op.p, op.v)) {
+            if (typeof op.p !== "string" || !appendPatchStreamValue(next, op.p, op.v)) {
                 failed = true;
                 break;
             }
@@ -118,15 +207,15 @@ function applyPatchOpsToBlocks(current, ops, initialAppendPath) {
             continue;
         }
         if (op.o === "replace") {
-            const match = op.p.match(blockSignaturePathPattern);
-            if (match) {
-                if (typeof op.v !== "string")
+            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;
-                const blockIndex = findBlockByStreamIndex(next, Number(match[1]));
-                const block = blockIndex >= 0 ? next[blockIndex] : undefined;
-                if (block?.type === "thinking")
-                    block.signature = op.v;
-                continue;
+                }
+                failed = true;
+                break;
             }
         }
         if (op.o === "replace" || op.o === "add") {
@@ -219,6 +308,28 @@ export class SessionPatchReducer {
     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);
+        if (!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();
     }

package/dist/types.d.ts

@@ -6,6 +6,17 @@ export type { ChannelConfig, DiscordChannelConfig, } from "@neta-art/cohub-proto
 export type ApiError = {
     message: string;
 };
+export type UserProfile = {
+    userUuid: string;
+    logtoUserId?: string;
+    displayName: string;
+    avatarUrl: string | null;
+    syncedAt?: string;
+};
+export type MeResponse = {
+    uuid: string;
+    profile: UserProfile;
+};
 export type UserRulesResponse = {
     content: string;
     updatedAt: string | null;
@@ -55,13 +66,55 @@ export type SpaceFsUploadEntry = {
 };
 export type SpaceFsUploadError = {
     name: string;
-    code: "file_too_large" | "name_invalid" | "write_failed";
+    code: "file_too_large" | "name_invalid" | "path_invalid" | "write_failed" | "object_missing";
     message: string;
 };
 export type SpaceFsUploadResponse = {
     uploaded: SpaceFsUploadEntry[];
     errors: SpaceFsUploadError[];
 };
+export type SpaceFsUploadPlanEntryInput = {
+    id: string;
+    name: string;
+    relativePath: string;
+    size: number;
+    mimeType?: string | null;
+    lastModified?: number;
+};
+export type SpaceFsCreateUploadInput = {
+    targetDir?: string;
+    entries: SpaceFsUploadPlanEntryInput[];
+};
+export type SpaceFsUploadPlanEntry = {
+    id: string;
+    objectKey: string;
+    uploadUrl: string;
+    headers?: Record<string, string>;
+};
+export type SpaceFsCreateUploadResponse = {
+    uploadId: string;
+    expiresAt: string;
+    entries: SpaceFsUploadPlanEntry[];
+};
+export type SpaceFsCompleteUploadInput = {
+    entries: Array<{
+        id: string;
+        etag?: string | null;
+    }>;
+};
+export type SpaceFsCompleteUploadResponse = {
+    ok: true;
+    taskRunId: string;
+};
+export type SpaceFsUploadProgress = {
+    phase: "queued" | "importing" | "done" | "failed";
+    totalFiles: number;
+    importedFiles: number;
+    totalBytes: number;
+    importedBytes: number;
+    currentPath?: string;
+    errors: SpaceFsUploadError[];
+};
 export type SessionBindingRecord = ProtocolSessionBindingRecord;
 export type SessionRecord = ProtocolSessionRecord & {
     bindings?: SessionBindingRecord[];
@@ -154,6 +207,28 @@ export type SessionTurnResponse = {
 export type SessionTurnSignedUrlsResponse = {
     urls: Record<string, string>;
 };
+export type SessionTurnStreamSnapshotResponse = {
+    snapshot: {
+        version: 2;
+        spaceId: string;
+        sessionId: string;
+        turnId: string | null;
+        anchorUserMessageId: string | null;
+        seq: number;
+        current: {
+            messageId: string | null;
+            messageOrdinal: number | null;
+            content: ContentBlock[];
+            appendPath: string | null;
+        };
+        intermediateMessages: Array<{
+            messageId: string | null;
+            messageOrdinal: number | null;
+            content: ContentBlock[];
+        }>;
+        updatedAt: number;
+    } | null;
+};
 export type ModelCatalogEntry = {
     provider: string;
     id: string;
@@ -220,6 +295,10 @@ export type CronJobRecord = {
     createdAt: string;
     updatedAt: string;
 };
+export type TaskRunDetailResponse = {
+    run: TaskRunRecord;
+    progress: unknown;
+};
 export type TaskRunRecord = {
     id: string;
     jobId: string;
@@ -272,6 +351,7 @@ export type SpaceRole = "host" | "builder" | "guest";
 export type SpaceMember = {
     userId: string;
     role: SpaceRole;
+    profile: UserProfile;
     createdAt: string;
     updatedAt: string;
 };

package/dist/websocket.js

@@ -610,6 +610,19 @@ export class WebsocketClient {
         });
         if (this.manuallyClosed)
             return;
+        if (typeof navigator !== "undefined" && navigator.onLine === false) {
+            await new Promise((resolve) => {
+                const fallbackTimer = setTimeout(resolve, this.reconnectMaxDelayMs);
+                const handleOnline = () => {
+                    clearTimeout(fallbackTimer);
+                    globalThis.removeEventListener?.("online", handleOnline);
+                    resolve();
+                };
+                globalThis.addEventListener?.("online", handleOnline, { once: true });
+            });
+            if (this.manuallyClosed)
+                return;
+        }
         await this.connect().catch((error) => {
             this.emit("error", { error, recoverable: true });
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Cohub SDK for spaces, sessions, checkpoints, and realtime agent collaboration.",
   "license": "UNLICENSED",
   "private": false,
@@ -44,7 +44,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@neta-art/cohub-protocol": "1.2.2"
+    "@neta-art/cohub-protocol": "1.2.3"
   },
   "devDependencies": {
     "typescript": "^6.0.3"