@hugex/ai 2.8.11 → 2.8.12

package/LICENSE

@@ -4,7 +4,7 @@ Copyright (c) HugeX. All rights reserved.
 
 Permission is granted to HugeX customers and authorized partners to install,
 use, and integrate @hugex packages (@hugex/ai, @hugex/ui, @hugex/shared, and
-related scoped packages) solely in connection with a HugeX Agent deployment
+related scoped packages) solely in connection with a HugeX or Ora deployment
 you are licensed to operate.
 
 You may not copy, modify, merge, publish, distribute, sublicense, or sell

package/README.md

@@ -2,7 +2,7 @@
 
 HugeX Agent runtime for Cloudflare Workers — flow execution (`FlowEngine`), session state (`AgentDO`), server route handlers, and the React client hook (`useAgent`).
 
-Flows are **designed** in [hx-ai](https://hugex.co/) (`AgentDesign.tsx`, React Flow canvas) and **saved** to HX Core. Tenant apps install this package, wire the worker routes, and connect the UI with `useAgent`.
+Flows are **designed** in the [HugeX platform](https://hugex.co/) (**Agent Design**) and **saved** to HX Core. Tenant apps install this package, wire the worker routes, and connect the UI with `useAgent`.
 
 ## Install
 
@@ -10,7 +10,7 @@ Flows are **designed** in [hx-ai](https://hugex.co/) (`AgentDesign.tsx`, React F
 pnpm add @hugex/ai
 ```
 
-Peer/runtime deps (React 19, `react-router` 7, `zod`, `zustand`, `ai`, etc.) are declared in the package — align versions with your tenant app.
+Peer dependencies are declared in the package — align versions with your tenant app.
 
 ## Exports
 
@@ -32,12 +32,6 @@ import {
   handleCommonRoutes,
   handleIntancesRoutes,
 } from '@hugex/ai';
-import { createRequestHandler } from 'react-router';
-
-const requestHandler = createRequestHandler(
-  () => import('virtual:react-router/server-build'),
-  import.meta.env.MODE,
-);
 
 export default {
   async fetch(request, env, ctx) {
@@ -53,7 +47,8 @@ export default {
     const instances = await handleIntancesRoutes(request, env, ctx);
     if (instances instanceof Response) return instances;
 
-    return requestHandler(request, { cloudflare: { env, ctx }, state: { ...auth } });
+    // Then delegate to your app's SSR/router handler.
+    return yourAppHandler(request, { cloudflare: { env, ctx }, state: { ...auth } });
   },
 } satisfies ExportedHandler<Env>;
 
@@ -104,7 +99,7 @@ Rules: exactly one Start, at least one Answer, all paths connected.
 
 ## `useAgent` — client hook
 
-`useAgent` opens a WebSocket to the session DO, decodes the `TYPE::CONTENT` wire protocol, and writes conversation state into a Zustand store. UI components subscribe to the store and call `send`, `clearHistory`, etc.
+`useAgent` opens a WebSocket to the session DO, decodes the `TYPE::CONTENT` wire protocol, and writes conversation state into the agent store. UI components subscribe to the store and call `send`, `clearHistory`, etc.
 
 ### Options
 
@@ -158,9 +153,9 @@ Reference: `ora-base/app/secure/chat/components/ChatView.tsx`.
 Flow under design in Agent Design; `flowId` from route params; session from run store; JWT via `query`:
 
 ```tsx
-const { id: flowId } = useParams<{ id: string }>();
+const flowId = '…'; // from your route or config
 const sessionId = '…'; // from run session store
-const socketUrl = tenant.data.ora.socketServer; // e.g. tenant worker host
+const socketUrl = tenant.data.ora.socketServer; // tenant worker host
 
 const { send, sendAuth, clearHistory } = useAgent({
   host: socketUrl,
@@ -173,7 +168,7 @@ const { send, sendAuth, clearHistory } = useAgent({
 const messages = useAgentStore((s) => s.messages);
 ```
 
-Reference: `hx-ai/.../RunStatusPanel.tsx` (opened from `AgentDesign.tsx`).
+Reference: `hx-ai/.../RunStatusPanel.tsx`.
 
 Start-node flags (`allow_images`, `allow_documents`, `memory_enabled`) are read from the canvas nodes to drive the Run UI.
 
@@ -228,7 +223,7 @@ Subscribe via `useAgentStore` (global) or `store` (isolated):
 | `status` | `'connecting' \| 'connected' \| 'disconnected'` — gate input on `'connected'` |
 | `flowConfig` | Start-node config from server (`CFG::`: greeting, attachments) |
 | `events` | Tool/info events from `SE::` stream |
-| `composioAuth` | OAuth redirect when Composio manual auth is required |
+| `composioAuth` | OAuth redirect when a connected tool requires manual authorization |
 | `approvals` | Human-in-the-loop tool approvals |
 
 ## Wire protocol (summary)
@@ -238,7 +233,7 @@ Inbound frames use `TYPE::CONTENT`:
 | Code | Meaning |
 |---|---|
 | `HIS` | Full history replay |
-| `SE` | Server event (tools, memory, Composio, …) |
+| `SE` | Server event (tools, memory, external integrations, …) |
 | `TS` / `TSC` | Assistant text stream / complete |
 | `RS` / `RSC` | Reasoning stream / complete |
 | `CFG` | Flow config (attachments, greeting) |
@@ -246,11 +241,11 @@ Inbound frames use `TYPE::CONTENT`:
 
 Outbound: `M:` user message, `CH:` clear history, `AUT:` runtime credential, `UID:` session identity.
 
-Full reference: Ora `WEBSOCKET_EVENTS.md` (in the `ora/` source repo).
+Full reference: wire protocol details in the HugeX runtime source (`WEBSOCKET_EVENTS.md`).
 
-## Vite
+## Bundler
 
-Exclude `@hugex/ai` from `optimizeDeps` in tenant apps:
+Exclude `@hugex/ai` from dependency pre-bundling in your dev server:
 
 ```ts
 optimizeDeps: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hugex/ai",
-  "version": "2.8.11",
-  "description": "HugeX Agent Framework",
+  "version": "2.8.12",
+  "description": "Ora AI Agent Framework",
   "author": "a@hugex.co",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",