@beanx/cathygo-web-core 0.1.3 → 0.1.4

package/README.md

@@ -21,10 +21,16 @@ Host applications still own account routing, agent selection, transport setup,
 selected session id, lightweight session lists, and product-specific shell UI.
 They should not own a second session execution runtime.
 
+## Session Host Helpers (`@0.1.4`)
+
+- `buildSessionLoadedAction` / `conversationMessagesToChatMessages`
+- `createSessionEventRouter`
+- `selectCanSend`, `selectCanStop`, `selectActiveTurnId`, `selectSessionStatus`, `selectIsMutating`
+
 ## First vNext Deliverables
 
 - Keep the current single-session `ChatState` reducer exported.
-- Add `SessionViewState`, session event reducer, and current-session selectors.
+- Session host helpers and selectors (above).
 - Add reducer tests for interrupt, replay, stop, and optimistic reconciliation.
 - Prove the implementation in `cathygo-agent/web` before publishing
-  `@beanx/cathygo-web-core@0.2.0`.
+  npm bumps on the `0.1.x` line (`0.2.0` reserved for breaking renames).

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { Dispatch, RefObject } from 'react';
-import { AgentActivity, SessionRuntimeSnapshot, LearningTurnEvent, ConversationSummary, GatewayModelStatus } from '@beanx/cathygo-protocol';
+import { AgentActivity, SessionRuntimeSnapshot, LearningTurnEvent, ConversationSummary, GatewayModelStatus, ConversationDetail, ConversationMessage } from '@beanx/cathygo-protocol';
 
 type AgentIdentityStatus = {
     agent_id?: string | null;
@@ -394,4 +394,34 @@ declare function ChatView({ chat, draft, attachments, attachmentPolicy, composer
 
 declare function modelStatusText(model: GatewayModelStatus): string;
 
-export { AgentActivityTimeline, type AgentIdentityStatus, type AgentRunProgress, type AgentRunProgressPhase, type AgentRunThinking, CHAT_HOME_MODES, CathyGOChatApp, type CathyGOChatAppProps, type CathyGOChatScreen, type ChatAction, ChatAgentIdentity, type ChatAttachment, type ChatHomeMode, type ChatHomeModeId, ChatHomeView, ChatListView, type ChatMessage$1 as ChatMessage, type ChatMessagePart, ChatMessage as ChatMessageView, type ChatRole, type ChatRuntimeId, ChatRuntimeSelector, type ChatRuntimeSelectorProps, type ChatState, ChatTopBar, ChatTranscript, ChatView, type ComposerAttachmentPolicy, type ComposerFileLike, type ComposerFileRejection, type ComposerFileRejectionReason, type ComposerFileValidationResult, DEFAULT_CHAT_HOME_MODE_ID, DEFAULT_COMPOSER_ATTACHMENT_POLICY, IconBack, IconBrain, IconCalendar, IconChevronDown, IconChevronRight, IconClose, IconCloud, IconCode, IconDevice, IconDevices, IconDocument, IconExternalLink, IconGatewayConnecting, IconGatewayOffline, IconGatewayOnline, IconGithub, IconHome, IconImageUpload, IconInfo, IconLocalComputer, IconMessage, IconMore, IconNewChat, IconPencil, IconPlug, IconSearch, IconSend, IconSettings, IconShield, IconSmartphone, MathMarkdown, MessageComposer, type MessageComposerHandle, type PendingComposerAttachment, RunStatus, type RuntimeOption, ScrollToBottomButton, type UseCathyGOChatResult, agentDisplayName, agentShortId, buildRuntimeOptions, composerAcceptAttribute, findChatHomeMode, fixCommonLatexMistakes, formatBytes, initialChatState, modelStatusText, normalizeComposerAttachmentPolicy, normalizeMathDelimiters, prepareMathMarkdown, reduceChat, stripMathForPreview, useCathyGOChat, validateComposerFiles };
+type RunningTurnsBySession = Record<string, string>;
+declare function eventSessionId(event: LearningTurnEvent): string | undefined;
+declare function eventTurnId(event: LearningTurnEvent): string | undefined;
+declare function shouldApplyEventToRuntime(chat: ChatState | undefined, event: LearningTurnEvent): boolean;
+declare function shouldApplyEventToActiveSession(event: LearningTurnEvent, activeSessionId: string | undefined): boolean;
+declare function isChatStateMutating(chat: ChatState | undefined): boolean;
+declare function selectCanSend(chat: ChatState): boolean;
+declare function selectCanStop(chat: ChatState): boolean;
+declare function selectActiveTurnId(chat: ChatState): string | undefined;
+declare function selectSessionStatus(chat: ChatState): string;
+declare function selectIsMutating(chat: ChatState): boolean;
+declare function updateRunningTurnFromEvent(running: RunningTurnsBySession, event: LearningTurnEvent): RunningTurnsBySession;
+declare function createSessionEventRouter(options: {
+    getActiveSessionId: () => string | undefined;
+    getChat: () => ChatState;
+    dispatchChat: (action: {
+        type: 'event.received';
+        event: LearningTurnEvent;
+    }) => void;
+    onTerminalTurn?: (sessionId: string) => void;
+}): (event: LearningTurnEvent) => void;
+
+type SessionHydrationOptions = {
+    resolveAttachmentUrl?: (uri: string) => string;
+};
+declare function buildSessionLoadedAction(sessionId: string, detail: ConversationDetail, options?: SessionHydrationOptions): Extract<ChatAction, {
+    type: 'session.loaded';
+}>;
+declare function conversationMessagesToChatMessages(messages: ConversationMessage[], options?: SessionHydrationOptions): ChatMessage$1[];
+
+export { AgentActivityTimeline, type AgentIdentityStatus, type AgentRunProgress, type AgentRunProgressPhase, type AgentRunThinking, CHAT_HOME_MODES, CathyGOChatApp, type CathyGOChatAppProps, type CathyGOChatScreen, type ChatAction, ChatAgentIdentity, type ChatAttachment, type ChatHomeMode, type ChatHomeModeId, ChatHomeView, ChatListView, type ChatMessage$1 as ChatMessage, type ChatMessagePart, ChatMessage as ChatMessageView, type ChatRole, type ChatRuntimeId, ChatRuntimeSelector, type ChatRuntimeSelectorProps, type ChatState, ChatTopBar, ChatTranscript, ChatView, type ComposerAttachmentPolicy, type ComposerFileLike, type ComposerFileRejection, type ComposerFileRejectionReason, type ComposerFileValidationResult, DEFAULT_CHAT_HOME_MODE_ID, DEFAULT_COMPOSER_ATTACHMENT_POLICY, IconBack, IconBrain, IconCalendar, IconChevronDown, IconChevronRight, IconClose, IconCloud, IconCode, IconDevice, IconDevices, IconDocument, IconExternalLink, IconGatewayConnecting, IconGatewayOffline, IconGatewayOnline, IconGithub, IconHome, IconImageUpload, IconInfo, IconLocalComputer, IconMessage, IconMore, IconNewChat, IconPencil, IconPlug, IconSearch, IconSend, IconSettings, IconShield, IconSmartphone, MathMarkdown, MessageComposer, type MessageComposerHandle, type PendingComposerAttachment, RunStatus, type RunningTurnsBySession, type RuntimeOption, ScrollToBottomButton, type SessionHydrationOptions, type UseCathyGOChatResult, agentDisplayName, agentShortId, buildRuntimeOptions, buildSessionLoadedAction, composerAcceptAttribute, conversationMessagesToChatMessages, createSessionEventRouter, eventSessionId, eventTurnId, findChatHomeMode, fixCommonLatexMistakes, formatBytes, initialChatState, isChatStateMutating, modelStatusText, normalizeComposerAttachmentPolicy, normalizeMathDelimiters, prepareMathMarkdown, reduceChat, selectActiveTurnId, selectCanSend, selectCanStop, selectIsMutating, selectSessionStatus, shouldApplyEventToActiveSession, shouldApplyEventToRuntime, stripMathForPreview, updateRunningTurnFromEvent, useCathyGOChat, validateComposerFiles };

package/dist/index.js

@@ -2800,6 +2800,131 @@ function RuntimeIcon({ kind }) {
   const className = "chat-runtime-icon";
   return kind === "cloud" ? /* @__PURE__ */ jsx15(IconCloud, { className }) : /* @__PURE__ */ jsx15(IconLocalComputer, { className });
 }
+
+// src/session-host/session-runtime.ts
+var TERMINAL_TURN_EVENTS = /* @__PURE__ */ new Set(["turn.completed", "turn.failed", "turn.cancelled"]);
+function eventSessionId(event) {
+  return optionalString2(event.payload.session_id);
+}
+function eventTurnId(event) {
+  return optionalString2(event.payload.turn_id);
+}
+function shouldApplyEventToRuntime(chat, event) {
+  const turnId = eventTurnId(event);
+  if (!turnId || event.event === "session.input.accepted") return true;
+  if (!isTurnScopedRuntimeEvent(event.event)) return true;
+  const activeTurnId = chat?.activeTurnId;
+  return !activeTurnId || activeTurnId === turnId;
+}
+function shouldApplyEventToActiveSession(event, activeSessionId) {
+  const sessionId = eventSessionId(event);
+  if (!sessionId) return false;
+  if (!activeSessionId) return false;
+  return sessionId === activeSessionId;
+}
+function isChatStateMutating(chat) {
+  if (!chat) return false;
+  return Boolean(chat.activeTurnId) || chat.status === "Sending" || chat.status === "Thinking" || chat.status === "Streaming" || chat.status === "Stopping";
+}
+function selectCanSend(chat) {
+  return chat.status !== "Loading" && chat.status !== "Disconnected" && chat.status !== "Error";
+}
+function selectCanStop(chat) {
+  return Boolean(chat.activeTurnId) || chat.status === "Thinking" || chat.status === "Streaming" || chat.status === "Stopping";
+}
+function selectActiveTurnId(chat) {
+  return chat.activeTurnId;
+}
+function selectSessionStatus(chat) {
+  return chat.status;
+}
+function selectIsMutating(chat) {
+  return isChatStateMutating(chat);
+}
+function updateRunningTurnFromEvent(running, event) {
+  const sessionId = eventSessionId(event);
+  const turnId = eventTurnId(event);
+  if (!sessionId || !turnId) return running;
+  if (TERMINAL_TURN_EVENTS.has(event.event)) {
+    if (!running[sessionId] || running[sessionId] === turnId) {
+      const next = { ...running };
+      delete next[sessionId];
+      return next;
+    }
+    return running;
+  }
+  if (event.event === "turn.started" || event.event === "assistant.delta") {
+    if (running[sessionId] === turnId) return running;
+    return { ...running, [sessionId]: turnId };
+  }
+  return running;
+}
+function createSessionEventRouter(options) {
+  return (event) => {
+    const sessionId = eventSessionId(event);
+    if (shouldApplyEventToActiveSession(event, options.getActiveSessionId()) && shouldApplyEventToRuntime(options.getChat(), event)) {
+      options.dispatchChat({ type: "event.received", event });
+    }
+    if (sessionId && TERMINAL_TURN_EVENTS.has(event.event)) {
+      options.onTerminalTurn?.(sessionId);
+    }
+  };
+}
+function isTurnScopedRuntimeEvent(event) {
+  return event === "turn.started" || event === "assistant.delta" || event === "assistant.completed" || event === "turn.completed" || event === "turn.cancelled" || event === "turn.failed" || event === "agent.activity.started" || event === "agent.activity.updated" || event === "agent.activity.completed" || event === "agent.progress.delta";
+}
+function optionalString2(value) {
+  if (value === void 0 || value === null) return void 0;
+  const text = String(value).trim();
+  return text || void 0;
+}
+
+// src/session-host/hydration.ts
+function buildSessionLoadedAction(sessionId, detail, options = {}) {
+  return {
+    type: "session.loaded",
+    sessionId,
+    messages: conversationMessagesToChatMessages(detail.messages, options),
+    activities: detail.activities ?? [],
+    runtime: detail.runtime ?? detail.session.runtime
+  };
+}
+function conversationMessagesToChatMessages(messages, options = {}) {
+  return messages.map((message) => ({
+    id: message.id,
+    role: message.role,
+    content: message.content,
+    parts: normalizeMessageParts(message.parts, options.resolveAttachmentUrl),
+    turnId: message.turn_id ?? void 0,
+    clientInputId: messageMetadataString(message.metadata, "client_input_id"),
+    clientTurnId: messageMetadataString(message.metadata, "client_turn_id"),
+    status: "done"
+  }));
+}
+function normalizeMessageParts(parts, resolveAttachmentUrl) {
+  const normalized = parts?.map((part) => {
+    if (part.type === "text" && part.text) {
+      return { type: "text", text: part.text };
+    }
+    if (part.type === "image" && part.attachment_id && part.attachment) {
+      const uri = part.attachment.uri;
+      return {
+        type: "image",
+        attachment_id: part.attachment_id,
+        attachment: {
+          ...part.attachment,
+          uri: uri && resolveAttachmentUrl ? resolveAttachmentUrl(uri) : uri
+        }
+      };
+    }
+    return void 0;
+  }).filter((part) => Boolean(part));
+  return normalized?.length ? normalized : void 0;
+}
+function messageMetadataString(metadata, key) {
+  const value = metadata?.[key];
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
 export {
   AgentActivityTimeline,
   CHAT_HOME_MODES,
@@ -2851,17 +2976,31 @@ export {
   agentDisplayName,
   agentShortId,
   buildRuntimeOptions,
+  buildSessionLoadedAction,
   composerAcceptAttribute,
+  conversationMessagesToChatMessages,
+  createSessionEventRouter,
+  eventSessionId,
+  eventTurnId,
   findChatHomeMode,
   fixCommonLatexMistakes,
   formatBytes,
   initialChatState,
+  isChatStateMutating,
   modelStatusText,
   normalizeComposerAttachmentPolicy,
   normalizeMathDelimiters,
   prepareMathMarkdown,
   reduceChat,
+  selectActiveTurnId,
+  selectCanSend,
+  selectCanStop,
+  selectIsMutating,
+  selectSessionStatus,
+  shouldApplyEventToActiveSession,
+  shouldApplyEventToRuntime,
   stripMathForPreview,
+  updateRunningTurnFromEvent,
   useCathyGOChat,
   validateComposerFiles
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beanx/cathygo-web-core",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "files": [
     "dist"
@@ -16,7 +16,7 @@
     "./styles.css": "./dist/styles.css"
   },
   "dependencies": {
-    "@beanx/cathygo-protocol": "0.1.2",
+    "@beanx/cathygo-protocol": "0.1.5",
     "@streamdown/math": "^1.0.2",
     "katex": "^0.16.47",
     "streamdown": "^2.5.0"