@useago/sdk 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/api/HttpClient.d.ts +31 -0
- package/dist/api/index.d.ts +1 -0
- package/dist/client/AgoClient.d.ts +113 -0
- package/dist/client/errors.d.ts +48 -0
- package/dist/client/index.d.ts +3 -0
- package/dist/client/types.d.ts +203 -0
- package/dist/createMockClient-BZKh_1em.cjs +941 -0
- package/dist/createMockClient-BZKh_1em.cjs.map +1 -0
- package/dist/createMockClient-uGlVyjbL.js +942 -0
- package/dist/createMockClient-uGlVyjbL.js.map +1 -0
- package/dist/functions/FunctionRegistry.d.ts +41 -0
- package/dist/functions/defineFunction.d.ts +22 -0
- package/dist/functions/index.d.ts +2 -0
- package/dist/functions/types.d.ts +50 -0
- package/dist/index.cjs +20 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.ts +12 -0
- package/dist/index.js +20 -0
- package/dist/index.js.map +1 -0
- package/dist/react/components/ChatInput.d.ts +12 -0
- package/dist/react/components/ChatWidget.d.ts +33 -0
- package/dist/react/components/Message.d.ts +7 -0
- package/dist/react/components/index.d.ts +6 -0
- package/dist/react/context/AgoContext.d.ts +36 -0
- package/dist/react/context/index.d.ts +2 -0
- package/dist/react/hooks/index.d.ts +6 -0
- package/dist/react/hooks/useAgo.d.ts +14 -0
- package/dist/react/hooks/useAgoFunction.d.ts +46 -0
- package/dist/react/hooks/useChat.d.ts +45 -0
- package/dist/react/hooks/useConversation.d.ts +28 -0
- package/dist/react/hooks/useMessages.d.ts +26 -0
- package/dist/react/index.d.ts +20 -0
- package/dist/react/testing.d.ts +2 -0
- package/dist/react.cjs +10585 -0
- package/dist/react.cjs.map +1 -0
- package/dist/react.d.ts +1 -0
- package/dist/react.js +10586 -0
- package/dist/react.js.map +1 -0
- package/dist/streaming/SSEHandler.d.ts +46 -0
- package/dist/streaming/index.d.ts +2 -0
- package/dist/testing/createMockClient.d.ts +42 -0
- package/dist/testing/index.d.ts +2 -0
- package/dist/utils/eventEmitter.d.ts +23 -0
- package/dist/utils/index.d.ts +2 -0
- package/dist/utils/logger.d.ts +14 -0
- package/dist/widget/index.d.ts +1 -0
- package/dist/widget/types.d.ts +42 -0
- package/dist/widget.cjs +2 -0
- package/dist/widget.cjs.map +1 -0
- package/dist/widget.d.ts +1 -0
- package/dist/widget.js +2 -0
- package/dist/widget.js.map +1 -0
- package/package.json +83 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createMockClient-uGlVyjbL.js","sources":["../src/client/errors.ts","../src/utils/logger.ts","../src/api/HttpClient.ts","../src/functions/FunctionRegistry.ts","../src/streaming/SSEHandler.ts","../src/utils/eventEmitter.ts","../src/client/AgoClient.ts","../src/testing/createMockClient.ts"],"sourcesContent":["/**\n * Base error class for AGO SDK\n */\nexport class AgoError extends Error {\n constructor(\n message: string,\n public code: string,\n public statusCode?: number\n ) {\n super(message);\n this.name = \"AgoError\";\n }\n}\n\n/**\n * Error from API response\n */\nexport class AgoApiError extends AgoError {\n constructor(\n message: string,\n code: string,\n statusCode: number,\n public type: string,\n public param?: string,\n public docUrl?: string\n ) {\n super(message, code, statusCode);\n this.name = \"AgoApiError\";\n }\n\n static fromResponse(data: ApiErrorResponse, statusCode: number): AgoApiError {\n const error = data.error;\n return new AgoApiError(\n error.message,\n error.code,\n statusCode,\n error.type,\n error.param,\n error.doc_url\n );\n }\n}\n\nexport interface ApiErrorResponse {\n error: {\n type: string;\n code: string;\n message: string;\n param?: string;\n doc_url?: string;\n };\n}\n\n/**\n * Network/connection error\n */\nexport class AgoNetworkError extends AgoError {\n constructor(message: string, public originalError?: Error) {\n super(message, \"network_error\");\n this.name = \"AgoNetworkError\";\n }\n}\n\n/**\n * SSE stream error\n */\nexport class AgoStreamError extends AgoError {\n constructor(message: string) {\n super(message, \"stream_error\");\n this.name = \"AgoStreamError\";\n }\n}\n\n/**\n * Function execution error\n */\nexport class AgoFunctionError extends AgoError {\n constructor(\n message: string,\n public functionName: string,\n public originalError?: Error\n ) {\n super(message, \"function_error\");\n this.name = \"AgoFunctionError\";\n }\n}\n","/**\n * Debug logger for SDK\n */\nexport class Logger {\n constructor(private enabled: boolean = false) {}\n\n enable(): void {\n this.enabled = true;\n }\n\n disable(): void {\n this.enabled = false;\n }\n\n log(...args: unknown[]): void {\n if (this.enabled) {\n console.log(\"[AGO SDK]\", ...args);\n }\n }\n\n warn(...args: unknown[]): void {\n if (this.enabled) {\n console.warn(\"[AGO SDK]\", ...args);\n }\n }\n\n error(...args: unknown[]): void {\n // Always log errors\n console.error(\"[AGO SDK]\", ...args);\n }\n\n debug(...args: unknown[]): void {\n if (this.enabled) {\n console.debug(\"[AGO SDK]\", ...args);\n }\n }\n}\n\nexport const logger = new Logger();\n","import { AgoApiError, AgoNetworkError, ApiErrorResponse } from \"../client/errors\";\nimport type { AgoConfig } from \"../client/types\";\nimport { logger } from \"../utils/logger\";\n\nconst DEFAULT_BASE_URL = \"https://api.useago.com\";\n\n/**\n * HTTP client with authentication headers\n */\nexport class HttpClient {\n private baseUrl: string;\n private headers: Record<string, string>;\n\n constructor(config: AgoConfig) {\n this.baseUrl = config.baseUrl?.replace(/\\/$/, \"\") || DEFAULT_BASE_URL;\n this.headers = {\n \"X-Widget-Key\": config.apiKey,\n \"X-Widget-Id\": config.widgetId,\n };\n\n if (config.userEmail) {\n this.headers[\"X-User-Email\"] = config.userEmail;\n }\n\n if (config.userJwt) {\n this.headers[\"Authorization\"] = `Bearer ${config.userJwt}`;\n }\n }\n\n /**\n * Update configuration (e.g., JWT token)\n */\n updateConfig(config: Partial<AgoConfig>): void {\n if (config.baseUrl) {\n this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n }\n if (config.apiKey) {\n this.headers[\"X-Widget-Key\"] = config.apiKey;\n }\n if (config.widgetId) {\n this.headers[\"X-Widget-Id\"] = config.widgetId;\n }\n if (config.userEmail) {\n this.headers[\"X-User-Email\"] = config.userEmail;\n }\n if (config.userJwt) {\n this.headers[\"Authorization\"] = `Bearer ${config.userJwt}`;\n }\n }\n\n /**\n * Make a GET request\n */\n async get<T>(path: string): Promise<T> {\n return this.request<T>(\"GET\", path);\n }\n\n /**\n * Make a POST request with JSON body\n */\n async post<T>(path: string, body?: unknown): Promise<T> {\n return this.request<T>(\"POST\", path, body);\n }\n\n /**\n * Make a POST request and return the raw Response (for streaming)\n */\n async postStream(path: string, body?: unknown): Promise<Response> {\n const url = `${this.baseUrl}${path}`;\n logger.debug(\"POST (stream)\", url, body);\n\n try {\n const response = await fetch(url, {\n method: \"POST\",\n headers: {\n ...this.headers,\n \"Content-Type\": \"application/json\",\n },\n body: body ? JSON.stringify(body) : undefined,\n });\n\n if (!response.ok) {\n await this.handleErrorResponse(response);\n }\n\n return response;\n } catch (error) {\n if (error instanceof AgoApiError) {\n throw error;\n }\n throw new AgoNetworkError(\n `Network error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Make a POST request with FormData (for file uploads)\n */\n async postFormData(path: string, formData: FormData): Promise<Response> {\n const url = `${this.baseUrl}${path}`;\n logger.debug(\"POST (formData)\", url);\n\n // Don't set Content-Type for FormData - browser sets it with boundary\n const headers = { ...this.headers };\n\n try {\n const response = await fetch(url, {\n method: \"POST\",\n headers,\n body: formData,\n });\n\n if (!response.ok) {\n await this.handleErrorResponse(response);\n }\n\n return response;\n } catch (error) {\n if (error instanceof AgoApiError) {\n throw error;\n }\n throw new AgoNetworkError(\n `Network error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n error instanceof Error ? error : undefined\n );\n }\n }\n\n private async request<T>(\n method: string,\n path: string,\n body?: unknown\n ): Promise<T> {\n const url = `${this.baseUrl}${path}`;\n logger.debug(method, url, body);\n\n try {\n const response = await fetch(url, {\n method,\n headers: {\n ...this.headers,\n \"Content-Type\": \"application/json\",\n },\n body: body ? JSON.stringify(body) : undefined,\n });\n\n if (!response.ok) {\n await this.handleErrorResponse(response);\n }\n\n // Handle 204 No Content\n if (response.status === 204) {\n return undefined as T;\n }\n\n return response.json();\n } catch (error) {\n if (error instanceof AgoApiError) {\n throw error;\n }\n throw new AgoNetworkError(\n `Network error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n error instanceof Error ? error : undefined\n );\n }\n }\n\n private async handleErrorResponse(response: Response): Promise<never> {\n let errorData: ApiErrorResponse | undefined;\n\n try {\n errorData = await response.json();\n } catch {\n // Response is not JSON\n }\n\n if (errorData?.error) {\n throw AgoApiError.fromResponse(errorData, response.status);\n }\n\n throw new AgoApiError(\n `HTTP ${response.status}: ${response.statusText}`,\n \"http_error\",\n response.status,\n \"api_error\"\n );\n }\n}\n","import { AgoFunctionError } from \"../client/errors\";\nimport { logger } from \"../utils/logger\";\nimport type {\n ClientFunctionDefinition,\n ClientFunctionHandler,\n ClientFunctionSchema,\n RegisteredFunction,\n} from \"./types\";\n\n/**\n * Registry for client-side functions that AGO can call\n */\nexport class FunctionRegistry {\n private functions: Map<string, RegisteredFunction> = new Map();\n\n /**\n * Register a function that AGO can call.\n * Accepts either a single definition object or (name, handler, schema) args.\n */\n register(definition: ClientFunctionDefinition): void;\n register(\n name: string,\n handler: ClientFunctionHandler,\n schema: Omit<ClientFunctionSchema, \"name\">\n ): void;\n register(\n nameOrDef: string | ClientFunctionDefinition,\n handler?: ClientFunctionHandler,\n schema?: Omit<ClientFunctionSchema, \"name\">\n ): void {\n if (typeof nameOrDef === \"object\") {\n const { name, handler: h, description, parameters } = nameOrDef;\n return this.register(name, h, { description, parameters });\n }\n\n const name = nameOrDef;\n if (!handler || !schema) {\n throw new Error(\"handler and schema are required\");\n }\n if (this.functions.has(name)) {\n logger.warn(`Function \"${name}\" is being overwritten`);\n }\n\n this.functions.set(name, {\n schema: { ...schema, name },\n handler,\n });\n\n logger.log(`Registered function: ${name}`);\n }\n\n /**\n * Unregister a function\n */\n unregister(name: string): boolean {\n const deleted = this.functions.delete(name);\n if (deleted) {\n logger.log(`Unregistered function: ${name}`);\n }\n return deleted;\n }\n\n /**\n * Get a registered function\n */\n get(name: string): RegisteredFunction | undefined {\n return this.functions.get(name);\n }\n\n /**\n * Check if a function is registered\n */\n has(name: string): boolean {\n return this.functions.has(name);\n }\n\n /**\n * Get all registered function schemas (for sending to backend)\n */\n getSchemas(): ClientFunctionSchema[] {\n return Array.from(this.functions.values()).map((f) => f.schema);\n }\n\n /**\n * Execute a registered function\n */\n async execute(\n name: string,\n args: Record<string, unknown>\n ): Promise<unknown> {\n const registration = this.functions.get(name);\n\n if (!registration) {\n throw new AgoFunctionError(\n `Function \"${name}\" is not registered`,\n name\n );\n }\n\n logger.log(`Executing function: ${name}`, args);\n\n try {\n const result = await registration.handler(args);\n logger.log(`Function ${name} completed:`, result);\n return result;\n } catch (error) {\n logger.error(`Function ${name} failed:`, error);\n throw new AgoFunctionError(\n `Function \"${name}\" execution failed: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n name,\n error instanceof Error ? error : undefined\n );\n }\n }\n\n /**\n * Clear all registered functions\n */\n clear(): void {\n this.functions.clear();\n logger.log(\"Cleared all registered functions\");\n }\n\n /**\n * Get the number of registered functions\n */\n get size(): number {\n return this.functions.size;\n }\n}\n","import type {\n AgoMessage,\n AgoSource,\n ToolCallData,\n SSEChunkData,\n} from \"../client/types\";\nimport { AgoStreamError } from \"../client/errors\";\nimport { logger } from \"../utils/logger\";\n\nexport interface SSEHandlerCallbacks {\n onStart?: (data: { conversationId: string; messageId: string }) => void;\n onChunk?: (data: { content: string; conversationId: string; messageId: string }) => void;\n onToolCall?: (toolCall: ToolCallData) => void;\n onClientFunction?: (data: {\n invocationId: string;\n functionName: string;\n arguments: Record<string, unknown>;\n conversationId: string;\n }) => void;\n onComplete?: (message: AgoMessage) => void;\n onError?: (error: Error) => void;\n}\n\n/**\n * Handles SSE streaming responses from AGO backend\n */\nexport class SSEHandler {\n private buffer = \"\";\n private message: Partial<AgoMessage> = {};\n private toolCalls: ToolCallData[] = [];\n private sources: AgoSource[] = [];\n private followUpReplies: string[] = [];\n private isFirstChunk = true;\n\n constructor(private callbacks: SSEHandlerCallbacks) {}\n\n /**\n * Process a streaming response\n */\n async processStream(response: Response): Promise<AgoMessage> {\n if (!response.body) {\n throw new AgoStreamError(\"Response has no body\");\n }\n\n const reader = response.body.getReader();\n const decoder = new TextDecoder();\n\n try {\n while (true) {\n const { done, value } = await reader.read();\n\n if (done) {\n break;\n }\n\n const text = decoder.decode(value, { stream: true });\n this.buffer += text;\n this.processBuffer();\n }\n\n // Process any remaining data\n if (this.buffer.trim()) {\n this.processBuffer();\n }\n\n return this.buildFinalMessage();\n } catch (error) {\n const streamError =\n error instanceof Error ? error : new AgoStreamError(\"Stream processing failed\");\n this.callbacks.onError?.(streamError);\n throw streamError;\n } finally {\n reader.releaseLock();\n }\n }\n\n private processBuffer(): void {\n // SSE messages are separated by double newlines\n const parts = this.buffer.split(\"\\n\\n\");\n\n // Keep the last part (might be incomplete)\n this.buffer = parts.pop() || \"\";\n\n for (const part of parts) {\n if (!part.trim()) continue;\n\n // Handle SSE format: \"data: {...}\" or \": heartbeat\"\n const lines = part.split(\"\\n\");\n\n for (const line of lines) {\n if (line.startsWith(\": \")) {\n // Comment/heartbeat, ignore\n continue;\n }\n\n if (line.startsWith(\"data: \")) {\n const jsonStr = line.slice(6);\n try {\n const data = JSON.parse(jsonStr) as SSEChunkData;\n this.handleChunk(data);\n } catch (error) {\n logger.warn(\"Failed to parse SSE data:\", jsonStr, error);\n }\n }\n }\n }\n }\n\n private handleChunk(data: SSEChunkData): void {\n // Handle message ID and conversation ID\n if (data.message_id && !this.message.id) {\n this.message.id = data.message_id;\n }\n\n if (data.thread?.id) {\n this.message.conversationId = data.thread.id;\n\n // Emit start event on first chunk with IDs\n if (this.isFirstChunk && this.message.id) {\n this.isFirstChunk = false;\n this.callbacks.onStart?.({\n conversationId: this.message.conversationId,\n messageId: this.message.id,\n });\n }\n }\n\n // Handle content\n if (data.content !== undefined) {\n this.message.content = (this.message.content || \"\") + data.content;\n if (this.message.conversationId && this.message.id) {\n this.callbacks.onChunk?.({\n content: data.content,\n conversationId: this.message.conversationId,\n messageId: this.message.id,\n });\n }\n }\n\n // Handle full content replacement\n if (data.full_content !== undefined) {\n this.message.content = data.full_content;\n }\n\n // Handle status\n if (data.status) {\n this.message.status = data.status;\n }\n\n // Handle agent\n if (data.agent) {\n this.message.agent = {\n id: data.agent.id,\n name: data.agent.name,\n displayName: data.agent.display_name,\n };\n }\n\n // Handle knowledge sources\n if (data.knowledge_sources) {\n this.sources = data.knowledge_sources.map((s) => {\n const doc = s.knowledge_document;\n return {\n id: doc.id,\n title: doc.title,\n url: doc.use_external_link ? doc.external_link_url : doc.internal_link_url,\n };\n });\n }\n\n // Handle tool calls\n if (data.tool_call_data && data.type) {\n const toolCall = this.parseToolCall(data);\n\n // Check if this is a client-side function invocation\n if (data.type === \"client_function\" && data.function_name) {\n this.callbacks.onClientFunction?.({\n invocationId: data.id!,\n functionName: data.function_name,\n arguments: data.arguments || {},\n conversationId: this.message.conversationId || \"\",\n });\n } else {\n this.callbacks.onToolCall?.(toolCall);\n }\n\n // Update or add tool call\n const existingIndex = this.toolCalls.findIndex((t) => t.id === toolCall.id);\n if (existingIndex >= 0) {\n this.toolCalls[existingIndex] = toolCall;\n } else {\n this.toolCalls.push(toolCall);\n }\n }\n\n // Handle follow-up replies\n if (data.follow_up_replies) {\n this.followUpReplies = data.follow_up_replies;\n }\n }\n\n private parseToolCall(data: SSEChunkData): ToolCallData {\n return {\n id: data.id || \"\",\n type: (data.type as ToolCallData[\"type\"]) || \"status_message\",\n status: data.status || \"unknown\",\n toolName: data.tool_name || \"\",\n toolDisplayName: data.tool_display_name,\n message: data.message,\n formSchema: data.form_schema,\n data: data.data,\n functionName: data.function_name,\n arguments: data.arguments,\n };\n }\n\n private buildFinalMessage(): AgoMessage {\n const message: AgoMessage = {\n id: this.message.id || \"\",\n conversationId: this.message.conversationId || \"\",\n content: this.message.content || \"\",\n role: \"assistant\",\n status: this.message.status || \"DONE\",\n agent: this.message.agent,\n sources: this.sources.length > 0 ? this.sources : undefined,\n toolCalls: this.toolCalls.length > 0 ? this.toolCalls : undefined,\n followUpReplies:\n this.followUpReplies.length > 0 ? this.followUpReplies : undefined,\n createdAt: new Date(),\n };\n\n this.callbacks.onComplete?.(message);\n return message;\n }\n}\n\n/**\n * Check if an error is a network error that should trigger polling fallback\n */\nexport function isStreamNetworkError(error: Error): boolean {\n const message = error.message.toLowerCase();\n return (\n message.includes(\"load failed\") ||\n message.includes(\"failed to fetch\") ||\n message.includes(\"network\") ||\n message.includes(\"abort\")\n );\n}\n","type EventHandler<T = unknown> = (data: T) => void;\n\n/**\n * Simple typed event emitter\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class EventEmitter<Events extends Record<string, any> = Record<string, unknown>> {\n private handlers: Map<keyof Events, Set<EventHandler<unknown>>> = new Map();\n\n on<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): void {\n if (!this.handlers.has(event)) {\n this.handlers.set(event, new Set());\n }\n this.handlers.get(event)!.add(handler as EventHandler<unknown>);\n }\n\n off<K extends keyof Events>(\n event: K,\n handler: EventHandler<Events[K]>\n ): void {\n const eventHandlers = this.handlers.get(event);\n if (eventHandlers) {\n eventHandlers.delete(handler as EventHandler<unknown>);\n }\n }\n\n emit<K extends keyof Events>(event: K, data: Events[K]): void {\n const eventHandlers = this.handlers.get(event);\n if (eventHandlers) {\n eventHandlers.forEach((handler) => {\n try {\n handler(data);\n } catch (error) {\n console.error(`Error in event handler for ${String(event)}:`, error);\n }\n });\n }\n }\n\n /**\n * Subscribe to an event and auto-unsubscribe after the first call.\n */\n once<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): void {\n const wrapper = ((data: Events[K]) => {\n this.off(event, wrapper as EventHandler<Events[K]>);\n handler(data);\n }) as EventHandler<Events[K]>;\n this.on(event, wrapper);\n }\n\n /**\n * Returns a Promise that resolves the next time `event` fires.\n * Rejects if `timeout` (ms) is reached first.\n */\n waitFor<K extends keyof Events>(\n event: K,\n options?: { timeout?: number }\n ): Promise<Events[K]> {\n return new Promise((resolve, reject) => {\n let timer: ReturnType<typeof setTimeout> | undefined;\n\n const handler = ((data: Events[K]) => {\n if (timer) clearTimeout(timer);\n resolve(data);\n }) as EventHandler<Events[K]>;\n\n this.once(event, handler);\n\n if (options?.timeout) {\n timer = setTimeout(() => {\n this.off(event, handler);\n reject(new Error(`waitFor(\"${String(event)}\") timed out after ${options.timeout}ms`));\n }, options.timeout);\n }\n });\n }\n\n removeAllListeners(event?: keyof Events): void {\n if (event) {\n this.handlers.delete(event);\n } else {\n this.handlers.clear();\n }\n }\n}\n","import { HttpClient } from \"../api/HttpClient\";\nimport { FunctionRegistry } from \"../functions/FunctionRegistry\";\nimport type { ClientFunctionDefinition, ClientFunctionHandler, ClientFunctionSchema } from \"../functions/types\";\nimport { SSEHandler } from \"../streaming/SSEHandler\";\nimport { EventEmitter } from \"../utils/eventEmitter\";\nimport { logger } from \"../utils/logger\";\nimport type {\n AgoConfig,\n AgoClientEvents,\n AgoEventName,\n AgoEventHandler,\n AgoMessage,\n Conversation,\n SendMessageOptions,\n} from \"./types\";\n\n/**\n * Main SDK client for AGO Chat integration\n */\nexport class AgoClient {\n private httpClient: HttpClient;\n private functionRegistry: FunctionRegistry;\n private eventEmitter: EventEmitter<AgoClientEvents>;\n private config: AgoConfig;\n\n constructor(config: AgoConfig) {\n this.config = config;\n this.httpClient = new HttpClient(config);\n this.functionRegistry = new FunctionRegistry();\n this.eventEmitter = new EventEmitter();\n\n if (config.debug) {\n logger.enable();\n }\n\n logger.log(\"AgoClient initialized\");\n }\n\n // ─────────────────────────────────────────────────────────────────\n // Messaging\n // ─────────────────────────────────────────────────────────────────\n\n /**\n * Send a message and receive a streaming response\n */\n async sendMessage(\n content: string,\n options?: SendMessageOptions\n ): Promise<AgoMessage> {\n const clientFunctions = this.functionRegistry.getSchemas();\n\n const body: Record<string, unknown> = {\n content,\n conversation_id: options?.conversationId,\n agent_id: options?.agentId || this.config.defaultAgentId,\n };\n\n // Include client functions if any are registered\n if (clientFunctions.length > 0) {\n body.client_functions = clientFunctions;\n }\n\n let response: Response;\n\n if (options?.files && options.files.length > 0) {\n // Use FormData for file uploads\n const formData = new FormData();\n formData.append(\"content\", content);\n\n if (options.conversationId) {\n formData.append(\"conversation_id\", options.conversationId);\n }\n\n if (options.agentId || this.config.defaultAgentId) {\n formData.append(\"agent_id\", options.agentId || this.config.defaultAgentId || \"\");\n }\n\n if (clientFunctions.length > 0) {\n formData.append(\"client_functions\", JSON.stringify(clientFunctions));\n }\n\n for (const file of options.files) {\n formData.append(\"files\", file);\n }\n\n response = await this.httpClient.postFormData(\"/api/sdk/v1/messages\", formData);\n } else {\n response = await this.httpClient.postStream(\"/api/sdk/v1/messages\", body);\n }\n\n return this.processSSEResponse(response);\n }\n\n private async processSSEResponse(response: Response): Promise<AgoMessage> {\n const handler = new SSEHandler({\n onStart: (data) => {\n this.eventEmitter.emit(\"message:start\", data);\n },\n onChunk: (data) => {\n this.eventEmitter.emit(\"message:chunk\", data);\n },\n onToolCall: (toolCall) => {\n this.eventEmitter.emit(\"toolCall:received\", toolCall);\n\n if (toolCall.type === \"form\") {\n this.eventEmitter.emit(\"toolCall:form\", toolCall);\n }\n },\n onClientFunction: async (data) => {\n this.eventEmitter.emit(\"function:invoke\", data);\n await this.handleClientFunctionInvocation(data);\n },\n onComplete: (message) => {\n this.eventEmitter.emit(\"message:complete\", message);\n },\n onError: (error) => {\n this.eventEmitter.emit(\"message:error\", { error: error.message });\n },\n });\n\n return handler.processStream(response);\n }\n\n private async handleClientFunctionInvocation(data: {\n invocationId: string;\n functionName: string;\n arguments: Record<string, unknown>;\n conversationId: string;\n }): Promise<void> {\n let result: unknown;\n let error: string | undefined;\n\n try {\n result = await this.functionRegistry.execute(data.functionName, data.arguments);\n } catch (err) {\n error = err instanceof Error ? err.message : \"Unknown error\";\n logger.error(\"Client function execution failed:\", err);\n }\n\n // Submit result back to backend using existing tool-call submit endpoint\n try {\n await this.submitToolCallForm(data.invocationId, {\n result,\n error,\n _type: \"client_function_result\",\n });\n\n this.eventEmitter.emit(\"function:result\", {\n invocationId: data.invocationId,\n result,\n error,\n });\n } catch (submitError) {\n logger.error(\"Failed to submit function result:\", submitError);\n }\n }\n\n // ─────────────────────────────────────────────────────────────────\n // Conversations\n // ─────────────────────────────────────────────────────────────────\n\n /**\n * Get list of conversations\n */\n async getConversations(): Promise<Conversation[]> {\n const response = await this.httpClient.get<{\n count: number;\n items: Array<{\n id: string;\n title: string;\n last_message_date: string;\n }>;\n }>(\"/api/sdk/v1/conversations\");\n\n return response.items.map((item) => ({\n id: item.id,\n title: item.title,\n lastMessageDate: new Date(item.last_message_date),\n }));\n }\n\n /**\n * Get a specific conversation with messages\n */\n async getConversation(conversationId: string): Promise<Conversation> {\n const response = await this.httpClient.get<{\n id: string;\n title: string;\n last_message_date: string;\n messages: Array<{\n id: string;\n content: string;\n role: \"user\" | \"assistant\";\n status: string;\n created_at: string;\n }>;\n }>(`/api/sdk/v1/conversations/${conversationId}`);\n\n return {\n id: response.id,\n title: response.title,\n lastMessageDate: new Date(response.last_message_date),\n messages: response.messages.map((m) => ({\n id: m.id,\n conversationId: response.id,\n content: m.content,\n role: m.role,\n status: m.status as AgoMessage[\"status\"],\n createdAt: new Date(m.created_at),\n })),\n };\n }\n\n /**\n * Get messages for a conversation\n */\n async getMessages(conversationId: string): Promise<AgoMessage[]> {\n const conversation = await this.getConversation(conversationId);\n return conversation.messages || [];\n }\n\n // ─────────────────────────────────────────────────────────────────\n // Tool Calls\n // ─────────────────────────────────────────────────────────────────\n\n /**\n * Submit form data for a tool call\n */\n async submitToolCallForm(\n toolCallId: string,\n formData: Record<string, unknown>\n ): Promise<void> {\n await this.httpClient.post(`/api/tool-calls/${toolCallId}/submit/`, {\n formData,\n });\n }\n\n /**\n * Confirm a tool call\n */\n async confirmToolCall(toolCallId: string): Promise<void> {\n await this.httpClient.post(`/api/tool-calls/${toolCallId}/confirm/`);\n }\n\n /**\n * Reject a tool call\n */\n async rejectToolCall(toolCallId: string): Promise<void> {\n await this.httpClient.post(`/api/tool-calls/${toolCallId}/reject/`);\n }\n\n // ─────────────────────────────────────────────────────────────────\n // Feedback\n // ─────────────────────────────────────────────────────────────────\n\n /**\n * Submit feedback for a message\n */\n async submitFeedback(\n messageId: string,\n rating: \"positive\" | \"negative\"\n ): Promise<void> {\n await this.httpClient.post(`/api/sdk/v1/messages/${messageId}/feedback`, {\n rating,\n });\n }\n\n // ─────────────────────────────────────────────────────────────────\n // Client-side Functions\n // ─────────────────────────────────────────────────────────────────\n\n /**\n * Register a client-side function that AGO can call.\n * Accepts either a definition object or (name, handler, schema) args.\n *\n * ```ts\n * // Single-object (preferred)\n * client.registerFunction({\n * name: \"lookupOrder\",\n * description: \"Look up an order\",\n * parameters: { type: \"object\", properties: { id: { type: \"string\" } } },\n * handler: async (args) => fetchOrder(args.id),\n * });\n *\n * // Classic 3-arg form\n * client.registerFunction(\"lookupOrder\", handler, schema);\n * ```\n */\n registerFunction(definition: ClientFunctionDefinition): void;\n registerFunction(\n name: string,\n handler: ClientFunctionHandler,\n schema: Omit<ClientFunctionSchema, \"name\">\n ): void;\n registerFunction(\n nameOrDef: string | ClientFunctionDefinition,\n handler?: ClientFunctionHandler,\n schema?: Omit<ClientFunctionSchema, \"name\">\n ): void {\n if (typeof nameOrDef === \"object\") {\n this.functionRegistry.register(nameOrDef);\n } else {\n this.functionRegistry.register(nameOrDef, handler!, schema!);\n }\n }\n\n /**\n * Unregister a client-side function\n */\n unregisterFunction(name: string): boolean {\n return this.functionRegistry.unregister(name);\n }\n\n /**\n * Get all registered function schemas\n */\n getRegisteredFunctions(): ClientFunctionSchema[] {\n return this.functionRegistry.getSchemas();\n }\n\n /**\n * Register a navigation function that lets AGO navigate users to different pages.\n * @param navigate - A callback that performs the navigation (e.g. react-router's navigate)\n * @param routes - Map of route names to paths, with descriptions for the LLM\n */\n registerNavigationFunction(\n navigate: (path: string) => void,\n routes: Array<{ name: string; path: string; description: string }>\n ): void {\n const routeNames = routes.map((r) => r.name);\n const routeDescriptions = routes\n .map((r) => `- \"${r.name}\": ${r.description}`)\n .join(\"\\n\");\n\n this.registerFunction(\n \"navigateToPage\",\n async (args) => {\n const pageName = args.page as string;\n const route = routes.find((r) => r.name === pageName);\n if (!route) {\n return { success: false, error: `Unknown page: ${pageName}` };\n }\n navigate(route.path);\n return { success: true, navigatedTo: route.path };\n },\n {\n description: `Navigate the user to a page in the application. Available pages:\\n${routeDescriptions}`,\n parameters: {\n type: \"object\",\n properties: {\n page: {\n type: \"string\",\n description: \"The page to navigate to\",\n enum: routeNames,\n },\n },\n required: [\"page\"],\n },\n }\n );\n }\n\n // ─────────────────────────────────────────────────────────────────\n // Events\n // ─────────────────────────────────────────────────────────────────\n\n /**\n * Subscribe to an event\n */\n on<K extends AgoEventName>(event: K, handler: AgoEventHandler<K>): void {\n this.eventEmitter.on(event, handler);\n }\n\n /**\n * Unsubscribe from an event\n */\n off<K extends AgoEventName>(event: K, handler: AgoEventHandler<K>): void {\n this.eventEmitter.off(event, handler);\n }\n\n /**\n * Subscribe to an event once — auto-unsubscribes after the first call.\n */\n once<K extends AgoEventName>(event: K, handler: AgoEventHandler<K>): void {\n this.eventEmitter.once(event, handler);\n }\n\n /**\n * Returns a Promise that resolves the next time `event` fires.\n *\n * ```ts\n * const msg = await client.waitFor(\"message:complete\", { timeout: 10000 });\n * ```\n */\n waitFor<K extends AgoEventName>(\n event: K,\n options?: { timeout?: number }\n ): Promise<AgoClientEvents[K]> {\n return this.eventEmitter.waitFor(event, options);\n }\n\n // ─────────────────────────────────────────────────────────────────\n // Configuration\n // ─────────────────────────────────────────────────────────────────\n\n /**\n * Update client configuration\n */\n updateConfig(config: Partial<AgoConfig>): void {\n this.config = { ...this.config, ...config };\n this.httpClient.updateConfig(config);\n\n if (config.debug !== undefined) {\n config.debug ? logger.enable() : logger.disable();\n }\n }\n\n /**\n * Clean up resources\n */\n destroy(): void {\n this.eventEmitter.removeAllListeners();\n this.functionRegistry.clear();\n logger.log(\"AgoClient destroyed\");\n }\n}\n","import type { AgoClient } from \"../client/AgoClient\";\nimport type {\n AgoClientEvents,\n AgoEventName,\n AgoMessage,\n Conversation,\n} from \"../client/types\";\nimport type { ClientFunctionSchema } from \"../functions/types\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype MockFn = (...args: any[]) => any;\n\nexport interface MockAgoClientOptions {\n overrides?: Partial<Record<string, MockFn>>;\n}\n\nexport interface MockAgoClient extends AgoClient {\n /**\n * Simulate a server-pushed event.\n * ```ts\n * mock.__emitEvent(\"message:complete\", { id: \"1\", content: \"hi\", ... });\n * ```\n */\n __emitEvent<K extends AgoEventName>(event: K, data: AgoClientEvents[K]): void;\n\n /**\n * All recorded method calls: `[methodName, ...args][]`\n */\n __calls: Array<{ method: string; args: unknown[] }>;\n\n /**\n * Get calls for a specific method.\n */\n __callsFor(method: string): Array<{ method: string; args: unknown[] }>;\n}\n\n/**\n * Create a mock AgoClient for testing. Works with any framework.\n *\n * ```ts\n * import { createMockClient } from \"@useago/sdk/testing\";\n *\n * const mock = createMockClient();\n * mock.__emitEvent(\"message:complete\", someMessage);\n * expect(mock.__callsFor(\"sendMessage\")).toHaveLength(1);\n * ```\n */\nexport function createMockClient(\n options: MockAgoClientOptions = {}\n): MockAgoClient {\n const { overrides = {} } = options;\n\n const noopMessage: AgoMessage = {\n id: \"mock-msg-1\",\n conversationId: \"mock-conv-1\",\n content: \"Mock response\",\n role: \"assistant\",\n status: \"DONE\",\n createdAt: new Date(),\n };\n\n const noopConversation: Conversation = {\n id: \"mock-conv-1\",\n title: \"Mock Conversation\",\n lastMessageDate: new Date(),\n };\n\n const listeners = new Map<string, Set<(...args: unknown[]) => void>>();\n const calls: Array<{ method: string; args: unknown[] }> = [];\n\n const defaults: Record<string, MockFn> = {\n sendMessage: async () => noopMessage,\n getConversations: async () => [noopConversation],\n getConversation: async () => noopConversation,\n getMessages: async () => [noopMessage],\n submitToolCallForm: async () => undefined,\n confirmToolCall: async () => undefined,\n rejectToolCall: async () => undefined,\n submitFeedback: async () => undefined,\n registerFunction: () => undefined,\n unregisterFunction: () => true,\n getRegisteredFunctions: () => [] as ClientFunctionSchema[],\n registerNavigationFunction: () => undefined,\n on: (event: string, handler: (...args: unknown[]) => void) => {\n if (!listeners.has(event)) listeners.set(event, new Set());\n listeners.get(event)!.add(handler);\n },\n off: (event: string, handler: (...args: unknown[]) => void) => {\n listeners.get(event)?.delete(handler);\n },\n once: (event: string, handler: (...args: unknown[]) => void) => {\n const wrapper = (...args: unknown[]) => {\n listeners.get(event)?.delete(wrapper);\n handler(...args);\n };\n if (!listeners.has(event)) listeners.set(event, new Set());\n listeners.get(event)!.add(wrapper);\n },\n waitFor: (event: string, options?: { timeout?: number }) => {\n return new Promise((resolve, reject) => {\n let timer: ReturnType<typeof setTimeout> | undefined;\n const handler = (data: unknown) => {\n if (timer) clearTimeout(timer);\n listeners.get(event)?.delete(handler);\n resolve(data);\n };\n if (!listeners.has(event)) listeners.set(event, new Set());\n listeners.get(event)!.add(handler);\n if (options?.timeout) {\n timer = setTimeout(() => {\n listeners.get(event)?.delete(handler);\n reject(new Error(`waitFor(\"${event}\") timed out after ${options.timeout}ms`));\n }, options.timeout);\n }\n });\n },\n updateConfig: () => undefined,\n destroy: () => {\n listeners.clear();\n },\n };\n\n const merged = { ...defaults, ...overrides } as Record<string, MockFn>;\n\n // Wrap all methods to record calls\n const mock: Record<string, unknown> = {};\n\n for (const [key, fn] of Object.entries(merged)) {\n mock[key] = (...args: unknown[]) => {\n calls.push({ method: key, args });\n return (fn as MockFn)(...args);\n };\n }\n\n // Test helpers (not recorded)\n mock.__calls = calls;\n mock.__callsFor = (method: string) => calls.filter((c) => c.method === method);\n mock.__emitEvent = (event: string, data: unknown) => {\n // Copy the set to avoid mutation during iteration (once handlers remove themselves)\n const handlers = listeners.get(event);\n if (handlers) {\n [...handlers].forEach((h) => h(data));\n }\n };\n\n return mock as unknown as MockAgoClient;\n}\n"],"names":["name","options"],"mappings":"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"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { ClientFunctionDefinition, ClientFunctionHandler, ClientFunctionSchema, RegisteredFunction } from "./types";
|
|
2
|
+
/**
|
|
3
|
+
* Registry for client-side functions that AGO can call
|
|
4
|
+
*/
|
|
5
|
+
export declare class FunctionRegistry {
|
|
6
|
+
private functions;
|
|
7
|
+
/**
|
|
8
|
+
* Register a function that AGO can call.
|
|
9
|
+
* Accepts either a single definition object or (name, handler, schema) args.
|
|
10
|
+
*/
|
|
11
|
+
register(definition: ClientFunctionDefinition): void;
|
|
12
|
+
register(name: string, handler: ClientFunctionHandler, schema: Omit<ClientFunctionSchema, "name">): void;
|
|
13
|
+
/**
|
|
14
|
+
* Unregister a function
|
|
15
|
+
*/
|
|
16
|
+
unregister(name: string): boolean;
|
|
17
|
+
/**
|
|
18
|
+
* Get a registered function
|
|
19
|
+
*/
|
|
20
|
+
get(name: string): RegisteredFunction | undefined;
|
|
21
|
+
/**
|
|
22
|
+
* Check if a function is registered
|
|
23
|
+
*/
|
|
24
|
+
has(name: string): boolean;
|
|
25
|
+
/**
|
|
26
|
+
* Get all registered function schemas (for sending to backend)
|
|
27
|
+
*/
|
|
28
|
+
getSchemas(): ClientFunctionSchema[];
|
|
29
|
+
/**
|
|
30
|
+
* Execute a registered function
|
|
31
|
+
*/
|
|
32
|
+
execute(name: string, args: Record<string, unknown>): Promise<unknown>;
|
|
33
|
+
/**
|
|
34
|
+
* Clear all registered functions
|
|
35
|
+
*/
|
|
36
|
+
clear(): void;
|
|
37
|
+
/**
|
|
38
|
+
* Get the number of registered functions
|
|
39
|
+
*/
|
|
40
|
+
get size(): number;
|
|
41
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { ClientFunctionDefinition } from "./types";
|
|
2
|
+
/**
|
|
3
|
+
* Create a reusable function definition.
|
|
4
|
+
* Returns the same object — this is an identity function for discoverability and type-checking.
|
|
5
|
+
*
|
|
6
|
+
* ```ts
|
|
7
|
+
* // Define once, reuse anywhere
|
|
8
|
+
* export const lookupOrder = defineFunction({
|
|
9
|
+
* name: "lookupOrder",
|
|
10
|
+
* description: "Look up an order by ID",
|
|
11
|
+
* parameters: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
|
|
12
|
+
* handler: async (args) => fetchOrder(args.id as string),
|
|
13
|
+
* });
|
|
14
|
+
*
|
|
15
|
+
* // Register with client
|
|
16
|
+
* client.registerFunction(lookupOrder);
|
|
17
|
+
*
|
|
18
|
+
* // Or use in React
|
|
19
|
+
* useAgoFunction(lookupOrder.name, lookupOrder);
|
|
20
|
+
* ```
|
|
21
|
+
*/
|
|
22
|
+
export declare function defineFunction(definition: ClientFunctionDefinition): ClientFunctionDefinition;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Schema for a client-side function that AGO can call
|
|
3
|
+
*/
|
|
4
|
+
export interface ClientFunctionSchema {
|
|
5
|
+
/** Function name (must be unique) */
|
|
6
|
+
name: string;
|
|
7
|
+
/** Description for the LLM to understand when to call this function */
|
|
8
|
+
description: string;
|
|
9
|
+
/** JSON Schema for function parameters */
|
|
10
|
+
parameters: {
|
|
11
|
+
type: "object";
|
|
12
|
+
properties: Record<string, {
|
|
13
|
+
type: string;
|
|
14
|
+
description?: string;
|
|
15
|
+
enum?: string[];
|
|
16
|
+
default?: unknown;
|
|
17
|
+
}>;
|
|
18
|
+
required?: string[];
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Function handler type
|
|
23
|
+
*/
|
|
24
|
+
export type ClientFunctionHandler = (args: Record<string, unknown>) => Promise<unknown> | unknown;
|
|
25
|
+
/**
|
|
26
|
+
* Registered function with handler
|
|
27
|
+
*/
|
|
28
|
+
export interface RegisteredFunction {
|
|
29
|
+
schema: ClientFunctionSchema;
|
|
30
|
+
handler: ClientFunctionHandler;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Single-object function definition — combines name, schema, and handler.
|
|
34
|
+
*
|
|
35
|
+
* ```ts
|
|
36
|
+
* const fn = defineFunction({
|
|
37
|
+
* name: "lookupOrder",
|
|
38
|
+
* description: "Look up an order by ID",
|
|
39
|
+
* parameters: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
|
|
40
|
+
* handler: async (args) => fetchOrder(args.id as string),
|
|
41
|
+
* });
|
|
42
|
+
* client.registerFunction(fn);
|
|
43
|
+
* ```
|
|
44
|
+
*/
|
|
45
|
+
export interface ClientFunctionDefinition {
|
|
46
|
+
name: string;
|
|
47
|
+
description: string;
|
|
48
|
+
parameters: ClientFunctionSchema["parameters"];
|
|
49
|
+
handler: ClientFunctionHandler;
|
|
50
|
+
}
|
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
+
const createMockClient = require("./createMockClient-BZKh_1em.cjs");
|
|
4
|
+
function defineFunction(definition) {
|
|
5
|
+
return definition;
|
|
6
|
+
}
|
|
7
|
+
exports.AgoApiError = createMockClient.AgoApiError;
|
|
8
|
+
exports.AgoClient = createMockClient.AgoClient;
|
|
9
|
+
exports.AgoError = createMockClient.AgoError;
|
|
10
|
+
exports.AgoFunctionError = createMockClient.AgoFunctionError;
|
|
11
|
+
exports.AgoNetworkError = createMockClient.AgoNetworkError;
|
|
12
|
+
exports.AgoStreamError = createMockClient.AgoStreamError;
|
|
13
|
+
exports.EventEmitter = createMockClient.EventEmitter;
|
|
14
|
+
exports.FunctionRegistry = createMockClient.FunctionRegistry;
|
|
15
|
+
exports.SSEHandler = createMockClient.SSEHandler;
|
|
16
|
+
exports.createMockClient = createMockClient.createMockClient;
|
|
17
|
+
exports.isStreamNetworkError = createMockClient.isStreamNetworkError;
|
|
18
|
+
exports.logger = createMockClient.logger;
|
|
19
|
+
exports.defineFunction = defineFunction;
|
|
20
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.cjs","sources":["../src/functions/defineFunction.ts"],"sourcesContent":["import type { ClientFunctionDefinition } from \"./types\";\n\n/**\n * Create a reusable function definition.\n * Returns the same object — this is an identity function for discoverability and type-checking.\n *\n * ```ts\n * // Define once, reuse anywhere\n * export const lookupOrder = defineFunction({\n * name: \"lookupOrder\",\n * description: \"Look up an order by ID\",\n * parameters: { type: \"object\", properties: { id: { type: \"string\" } }, required: [\"id\"] },\n * handler: async (args) => fetchOrder(args.id as string),\n * });\n *\n * // Register with client\n * client.registerFunction(lookupOrder);\n *\n * // Or use in React\n * useAgoFunction(lookupOrder.name, lookupOrder);\n * ```\n */\nexport function defineFunction(\n definition: ClientFunctionDefinition\n): ClientFunctionDefinition {\n return definition;\n}\n"],"names":[],"mappings":";;;AAsBO,SAAS,eACd,YAC0B;AAC1B,SAAO;AACT;;;;;;;;;;;;;;"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export { AgoClient } from "./client/AgoClient";
|
|
2
|
+
export type { AgoConfig, SendMessageOptions, AgoMessage, Conversation, AgoAgent, AgoSource, ToolCallData, ToolCallType, FormSchema, FormField, FunctionSchema, ClientFunction, FunctionDefinition, ClientFunctionInvocation, AgoClientEvents, AgoEventName, AgoEventHandler, MessageStatus, SSEChunkData, } from "./client/types";
|
|
3
|
+
export { AgoError, AgoApiError, AgoNetworkError, AgoStreamError, AgoFunctionError, } from "./client/errors";
|
|
4
|
+
export { FunctionRegistry } from "./functions/FunctionRegistry";
|
|
5
|
+
export { defineFunction } from "./functions/defineFunction";
|
|
6
|
+
export type { ClientFunctionSchema, ClientFunctionHandler, ClientFunctionDefinition, RegisteredFunction, } from "./functions/types";
|
|
7
|
+
export { createMockClient } from "./testing";
|
|
8
|
+
export type { MockAgoClient, MockAgoClientOptions } from "./testing";
|
|
9
|
+
export { SSEHandler, isStreamNetworkError } from "./streaming/SSEHandler";
|
|
10
|
+
export type { AgoWidgetConfig, AgoWidgetColors } from "./widget/types";
|
|
11
|
+
export { EventEmitter } from "./utils/eventEmitter";
|
|
12
|
+
export { logger } from "./utils/logger";
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { A, a, b, c, d, e, E, F, S, f, i, l } from "./createMockClient-uGlVyjbL.js";
|
|
2
|
+
function defineFunction(definition) {
|
|
3
|
+
return definition;
|
|
4
|
+
}
|
|
5
|
+
export {
|
|
6
|
+
A as AgoApiError,
|
|
7
|
+
a as AgoClient,
|
|
8
|
+
b as AgoError,
|
|
9
|
+
c as AgoFunctionError,
|
|
10
|
+
d as AgoNetworkError,
|
|
11
|
+
e as AgoStreamError,
|
|
12
|
+
E as EventEmitter,
|
|
13
|
+
F as FunctionRegistry,
|
|
14
|
+
S as SSEHandler,
|
|
15
|
+
f as createMockClient,
|
|
16
|
+
defineFunction,
|
|
17
|
+
i as isStreamNetworkError,
|
|
18
|
+
l as logger
|
|
19
|
+
};
|
|
20
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sources":["../src/functions/defineFunction.ts"],"sourcesContent":["import type { ClientFunctionDefinition } from \"./types\";\n\n/**\n * Create a reusable function definition.\n * Returns the same object — this is an identity function for discoverability and type-checking.\n *\n * ```ts\n * // Define once, reuse anywhere\n * export const lookupOrder = defineFunction({\n * name: \"lookupOrder\",\n * description: \"Look up an order by ID\",\n * parameters: { type: \"object\", properties: { id: { type: \"string\" } }, required: [\"id\"] },\n * handler: async (args) => fetchOrder(args.id as string),\n * });\n *\n * // Register with client\n * client.registerFunction(lookupOrder);\n *\n * // Or use in React\n * useAgoFunction(lookupOrder.name, lookupOrder);\n * ```\n */\nexport function defineFunction(\n definition: ClientFunctionDefinition\n): ClientFunctionDefinition {\n return definition;\n}\n"],"names":[],"mappings":";AAsBO,SAAS,eACd,YAC0B;AAC1B,SAAO;AACT;"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import React from "react";
|
|
2
|
+
export interface ChatInputProps {
|
|
3
|
+
onSend: (message: string, files?: File[]) => void;
|
|
4
|
+
disabled?: boolean;
|
|
5
|
+
placeholder?: string;
|
|
6
|
+
allowFiles?: boolean;
|
|
7
|
+
className?: string;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Chat input component with send button
|
|
11
|
+
*/
|
|
12
|
+
export declare const ChatInput: React.FC<ChatInputProps>;
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import React from "react";
|
|
2
|
+
import type { AgoClient } from "../../client/AgoClient";
|
|
3
|
+
export interface ChatWidgetProps {
|
|
4
|
+
/** The AGO client instance. If omitted, reads from AgoProvider context. */
|
|
5
|
+
client?: AgoClient;
|
|
6
|
+
/** Initial conversation ID */
|
|
7
|
+
conversationId?: string;
|
|
8
|
+
/** Widget title */
|
|
9
|
+
title?: string;
|
|
10
|
+
/** Welcome message shown when no messages */
|
|
11
|
+
welcomeMessage?: string;
|
|
12
|
+
/** Input placeholder */
|
|
13
|
+
placeholder?: string;
|
|
14
|
+
/** Enable file attachments */
|
|
15
|
+
allowFiles?: boolean;
|
|
16
|
+
/** Widget height */
|
|
17
|
+
height?: string | number;
|
|
18
|
+
/** URL of a logo to display in the header */
|
|
19
|
+
logoUrl?: string;
|
|
20
|
+
/** Additional CSS class */
|
|
21
|
+
className?: string;
|
|
22
|
+
/** Callback when a message is sent */
|
|
23
|
+
onMessageSent?: (content: string) => void;
|
|
24
|
+
/** Callback when a message is received */
|
|
25
|
+
onMessageReceived?: (message: {
|
|
26
|
+
id: string;
|
|
27
|
+
content: string;
|
|
28
|
+
}) => void;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Pre-built chat widget component
|
|
32
|
+
*/
|
|
33
|
+
export declare const ChatWidget: React.FC<ChatWidgetProps>;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { ChatWidget } from "./ChatWidget";
|
|
2
|
+
export type { ChatWidgetProps } from "./ChatWidget";
|
|
3
|
+
export { Message } from "./Message";
|
|
4
|
+
export type { MessageProps } from "./Message";
|
|
5
|
+
export { ChatInput } from "./ChatInput";
|
|
6
|
+
export type { ChatInputProps } from "./ChatInput";
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import React from "react";
|
|
2
|
+
import type { AgoClient } from "../../client/AgoClient";
|
|
3
|
+
import type { AgoConfig } from "../../client/types";
|
|
4
|
+
export type AgoProviderProps = {
|
|
5
|
+
children: React.ReactNode;
|
|
6
|
+
} & (({
|
|
7
|
+
client: AgoClient;
|
|
8
|
+
} & Partial<Record<keyof AgoConfig, never>>) | ({
|
|
9
|
+
client?: never;
|
|
10
|
+
} & AgoConfig));
|
|
11
|
+
/**
|
|
12
|
+
* Provides an AgoClient to all descendant components via React context.
|
|
13
|
+
*
|
|
14
|
+
* ```tsx
|
|
15
|
+
* // Create client from config
|
|
16
|
+
* <AgoProvider apiKey="..." widgetId="...">
|
|
17
|
+
* <App />
|
|
18
|
+
* </AgoProvider>
|
|
19
|
+
*
|
|
20
|
+
* // Or pass a pre-built client (useful for testing)
|
|
21
|
+
* <AgoProvider client={myClient}>
|
|
22
|
+
* <App />
|
|
23
|
+
* </AgoProvider>
|
|
24
|
+
* ```
|
|
25
|
+
*/
|
|
26
|
+
export declare const AgoProvider: React.FC<AgoProviderProps>;
|
|
27
|
+
/**
|
|
28
|
+
* Returns the AgoClient from the nearest AgoProvider.
|
|
29
|
+
* Throws if used outside of an AgoProvider.
|
|
30
|
+
*/
|
|
31
|
+
export declare function useAgoClient(): AgoClient;
|
|
32
|
+
/**
|
|
33
|
+
* Returns the AgoClient from context, or null if no provider exists.
|
|
34
|
+
* Use this when client access is optional.
|
|
35
|
+
*/
|
|
36
|
+
export declare function useOptionalAgoClient(): AgoClient | null;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { useAgo } from "./useAgo";
|
|
2
|
+
export type { UseAgoOptions, UseAgoResult } from "./useAgo";
|
|
3
|
+
export { useMessages } from "./useMessages";
|
|
4
|
+
export type { UseMessagesOptions, UseMessagesResult } from "./useMessages";
|
|
5
|
+
export { useConversation } from "./useConversation";
|
|
6
|
+
export type { UseConversationOptions, UseConversationResult } from "./useConversation";
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { AgoClient } from "../../client/AgoClient";
|
|
2
|
+
import type { AgoConfig } from "../../client/types";
|
|
3
|
+
export interface UseAgoOptions extends AgoConfig {
|
|
4
|
+
}
|
|
5
|
+
export interface UseAgoResult {
|
|
6
|
+
/** The AGO client instance */
|
|
7
|
+
client: AgoClient;
|
|
8
|
+
/** Whether the client is ready */
|
|
9
|
+
isReady: boolean;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Hook to create and manage an AgoClient instance
|
|
13
|
+
*/
|
|
14
|
+
export declare function useAgo(config: UseAgoOptions): UseAgoResult;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { ClientFunctionHandler } from "../../functions/types";
|
|
2
|
+
export interface UseAgoFunctionOptions {
|
|
3
|
+
description: string;
|
|
4
|
+
parameters: {
|
|
5
|
+
type: "object";
|
|
6
|
+
properties: Record<string, {
|
|
7
|
+
type: string;
|
|
8
|
+
description?: string;
|
|
9
|
+
enum?: string[];
|
|
10
|
+
default?: unknown;
|
|
11
|
+
}>;
|
|
12
|
+
required?: string[];
|
|
13
|
+
};
|
|
14
|
+
handler: ClientFunctionHandler;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Declaratively register a client-side function with the AGO agent.
|
|
18
|
+
* Automatically unregisters on unmount and re-registers when deps change.
|
|
19
|
+
*
|
|
20
|
+
* ```tsx
|
|
21
|
+
* useAgoFunction("showToast", {
|
|
22
|
+
* description: "Show a notification to the user",
|
|
23
|
+
* parameters: { type: "object", properties: { message: { type: "string" } } },
|
|
24
|
+
* handler: async (args) => { toast(args.message); return { shown: true }; },
|
|
25
|
+
* });
|
|
26
|
+
* ```
|
|
27
|
+
*/
|
|
28
|
+
export declare function useAgoFunction(name: string, options: UseAgoFunctionOptions): void;
|
|
29
|
+
export interface AgoRoute {
|
|
30
|
+
name: string;
|
|
31
|
+
path: string;
|
|
32
|
+
description: string;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Declaratively register navigation routes with the AGO agent.
|
|
36
|
+
* Wraps `registerNavigationFunction` with React lifecycle management.
|
|
37
|
+
*
|
|
38
|
+
* ```tsx
|
|
39
|
+
* const navigate = useNavigate();
|
|
40
|
+
* useAgoNavigation(navigate, [
|
|
41
|
+
* { name: "dashboard", path: "/dashboard", description: "Main dashboard" },
|
|
42
|
+
* { name: "settings", path: "/settings", description: "User settings" },
|
|
43
|
+
* ]);
|
|
44
|
+
* ```
|
|
45
|
+
*/
|
|
46
|
+
export declare function useAgoNavigation(navigate: (path: string) => void, routes: AgoRoute[]): void;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { AgoClient } from "../../client/AgoClient";
|
|
2
|
+
import type { AgoMessage, Conversation } from "../../client/types";
|
|
3
|
+
export interface UseChatOptions {
|
|
4
|
+
/** AgoClient instance. If omitted, reads from AgoProvider context. */
|
|
5
|
+
client?: AgoClient;
|
|
6
|
+
/** Initial conversation ID to load */
|
|
7
|
+
conversationId?: string;
|
|
8
|
+
/** Auto-load conversation list on mount (default: true) */
|
|
9
|
+
autoLoad?: boolean;
|
|
10
|
+
}
|
|
11
|
+
export interface UseChatResult {
|
|
12
|
+
/** Messages in the current conversation */
|
|
13
|
+
messages: AgoMessage[];
|
|
14
|
+
/** Whether a message is being sent/streamed */
|
|
15
|
+
isLoading: boolean;
|
|
16
|
+
/** Current error */
|
|
17
|
+
error: Error | null;
|
|
18
|
+
/** Send a message */
|
|
19
|
+
sendMessage: (content: string, files?: File[]) => Promise<AgoMessage | null>;
|
|
20
|
+
/** Clear current messages */
|
|
21
|
+
clearMessages: () => void;
|
|
22
|
+
/** Current conversation ID */
|
|
23
|
+
conversationId: string | undefined;
|
|
24
|
+
/** All conversations */
|
|
25
|
+
conversations: Conversation[];
|
|
26
|
+
/** Currently selected conversation */
|
|
27
|
+
currentConversation: Conversation | null;
|
|
28
|
+
/** Whether conversations are loading */
|
|
29
|
+
isConversationsLoading: boolean;
|
|
30
|
+
/** Select a conversation by ID */
|
|
31
|
+
selectConversation: (conversationId: string) => Promise<void>;
|
|
32
|
+
/** Start a new conversation */
|
|
33
|
+
startNewConversation: () => void;
|
|
34
|
+
/** Refresh conversations list */
|
|
35
|
+
refreshConversations: () => Promise<void>;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* All-in-one hook for building a custom chat UI.
|
|
39
|
+
* Composes useMessages + useConversation.
|
|
40
|
+
*
|
|
41
|
+
* ```tsx
|
|
42
|
+
* const { messages, sendMessage, conversations, selectConversation } = useChat();
|
|
43
|
+
* ```
|
|
44
|
+
*/
|
|
45
|
+
export declare function useChat(options?: UseChatOptions): UseChatResult;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { AgoClient } from "../../client/AgoClient";
|
|
2
|
+
import type { Conversation } from "../../client/types";
|
|
3
|
+
export interface UseConversationOptions {
|
|
4
|
+
/** The AGO client instance. If omitted, reads from AgoProvider context. */
|
|
5
|
+
client?: AgoClient;
|
|
6
|
+
/** Auto-load conversations on mount */
|
|
7
|
+
autoLoad?: boolean;
|
|
8
|
+
}
|
|
9
|
+
export interface UseConversationResult {
|
|
10
|
+
/** List of conversations */
|
|
11
|
+
conversations: Conversation[];
|
|
12
|
+
/** Currently selected conversation */
|
|
13
|
+
currentConversation: Conversation | null;
|
|
14
|
+
/** Whether conversations are loading */
|
|
15
|
+
isLoading: boolean;
|
|
16
|
+
/** Current error, if any */
|
|
17
|
+
error: Error | null;
|
|
18
|
+
/** Select a conversation */
|
|
19
|
+
selectConversation: (conversationId: string) => Promise<void>;
|
|
20
|
+
/** Clear current conversation (start new) */
|
|
21
|
+
startNewConversation: () => void;
|
|
22
|
+
/** Refresh conversations list */
|
|
23
|
+
refreshConversations: () => Promise<void>;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Hook to manage conversations
|
|
27
|
+
*/
|
|
28
|
+
export declare function useConversation({ client: clientProp, autoLoad, }?: UseConversationOptions): UseConversationResult;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { AgoClient } from "../../client/AgoClient";
|
|
2
|
+
import type { AgoMessage } from "../../client/types";
|
|
3
|
+
export interface UseMessagesOptions {
|
|
4
|
+
/** The AGO client instance. If omitted, reads from AgoProvider context. */
|
|
5
|
+
client?: AgoClient;
|
|
6
|
+
/** Conversation ID to load messages for */
|
|
7
|
+
conversationId?: string;
|
|
8
|
+
}
|
|
9
|
+
export interface UseMessagesResult {
|
|
10
|
+
/** List of messages */
|
|
11
|
+
messages: AgoMessage[];
|
|
12
|
+
/** Whether a message is being sent */
|
|
13
|
+
isLoading: boolean;
|
|
14
|
+
/** Current error, if any */
|
|
15
|
+
error: Error | null;
|
|
16
|
+
/** Send a new message */
|
|
17
|
+
sendMessage: (content: string, files?: File[]) => Promise<AgoMessage | null>;
|
|
18
|
+
/** Clear messages */
|
|
19
|
+
clearMessages: () => void;
|
|
20
|
+
/** Current conversation ID */
|
|
21
|
+
conversationId: string | undefined;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Hook to manage messages in a conversation
|
|
25
|
+
*/
|
|
26
|
+
export declare function useMessages({ client: clientProp, conversationId: initialConversationId, }?: UseMessagesOptions): UseMessagesResult;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export { AgoProvider, useAgoClient, useOptionalAgoClient } from "./context";
|
|
2
|
+
export type { AgoProviderProps } from "./context";
|
|
3
|
+
export { ChatWidget } from "./components/ChatWidget";
|
|
4
|
+
export type { ChatWidgetProps } from "./components/ChatWidget";
|
|
5
|
+
export { Message } from "./components/Message";
|
|
6
|
+
export type { MessageProps } from "./components/Message";
|
|
7
|
+
export { ChatInput } from "./components/ChatInput";
|
|
8
|
+
export type { ChatInputProps } from "./components/ChatInput";
|
|
9
|
+
export { useAgo } from "./hooks/useAgo";
|
|
10
|
+
export type { UseAgoOptions, UseAgoResult } from "./hooks/useAgo";
|
|
11
|
+
export { useMessages } from "./hooks/useMessages";
|
|
12
|
+
export type { UseMessagesOptions, UseMessagesResult } from "./hooks/useMessages";
|
|
13
|
+
export { useConversation } from "./hooks/useConversation";
|
|
14
|
+
export type { UseConversationOptions, UseConversationResult } from "./hooks/useConversation";
|
|
15
|
+
export { useChat } from "./hooks/useChat";
|
|
16
|
+
export type { UseChatOptions, UseChatResult } from "./hooks/useChat";
|
|
17
|
+
export { useAgoFunction, useAgoNavigation } from "./hooks/useAgoFunction";
|
|
18
|
+
export type { UseAgoFunctionOptions, AgoRoute } from "./hooks/useAgoFunction";
|
|
19
|
+
export { createMockClient } from "./testing";
|
|
20
|
+
export type { AgoConfig, AgoMessage, Conversation, AgoAgent, AgoSource, ToolCallData, } from "../client/types";
|