@hugex/ai 2.8.15 → 2.9.4

package/dist/chunk-3TXHFKDN.js

@@ -0,0 +1 @@
+var d=c=>a=>{var b=c[a];if(b)return b();throw new Error("Module not found in bundle: "+a)};export{d as a};

package/dist/{chunk-TUI5H3ZB.js → chunk-G3SGJ7XJ.js}

@@ -1 +1 @@
-import{tool as x}from"ai";import{z as p}from"zod";async function T(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/flow/${t}`,{method:"GET",headers:{Authorization:`${o.HX_API_KEY}`},cache:"no-store"});if(!r.ok)throw new Error("Failed to fetch flow KV");return r.json()}async function D(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/flow/${t}/state`,{method:"GET",headers:{Authorization:`${o.HX_API_KEY}`},cache:"no-store"});if(!r.ok)throw new Error("Failed to fetch flow state");return r.json()}async function A(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/vectorize/get`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`${o.HX_API_KEY}`},body:JSON.stringify({hashes:t})});if(!r.ok)throw new Error("Failed to fetch embeddings from cache");return r.json()}async function P(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/vectorize/put`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`${o.HX_API_KEY}`},body:JSON.stringify({items:t})});if(!r.ok)throw new Error("Failed to store embeddings in cache");return r.json()}var S=async t=>{let o=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(t));return Array.from(new Uint8Array(o)).map(r=>r.toString(16).padStart(2,"0")).join("")},_=async(t,o,r=!1)=>{var f,b,w,y;let i=Array.isArray(o)?o:[o],c=await Promise.all(i.map(e=>S(e))),s=!!((f=t==null?void 0:t.env)!=null&&f.HX_CORE_URL)&&!!((b=t==null?void 0:t.env)!=null&&b.HX_API_KEY);console.log("Debug: KV cache API available:",s);let l=[],n=[];if(s){console.log("Debug: Attempting to get embeddings from KV cache via API");try{l=await A(c,t.env)}catch(e){console.warn("Failed to fetch from KV cache API",e),l=c.map(()=>null)}n=l.map((e,a)=>e===null?a:-1).filter(e=>e!==-1),console.log("Debug: Cached embeddings found:",l.filter(e=>e!==null).length,"missing:",n.length)}else console.log("Debug: KV cache API not available, skipping cache lookup"),n=i.map((e,a)=>a);if(n.length===0)return console.log("Debug: All embeddings retrieved from cache"),{data:l};let d=n.map(e=>i[e]),g,h;console.log("Debug: Generating embeddings for missing texts, count:",d.length);for(let e=0;e<3;e++)try{console.log("Debug: Primary embedding generation attempt",e+1);let a=new Promise((E,$)=>setTimeout(()=>$(new Error("Timeout after 2 seconds")),2e3)),u=(w=t==null?void 0:t.env)==null?void 0:w.AI.run("@cf/baai/bge-m3",{text:d});g=await Promise.race([u,a]),console.log("Debug: Primary embedding generation successful on attempt",e+1);break}catch(a){if(console.warn(`Primary embedding attempt ${e+1} failed:`,a),h=a,e===2)break}if(!g){if(!r)throw h;console.warn("Falling back to Ollama");try{let e=await fetch(`${(y=t==null?void 0:t.env)==null?void 0:y.OLLAMA_BASE_URL}/api/embed`,{method:"POST",headers:{"Content-Type":"application/json",Cookie:"hxsecure=1"},body:JSON.stringify({model:"bge-m3:latest",input:d})});if(!e.ok)throw new Error(`Ollama API error: ${e.statusText}`);let a=await e.json();console.log("Embedding response data:",a.embeddings.length),g={data:a.embeddings},console.log("Debug: Fallback embedding generation successful")}catch(e){throw console.error("Both embedding methods failed:",e),e}}if(s&&n.length>0){console.log("Debug: Storing new embeddings in KV cache via API");let e=n.map((a,u)=>({hash:c[a],embedding:g.data[u]}));try{await P(e,t.env)}catch(a){console.warn("Failed to store in KV cache API",a)}}else console.log("Debug: Skipping cache storage as KV API not available or no new embeddings");let m=l.slice();for(let e=0;e<n.length;e++)m[n[e]]=g.data[e];return console.log("Debug: Embedding generation complete, total embeddings:",m.length),{data:m}};function V(t,o,r){return x({description:"Perform semantic vector search on memo data with optional static parameters. Returns relevant matches with scores and metadata.",inputSchema:p.object({query:p.string().min(1).describe("The search query to vectorize and search for"),topK:p.number().optional().default(5).describe("Number of top results to return (overrides static params if provided)")}),execute:async({query:i,topK:c=3})=>{var l;let s=r==null?void 0:r.namespace;if(!s)return{results:[]};if(`${i}${s}${c}`,!i||typeof i!="string"||i.trim()==="")return{results:[]};try{let n=await _(t,i,!0),d=await t.env[`VDB_${(l=o.flowData)==null?void 0:l.tenant}_1024`].query(n.data[0],{namespace:s,topK:c,returnMetadata:"all"}),h=(Array.isArray(d.matches)?d.matches:[]).map(m=>{var f;return(f=m.metadata)==null?void 0:f.value}).filter(m=>typeof m=="string");return`${i}${s}${c}${h.length}`,{query:i,topK:c,matches:h}}catch(n){return`${i}${s}${c}${n}`,{results:[]}}}})}export{T as a,D as b,S as c,_ as d,V as e};
+import{tool as T}from"ai";import{z as p}from"zod";async function E(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/flow/${t}`,{method:"GET",headers:{Authorization:`${o.HX_API_KEY}`},cache:"no-store"});if(!r.ok)throw new Error("Failed to fetch flow KV");return r.json()}async function D(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/flow/${t}/state`,{method:"GET",headers:{Authorization:`${o.HX_API_KEY}`},cache:"no-store"});if(!r.ok)throw new Error("Failed to fetch flow state");return r.json()}async function A(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/vectorize/get`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`${o.HX_API_KEY}`},body:JSON.stringify({hashes:t})});if(!r.ok)throw new Error("Failed to fetch embeddings from cache");return r.json()}async function P(t,o){let r=await fetch(`${o.HX_CORE_URL}/ora/vectorize/put`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`${o.HX_API_KEY}`},body:JSON.stringify({items:t})});if(!r.ok)throw new Error("Failed to store embeddings in cache");return r.json()}var S=async t=>{let o=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(t));return Array.from(new Uint8Array(o)).map(r=>r.toString(16).padStart(2,"0")).join("")},_=async(t,o,r=!1)=>{var f,b,w,y;let i=Array.isArray(o)?o:[o],c=await Promise.all(i.map(e=>S(e))),s=!!((f=t==null?void 0:t.env)!=null&&f.HX_CORE_URL)&&!!((b=t==null?void 0:t.env)!=null&&b.HX_API_KEY);console.log("Debug: KV cache API available:",s);let l=[],n=[];if(s){console.log("Debug: Attempting to get embeddings from KV cache via API");try{l=await A(c,t.env)}catch(e){console.warn("Failed to fetch from KV cache API",e),l=c.map(()=>null)}n=l.map((e,a)=>e===null?a:-1).filter(e=>e!==-1),console.log("Debug: Cached embeddings found:",l.filter(e=>e!==null).length,"missing:",n.length)}else console.log("Debug: KV cache API not available, skipping cache lookup"),n=i.map((e,a)=>a);if(n.length===0)return console.log("Debug: All embeddings retrieved from cache"),{data:l};let d=n.map(e=>i[e]),g,h;console.log("Debug: Generating embeddings for missing texts, count:",d.length);for(let e=0;e<3;e++)try{console.log("Debug: Primary embedding generation attempt",e+1);let a=new Promise((x,$)=>setTimeout(()=>$(new Error("Timeout after 2 seconds")),2e3)),u=(w=t==null?void 0:t.env)==null?void 0:w.AI.run("@cf/baai/bge-m3",{text:d});g=await Promise.race([u,a]),console.log("Debug: Primary embedding generation successful on attempt",e+1);break}catch(a){if(console.warn(`Primary embedding attempt ${e+1} failed:`,a),h=a,e===2)break}if(!g){if(!r)throw h;console.warn("Falling back to Ollama");try{let e=await fetch(`${(y=t==null?void 0:t.env)==null?void 0:y.OLLAMA_BASE_URL}/api/embed`,{method:"POST",headers:{"Content-Type":"application/json",Cookie:"hxsecure=1"},body:JSON.stringify({model:"bge-m3:latest",input:d})});if(!e.ok)throw new Error(`Ollama API error: ${e.statusText}`);let a=await e.json();console.log("Embedding response data:",a.embeddings.length),g={data:a.embeddings},console.log("Debug: Fallback embedding generation successful")}catch(e){throw console.error("Both embedding methods failed:",e),e}}if(s&&n.length>0){console.log("Debug: Storing new embeddings in KV cache via API");let e=n.map((a,u)=>({hash:c[a],embedding:g.data[u]}));try{await P(e,t.env)}catch(a){console.warn("Failed to store in KV cache API",a)}}else console.log("Debug: Skipping cache storage as KV API not available or no new embeddings");let m=l.slice();for(let e=0;e<n.length;e++)m[n[e]]=g.data[e];return console.log("Debug: Embedding generation complete, total embeddings:",m.length),{data:m}};function V(t,o,r){return T({description:"Perform semantic vector search on memo data with optional static parameters. Returns relevant matches with scores and metadata.",inputSchema:p.object({query:p.string().min(1).describe("The search query to vectorize and search for"),topK:p.number().optional().default(5).describe("Number of top results to return (overrides static params if provided)")}),execute:async({query:i,topK:c=3})=>{var l;let s=r==null?void 0:r.namespace;if(!s)return{results:[]};if(`${i}${s}${c}`,!i||typeof i!="string"||i.trim()==="")return{results:[]};try{let n=await _(t,i,!0),d=await t.env[`VDB_${(l=o.flowData)==null?void 0:l.tenant}_1024`].query(n.data[0],{namespace:s,topK:c,returnMetadata:"all"}),h=(Array.isArray(d.matches)?d.matches:[]).map(m=>{var f;return(f=m.metadata)==null?void 0:f.value}).filter(m=>typeof m=="string");return`${i}${s}${c}${h.length}`,{query:i,topK:c,matches:h}}catch(n){return`${i}${s}${c}${n}`,{results:[]}}}})}export{E as a,D as b,S as c,_ as d,V as e};

package/dist/chunk-R6EKV3WR.js

@@ -0,0 +1 @@
+import{tool as t}from"ai";import{z as o}from"zod";var p=(n,i,r,a)=>t({description:"Get the weather in a location (in Celsius)",inputSchema:o.object({location:o.string().describe("The location to get the weather for")}),execute:async({location:e})=>(`${e}`,{location:e,temperature:Math.floor(Math.random()*21)})});export{p as a};

package/dist/{chunk-43NDF544.js → chunk-RYHQGPX5.js}

@@ -1 +1 @@
-import{tool as m}from"ai";import{z as u}from"zod";function F(p,v,n,d){let o=e=>{let t=e.toLowerCase().replace("\xB0","").replace("kelvin","k");if(t==="c"||t==="celsius")return"C";if(t==="f"||t==="fahrenheit")return"F";if(t==="k"||t==="kelvin")return"K";throw new Error(`Invalid temperature unit: ${e}. Supported units: C/\xB0C/Celsius, F/\xB0F/Fahrenheit, K/Kelvin`)},l=(e,t,a)=>{let i=o(t),s=o(a),r;switch(i){case"C":r=e;break;case"F":r=(e-32)*5/9;break;case"K":r=e-273.15;break;default:throw new Error(`Unsupported source unit: ${t}`)}switch(s){case"C":return r;case"F":return r*9/5+32;case"K":return r+273.15;default:throw new Error(`Unsupported target unit: ${a}`)}};return m({description:"Convert temperature between Celsius, Fahrenheit, and Kelvin with optional static parameters. Always prioritizes output results over input.",inputSchema:u.object({temperature:u.number().describe("Temperature value to convert"),source:u.string().optional().describe("Source temperature unit (C/\xB0C/Celsius, F/\xB0F/Fahrenheit, K/Kelvin). Overrides static params if provided."),target:u.string().optional().describe("Target temperature unit (C/\xB0C/Celsius, F/\xB0F/Fahrenheit, K/Kelvin). Overrides static params if provided.")}),execute:async({temperature:e,source:t,target:a})=>{let i=(n==null?void 0:n.source)||t||"C",s=(n==null?void 0:n.target)||a||"F";if(`${e}${i}${s}`,typeof e!="number"||!Number.isFinite(e))throw new Error(`Invalid temperature value: ${e}. Must be a finite number.`);try{let r=l(e,i,s),g=o(i),c=o(s);return{input:{temperature:e,source:g,target:c},output:{value:Number(r.toFixed(2)),unit:c,important:"If source and target is different from your input, is because it is being force by defaults settings."}}}catch(r){throw new Error(`Conversion failed: ${r instanceof Error?r.message:String(r)}`)}}})}export{F as a};
+import{tool as m}from"ai";import{z as u}from"zod";function F(p,v,n,d){let s=e=>{let t=e.toLowerCase().replace("\xB0","").replace("kelvin","k");if(t==="c"||t==="celsius")return"C";if(t==="f"||t==="fahrenheit")return"F";if(t==="k"||t==="kelvin")return"K";throw new Error(`Invalid temperature unit: ${e}. Supported units: C/\xB0C/Celsius, F/\xB0F/Fahrenheit, K/Kelvin`)},l=(e,t,a)=>{let i=s(t),o=s(a),r;switch(i){case"C":r=e;break;case"F":r=(e-32)*5/9;break;case"K":r=e-273.15;break;default:throw new Error(`Unsupported source unit: ${t}`)}switch(o){case"C":return r;case"F":return r*9/5+32;case"K":return r+273.15;default:throw new Error(`Unsupported target unit: ${a}`)}};return m({description:"Convert temperature between Celsius, Fahrenheit, and Kelvin with optional static parameters. Always prioritizes output results over input.",inputSchema:u.object({temperature:u.number().describe("Temperature value to convert"),source:u.string().optional().describe("Source temperature unit (C/\xB0C/Celsius, F/\xB0F/Fahrenheit, K/Kelvin). Overrides static params if provided."),target:u.string().optional().describe("Target temperature unit (C/\xB0C/Celsius, F/\xB0F/Fahrenheit, K/Kelvin). Overrides static params if provided.")}),execute:async({temperature:e,source:t,target:a})=>{let i=(n==null?void 0:n.source)||t||"C",o=(n==null?void 0:n.target)||a||"F";if(`${e}${i}${o}`,typeof e!="number"||!Number.isFinite(e))throw new Error(`Invalid temperature value: ${e}. Must be a finite number.`);try{let r=l(e,i,o),g=s(i),c=s(o);return{input:{temperature:e,source:g,target:c},output:{value:Number(r.toFixed(2)),unit:c,important:"If source and target is different from your input, is because it is being force by defaults settings."}}}catch(r){throw new Error(`Conversion failed: ${r instanceof Error?r.message:String(r)}`)}}})}export{F as a};

package/dist/client/hooks/useAgent.d.ts

@@ -0,0 +1,31 @@
+import { type AgentStoreApi } from '../states/agent-store';
+type QueryObject = Record<string, string | null>;
+export declare function useAgent(opts?: {
+    host?: string;
+    basePath?: string;
+    agent?: string;
+    name?: string;
+    query?: QueryObject | (() => Promise<QueryObject>);
+    /** Optional client-supplied session identity (fallback when no JWT user). Sent on connect via `UID`. */
+    user?: string;
+    storeKey?: string;
+}): {
+    connection: any;
+    store: AgentStoreApi;
+    send: (text: string, images?: {
+        mimeType: string;
+        data: string;
+    }[], documents?: {
+        name: string;
+        mimeType: string;
+        data: string;
+    }[]) => void;
+    clearHistory: () => void;
+    sendAuth: (name: string, value: string) => void;
+    setIdentity: (userId: string) => void;
+    toggleEventsVisible: () => void;
+    clearEvents: () => void;
+    approve: (toolCallId: string) => void;
+    reject: (toolCallId: string) => void;
+};
+export {};

package/dist/client/states/agent-store.d.ts

@@ -0,0 +1,95 @@
+import type { ApprovalRequestPayload, EventItem, FlowConfig, Message, StepInfo, TypingMessage } from '../../common/types/agent-types';
+export interface AgentState {
+    messages: Message[];
+    events: EventItem[];
+    eventsVisible: boolean;
+    status: 'connecting' | 'connected' | 'disconnected';
+    typingMessage: TypingMessage;
+    reasoningMessage: TypingMessage;
+    isReasoning: boolean;
+    stepInfo: StepInfo;
+    approvals: Array<{
+        id: string;
+        toolCallId: string;
+        toolName: string;
+        args: Record<string, unknown>;
+        description: string;
+        ts: number;
+        status: 'pending' | 'approved' | 'rejected';
+    }>;
+    error: string | null;
+    flowConfig: FlowConfig | null;
+    composioAuth: ComposioAuthRequest | null;
+}
+export interface ComposioAuthRequest {
+    toolkit?: string;
+    redirectUrl: string;
+    toolRowId?: string;
+}
+export interface AgentActions {
+    initHistory: (messages: Message[]) => void;
+    addEvent: (event: EventItem) => void;
+    clearEvents: () => void;
+    setMessages: (messages: Message[]) => void;
+    addMessage: (message: Message) => void;
+    setTyping: (typing: TypingMessage) => void;
+    appendTyping: (id: string, chunk: string) => void;
+    clearTyping: () => void;
+    setReasoning: (reasoning: TypingMessage) => void;
+    appendReasoning: (id: string, chunk: string) => void;
+    clearReasoning: () => void;
+    setReasoningActive: (active: boolean) => void;
+    setStep: (step: StepInfo) => void;
+    clearStep: () => void;
+    setStatus: (status: AgentState['status']) => void;
+    toggleEvents: () => void;
+    clearHistory: () => void;
+    addApprovalRequest: (payload: ApprovalRequestPayload) => void;
+    updateApprovalStatus: (payload: {
+        toolCallId: string;
+        status: 'approved' | 'rejected';
+    }) => void;
+    removeApproval: (toolCallId: string) => void;
+    setError: (error: string | null) => void;
+    setFlowConfig: (config: FlowConfig | null) => void;
+    setComposioAuth: (request: ComposioAuthRequest | null) => void;
+    clearComposioAuth: () => void;
+}
+export type AgentStore = AgentState & AgentActions;
+declare function createAgentStoreImpl(devtoolsName: string): import("node_modules/zustand/esm/react.mjs").UseBoundStore<Omit<import("node_modules/zustand/esm/vanilla.mjs").StoreApi<AgentStore>, "devtools" | "setState"> & {
+    setState(partial: Partial<AgentStore> | ((state: AgentStore) => Partial<AgentStore> | AgentStore) | AgentStore, replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: ((state: AgentStore) => AgentStore) | AgentStore, replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}>;
+export type AgentStoreApi = ReturnType<typeof createAgentStoreImpl>;
+export declare const useAgentStore: import("node_modules/zustand/esm/react.mjs").UseBoundStore<Omit<import("node_modules/zustand/esm/vanilla.mjs").StoreApi<AgentStore>, "devtools" | "setState"> & {
+    setState(partial: Partial<AgentStore> | ((state: AgentStore) => Partial<AgentStore> | AgentStore) | AgentStore, replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: ((state: AgentStore) => AgentStore) | AgentStore, replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}>;
+export declare function getAgentStore(key?: string): AgentStoreApi;
+export {};

package/dist/client.d.ts

@@ -1,129 +1,4 @@
-import * as zustand from 'zustand';
-import { Message, EventItem, TypingMessage, StepInfo, FlowConfig, ApprovalRequestPayload } from './common.js';
-export { Capabilities, ChatHistoryItem, EffectiveParams, FlowNode, GENERATION_PARAM_KEYS, GENERATION_PRESETS, GenerationParamKey, GenerationPresetId, MAX_USER_IDENTITY_LENGTH, MODEL_REGISTRY_SNAPSHOT, MessageType, ModelEntry, ModelRegistrySnapshot, NODETYPES, NodeType, OutVar, PRESET_PARAM_KEYS, ParamAdjustment, ParamRange, ParamSupport, REASONING_EFFORT_LEVELS, ReasoningCapability, ReasoningEffortLevel, ResolveInput, ResolveOptions, ResolvedModel, TOOL_REGISTRY_SNAPSHOT, ToolExecutionResultPayload, UserAuthPayload, UserInterface, UserMessagePayload, VariableMapping, WsClientMessage, WsClientMessageType, WsComplete, WsError, WsHistory, WsMessage, WsServerMessage, WsServerMessageType, applyPresetToOverrides, buildReasoningProviderOptions, deriveParamSupport, getDefaultOutVars, getEffectiveOutVars, getModelEntry, logc, messageTypes, normalizeEffectiveParams, normalizeReasoning, openAiReasoningParamSupport, openAiStandardParamSupport, parseUserAuth, parseUserMessage, pickNodeOverrides, reasoningEffortLevels, reasoningExposable, resolveOutVarRef, resolvePreset, resolveReasoningEffort, resolveTemplate, sanitizeUserIdentity, stripUnsupportedFromNodeData, toStreamTextSettings, walkPath, workersAiParamSupport, wsDebug, xaiParamSupport } from './common.js';
-
-interface AgentState {
-    messages: Message[];
-    events: EventItem[];
-    eventsVisible: boolean;
-    status: 'connecting' | 'connected' | 'disconnected';
-    typingMessage: TypingMessage;
-    reasoningMessage: TypingMessage;
-    isReasoning: boolean;
-    stepInfo: StepInfo;
-    approvals: Array<{
-        id: string;
-        toolCallId: string;
-        toolName: string;
-        args: Record<string, unknown>;
-        description: string;
-        ts: number;
-        status: 'pending' | 'approved' | 'rejected';
-    }>;
-    error: string | null;
-    flowConfig: FlowConfig | null;
-    composioAuth: ComposioAuthRequest | null;
-}
-interface ComposioAuthRequest {
-    toolkit?: string;
-    redirectUrl: string;
-    toolRowId?: string;
-}
-interface AgentActions {
-    initHistory: (messages: Message[]) => void;
-    addEvent: (event: EventItem) => void;
-    clearEvents: () => void;
-    setMessages: (messages: Message[]) => void;
-    addMessage: (message: Message) => void;
-    setTyping: (typing: TypingMessage) => void;
-    appendTyping: (id: string, chunk: string) => void;
-    clearTyping: () => void;
-    setReasoning: (reasoning: TypingMessage) => void;
-    appendReasoning: (id: string, chunk: string) => void;
-    clearReasoning: () => void;
-    setReasoningActive: (active: boolean) => void;
-    setStep: (step: StepInfo) => void;
-    clearStep: () => void;
-    setStatus: (status: AgentState['status']) => void;
-    toggleEvents: () => void;
-    clearHistory: () => void;
-    addApprovalRequest: (payload: ApprovalRequestPayload) => void;
-    updateApprovalStatus: (payload: {
-        toolCallId: string;
-        status: 'approved' | 'rejected';
-    }) => void;
-    removeApproval: (toolCallId: string) => void;
-    setError: (error: string | null) => void;
-    setFlowConfig: (config: FlowConfig | null) => void;
-    setComposioAuth: (request: ComposioAuthRequest | null) => void;
-    clearComposioAuth: () => void;
-}
-type AgentStore = AgentState & AgentActions;
-declare function createAgentStoreImpl(devtoolsName: string): zustand.UseBoundStore<Omit<zustand.StoreApi<AgentStore>, "setState" | "devtools"> & {
-    setState(partial: AgentStore | Partial<AgentStore> | ((state: AgentStore) => AgentStore | Partial<AgentStore>), replace?: false | undefined, action?: (string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }) | undefined): void;
-    setState(state: AgentStore | ((state: AgentStore) => AgentStore), replace: true, action?: (string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }) | undefined): void;
-    devtools: {
-        cleanup: () => void;
-    };
-}>;
-type AgentStoreApi = ReturnType<typeof createAgentStoreImpl>;
-declare const useAgentStore: zustand.UseBoundStore<Omit<zustand.StoreApi<AgentStore>, "setState" | "devtools"> & {
-    setState(partial: AgentStore | Partial<AgentStore> | ((state: AgentStore) => AgentStore | Partial<AgentStore>), replace?: false | undefined, action?: (string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }) | undefined): void;
-    setState(state: AgentStore | ((state: AgentStore) => AgentStore), replace: true, action?: (string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }) | undefined): void;
-    devtools: {
-        cleanup: () => void;
-    };
-}>;
-declare function getAgentStore(key?: string): AgentStoreApi;
-
-type QueryObject = Record<string, string | null>;
-declare function useAgent(opts?: {
-    host?: string;
-    basePath?: string;
-    agent?: string;
-    name?: string;
-    query?: QueryObject | (() => Promise<QueryObject>);
-    /** Optional client-supplied session identity (fallback when no JWT user). Sent on connect via `UID`. */
-    user?: string;
-    storeKey?: string;
-}): {
-    connection: any;
-    store: AgentStoreApi;
-    send: (text: string, images?: {
-        mimeType: string;
-        data: string;
-    }[], documents?: {
-        name: string;
-        mimeType: string;
-        data: string;
-    }[]) => void;
-    clearHistory: () => void;
-    sendAuth: (name: string, value: string) => void;
-    setIdentity: (userId: string) => void;
-    toggleEventsVisible: () => void;
-    clearEvents: () => void;
-    approve: (toolCallId: string) => void;
-    reject: (toolCallId: string) => void;
-};
-
-export { type AgentActions, type AgentState, type AgentStore, type AgentStoreApi, ApprovalRequestPayload, type ComposioAuthRequest, EventItem, FlowConfig, Message, StepInfo, TypingMessage, getAgentStore, useAgent, useAgentStore };
+export * from './client/hooks/useAgent';
+export * from './client/states/agent-store';
+export * from './index.common';
+export * from './common/utils/logc';

package/dist/client.js

@@ -1 +1 @@
-import{a as d,b as G,c as E,d as $,e as L,f as Se,g as Ae,h as fe}from"./chunk-HAYNUZZB.js";import{a as J,b as Y,c as k,d as K,e as Q,f as X}from"./chunk-OYP6D5VN.js";import{a as z,b as B,c as W,d as Z,e as ee,f as te,g as ne,h as se,i as oe,j as re,k as ae,l as ie,m as ge,n as le,o as pe,p as ce,q as de,r as ue,s as ve,t as ye}from"./chunk-GRZ6ZRHM.js";import{a as P}from"./chunk-U56YWPSI.js";import"./chunk-6BYZCJPP.js";import{useAgent as H}from"agents/react";import{useCallback as u,useEffect as j,useMemo as U,useRef as S}from"react";import{create as q}from"zustand";import{devtools as V}from"zustand/middleware";var F={messages:[],events:[],eventsVisible:!1,status:"connecting",typingMessage:null,reasoningMessage:null,isReasoning:!1,stepInfo:null,approvals:[],error:null,flowConfig:null,composioAuth:null};function T(n){return q()(V((t,y)=>({...F,initHistory:e=>t({messages:e}),addEvent:e=>t(o=>({events:[...o.events,{...e,ts:Date.now()}]})),clearEvents:()=>t({events:[]}),setMessages:e=>{t({messages:e})},addMessage:e=>{t(o=>({messages:[...o.messages,e]}))},setTyping:e=>t({typingMessage:e}),appendTyping:(e,o)=>{let i=y().typingMessage;i&&i.id===e?t({typingMessage:{id:e,text:i.text+o}}):t({typingMessage:{id:e,text:o}})},clearTyping:()=>t({typingMessage:null}),setReasoning:e=>t({reasoningMessage:e}),appendReasoning:(e,o)=>{let i=y().reasoningMessage;i&&i.id===e?t({reasoningMessage:{id:e,text:i.text+o}}):t({reasoningMessage:{id:e,text:o}})},clearReasoning:()=>t({reasoningMessage:null,isReasoning:!1}),setReasoningActive:e=>t({isReasoning:e}),setStep:e=>t({stepInfo:e}),clearStep:()=>t({stepInfo:null}),setStatus:e=>t({status:e}),toggleEvents:()=>t(e=>({eventsVisible:!e.eventsVisible})),clearHistory:()=>t({messages:[],typingMessage:null,reasoningMessage:null,isReasoning:!1,stepInfo:null}),addApprovalRequest:e=>{let o={id:`approval-${Date.now()}-${Math.random()}`,toolCallId:e.toolCallId,toolName:e.toolName,args:e.args??{},description:e.description,ts:Date.now(),status:"pending"};t(i=>({approvals:[...i.approvals,o]}))},updateApprovalStatus:({toolCallId:e,status:o})=>{t(i=>({approvals:i.approvals.map(v=>v.toolCallId===e?{...v,status:o}:v)}))},removeApproval:e=>{t(o=>({approvals:o.approvals.filter(i=>i.toolCallId!==e)}))},setError:e=>t({error:e}),setFlowConfig:e=>t({flowConfig:e}),setComposioAuth:e=>t({composioAuth:e}),clearComposioAuth:()=>t({composioAuth:null})}),{name:n,enabled:!0}))}var D=T("agent-store"),M=new Map;function I(n){if(!n)return D;let t=M.get(n);return t||(t=T(`agent-store:${n}`),M.set(n,t)),t}function we(n){let t=U(()=>I(n==null?void 0:n.storeKey),[n==null?void 0:n.storeKey]),y=t(s=>s.typingMessage),e=S(null),o=S(null),i=S(null),v=S(null);j(()=>{e.current=y},[y]);let A=u(s=>{var g;let r=s.trim().slice(0,E);!r||typeof((g=v.current)==null?void 0:g.send)!="function"||v.current.send(d.USER_IDENTITY+":"+r)},[]),l=H({host:n==null?void 0:n.host,basePath:(n==null?void 0:n.basePath)??"/api/agents/base",agent:n==null?void 0:n.agent,name:n==null?void 0:n.name,query:n==null?void 0:n.query,onMessage:s=>{if(typeof s.data!="string")return;let[r,g]=s.data.split("::");if(!r||!g)return;let a=t.getState(),f={[d.SERVER_HISTORY]:p=>{let c=JSON.parse(p);a.setMessages(c.messages)},[d.SERVER_EVENT]:p=>{var R;let c=JSON.parse(p);if((c==null?void 0:c.type)==="info:composio:auth_required"&&((R=c==null?void 0:c.content)!=null&&R.redirectUrl)){let m=c.content;a.setComposioAuth({toolkit:m.toolkit,redirectUrl:m.redirectUrl,toolRowId:m.toolRowId})}a.addEvent({type:"server",...c})},[d.SERVER_ERROR]:p=>{a.setError(p),a.addEvent({type:"error",content:p})},[d.SERVER_TEXT_STREAM]:p=>{o.current?a.appendTyping(o.current,p):(o.current=String(Date.now()),a.setTyping({id:o.current,text:p}))},[d.SERVER_TEXT_STREAM_COMPLETE]:p=>{if(a.setReasoningActive(!1),o.current&&a.typingMessage){let c=a.typingMessage.text;a.addMessage({role:"assistant",type:"text",content:c,id:o.current,ts:Date.now()}),a.clearTyping(),o.current=null}},[d.SERVER_REASONING_STREAM]:p=>{a.setReasoningActive(!0),i.current?a.appendReasoning(i.current,p):(i.current=String(Date.now()),a.setReasoning({id:i.current,text:p}))},[d.SERVER_REASONING_STREAM_COMPLETE]:()=>{i.current=null,a.setReasoningActive(!1)},[d.SERVER_CONFIG]:p=>{a.setFlowConfig(JSON.parse(p))}};f[r]&&f[r](g)},onOpen:()=>{let s=t.getState();s.setStatus("connected"),s.clearTyping(),o.current=null,s.clearReasoning(),i.current=null,s.clearStep(),s.addEvent({type:"connection",content:"Connected to Agent Server"}),n!=null&&n.user&&A(n.user)},onClose:()=>{let s=t.getState();s.setStatus("disconnected"),s.setFlowConfig(null),s.addEvent({type:"connection",content:"Connection closed"})}});v.current=l;let C=u((s,r,g)=>{let a=s.trim();if(!a&&(!r||r.length===0)&&(!g||g.length===0))return;let p=((r==null?void 0:r.length)??0)>0||((g==null?void 0:g.length)??0)>0?JSON.stringify({text:a,images:r,documents:g}):a;l.send(d.USER_MESSAGE+":"+p);let c=t.getState();i.current=null,c.clearReasoning(),c.addMessage({id:String(Date.now())+Math.random(),role:"user",type:"text",content:a,images:r,ts:Date.now()})},[l]),h=u(()=>{t.getState().clearHistory(),l.send(d.USER_CLEAR_HISTORY+":1")},[l]),w=u((s,r)=>{let g=s.trim();g&&l.send(d.USER_AUTH+":"+JSON.stringify({name:g,value:r}))},[l]),x=u(s=>{A(s)},[A]),_=u(()=>t.getState().toggleEvents(),[]),b=u(()=>t.getState().clearEvents(),[]),N=u(s=>{let r=t.getState();r.updateApprovalStatus({toolCallId:s,status:"approved"});let g=JSON.stringify({type:"tool_approval",toolCallId:s,approved:!0});typeof(l==null?void 0:l.send)=="function"&&l.send(g),r.addEvent({type:"approval",content:`Approved tool call ${s}`,ts:Date.now()})},[l]),O=u(s=>{let r=t.getState();r.updateApprovalStatus({toolCallId:s,status:"rejected"});let g=JSON.stringify({type:"tool_approval",toolCallId:s,approved:!1});typeof(l==null?void 0:l.send)=="function"&&l.send(g),r.addEvent({type:"approval",content:`Rejected tool call ${s}`,ts:Date.now()})},[l]);return{connection:l,store:t,send:C,clearHistory:h,sendAuth:w,setIdentity:x,toggleEventsVisible:_,clearEvents:b,approve:N,reject:O}}export{z as GENERATION_PARAM_KEYS,W as GENERATION_PRESETS,E as MAX_USER_IDENTITY_LENGTH,Ae as MODEL_REGISTRY_SNAPSHOT,J as NodeType,B as PRESET_PARAM_KEYS,pe as REASONING_EFFORT_LEVELS,Se as TOOL_REGISTRY_SNAPSHOT,te as applyPresetToOverrides,ye as buildReasoningProviderOptions,Z as deriveParamSupport,I as getAgentStore,k as getDefaultOutVars,K as getEffectiveOutVars,fe as getModelEntry,P as logc,d as messageTypes,se as normalizeEffectiveParams,ce as normalizeReasoning,ae as openAiReasoningParamSupport,re as openAiStandardParamSupport,L as parseUserAuth,G as parseUserMessage,ne as pickNodeOverrides,de as reasoningEffortLevels,ue as reasoningExposable,Q as resolveOutVarRef,ee as resolvePreset,ve as resolveReasoningEffort,X as resolveTemplate,$ as sanitizeUserIdentity,le as stripUnsupportedFromNodeData,oe as toStreamTextSettings,we as useAgent,D as useAgentStore,Y as walkPath,ge as workersAiParamSupport,ie as xaiParamSupport};
+import{a as d,b as G,c as E,d as $,e as L,f as Se,g as Ae,h as fe}from"./chunk-HAYNUZZB.js";import{a as J,b as Y,c as k,d as K,e as Q,f as X}from"./chunk-OYP6D5VN.js";import{a as z,b as B,c as W,d as Z,e as ee,f as te,g as ne,h as se,i as oe,j as re,k as ae,l as ie,m as ge,n as le,o as pe,p as ce,q as de,r as ue,s as ve,t as ye}from"./chunk-GRZ6ZRHM.js";import{a as P}from"./chunk-U56YWPSI.js";import"./chunk-3TXHFKDN.js";import{useAgent as H}from"agents/react";import{useCallback as u,useEffect as j,useMemo as U,useRef as S}from"react";import{create as q}from"zustand";import{devtools as V}from"zustand/middleware";var F={messages:[],events:[],eventsVisible:!1,status:"connecting",typingMessage:null,reasoningMessage:null,isReasoning:!1,stepInfo:null,approvals:[],error:null,flowConfig:null,composioAuth:null};function T(n){return q()(V((t,y)=>({...F,initHistory:e=>t({messages:e}),addEvent:e=>t(o=>({events:[...o.events,{...e,ts:Date.now()}]})),clearEvents:()=>t({events:[]}),setMessages:e=>{t({messages:e})},addMessage:e=>{t(o=>({messages:[...o.messages,e]}))},setTyping:e=>t({typingMessage:e}),appendTyping:(e,o)=>{let i=y().typingMessage;i&&i.id===e?t({typingMessage:{id:e,text:i.text+o}}):t({typingMessage:{id:e,text:o}})},clearTyping:()=>t({typingMessage:null}),setReasoning:e=>t({reasoningMessage:e}),appendReasoning:(e,o)=>{let i=y().reasoningMessage;i&&i.id===e?t({reasoningMessage:{id:e,text:i.text+o}}):t({reasoningMessage:{id:e,text:o}})},clearReasoning:()=>t({reasoningMessage:null,isReasoning:!1}),setReasoningActive:e=>t({isReasoning:e}),setStep:e=>t({stepInfo:e}),clearStep:()=>t({stepInfo:null}),setStatus:e=>t({status:e}),toggleEvents:()=>t(e=>({eventsVisible:!e.eventsVisible})),clearHistory:()=>t({messages:[],typingMessage:null,reasoningMessage:null,isReasoning:!1,stepInfo:null}),addApprovalRequest:e=>{let o={id:`approval-${Date.now()}-${Math.random()}`,toolCallId:e.toolCallId,toolName:e.toolName,args:e.args??{},description:e.description,ts:Date.now(),status:"pending"};t(i=>({approvals:[...i.approvals,o]}))},updateApprovalStatus:({toolCallId:e,status:o})=>{t(i=>({approvals:i.approvals.map(v=>v.toolCallId===e?{...v,status:o}:v)}))},removeApproval:e=>{t(o=>({approvals:o.approvals.filter(i=>i.toolCallId!==e)}))},setError:e=>t({error:e}),setFlowConfig:e=>t({flowConfig:e}),setComposioAuth:e=>t({composioAuth:e}),clearComposioAuth:()=>t({composioAuth:null})}),{name:n,enabled:!0}))}var D=T("agent-store"),M=new Map;function I(n){if(!n)return D;let t=M.get(n);return t||(t=T(`agent-store:${n}`),M.set(n,t)),t}function we(n){let t=U(()=>I(n==null?void 0:n.storeKey),[n==null?void 0:n.storeKey]),y=t(s=>s.typingMessage),e=S(null),o=S(null),i=S(null),v=S(null);j(()=>{e.current=y},[y]);let A=u(s=>{var g;let r=s.trim().slice(0,E);!r||typeof((g=v.current)==null?void 0:g.send)!="function"||v.current.send(d.USER_IDENTITY+":"+r)},[]),l=H({host:n==null?void 0:n.host,basePath:(n==null?void 0:n.basePath)??"/api/agents/base",agent:n==null?void 0:n.agent,name:n==null?void 0:n.name,query:n==null?void 0:n.query,onMessage:s=>{if(typeof s.data!="string")return;let[r,g]=s.data.split("::");if(!r||!g)return;let a=t.getState(),f={[d.SERVER_HISTORY]:p=>{let c=JSON.parse(p);a.setMessages(c.messages)},[d.SERVER_EVENT]:p=>{var R;let c=JSON.parse(p);if((c==null?void 0:c.type)==="info:composio:auth_required"&&((R=c==null?void 0:c.content)!=null&&R.redirectUrl)){let m=c.content;a.setComposioAuth({toolkit:m.toolkit,redirectUrl:m.redirectUrl,toolRowId:m.toolRowId})}a.addEvent({type:"server",...c})},[d.SERVER_ERROR]:p=>{a.setError(p),a.addEvent({type:"error",content:p})},[d.SERVER_TEXT_STREAM]:p=>{o.current?a.appendTyping(o.current,p):(o.current=String(Date.now()),a.setTyping({id:o.current,text:p}))},[d.SERVER_TEXT_STREAM_COMPLETE]:p=>{if(a.setReasoningActive(!1),o.current&&a.typingMessage){let c=a.typingMessage.text;a.addMessage({role:"assistant",type:"text",content:c,id:o.current,ts:Date.now()}),a.clearTyping(),o.current=null}},[d.SERVER_REASONING_STREAM]:p=>{a.setReasoningActive(!0),i.current?a.appendReasoning(i.current,p):(i.current=String(Date.now()),a.setReasoning({id:i.current,text:p}))},[d.SERVER_REASONING_STREAM_COMPLETE]:()=>{i.current=null,a.setReasoningActive(!1)},[d.SERVER_CONFIG]:p=>{a.setFlowConfig(JSON.parse(p))}};f[r]&&f[r](g)},onOpen:()=>{let s=t.getState();s.setStatus("connected"),s.clearTyping(),o.current=null,s.clearReasoning(),i.current=null,s.clearStep(),s.addEvent({type:"connection",content:"Connected to Agent Server"}),n!=null&&n.user&&A(n.user)},onClose:()=>{let s=t.getState();s.setStatus("disconnected"),s.setFlowConfig(null),s.addEvent({type:"connection",content:"Connection closed"})}});v.current=l;let C=u((s,r,g)=>{let a=s.trim();if(!a&&(!r||r.length===0)&&(!g||g.length===0))return;let p=((r==null?void 0:r.length)??0)>0||((g==null?void 0:g.length)??0)>0?JSON.stringify({text:a,images:r,documents:g}):a;l.send(d.USER_MESSAGE+":"+p);let c=t.getState();i.current=null,c.clearReasoning(),c.addMessage({id:String(Date.now())+Math.random(),role:"user",type:"text",content:a,images:r,ts:Date.now()})},[l]),h=u(()=>{t.getState().clearHistory(),l.send(d.USER_CLEAR_HISTORY+":1")},[l]),w=u((s,r)=>{let g=s.trim();g&&l.send(d.USER_AUTH+":"+JSON.stringify({name:g,value:r}))},[l]),x=u(s=>{A(s)},[A]),_=u(()=>t.getState().toggleEvents(),[]),b=u(()=>t.getState().clearEvents(),[]),N=u(s=>{let r=t.getState();r.updateApprovalStatus({toolCallId:s,status:"approved"});let g=JSON.stringify({type:"tool_approval",toolCallId:s,approved:!0});typeof(l==null?void 0:l.send)=="function"&&l.send(g),r.addEvent({type:"approval",content:`Approved tool call ${s}`,ts:Date.now()})},[l]),O=u(s=>{let r=t.getState();r.updateApprovalStatus({toolCallId:s,status:"rejected"});let g=JSON.stringify({type:"tool_approval",toolCallId:s,approved:!1});typeof(l==null?void 0:l.send)=="function"&&l.send(g),r.addEvent({type:"approval",content:`Rejected tool call ${s}`,ts:Date.now()})},[l]);return{connection:l,store:t,send:C,clearHistory:h,sendAuth:w,setIdentity:x,toggleEventsVisible:_,clearEvents:b,approve:N,reject:O}}export{z as GENERATION_PARAM_KEYS,W as GENERATION_PRESETS,E as MAX_USER_IDENTITY_LENGTH,Ae as MODEL_REGISTRY_SNAPSHOT,J as NodeType,B as PRESET_PARAM_KEYS,pe as REASONING_EFFORT_LEVELS,Se as TOOL_REGISTRY_SNAPSHOT,te as applyPresetToOverrides,ye as buildReasoningProviderOptions,Z as deriveParamSupport,I as getAgentStore,k as getDefaultOutVars,K as getEffectiveOutVars,fe as getModelEntry,P as logc,d as messageTypes,se as normalizeEffectiveParams,ce as normalizeReasoning,ae as openAiReasoningParamSupport,re as openAiStandardParamSupport,L as parseUserAuth,G as parseUserMessage,ne as pickNodeOverrides,de as reasoningEffortLevels,ue as reasoningExposable,Q as resolveOutVarRef,ee as resolvePreset,ve as resolveReasoningEffort,X as resolveTemplate,$ as sanitizeUserIdentity,le as stripUnsupportedFromNodeData,oe as toStreamTextSettings,we as useAgent,D as useAgentStore,Y as walkPath,ge as workersAiParamSupport,ie as xaiParamSupport};

package/dist/common/constants/ai-models.d.ts

@@ -0,0 +1,10 @@
+import type { ModelEntry, ModelRegistrySnapshot } from '../types/ai-models-types';
+/**
+ * @deprecated Static model registry removed. Runtime resolves models from hx-ora
+ * (KV/D1 via getOraModel / fetchOraModel). This export is an empty stub.
+ */
+export declare const MODEL_REGISTRY_SNAPSHOT: ModelRegistrySnapshot;
+/**
+ * @deprecated Use hx-ora backend model records instead.
+ */
+export declare function getModelEntry(_id: string): ModelEntry | undefined;

package/dist/common/constants/tools-registry.d.ts

@@ -0,0 +1,8 @@
+interface ToolEntry {
+    id: string;
+    label: string;
+    description: string;
+    parameters?: Record<string, any>;
+}
+export declare const TOOL_REGISTRY_SNAPSHOT: Record<string, ToolEntry>;
+export {};

package/dist/common/types/agent-types.d.ts

@@ -0,0 +1,61 @@
+export declare const messageTypes: {
+    readonly USER_MESSAGE: 'M';
+    readonly USER_CLEAR_HISTORY: 'CH';
+    readonly USER_AUTH: 'AUT';
+    readonly USER_IDENTITY: 'UID';
+    readonly SERVER_EVENT: 'SE';
+    readonly SERVER_HISTORY: 'HIS';
+    readonly SERVER_ERROR: 'ERR';
+    readonly SERVER_STEP: 'STEP';
+    readonly SERVER_TEXT_STREAM: 'TS';
+    readonly SERVER_TEXT_STREAM_COMPLETE: 'TSC';
+    readonly SERVER_REASONING_STREAM: 'RS';
+    readonly SERVER_REASONING_STREAM_COMPLETE: 'RSC';
+    readonly SERVER_CONFIG: 'CFG';
+};
+export type FlowConfig = {
+    allow_images: boolean;
+    allow_documents: boolean;
+    greeting?: string;
+};
+export type Message = {
+    id?: string;
+    role: 'user' | 'assistant';
+    type: 'text' | 'url';
+    content: any;
+    images?: {
+        mimeType: string;
+        data: string;
+    }[];
+    ts: number;
+};
+export type EventItem = {
+    type: string;
+    content: any;
+    [key: string]: any;
+};
+export type TypingMessage = {
+    id: string;
+    text: string;
+} | null;
+export type StepInfo = {
+    tool?: string;
+    phase?: string;
+} | null;
+export type MessageType = (typeof messageTypes)[keyof typeof messageTypes];
+export type ChatHistoryItem = {
+    role: 'user' | 'assistant';
+    content: string;
+};
+export type ApprovalRequestPayload = {
+    type: 'tool_approval_request';
+    toolCallId: string;
+    toolName: string;
+    args: any;
+    description: string;
+};
+export type ToolExecutionResultPayload = {
+    toolCallId: string;
+    result: string;
+    approved: boolean;
+};

package/dist/common/types/ai-models-types.d.ts

@@ -0,0 +1,94 @@
+export type EffectiveParams = {
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    maxOutputTokens?: number;
+    seed?: number;
+    stopSequences?: string[];
+    maxRetries?: number;
+};
+export type ParamRange = {
+    min: number;
+    max: number;
+    step?: number;
+};
+export type ParamSupport = {
+    temperature?: ParamRange | false;
+    topP?: ParamRange | false;
+    topK?: ParamRange | false;
+    frequencyPenalty?: ParamRange | false;
+    presencePenalty?: ParamRange | false;
+    maxOutputTokens?: {
+        max: number;
+    } | false;
+    seed?: boolean;
+    stopSequences?: {
+        max: number;
+    } | false;
+};
+export type ReasoningEffortLevel = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+/**
+ * Describes how a model exposes/controls "reasoning". This is the SOURCE OF TRUTH —
+ * declared per-model in the capabilities registry, never inferred from the provider at runtime.
+ *
+ * - `none`   → model does not reason (or reasoning is not surfaced).
+ * - `effort` → opaque reasoning controlled via a provider `reasoningEffort` knob
+ *              (e.g. OpenAI o-series / gpt-5, xAI grok). `levels` lists the values THIS
+ *              model accepts; `exposesReasoning` marks models that can stream a reasoning
+ *              summary (OpenAI needs `reasoningSummary` for this).
+ * - `tag`    → model "thinks out loud" inside XML-like tags in the text stream
+ *              (e.g. DeepSeek R1); reasoning is extracted via middleware (always exposable).
+ */
+export type ReasoningCapability = {
+    kind: 'none';
+} | {
+    kind: 'effort';
+    levels?: ReasoningEffortLevel[];
+    defaultLevel?: ReasoningEffortLevel;
+    exposesReasoning?: boolean;
+} | {
+    kind: 'tag';
+    tagName?: string;
+    startWithReasoning?: boolean;
+};
+export type Capabilities = {
+    function_calling: boolean;
+    /** `true`/`false` is the legacy shape; prefer the structured {@link ReasoningCapability}. */
+    reasoning: boolean | ReasoningCapability;
+    multimodal: boolean;
+    params?: ParamSupport;
+};
+export type GenerationPresetId = 'precise' | 'balanced' | 'creative' | 'custom';
+export type ModelEntry = {
+    id: string;
+    label: string;
+    provider: 'openai' | 'cloudflare' | 'workersai' | string;
+    providerModel: string;
+    author: string;
+    description?: string;
+    defaultParams?: EffectiveParams;
+    capabilities?: Capabilities;
+    tags?: string[];
+    price?: {
+        input: number;
+        output: number;
+    };
+    contextWindow?: number;
+};
+export type ModelRegistrySnapshot = Record<string, ModelEntry>;
+export type ParamAdjustment = {
+    key: string;
+    action: 'stripped' | 'clamped';
+    detail?: string;
+};
+export type ResolvedModel = {
+    provider: string;
+    modelHandle: any;
+    entry: ModelEntry;
+    effectiveParams: EffectiveParams;
+    paramAdjustments?: ParamAdjustment[];
+    /** Normalized reasoning descriptor for this model (never the legacy boolean). */
+    reasoning: ReasoningCapability;
+};

package/dist/common/types/memory-types.d.ts

@@ -0,0 +1,28 @@
+export type MemoryMode = 'raw' | 'summarize';
+export type ContextDomain = 'tool' | 'summary' | 'keydata' | 'info' | 'skill';
+export interface MemoryConfig {
+    enabled: boolean;
+    mode: MemoryMode;
+    summaryModel: string;
+    summaryThreshold: number;
+    toolCache: boolean;
+}
+export interface ContextMeta {
+    toolName?: string;
+    paramsHash?: string;
+    cacheable?: boolean;
+    truncated?: boolean;
+}
+export interface ContextRow {
+    ref: string;
+    domain: ContextDomain;
+    description: string;
+    data?: string;
+    cycle: number;
+    meta?: string;
+    ts: number;
+}
+export type ContextIndexEntry = Pick<ContextRow, 'ref' | 'domain' | 'description' | 'cycle' | 'ts' | 'meta'>;
+export type ContextUpsertInput = Omit<ContextRow, 'ts'> & {
+    ts?: number;
+};

package/dist/common/types/node-types.d.ts

@@ -0,0 +1,9 @@
+export declare enum NodeType {
+    START_NODE = "startNode",
+    CLASSIFIER_NODE = "classifierNode",
+    MEMO_NODE = "memoNode",
+    LLM_NODE = "llmNode",
+    ANSWER_NODE = "answerNode",
+    API_NODE = "apiNode"
+}
+export type NODETYPES = NodeType.START_NODE | NodeType.CLASSIFIER_NODE | NodeType.MEMO_NODE | NodeType.LLM_NODE | NodeType.ANSWER_NODE | NodeType.API_NODE;

package/dist/common/types/user-types.d.ts

@@ -0,0 +1,11 @@
+export interface UserInterface {
+    id: string;
+    email: string;
+    name: string;
+    first_name: string;
+    last_name: string;
+    tenant: string;
+    roles: string;
+    db_name: string | null;
+    user_id: string | null;
+}

package/dist/common/types/var-mapping.d.ts

@@ -0,0 +1,29 @@
+export interface FlowNode {
+    id: string;
+    type: string;
+    data?: any;
+}
+export interface VariableMapping {
+    var: string;
+    from: string;
+    default?: string;
+}
+export interface OutVar {
+    name: string;
+    path?: string;
+    label?: string;
+    description?: string;
+    type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'image' | 'file';
+    source?: 'default' | 'user';
+}
+export interface ResolveInput {
+    context: Record<string, any>;
+    results: Record<string, any>;
+    nodes: FlowNode[];
+    secrets?: Record<string, string>;
+}
+export interface ResolveOptions {
+    callerTag?: string;
+    serializeNonStrings?: boolean;
+    onError?: (msg: string) => void;
+}

package/dist/common/types/ws-message.d.ts

@@ -0,0 +1,58 @@
+export type WsServerMessageType = 'chunk' | 'finish' | 'error' | 'complete' | 'history';
+export type WsClientMessageType = 'message' | 'debug';
+export interface WsServerMessage {
+    type: WsServerMessageType;
+    content: string;
+    timestamp: number;
+}
+export interface WsHistory extends WsServerMessage {
+    type: 'history';
+    messages: any[];
+}
+export interface WsError extends WsServerMessage {
+    type: 'error';
+    error: string;
+}
+export interface WsComplete extends WsServerMessage {
+    type: 'complete';
+    done: boolean;
+}
+export interface WsClientMessage {
+    type: WsClientMessageType;
+    timestamp: number;
+}
+export interface WsMessage extends WsClientMessage {
+    type: 'message';
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface wsDebug extends WsClientMessage {
+    type: 'debug';
+    content: string;
+}
+export interface UserMessagePayload {
+    text: string;
+    images?: {
+        mimeType: string;
+        data: string;
+    }[];
+    documents?: {
+        name: string;
+        mimeType: string;
+        data: string;
+    }[];
+}
+export declare function parseUserMessage(content: string): UserMessagePayload;
+export interface UserAuthPayload {
+    name: string;
+    value: string;
+}
+/**
+ * Parse an `AUT` message payload: JSON `{ name, value }`.
+ * `name` must match the secrets grammar `[A-Z][A-Z0-9_]*` so it aligns with the
+ * `{{ auth.NAME }}` template namespace. Returns null on any malformed input.
+ */
+export declare const MAX_USER_IDENTITY_LENGTH = 256;
+/** Trim and cap a client-supplied session identity string. Returns null if empty. */
+export declare function sanitizeUserIdentity(content: string): string | null;
+export declare function parseUserAuth(content: string): UserAuthPayload | null;