@neta-art/cohub 2.7.1 → 2.9.0

package/dist/chunks/http.js

@@ -1,4 +1,4 @@
-import { r as getRealtimeSpaceRoom } from "./types.js";
+import { a as getRealtimeSpaceRoom, n as HttpTransport, t as HttpError } from "./transport.js";
 import { a as resolveApiBaseUrl } from "./environment.js";
 //#region src/apis/channels.ts
 var ChannelsApi = class {
@@ -99,7 +99,20 @@ function sleep(ms, signal) {
 	});
 }
 function isGenerationTaskResult(value) {
-	return !!value && typeof value === "object" && !Array.isArray(value) && typeof value.model === "string" && Array.isArray(value.output);
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const record = value;
+	if (typeof record.model !== "string" || !Array.isArray(record.output)) return false;
+	if (record.requestId !== void 0 && typeof record.requestId !== "string") return false;
+	if (record.cost !== void 0 && (typeof record.cost !== "number" || !Number.isFinite(record.cost))) return false;
+	if (record.billing !== void 0 && record.billing !== null) {
+		if (!record.billing || typeof record.billing !== "object" || Array.isArray(record.billing)) return false;
+		const billing = record.billing;
+		if (typeof billing.amountUsd !== "number" || !Number.isFinite(billing.amountUsd)) return false;
+		if (typeof billing.usageType !== "string") return false;
+		if (billing.status !== "recorded" && billing.status !== "overage" && billing.status !== "skipped") return false;
+		if (billing.reason !== void 0 && billing.reason !== null && typeof billing.reason !== "string") return false;
+	}
+	return true;
 }
 var GenerationsApi = class {
 	transport;
@@ -295,113 +308,6 @@ function ensureRealtimeConnected(websocketClient) {
 	});
 }
 //#endregion
-//#region src/transport.ts
-const responseBodyForError = async (response) => {
-	return (response.headers.get("content-type") ?? "").includes("application/json") ? await response.json().catch(() => null) : await response.text().catch(() => response.statusText);
-};
-const messageFromErrorBody = (body, fallback) => {
-	if (typeof body === "string") return body.trim() || fallback;
-	if (body && typeof body === "object") {
-		const errorBody = body;
-		if (typeof errorBody.message === "string" && errorBody.message.trim()) return errorBody.message;
-		if (typeof errorBody.error?.message === "string" && errorBody.error.message.trim()) return errorBody.error.message;
-	}
-	return fallback;
-};
-function errorCodeFromBody(body) {
-	if (!body || typeof body !== "object") return null;
-	const errorBody = body;
-	if (typeof errorBody.code === "string" && errorBody.code.trim()) return errorBody.code;
-	if (typeof errorBody.error?.code === "string" && errorBody.error.code.trim()) return errorBody.error.code;
-	return null;
-}
-var HttpError = class extends Error {
-	status;
-	body;
-	code;
-	constructor(message, status, body) {
-		super(message);
-		this.name = "HttpError";
-		this.status = status;
-		this.body = body;
-		this.code = errorCodeFromBody(body);
-	}
-};
-var HttpTransport = class {
-	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, tokenOverride) {
-		const headers = new Headers(init?.headers);
-		const token = tokenOverride ?? (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));
-		const getAccessToken = this.getAccessToken;
-		if (response.status === 401 && getAccessToken) {
-			const refreshedToken = await (async () => {
-				try {
-					return await getAccessToken({ forceRefresh: true });
-				} catch {
-					return null;
-				}
-			})();
-			if (refreshedToken) {
-				const retryResponse = await fetcher(url, await this.withAuthorization(init, refreshedToken));
-				if (retryResponse.status !== 401) {
-					if (!retryResponse.ok) {
-						const body = await responseBodyForError(retryResponse);
-						throw new HttpError(messageFromErrorBody(body, retryResponse.statusText), retryResponse.status, body);
-					}
-					return retryResponse;
-				}
-			}
-		}
-		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(),
-			json: () => response.json()
-		};
-	}
-	async blob(path, init) {
-		return (await this.raw(path, init)).blob();
-	}
-};
-//#endregion
 //#region src/session-patch-reducer.ts
 const blockSubPathPattern = /^\/message\/content\/blocks\/(\d+)\/(.+)$/;
 const blockPathPattern = /^\/message\/content\/blocks\/(\d+)$/;
@@ -1455,6 +1361,15 @@ var SpaceFilesApi = class {
 		const params = new URLSearchParams({ path });
 		return this.transport.request(`/api/spaces/${this.spaceId}/fs/file?${params.toString()}`, { fetch: customFetch });
 	}
+	/** Pending workspace changes vs the space head checkpoint. */
+	diff(customFetch) {
+		return this.transport.request(`/api/spaces/${this.spaceId}/fs/diff`, { fetch: customFetch });
+	}
+	/** Per-file pending workspace diff vs the space head checkpoint. */
+	diffFile(path, customFetch) {
+		const params = new URLSearchParams({ path });
+		return this.transport.request(`/api/spaces/${this.spaceId}/fs/diff/file?${params.toString()}`, { fetch: customFetch });
+	}
 	readMany(paths, customFetch) {
 		return this.transport.request(`/api/spaces/${this.spaceId}/fs/files`, {
 			method: "POST",
@@ -2222,16 +2137,80 @@ var SpaceCheckpointFilesApi = class {
 		return this.transport.request(`/api/spaces/${this.spaceId}/checkpoints/${this.checkpointId}/fs/file?${params.toString()}`, { fetch: customFetch });
 	}
 };
+async function hydrateCheckpointDiffSummary(summary, customFetch) {
+	if (summary.delivery !== "url" || !summary.url) return {
+		...summary,
+		delivery: summary.delivery ?? "inline"
+	};
+	const response = await (customFetch ?? fetch)(summary.url);
+	if (!response.ok) throw new HttpError(`Failed to load checkpoint diff (${response.status})`, response.status, null);
+	const body = await response.json();
+	return {
+		...body,
+		delivery: "inline",
+		url: summary.url,
+		precomputed: summary.precomputed ?? body.precomputed ?? true,
+		headCheckpointId: body.headCheckpointId || summary.headCheckpointId,
+		headCommitHash: body.headCommitHash || summary.headCommitHash,
+		baseCheckpointId: body.baseCheckpointId ?? summary.baseCheckpointId,
+		baseCommitHash: body.baseCommitHash ?? summary.baseCommitHash
+	};
+}
+async function hydrateCheckpointDiffFile(file, customFetch) {
+	if (file.delivery !== "url" || !file.url) return {
+		...file,
+		delivery: file.delivery ?? "inline"
+	};
+	if (file.kind !== "text") return {
+		...file,
+		delivery: file.delivery ?? "url"
+	};
+	const response = await (customFetch ?? fetch)(file.url);
+	if (!response.ok) throw new HttpError(`Failed to load file diff (${response.status})`, response.status, null);
+	const body = await response.json();
+	return {
+		...body,
+		path: body.path || file.path,
+		oldPath: body.oldPath ?? file.oldPath ?? null,
+		status: body.status ?? file.status,
+		kind: body.kind ?? file.kind,
+		delivery: "inline",
+		url: file.url
+	};
+}
+var SpaceCheckpointDiffApi = class {
+	transport;
+	spaceId;
+	checkpointId;
+	constructor(transport, spaceId, checkpointId) {
+		this.transport = transport;
+		this.spaceId = spaceId;
+		this.checkpointId = checkpointId;
+	}
+	async summary(options, customFetch) {
+		const params = new URLSearchParams();
+		if (options?.base) params.set("base", options.base);
+		const query = params.toString();
+		return hydrateCheckpointDiffSummary(await this.transport.request(`/api/spaces/${this.spaceId}/checkpoints/${this.checkpointId}/fs/diff${query ? `?${query}` : ""}`, { fetch: customFetch }), customFetch);
+	}
+	async file(path, options, customFetch) {
+		const params = new URLSearchParams({ path });
+		if (options?.base) params.set("base", options.base);
+		return hydrateCheckpointDiffFile(await this.transport.request(`/api/spaces/${this.spaceId}/checkpoints/${this.checkpointId}/fs/diff/file?${params.toString()}`, { fetch: customFetch }), customFetch);
+	}
+};
 var SpaceCheckpointApi = class {
 	transport;
 	spaceId;
 	id;
 	files;
+	diff;
 	constructor(transport, spaceId, id) {
 		this.transport = transport;
 		this.spaceId = spaceId;
 		this.id = id;
 		this.files = new SpaceCheckpointFilesApi(transport, spaceId, id);
+		this.diff = new SpaceCheckpointDiffApi(transport, spaceId, id);
 	}
 	get(customFetch) {
 		return this.transport.request(`/api/spaces/${this.spaceId}/checkpoints/${this.id}`, { fetch: customFetch });
@@ -2306,6 +2285,122 @@ var SpaceClient = class {
 			body: JSON.stringify(input)
 		});
 	}
+	/**
+	* Raw LLM completion. Caller fully controls messages and optional system prompt file.
+	* Non-streaming JSON response. Use `streamCompletion` for SSE.
+	*/
+	completion(input) {
+		return this.transport.request(`/api/spaces/${this.id}/completions`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				...input,
+				stream: false
+			})
+		});
+	}
+	/** Raw LLM completion with SSE events. Yields deltas; returns the final aggregated result. */
+	async *streamCompletion(input, options) {
+		const signal = options?.signal;
+		if (signal?.aborted) throw signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("aborted");
+		const raw = await this.transport.raw(`/api/spaces/${this.id}/completions`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Accept: "text/event-stream"
+			},
+			body: JSON.stringify({
+				...input,
+				stream: true
+			}),
+			signal
+		});
+		if (!(raw.response.headers.get("content-type") ?? "").includes("text/event-stream")) {
+			const body = await raw.json().catch(() => null);
+			if (body && typeof body === "object" && "completionId" in body) {
+				const result = body;
+				yield {
+					type: "done",
+					completionId: result.completionId,
+					message: result.message,
+					usage: result.usage
+				};
+				return result;
+			}
+			throw new HttpError(body && typeof body === "object" && typeof body.message === "string" ? body.message : "Unexpected completion response", raw.response.status, body);
+		}
+		if (!raw.response.body) throw new HttpError("Empty completion stream", 502, null);
+		const reader = raw.response.body.getReader();
+		const decoder = new TextDecoder();
+		let buffer = "";
+		let result = null;
+		let meta = null;
+		let lastUsage = null;
+		let readerReleased = false;
+		const releaseReader = async () => {
+			if (readerReleased) return;
+			readerReleased = true;
+			try {
+				await reader.cancel();
+			} catch {}
+		};
+		const onAbort = () => {
+			releaseReader();
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
+		const consume = (event) => {
+			if (event.type === "meta") meta = event;
+			if (event.type === "usage") lastUsage = event.usage;
+			if (event.type === "done") result = {
+				completionId: event.completionId,
+				provider: meta?.provider ?? "",
+				model: meta?.model ?? "",
+				systemPromptPath: meta?.systemPromptPath ?? null,
+				message: event.message,
+				usage: event.usage ?? lastUsage
+			};
+			if (event.type === "error") throw new HttpError(event.message, 502, event);
+		};
+		const parseDataLine = (chunk) => {
+			const dataLine = chunk.split("\n").map((line) => line.trimEnd()).find((line) => line.startsWith("data:"));
+			if (!dataLine) return null;
+			const payload = dataLine.slice(5).trim();
+			if (!payload || payload === "[DONE]") return null;
+			try {
+				return JSON.parse(payload);
+			} catch {
+				return null;
+			}
+		};
+		try {
+			while (true) {
+				if (signal?.aborted) throw signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("aborted");
+				const { done, value } = await reader.read();
+				if (done) break;
+				buffer += decoder.decode(value, { stream: true });
+				const chunks = buffer.split("\n\n");
+				buffer = chunks.pop() ?? "";
+				for (const chunk of chunks) {
+					const event = parseDataLine(chunk);
+					if (!event) continue;
+					consume(event);
+					yield event;
+				}
+			}
+			if (buffer.trim()) {
+				const event = parseDataLine(buffer);
+				if (event) {
+					consume(event);
+					yield event;
+				}
+			}
+			if (!result) throw new HttpError("Completion stream ended without a result", 502, null);
+			return result;
+		} finally {
+			signal?.removeEventListener("abort", onAbort);
+			await releaseReader();
+		}
+	}
 	update(input) {
 		return this.transport.request(`/api/spaces/${this.id}`, {
 			method: "PATCH",
@@ -2613,4 +2708,4 @@ var CohubHttpClient = class {
 };
 const createHttpClient = (options) => new CohubHttpClient(options);
 //#endregion
-export { ModelsApi as C, ChannelsApi as E, PromptsApi as S, CronJobsApi as T, ensureRealtimeConnected as _, UserApi as a, SearchApi as b, SpacesApi as c, createSessionGenerationStreamClient as d, parseAssistantMessageCommit as f, HttpTransport as g, HttpError as h, WorksApi as i, PublicInviteApi as l, createSessionPatchReducer as m, createHttpClient as n, TasksApi as o, SessionPatchReducer as p, WorkCommerceApi as r, SpaceClient as s, CohubHttpClient as t, SessionGenerationStreamClient as u, SessionAccessApi as v, GenerationsApi as w, PublicAssetsApi as x, ReferencesApi as y };
+export { CronJobsApi as C, GenerationsApi as S, ReferencesApi as _, UserApi as a, PromptsApi as b, SpacesApi as c, createSessionGenerationStreamClient as d, parseAssistantMessageCommit as f, SessionAccessApi as g, ensureRealtimeConnected as h, WorksApi as i, PublicInviteApi as l, createSessionPatchReducer as m, createHttpClient as n, TasksApi as o, SessionPatchReducer as p, WorkCommerceApi as r, SpaceClient as s, CohubHttpClient as t, SessionGenerationStreamClient as u, SearchApi as v, ChannelsApi as w, ModelsApi as x, PublicAssetsApi as y };

package/dist/chunks/transport.js

@@ -0,0 +1,143 @@
+import { a as resolveApiBaseUrl } from "./environment.js";
+//#region ../protocol/src/realtime/types.ts
+const WS_COMPACT_STREAM_CAPABILITY = "session.compact_stream.v1";
+const WS_ROOM_SUBSCRIPTION_CAPABILITY = "realtime.rooms.v1";
+const getRealtimeSpaceRoom = (spaceId) => `space:${spaceId}`;
+const parseRealtimeRoom = (room) => {
+	const trimmed = room.trim();
+	const separatorIndex = trimmed.indexOf(":");
+	if (separatorIndex <= 0) return null;
+	const kind = trimmed.slice(0, separatorIndex);
+	const id = trimmed.slice(separatorIndex + 1).trim();
+	if (!id) return null;
+	if (kind !== "space" && kind !== "user") return null;
+	return {
+		kind,
+		id
+	};
+};
+const normalizeRealtimeRooms = (rooms) => {
+	const normalized = /* @__PURE__ */ new Set();
+	for (const room of rooms) {
+		const parsed = typeof room === "string" ? parseRealtimeRoom(room) : null;
+		if (!parsed) continue;
+		normalized.add(`${parsed.kind}:${parsed.id}`);
+	}
+	return [...normalized];
+};
+const getNonEmptyString = (value) => typeof value === "string" && value.trim() ? value : null;
+const getSessionTurnPatchStreamKey = (input, options = {}) => {
+	const turnId = getNonEmptyString(input.turnId);
+	const messageKey = getNonEmptyString(input.messageId) ?? getNonEmptyString(input.sourceMessageId) ?? getNonEmptyString(input.anchorUserMessageId) ?? (typeof input.messageOrdinal === "number" && Number.isFinite(input.messageOrdinal) ? `ordinal:${input.messageOrdinal}` : null);
+	if (turnId && messageKey) return `${turnId}:${messageKey}`;
+	const streamKey = messageKey ?? turnId;
+	if (streamKey) return streamKey;
+	return options.includeSessionFallback ? getNonEmptyString(input.sessionId) : null;
+};
+//#endregion
+//#region src/transport.ts
+const responseBodyForError = async (response) => {
+	return (response.headers.get("content-type") ?? "").includes("application/json") ? await response.json().catch(() => null) : await response.text().catch(() => response.statusText);
+};
+const messageFromErrorBody = (body, fallback) => {
+	if (typeof body === "string") return body.trim() || fallback;
+	if (body && typeof body === "object") {
+		const errorBody = body;
+		if (typeof errorBody.message === "string" && errorBody.message.trim()) return errorBody.message;
+	}
+	return fallback;
+};
+function errorCodeFromBody(body) {
+	if (!body || typeof body !== "object") return null;
+	const errorBody = body;
+	if (typeof errorBody.code === "string" && errorBody.code.trim()) return errorBody.code;
+	return null;
+}
+var HttpError = class extends Error {
+	status;
+	body;
+	code;
+	constructor(message, status, body) {
+		super(message);
+		this.name = "HttpError";
+		this.status = status;
+		this.body = body;
+		this.code = errorCodeFromBody(body);
+	}
+};
+var HttpTransport = class {
+	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, tokenOverride) {
+		const headers = new Headers(init?.headers);
+		const token = tokenOverride ?? (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));
+		const getAccessToken = this.getAccessToken;
+		if (response.status === 401 && getAccessToken) {
+			const refreshedToken = await (async () => {
+				try {
+					return await getAccessToken({ forceRefresh: true });
+				} catch {
+					return null;
+				}
+			})();
+			if (refreshedToken) {
+				const retryResponse = await fetcher(url, await this.withAuthorization(init, refreshedToken));
+				if (retryResponse.status !== 401) {
+					if (!retryResponse.ok) {
+						const body = await responseBodyForError(retryResponse);
+						throw new HttpError(messageFromErrorBody(body, retryResponse.statusText), retryResponse.status, body);
+					}
+					return retryResponse;
+				}
+			}
+		}
+		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(),
+			json: () => response.json()
+		};
+	}
+	async blob(path, init) {
+		return (await this.raw(path, init)).blob();
+	}
+};
+//#endregion
+export { getRealtimeSpaceRoom as a, WS_ROOM_SUBSCRIPTION_CAPABILITY as i, HttpTransport as n, getSessionTurnPatchStreamKey as o, WS_COMPACT_STREAM_CAPABILITY as r, normalizeRealtimeRooms as s, HttpError as t };