@revealui/ai 0.2.7 → 0.2.9

package/LICENSE

@@ -1,22 +1,109 @@
-MIT License
+Functional Source License, Version 1.1, MIT Future License
 
-Copyright (c) 2025-2026 RevealUI Studio
+Abbreviation
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+FSL-1.1-MIT
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+Notice
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Copyright 2025-2026 RevealUI Studio (founder@revealui.com)
 
+Terms and Conditions
+
+Licensor:             RevealUI Studio
+
+Licensed Work:        @revealui/ai
+                      The Licensed Work is copyright 2025-2026 RevealUI Studio.
+
+Change Date:          2028-04-08
+
+Change License:       MIT
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact: founder@revealui.com
+
+License text below is the Functional Source License, Version 1.1, MIT Future
+License, as published at https://fsl.software/FSL-1.1-MIT.template.md
+
+---
+
+## Terms and Conditions
+
+### Acceptance
+
+In order to get any license under these terms, you must agree to them as
+both strict obligations and conditions to all your licenses.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the licensed work, in each case
+subject to the limitations and conditions below.
+
+### Limitations
+
+You may not make the functionality of the licensed work or a modified
+version available to third parties as a service, or distribute the
+licensed work or a modified version in a way that makes the functionality
+of the software available to third parties. Making the functionality of
+the licensed work available to third parties includes, without limitation,
+enabling third parties to interact with the functionality of the licensed
+work remotely through a computer network, offering a service the value of
+which entirely or primarily derives from the value of the licensed work,
+or offering a service that accomplishes for users the primary purpose of
+the licensed work or a modified version.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor
+can license, or becomes able to license, to make, have made, use, sell,
+offer for sale, import and have imported the licensed work, in each case
+subject to the limitations and conditions in this license. This license
+does not cover any patent claims that you cause to be infringed by
+modifications or additions to the licensed work. If you or your company
+make any written claim that the licensed work infringes or contributes to
+infringement of any patent, your patent license for the licensed work
+granted under these terms ends immediately. If your company makes such a
+claim, your patent license ends immediately for work on behalf of your
+company.
+
+### Fair Use
+
+This license is not intended to limit any right of fair use, fair
+dealing, or other applicable copyright exception or limitation.
+
+### No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your
+licenses to anyone else, or prevent the licensor from granting licenses
+to anyone else. These terms do not imply any other licenses.
+
+### Termination
+
+If you use the licensed work in violation of these terms, such use is
+not licensed, and your licenses may be revoked if you do not cure the
+violation.
+
+The licensor may also revoke your licenses if you fail to comply with
+these terms.
+
+### No Liability
+
+***As far as the law allows, the licensed work comes as is, without any
+warranty or condition, and the licensor will not be liable to you for any
+damages arising out of these terms or the use or nature of the licensed
+work, under any kind of legal claim.***
+
+### Change Date
+
+On the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under
+this License, whichever comes first, the Licensor hereby grants you
+rights under the terms of the Change License, and the rights granted in
+the paragraphs above terminate.
+
+### Change License
+
+On the Change Date, the Licensed Work will be made available under the
+Change License specified above (MIT).

package/README.md

@@ -1,6 +1,6 @@
 # @revealui/ai
 
-> **Commercial package** — requires a [RevealUI Pro license](https://revealui.com/pro). Free to install and evaluate; a license key is required for production use.
+> **Commercial package**  -  requires a [RevealUI Pro license](https://revealui.com/pro). Free to install and evaluate; a license key is required for production use.
 
 
 AI system for RevealUI - memory, LLM, orchestration, and tools.
@@ -309,7 +309,7 @@ Potential optimizations (not yet implemented):
 
 ## License
 
-Commercial — see [LICENSE.commercial](../../LICENSE.commercial)
+Commercial  -  see [LICENSE.commercial](../../LICENSE.commercial)
 
 ---
 

package/dist/a2a/card.d.ts

@@ -20,7 +20,7 @@ declare class AgentCardRegistry {
     listDefs(): AgentDefinition[];
     has(agentId: string): boolean;
 }
-/** Singleton registry — import and use directly */
+/** Singleton registry  -  import and use directly */
 export declare const agentCardRegistry: AgentCardRegistry;
 export type { AgentDefinition };
 //# sourceMappingURL=card.d.ts.map

package/dist/a2a/card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/a2a/card.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,KAAK,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAwI/E,cAAM,iBAAiB;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;;IAO3D,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAIpC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO;IAOzF,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAM9D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAI1C,QAAQ,IAAI,eAAe,EAAE;IAI7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAG9B;AAED,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAEzD,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/a2a/card.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,KAAK,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAwI/E,cAAM,iBAAiB;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;;IAO3D,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAIpC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO;IAOzF,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAM9D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAI1C,QAAQ,IAAI,eAAe,EAAE;IAI7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAG9B;AAED,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAEzD,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/a2a/card.js

@@ -10,7 +10,7 @@ import { agentDefinitionToCard } from '@revealui/contracts';
 // =============================================================================
 // Built-in agent definitions
 // =============================================================================
-/** RevealUI platform meta-agent — "The Creator" */
+/** RevealUI platform meta-agent  -  "The Creator" */
 const THE_CREATOR_DEF = {
     id: 'revealui-creator',
     version: 1,
@@ -21,7 +21,7 @@ const THE_CREATOR_DEF = {
     model: 'claude-opus-4-6',
     systemPrompt: 'You are The Creator, the meta-agent for RevealUI. You design, configure, and deploy ' +
         'purpose-built AI agents for RevealUI users. You have access to agent scaffolding tools, ' +
-        'the RevealUI CMS, and the billing system.',
+        'the RevealUI admin, and the billing system.',
     tools: [
         {
             name: 'scaffoldAgent',
@@ -73,7 +73,7 @@ const TICKET_AGENT_DEF = {
     version: 1,
     name: 'Ticket Agent',
     description: 'Handles support tickets, resolves user issues, and escalates when needed. ' +
-        'Uses the RevealUI CMS to create and update tickets.',
+        'Uses the RevealUI admin to create and update tickets.',
     model: 'claude-sonnet-4-6',
     systemPrompt: 'You are the RevealUI Ticket Agent. You help users resolve issues by creating tickets, ' +
         'searching for solutions, and escalating complex problems to the support team.',
@@ -169,5 +169,5 @@ class AgentCardRegistry {
         return this.defs.has(agentId);
     }
 }
-/** Singleton registry — import and use directly */
+/** Singleton registry  -  import and use directly */
 export const agentCardRegistry = new AgentCardRegistry();

package/dist/a2a/handler.d.ts

@@ -5,10 +5,10 @@
  * Integrates with AgentRuntime and AgentOrchestrator from @revealui/ai/orchestration.
  *
  * Supported methods:
- *   tasks/send          — synchronous task execution
- *   tasks/get           — retrieve task by ID
- *   tasks/cancel        — cancel a running task
- *   tasks/sendSubscribe — (handled at route level via SSE; returns taskId here)
+ *   tasks/send           -  synchronous task execution
+ *   tasks/get            -  retrieve task by ID
+ *   tasks/cancel         -  cancel a running task
+ *   tasks/sendSubscribe  -  (handled at route level via SSE; returns taskId here)
  */
 import type { A2AJsonRpcRequest, A2AJsonRpcResponse } from '@revealui/contracts';
 import type { LLMClient } from '../llm/client.js';

package/dist/a2a/handler.js

@@ -5,10 +5,10 @@
  * Integrates with AgentRuntime and AgentOrchestrator from @revealui/ai/orchestration.
  *
  * Supported methods:
- *   tasks/send          — synchronous task execution
- *   tasks/get           — retrieve task by ID
- *   tasks/cancel        — cancel a running task
- *   tasks/sendSubscribe — (handled at route level via SSE; returns taskId here)
+ *   tasks/send           -  synchronous task execution
+ *   tasks/get            -  retrieve task by ID
+ *   tasks/cancel         -  cancel a running task
+ *   tasks/sendSubscribe  -  (handled at route level via SSE; returns taskId here)
  */
 import { A2ASendTaskParamsSchema } from '@revealui/contracts';
 import { logger } from '@revealui/core/observability/logger';
@@ -57,7 +57,7 @@ async function handleTasksSend(id, params, agentId, llmClient) {
     try {
         // Transition to working
         updateTaskState(task.id, 'working');
-        // Execute via orchestration — for now, produce a direct text response.
+        // Execute via orchestration  -  for now, produce a direct text response.
         // Full AgentRuntime integration wires in when an LLM provider is configured.
         const agentDef = agentId
             ? agentCardRegistry.getDef(agentId)

package/dist/a2a/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @revealui/ai — A2A Protocol Implementation
+ * @revealui/ai  -  A2A Protocol Implementation
  *
  * Agent-to-Agent (A2A) protocol support for RevealUI.
  * Exports the agent card registry, task store, and JSON-RPC handler.

package/dist/a2a/index.js

@@ -1,5 +1,5 @@
 /**
- * @revealui/ai — A2A Protocol Implementation
+ * @revealui/ai  -  A2A Protocol Implementation
  *
  * Agent-to-Agent (A2A) protocol support for RevealUI.
  * Exports the agent card registry, task store, and JSON-RPC handler.

package/dist/audit/emitter.d.ts

@@ -15,7 +15,7 @@ import type { AuditEventType, AuditSeverity } from './types.js';
  */
 export interface AuditEmitter {
     /**
-     * Emit an audit event. This is a fire-and-forget operation —
+     * Emit an audit event. This is a fire-and-forget operation  -
      * the agent does not receive confirmation or any data back.
      */
     emit(eventType: AuditEventType, payload: Record<string, unknown>, severity?: AuditSeverity): void;

package/dist/audit/emitter.js

@@ -20,12 +20,12 @@
 export function createAuditEmitter(agentId, handler) {
     const emitter = {
         emit(eventType, payload, severity = 'info') {
-            // Fire-and-forget — agents don't get feedback from the audit system
+            // Fire-and-forget  -  agents don't get feedback from the audit system
             try {
                 handler(agentId, eventType, payload, severity);
             }
             catch {
-                // Silently swallow errors — audit failures must never affect agent execution
+                // Silently swallow errors  -  audit failures must never affect agent execution
             }
         },
     };

package/dist/audit/index.d.ts

@@ -9,7 +9,7 @@
  * - **Store** is append-only (no updates, no deletes)
  *
  * This architecture ensures that AI agents cannot tamper with, disable,
- * or circumvent the audit trail — it lives entirely outside their scope.
+ * or circumvent the audit trail  -  it lives entirely outside their scope.
  *
  * ## Quick Start
  *
@@ -29,7 +29,7 @@
  *
  * // Create write-only emitter for an agent
  * const emitter = observer.createEmitterForAgent('agent-1')
- * // Pass `emitter` to the agent — it can only call emitter.emit()
+ * // Pass `emitter` to the agent  -  it can only call emitter.emit()
  *
  * // Human can halt agents at any time
  * observer.haltAgent('agent-1', 'admin', 'Suspicious behavior')

package/dist/audit/index.js

@@ -9,7 +9,7 @@
  * - **Store** is append-only (no updates, no deletes)
  *
  * This architecture ensures that AI agents cannot tamper with, disable,
- * or circumvent the audit trail — it lives entirely outside their scope.
+ * or circumvent the audit trail  -  it lives entirely outside their scope.
  *
  * ## Quick Start
  *
@@ -29,7 +29,7 @@
  *
  * // Create write-only emitter for an agent
  * const emitter = observer.createEmitterForAgent('agent-1')
- * // Pass `emitter` to the agent — it can only call emitter.emit()
+ * // Pass `emitter` to the agent  -  it can only call emitter.emit()
  *
  * // Human can halt agents at any time
  * observer.haltAgent('agent-1', 'admin', 'Suspicious behavior')

package/dist/audit/store.d.ts

@@ -2,7 +2,7 @@
  * Audit Store
  *
  * Append-only storage interface for audit entries.
- * No update or delete operations — the log is immutable.
+ * No update or delete operations  -  the log is immutable.
  * Includes an in-memory implementation and a pluggable interface
  * for persistent backends (PostgreSQL, etc.).
  */
@@ -25,7 +25,7 @@ export interface AuditStore {
 }
 /**
  * In-memory audit store for development and testing.
- * Entries are stored in a simple array — not suitable for production.
+ * Entries are stored in a simple array  -  not suitable for production.
  */
 export declare class InMemoryAuditStore implements AuditStore {
     private entries;

package/dist/audit/store.js

@@ -2,14 +2,14 @@
  * Audit Store
  *
  * Append-only storage interface for audit entries.
- * No update or delete operations — the log is immutable.
+ * No update or delete operations  -  the log is immutable.
  * Includes an in-memory implementation and a pluggable interface
  * for persistent backends (PostgreSQL, etc.).
  */
 // ─── In-Memory Implementation ───────────────────────────────────────────────
 /**
  * In-memory audit store for development and testing.
- * Entries are stored in a simple array — not suitable for production.
+ * Entries are stored in a simple array  -  not suitable for production.
  */
 export class InMemoryAuditStore {
     entries = [];

package/dist/client/errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Client-safe AI error classes.
+ *
+ * Lightweight errors for React hooks  -  no server-side dependencies.
+ * Consumers can programmatically handle specific error types (retry on 429, redirect on 401).
+ */
+export declare class AIError extends Error {
+    readonly statusCode: number;
+    readonly operation: string;
+    constructor(message: string, statusCode: number, operation: string);
+}
+export declare function createAIError(operation: string, statusCode: number, statusText: string): AIError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,OAAQ,SAAQ,KAAK;aAGd,UAAU,EAAE,MAAM;aAClB,SAAS,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM;CAKpC;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAahG"}

package/dist/client/errors.js

@@ -0,0 +1,28 @@
+/**
+ * Client-safe AI error classes.
+ *
+ * Lightweight errors for React hooks  -  no server-side dependencies.
+ * Consumers can programmatically handle specific error types (retry on 429, redirect on 401).
+ */
+export class AIError extends Error {
+    statusCode;
+    operation;
+    constructor(message, statusCode, operation) {
+        super(message);
+        this.statusCode = statusCode;
+        this.operation = operation;
+        this.name = 'AIError';
+    }
+}
+export function createAIError(operation, statusCode, statusText) {
+    const message = statusCode === 401
+        ? `Authentication required for ${operation}`
+        : statusCode === 403
+            ? `Insufficient permissions for ${operation}`
+            : statusCode === 404
+                ? `Resource not found: ${operation}`
+                : statusCode === 429
+                    ? `Too many requests — retry ${operation} shortly`
+                    : `${operation} failed: ${statusText}`;
+    return new AIError(message, statusCode, operation);
+}

package/dist/client/hooks/useAgentContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAgentContext.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/useAgentContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAeD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAkKvB"}
+{"version":3,"file":"useAgentContext.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/useAgentContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAeD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAkKvB"}

package/dist/client/hooks/useAgentContext.js

@@ -5,6 +5,7 @@
  * Wraps AgentContextManager for client-side usage.
  */
 import { useCallback, useEffect, useState } from 'react';
+import { createAIError } from '../errors.js';
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const parseContextPayload = (payload) => {
     if (!isRecord(payload))
@@ -37,7 +38,7 @@ export function useAgentContext(sessionId, agentId, options = {}) {
                 setError(null);
                 const response = await fetch(`/api/memory/context/${sessionId}/${agentId}`);
                 if (!response.ok) {
-                    throw new Error(`Failed to load agent context: ${response.statusText}`);
+                    throw createAIError('load agent context', response.status, response.statusText);
                 }
                 const payload = (await response.json());
                 if (!mounted)
@@ -65,7 +66,7 @@ export function useAgentContext(sessionId, agentId, options = {}) {
         try {
             const response = await fetch(`/api/memory/context/${sessionId}/${agentId}`);
             if (!response.ok) {
-                throw new Error(`Failed to sync agent context: ${response.statusText}`);
+                throw createAIError('sync agent context', response.status, response.statusText);
             }
             const payload = (await response.json());
             setContextState(parseContextPayload(payload));
@@ -98,7 +99,7 @@ export function useAgentContext(sessionId, agentId, options = {}) {
                 body: JSON.stringify({ [key]: value }),
             });
             if (!response.ok) {
-                throw new Error(`Failed to update context: ${response.statusText}`);
+                throw createAIError('update context', response.status, response.statusText);
             }
             const payload = (await response.json());
             setContextState(parseContextPayload(payload));
@@ -118,7 +119,7 @@ export function useAgentContext(sessionId, agentId, options = {}) {
                 body: JSON.stringify(updates),
             });
             if (!response.ok) {
-                throw new Error(`Failed to update context: ${response.statusText}`);
+                throw createAIError('update context', response.status, response.statusText);
             }
             const payload = (await response.json());
             setContextState(parseContextPayload(payload));
@@ -138,7 +139,7 @@ export function useAgentContext(sessionId, agentId, options = {}) {
                 body: JSON.stringify({ key }),
             });
             if (!response.ok) {
-                throw new Error(`Failed to remove context key: ${response.statusText}`);
+                throw createAIError('remove context key', response.status, response.statusText);
             }
             const payload = (await response.json());
             setContextState(parseContextPayload(payload));

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

@@ -1,7 +1,7 @@
 /**
- * useAgentStream — React hook for streaming agent responses via SSE
+ * useAgentStream  -  React hook for streaming agent responses via SSE
  *
- * Uses fetch + ReadableStream (NOT EventSource — it doesn't support POST).
+ * Uses fetch + ReadableStream (NOT EventSource  -  it doesn't support POST).
  * Accumulates AgentStreamChunks into state and exposes:
  *   - text: accumulated output text
  *   - chunks: all received chunks in order

package/dist/client/hooks/useAgentStream.js

@@ -1,7 +1,7 @@
 /**
- * useAgentStream — React hook for streaming agent responses via SSE
+ * useAgentStream  -  React hook for streaming agent responses via SSE
  *
- * Uses fetch + ReadableStream (NOT EventSource — it doesn't support POST).
+ * Uses fetch + ReadableStream (NOT EventSource  -  it doesn't support POST).
  * Accumulates AgentStreamChunks into state and exposes:
  *   - text: accumulated output text
  *   - chunks: all received chunks in order
@@ -80,7 +80,7 @@ export function useAgentStream() {
                         }));
                     }
                     catch {
-                        // Malformed SSE data — skip
+                        // Malformed SSE data  -  skip
                     }
                 }
             }

package/dist/client/hooks/useEpisodicMemory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEpisodicMemory.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/useEpisodicMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAO9D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IACzD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAmCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CA4KzE"}
+{"version":3,"file":"useEpisodicMemory.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/useEpisodicMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAQ9D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IACzD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAmCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CA4KzE"}

package/dist/client/hooks/useEpisodicMemory.js

@@ -4,6 +4,7 @@
  * React hook for managing episodic memory in client components.
  */
 import { useCallback, useEffect, useState } from 'react';
+import { createAIError } from '../errors.js';
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const isAgentMemory = (value) => {
     if (!isRecord(value))
@@ -43,7 +44,7 @@ export function useEpisodicMemory(userId) {
                 setError(null);
                 const response = await fetch(`/api/memory/episodic/${userId}`);
                 if (!response.ok) {
-                    throw new Error(`Failed to load episodic memory: ${response.statusText}`);
+                    throw createAIError('load episodic memory', response.status, response.statusText);
                 }
                 const payload = (await response.json());
                 if (!mounted)
@@ -75,7 +76,7 @@ export function useEpisodicMemory(userId) {
             setError(null);
             const response = await fetch(`/api/memory/episodic/${userId}`);
             if (!response.ok) {
-                throw new Error(`Failed to refresh episodic memory: ${response.statusText}`);
+                throw createAIError('refresh episodic memory', response.status, response.statusText);
             }
             const payload = (await response.json());
             const parsed = parseEpisodicPayload(payload);
@@ -100,7 +101,7 @@ export function useEpisodicMemory(userId) {
                 body: JSON.stringify(memory),
             });
             if (!response.ok) {
-                throw new Error(`Failed to add memory: ${response.statusText}`);
+                throw createAIError('add memory', response.status, response.statusText);
             }
             const payload = (await response.json());
             const parsed = parseEpisodicPayload(payload);
@@ -121,7 +122,7 @@ export function useEpisodicMemory(userId) {
                 method: 'DELETE',
             });
             if (!response.ok) {
-                throw new Error(`Failed to remove memory: ${response.statusText}`);
+                throw createAIError('remove memory', response.status, response.statusText);
             }
             // Refresh to get updated list
             await refresh();
@@ -144,7 +145,7 @@ export function useEpisodicMemory(userId) {
                 body: JSON.stringify({ query, options: { limit: 20, threshold: 0.5 } }),
             });
             if (!response.ok) {
-                throw new Error(`Search failed: ${response.statusText}`);
+                throw createAIError('search memory', response.status, response.statusText);
             }
             const data = (await response.json());
             if (data.results && Array.isArray(data.results)) {

package/dist/client/hooks/useWorkingMemory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkingMemory.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/useWorkingMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,YAAY,EAAE;QACZ,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC1C,KAAK,CAAC,EAAE;YACN,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;SACtB,CAAC;QACF,WAAW,CAAC,EAAE;YACZ,EAAE,EAAE,MAAM,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;YACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;IACF,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAiHD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA6NxB"}
+{"version":3,"file":"useWorkingMemory.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/useWorkingMemory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,YAAY,EAAE;QACZ,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC1C,KAAK,CAAC,EAAE;YACN,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;SACtB,CAAC;QACF,WAAW,CAAC,EAAE;YACZ,EAAE,EAAE,MAAM,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;YACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;IACF,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAiHD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA6NxB"}

package/dist/client/hooks/useWorkingMemory.js

@@ -4,6 +4,7 @@
  * React hook for managing working memory in client components.
  */
 import { useCallback, useEffect, useState } from 'react';
+import { createAIError } from '../errors.js';
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const isSessionStatus = (value) => value === 'active' || value === 'paused' || value === 'completed';
 const isTaskStatus = (value) => value === 'pending' || value === 'running' || value === 'completed' || value === 'failed';
@@ -110,7 +111,7 @@ export function useWorkingMemory(sessionId, options = {}) {
                 setError(null);
                 const response = await fetch(`/api/memory/working/${sessionId}`);
                 if (!response.ok) {
-                    throw new Error(`Failed to load working memory: ${response.statusText}`);
+                    throw createAIError('load working memory', response.status, response.statusText);
                 }
                 const payload = (await response.json());
                 if (!mounted)
@@ -141,7 +142,7 @@ export function useWorkingMemory(sessionId, options = {}) {
         try {
             const response = await fetch(`/api/memory/working/${sessionId}`);
             if (!response.ok) {
-                throw new Error(`Failed to sync working memory: ${response.statusText}`);
+                throw createAIError('sync working memory', response.status, response.statusText);
             }
             const payload = (await response.json());
             const parsed = parseWorkingPayload(payload);
@@ -173,7 +174,7 @@ export function useWorkingMemory(sessionId, options = {}) {
                 body: JSON.stringify({ context: newContext }),
             });
             if (!response.ok) {
-                throw new Error(`Failed to update context: ${response.statusText}`);
+                throw createAIError('update context', response.status, response.statusText);
             }
             const payload = (await response.json());
             setContextState(parseContextPayload(payload));
@@ -206,7 +207,7 @@ export function useWorkingMemory(sessionId, options = {}) {
                 body: JSON.stringify({ sessionState: state }),
             });
             if (!response.ok) {
-                throw new Error(`Failed to update session state: ${response.statusText}`);
+                throw createAIError('update session state', response.status, response.statusText);
             }
             const payload = (await response.json());
             setSessionStateState(parseSessionPayload(payload));
@@ -227,7 +228,7 @@ export function useWorkingMemory(sessionId, options = {}) {
                 body: JSON.stringify({ activeAgents: newAgents }),
             });
             if (!response.ok) {
-                throw new Error(`Failed to add agent: ${response.statusText}`);
+                throw createAIError('add agent', response.status, response.statusText);
             }
             const payload = (await response.json());
             setActiveAgents(parseActiveAgentsPayload(payload));
@@ -248,7 +249,7 @@ export function useWorkingMemory(sessionId, options = {}) {
                 body: JSON.stringify({ activeAgents: newAgents }),
             });
             if (!response.ok) {
-                throw new Error(`Failed to remove agent: ${response.statusText}`);
+                throw createAIError('remove agent', response.status, response.statusText);
             }
             const payload = (await response.json());
             setActiveAgents(parseActiveAgentsPayload(payload));

package/dist/embeddings/index.d.ts

@@ -4,7 +4,7 @@
  * Functions for generating embeddings using the configured LLM provider.
  * Provider is auto-detected from env vars (OLLAMA_BASE_URL → GROQ → ANTHROPIC).
  * For local/free inference use Ollama with `nomic-embed-text`.
- * Note: Groq and Anthropic do not support embeddings — use Ollama for embedding tasks.
+ * Note: Groq and Anthropic do not support embeddings  -  use Ollama for embedding tasks.
  */
 import z from 'zod/v4';
 declare const EmbeddingSchema: z.ZodObject<{