@neta-art/cohub 1.16.1 → 1.17.0

package/dist/chunks/http.d.ts

@@ -1300,7 +1300,7 @@ type GenerationStreamIntermediateMessage = {
 };
 type GenerationStreamStateEvent = {
   type: "state";
-  source: "snapshot" | "patch" | "progress";
+  source: "patch";
   state: SessionPatchState;
   messageId: string | null;
   messageOrdinal: number | null;
@@ -1329,7 +1329,7 @@ type GenerationStreamErrorEvent = {
 };
 type GenerationStreamOutOfSyncEvent = {
   type: "out_of_sync";
-  source: "snapshot" | "patch";
+  source: "patch";
   reason: "duplicate" | "version_mismatch" | "invalid";
   state: SessionPatchState;
   rawEvent: WebsocketEventPayload;
@@ -1353,7 +1353,7 @@ declare class SessionGenerationStreamClient {
   private messageId;
   private messageOrdinal;
   private intermediateMessages;
-  private progressState;
+  private patchState;
   constructor(websocketClient: WebsocketClient | null, spaceId: string, sessionId: string);
   subscribe(handlers: GenerationStreamSubscriptionHandlers): () => void;
   private emit;
@@ -1362,9 +1362,7 @@ declare class SessionGenerationStreamClient {
   private addIntermediateMessage;
   private handleAppliedState;
   private prepareMessageBoundary;
-  private handleSnapshot;
   private handlePatch;
-  private handleProgress;
   private handlePersisted;
   private handleFinalized;
   private handleEvent;
@@ -1397,23 +1395,16 @@ declare class PublicInviteApi {
 //#endregion
 //#region src/apis/spaces.d.ts
 type SessionSubscriptionHandlers = {
-  patch?: (event: WebsocketEventPayload) => void;
-  /**
-   * @deprecated Use `session.subscribeGeneration({ state })` for normalized
-   * snapshot/patch/progress generation state.
-   */
-  patchState?: (result: SessionPatchApplyResult) => void; /** @deprecated Use `session.subscribeGeneration({ state })`. */
-  snapshot?: (event: WebsocketEventPayload) => void; /** @deprecated Legacy progress events are normalized by `subscribeGeneration`. */
-  progress?: (event: WebsocketEventPayload) => void; /** @deprecated Use `session.subscribeGeneration({ commit, finalized })`. */
-  final?: (event: WebsocketEventPayload) => void;
+  patch?: (event: WebsocketEventPayload) => void; /** @deprecated Use `session.subscribeGeneration({ state })`. */
+  patchState?: (result: SessionPatchApplyResult) => void;
   turnUpdated?: (event: WebsocketEventPayload) => void;
   turnFinalized?: (event: WebsocketEventPayload) => void;
   error?: (event: WebsocketEventPayload) => void;
   persisted?: (event: WebsocketEventPayload) => void;
   event?: (event: WebsocketEventPayload) => void;
 };
-type SessionEventName = "turn.patch" | "turn.snapshot" | "turn.progress" | "turn.final" | "turn.updated" | "turn.error" | "message.persisted";
-type SpaceEventName = SessionEventName | "ports.changed" | "event";
+type SessionEventName = "created" | "updated" | "turn.created" | "turn.patch" | "turn.updated" | "turn.finalized" | "turn.error" | "message.persisted";
+type SpaceEventName = SessionEventName | "ports.changed" | "task.created" | "task.updated" | "event";
 type SessionSendMessageInput = {
   content: ContentBlock[];
   model?: string;

package/dist/chunks/http.js

@@ -320,7 +320,7 @@ const createIdleState = (input) => ({
 function cloneBlock(block) {
 	return structuredClone(block);
 }
-function getStreamIndex$1(block) {
+function getStreamIndex(block) {
 	const value = block._meta?.streamIndex;
 	return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
@@ -331,19 +331,19 @@ function blockIdentityCompatible(prev, next) {
 	return true;
 }
 function findBlockByStreamIndex(blocks, streamIndex) {
-	return blocks.findIndex((block) => getStreamIndex$1(block) === streamIndex);
+	return blocks.findIndex((block) => getStreamIndex(block) === streamIndex);
 }
 function findBlockForReplacement(blocks, streamIndex, nextBlock) {
-	const compatibleIndex = blocks.findIndex((block) => getStreamIndex$1(block) === streamIndex && blockIdentityCompatible(block, nextBlock));
+	const compatibleIndex = blocks.findIndex((block) => getStreamIndex(block) === streamIndex && blockIdentityCompatible(block, nextBlock));
 	if (compatibleIndex >= 0) return compatibleIndex;
-	const sameStreamIndex = blocks.findIndex((block) => getStreamIndex$1(block) === streamIndex);
+	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$1(a);
-		const bIndex = getStreamIndex$1(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;
@@ -697,14 +697,6 @@ const createSessionPatchReducer = () => new SessionPatchReducer();
 //#region src/session-generation-stream.ts
 const isRecord = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
 const isContentBlockArray = (value) => Array.isArray(value) && value.every((item) => isRecord(item) && typeof item.type === "string");
-const stringField = (record, key) => {
-	const value = record[key];
-	return typeof value === "string" ? value : null;
-};
-const numberField = (record, key) => {
-	const value = record[key];
-	return typeof value === "number" && Number.isFinite(value) ? value : null;
-};
 const getMessageKind = (message) => {
 	const kind = message.meta?.messageKind;
 	return typeof kind === "string" ? kind : null;
@@ -737,68 +729,6 @@ function parseAssistantMessageCommit(message) {
 		isFinal: false
 	};
 }
-function cloneContentBlock(block) {
-	return structuredClone(block);
-}
-function getStreamIndex(block) {
-	const value = block._meta?.streamIndex;
-	return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function findMergeTargetIndex(result, block) {
-	const streamIndex = getStreamIndex(block);
-	if (streamIndex != null) return result.findIndex((existing) => existing.type === block.type && getStreamIndex(existing) === streamIndex);
-	if (block.type === "tool_use") return result.findIndex((existing) => existing.type === "tool_use" && existing.id === block.id);
-	if (block.type === "tool_result") return result.findIndex((existing) => existing.type === "tool_result" && existing.tool_use_id === block.tool_use_id);
-	return -1;
-}
-function mergeStreamingDeltaBlocks(existing, delta) {
-	if (delta.length === 0) return existing;
-	const result = existing.map(cloneContentBlock);
-	for (const block of delta) {
-		const targetIndex = findMergeTargetIndex(result, block);
-		if (targetIndex === -1) {
-			result.push(cloneContentBlock(block));
-			continue;
-		}
-		const target = result[targetIndex];
-		if (block.type === "text" && target?.type === "text") {
-			target.text += block.text;
-			continue;
-		}
-		if (block.type === "thinking" && target?.type === "thinking") {
-			target.thinking += block.thinking;
-			if (block.signature) target.signature = block.signature;
-			if (block._meta) target._meta = {
-				...target._meta ?? {},
-				...block._meta
-			};
-			continue;
-		}
-		result[targetIndex] = Object.assign(target ?? {}, cloneContentBlock(block));
-	}
-	return result;
-}
-function parseSnapshotMessage(value) {
-	if (!isRecord(value) || !isContentBlockArray(value.content)) return null;
-	return {
-		messageId: stringField(value, "messageId"),
-		messageOrdinal: numberField(value, "messageOrdinal"),
-		content: value.content,
-		...typeof value.id === "string" ? { id: value.id } : {},
-		...typeof value.sessionId === "string" ? { sessionId: value.sessionId } : {},
-		...value.role === "user" || value.role === "assistant" || value.role === "system" ? { role: value.role } : {},
-		...typeof value.text === "string" ? { text: value.text } : {},
-		...typeof value.provider === "string" ? { provider: value.provider } : {},
-		...typeof value.model === "string" ? { model: value.model } : {},
-		...typeof value.stopReason === "string" ? { stopReason: value.stopReason } : {},
-		...typeof value.errorMessage === "string" ? { errorMessage: value.errorMessage } : {},
-		...isRecord(value.usage) ? { usage: value.usage } : {},
-		...typeof value.durationMs === "number" ? { durationMs: value.durationMs } : {},
-		...typeof value.toolCallsObjectKey === "string" ? { toolCallsObjectKey: value.toolCallsObjectKey } : {},
-		...isRecord(value.meta) ? { meta: value.meta } : {},
-		...typeof value.createdAt === "string" ? { createdAt: value.createdAt } : {}
-	};
-}
 function messageRecordToIntermediate(message) {
 	if (!isContentBlockArray(message.content) || message.content.length === 0) return null;
 	const meta = isRecord(message.meta) ? message.meta : {};
@@ -838,7 +768,7 @@ var SessionGenerationStreamClient = class SessionGenerationStreamClient {
 	messageId = null;
 	messageOrdinal = null;
 	intermediateMessages = [];
-	progressState = null;
+	patchState = null;
 	constructor(websocketClient, spaceId, sessionId) {
 		this.websocketClient = websocketClient;
 		this.spaceId = spaceId;
@@ -866,7 +796,7 @@ var SessionGenerationStreamClient = class SessionGenerationStreamClient {
 	resetCurrentMessage() {
 		this.messageId = null;
 		this.messageOrdinal = null;
-		this.progressState = null;
+		this.patchState = null;
 	}
 	appendCurrentMessage(state) {
 		if (state.contentBlocks.length === 0) return;
@@ -894,14 +824,14 @@ var SessionGenerationStreamClient = class SessionGenerationStreamClient {
 		if (!result.applied) {
 			this.emit(handlers, {
 				type: "out_of_sync",
-				source: source === "progress" ? "patch" : source,
+				source,
 				reason: result.reason,
 				state: result.state,
 				rawEvent
 			});
 			return;
 		}
-		this.progressState = result.state;
+		this.patchState = result.state;
 		this.messageId = messageId;
 		this.messageOrdinal = messageOrdinal;
 		this.emit(handlers, {
@@ -915,7 +845,7 @@ var SessionGenerationStreamClient = class SessionGenerationStreamClient {
 		});
 	}
 	prepareMessageBoundary(input) {
-		const current = this.progressState ?? this.reducer.get({
+		const current = this.patchState ?? this.reducer.get({
 			spaceId: this.spaceId,
 			sessionId: this.sessionId
 		});
@@ -947,45 +877,6 @@ var SessionGenerationStreamClient = class SessionGenerationStreamClient {
 		}
 		return nextMessageId;
 	}
-	handleSnapshot(event, handlers) {
-		const payload = event.payload;
-		const current = isRecord(payload.current) ? payload.current : null;
-		const content = current ? current.content : null;
-		const seq = typeof payload.seq === "number" ? payload.seq : null;
-		if (!current || !isContentBlockArray(content) || seq === null) {
-			this.emit(handlers, {
-				type: "out_of_sync",
-				source: "snapshot",
-				reason: "invalid",
-				state: this.reducer.get({
-					spaceId: this.spaceId,
-					sessionId: this.sessionId
-				}),
-				rawEvent: event
-			});
-			return;
-		}
-		const turnId = typeof payload.turnId === "string" ? payload.turnId : null;
-		const anchorUserMessageId = typeof payload.anchorUserMessageId === "string" ? payload.anchorUserMessageId : null;
-		const messageOrdinal = numberField(current, "messageOrdinal");
-		const messageId = this.prepareMessageBoundary({
-			turnId,
-			messageId: stringField(current, "messageId"),
-			messageOrdinal,
-			anchorUserMessageId
-		});
-		this.intermediateMessages = Array.isArray(payload.intermediateMessages) ? payload.intermediateMessages.map(parseSnapshotMessage).filter((message) => message !== null) : [];
-		const result = this.reducer.applySnapshot({
-			spaceId: this.spaceId,
-			sessionId: this.sessionId,
-			turnId,
-			seq,
-			contentBlocks: content,
-			anchorUserMessageId,
-			appendPath: stringField(current, "appendPath")
-		});
-		this.handleAppliedState(handlers, "snapshot", result, event, messageId, messageOrdinal);
-	}
 	handlePatch(event, handlers) {
 		const payload = event.payload;
 		const seq = typeof payload.seq === "number" ? payload.seq : null;
@@ -1024,45 +915,6 @@ var SessionGenerationStreamClient = class SessionGenerationStreamClient {
 		const result = this.reducer.applyPatch(input);
 		this.handleAppliedState(handlers, "patch", result, event, messageId, messageOrdinal);
 	}
-	handleProgress(event, handlers) {
-		const payload = event.payload;
-		if (!isContentBlockArray(payload.content)) return;
-		const current = this.progressState ?? this.reducer.get({
-			spaceId: this.spaceId,
-			sessionId: this.sessionId
-		});
-		const turnId = typeof payload.turnId === "string" ? payload.turnId : current.turnId;
-		const anchorUserMessageId = typeof payload.anchorUserMessageId === "string" ? payload.anchorUserMessageId : current.anchorUserMessageId;
-		const messageOrdinal = typeof payload.messageOrdinal === "number" ? payload.messageOrdinal : this.messageOrdinal;
-		const messageId = this.prepareMessageBoundary({
-			turnId,
-			messageId: typeof payload.messageId === "string" ? payload.messageId : this.messageId,
-			messageOrdinal,
-			anchorUserMessageId
-		});
-		const base = this.progressState?.turnId === turnId ? this.progressState : current;
-		const state = {
-			...base,
-			spaceId: this.spaceId,
-			sessionId: this.sessionId,
-			status: "streaming",
-			contentBlocks: mergeStreamingDeltaBlocks(base.contentBlocks, payload.content),
-			anchorUserMessageId,
-			turnId
-		};
-		this.progressState = state;
-		this.messageId = messageId;
-		this.messageOrdinal = messageOrdinal;
-		this.emit(handlers, {
-			type: "state",
-			source: "progress",
-			state,
-			messageId,
-			messageOrdinal,
-			intermediateMessages: [...this.intermediateMessages],
-			rawEvent: event
-		});
-	}
 	handlePersisted(event, handlers) {
 		const message = event.payload.message;
 		if (!isRecord(message)) return;
@@ -1121,15 +973,9 @@ var SessionGenerationStreamClient = class SessionGenerationStreamClient {
 	}
 	handleEvent(event, handlers) {
 		switch (event.type) {
-			case "session.turn.snapshot":
-				this.handleSnapshot(event, handlers);
-				return;
 			case "session.turn.patch":
 				this.handlePatch(event, handlers);
 				return;
-			case "session.turn.progress":
-				this.handleProgress(event, handlers);
-				return;
 			case "session.message.persisted":
 				this.handlePersisted(event, handlers);
 				return;
@@ -1217,12 +1063,13 @@ const getFilenameFromContentDisposition = (value) => {
 };
 const toSessionEventName = (type) => {
 	switch (type) {
+		case "session.created": return "created";
+		case "session.updated": return "updated";
+		case "session.turn.created": return "turn.created";
 		case "session.turn.patch": return "turn.patch";
-		case "session.turn.snapshot": return "turn.snapshot";
-		case "session.turn.progress": return "turn.progress";
 		case "session.turn.error": return "turn.error";
 		case "session.turn.updated": return "turn.updated";
-		case "session.turn.finalized": return "turn.final";
+		case "session.turn.finalized": return "turn.finalized";
 		case "session.message.persisted": return "message.persisted";
 		default: return null;
 	}
@@ -1500,8 +1347,6 @@ var SessionRealtimeClient = class {
 					}));
 				}
 			}
-			if (eventName === "turn.snapshot") handlers.snapshot?.(event);
-			if (eventName === "turn.progress") handlers.progress?.(event);
 			if (eventName === "turn.error") {
 				this.patchReducer.fail({
 					spaceId: this.spaceId,
@@ -1517,32 +1362,24 @@ var SessionRealtimeClient = class {
 				});
 			}
 			if (eventName === "turn.updated") handlers.turnUpdated?.(event);
-			if (eventName === "turn.final") {
+			if (eventName === "turn.finalized") {
 				this.patchReducer.complete({
 					spaceId: this.spaceId,
 					sessionId: this.sessionId,
 					turnId: typeof event.payload.turn === "object" && event.payload.turn && "id" in event.payload.turn ? String(event.payload.turn.id) : null
 				});
 				handlers.turnFinalized?.(event);
-				handlers.final?.(event);
-			}
-			if (isAssistantFinalPersistedEvent(event)) {
-				this.patchReducer.complete({
-					spaceId: this.spaceId,
-					sessionId: this.sessionId,
-					turnId: getPersistedMessageTurnId(event)
-				});
-				handlers.final?.(event);
 			}
+			if (isAssistantFinalPersistedEvent(event)) this.patchReducer.complete({
+				spaceId: this.spaceId,
+				sessionId: this.sessionId,
+				turnId: getPersistedMessageTurnId(event)
+			});
 		});
 		return () => unsubscribe();
 	}
 	on(type, handler) {
 		return this.subscribe({ event: (event) => {
-			if (type === "turn.final" && isAssistantFinalPersistedEvent(event)) {
-				handler(event);
-				return;
-			}
 			if (toSessionEventName(event.type) === type) handler(event);
 		} });
 	}
@@ -1656,7 +1493,11 @@ var SpaceEventsApi = class {
 				handler(event);
 				return;
 			}
-			if (type === "turn.final" && isAssistantFinalPersistedEvent(event)) {
+			if (type === "task.created" && event.type === "task.created") {
+				handler(event);
+				return;
+			}
+			if (type === "task.updated" && event.type === "task.updated") {
 				handler(event);
 				return;
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "Cohub SDK for spaces, sessions, checkpoints, and realtime agent collaboration.",
   "license": "UNLICENSED",
   "private": false,