@revealui/ai 0.2.8 → 0.3.0

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<{

package/dist/embeddings/index.js

@@ -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';
 import { createLLMClientFromEnv } from '../llm/client.js';
@@ -41,9 +41,9 @@ export async function generateEmbedding(text, options = {}) {
     if (!text || typeof text !== 'string' || text.trim().length === 0) {
         throw new Error('Text must be a non-empty string');
     }
-    // Use unified LLM client — auto-detects provider from env vars
+    // Use unified LLM client  -  auto-detects provider from env vars
     const client = createLLMClientFromEnv();
-    // Ask client to embed — each provider uses its own default model when model is undefined
+    // Ask client to embed  -  each provider uses its own default model when model is undefined
     const result = await client.embed(text, model ? { model } : undefined);
     // If provider returned batch, pick first
     const embeddingResult = Array.isArray(result) ? result[0] : result;
@@ -66,7 +66,7 @@ export async function generateEmbedding(text, options = {}) {
  * @returns Array of embeddings in the same order as input texts
  */
 export async function generateEmbeddings(texts, options = {}) {
-    // Generate in parallel — providers that support batch (Ollama, OpenAI) can be
+    // Generate in parallel  -  providers that support batch (Ollama, OpenAI) can be
     // optimised later by passing the full array directly to client.embed()
     const embeddings = await Promise.all(texts.map((text) => generateEmbedding(text, options)));
     return embeddings;

package/dist/inference/context-budget.d.ts

@@ -1,7 +1,7 @@
 /**
  * Context Budget Policy
  * Model-tier-aware context allocation for the coding agent.
- * Ensures small models (BitNet 2B) get only essential context,
+ * Ensures small models (Gemma 4 E2B) get only essential context,
  * while large models (Claude, GPT-4) get full context.
  */
 export type ModelTier = 'small' | 'medium' | 'large';

package/dist/inference/context-budget.js

@@ -1,7 +1,7 @@
 /**
  * Context Budget Policy
  * Model-tier-aware context allocation for the coding agent.
- * Ensures small models (BitNet 2B) get only essential context,
+ * Ensures small models (Gemma 4 E2B) get only essential context,
  * while large models (Claude, GPT-4) get full context.
  */
 const BUDGETS = {
@@ -33,7 +33,7 @@ const BUDGETS = {
 /** Known model patterns → tier mapping */
 const MODEL_TIER_PATTERNS = [
     // Small: local quantized models
-    { pattern: /bitnet/i, tier: 'small' },
+    { pattern: /gemma4.*e2b/i, tier: 'small' },
     { pattern: /tinyllama/i, tier: 'small' },
     { pattern: /phi-[12]/i, tier: 'small' },
     { pattern: /\b[12]b\b/i, tier: 'small' },
@@ -44,7 +44,7 @@ const MODEL_TIER_PATTERNS = [
     { pattern: /gemma.*[79]b/i, tier: 'medium' },
     { pattern: /llama.*70b/i, tier: 'medium' },
     { pattern: /mixtral/i, tier: 'medium' },
-    { pattern: /qwen.*[78]b/i, tier: 'medium' },
+    { pattern: /qwen.*\d{1,3}b/i, tier: 'medium' },
     { pattern: /deepseek.*[78]b/i, tier: 'medium' },
     // Large: cloud models with large context
     { pattern: /claude/i, tier: 'large' },
@@ -61,7 +61,7 @@ export function classifyModel(modelName) {
         if (pattern.test(modelName))
             return tier;
     }
-    // Default to medium — safe middle ground
+    // Default to medium  -  safe middle ground
     return 'medium';
 }
 /**

package/dist/inference/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Inference utilities — context budget, compression, and task decomposition.
+ * Inference utilities  -  context budget, compression, and task decomposition.
  */
 export { type ContextBudget, classifyModel, getContextBudget, getContextBudgetForModel, type ModelTier, pruneHistory, truncateToolResult, } from './context-budget.js';
 export { compressContext } from './overflow-compressor.js';

package/dist/inference/index.js

@@ -1,5 +1,5 @@
 /**
- * Inference utilities — context budget, compression, and task decomposition.
+ * Inference utilities  -  context budget, compression, and task decomposition.
  */
 export { classifyModel, getContextBudget, getContextBudgetForModel, pruneHistory, truncateToolResult, } from './context-budget.js';
 export { compressContext } from './overflow-compressor.js';

package/dist/inference/runRag.d.ts

@@ -1,5 +1,5 @@
 /**
- * RAG Query — Retrieval-Augmented Generation
+ * RAG Query  -  Retrieval-Augmented Generation
  *
  * Generates an embedding for the query, searches the rag_chunks table via
  * pgvector cosine distance, assembles ranked context with recency weighting,
@@ -14,7 +14,7 @@ export interface RAGOptions {
     limit?: number;
     /** Minimum cosine similarity threshold 0–1 (default 0.6) */
     threshold?: number;
-    /** Custom embedding function — defaults to generateEmbedding() */
+    /** Custom embedding function  -  defaults to generateEmbedding() */
     embeddingFn?: (text: string) => Promise<number[]>;
     /** search mode: 'speed' (vector-only) | 'accuracy' (BM25 hybrid + optional rerank) */
     mode?: 'speed' | 'accuracy';
@@ -22,7 +22,7 @@ export interface RAGOptions {
     llmClient?: LLMClient;
     /** Maximum tokens for assembled context (default 2000) */
     maxContextTokens?: number;
-    /** Filter to a specific CMS collection */
+    /** Filter to a specific admin collection */
     sourceCollection?: string;
 }
 /**