@revealui/ai 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025-2026 RevealUI Studio
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+

package/LICENSE.commercial

@@ -0,0 +1,112 @@
+RevealUI Commercial License
+Version 1.0, February 2026
+
+Copyright (c) 2025-2026 RevealUI Studio (founder@revealui.com)
+
+TERMS AND CONDITIONS
+
+1. DEFINITIONS
+
+"Software" means the RevealUI source code, documentation, and associated
+files contained in directories and packages designated as commercial,
+including but not limited to: packages/ai, packages/mcp, packages/editors,
+packages/services, packages/harnesses, and any directory named "ee" within
+the repository.
+
+"License Key" means a valid RevealUI license key obtained through an active
+paid subscription at https://revealui.com.
+
+"Licensee" means the individual or organization that holds a valid License
+Key through an active subscription.
+
+"Production Use" means any use of the Software beyond local development and
+evaluation, including but not limited to: deploying the Software to serve
+end users, integrating the Software into a product or service, or using the
+Software in a revenue-generating capacity.
+
+2. GRANT OF RIGHTS
+
+Subject to the terms of this License and a valid License Key, the Licensee
+is granted a non-exclusive, non-transferable, revocable license to:
+
+  (a) Use the Software for internal development and Production Use.
+  (b) Modify the Software for internal use.
+  (c) Deploy the Software on infrastructure controlled by the Licensee.
+
+Enterprise License holders are additionally granted the right to:
+
+  (d) Deploy the Software in a self-hosted environment.
+  (e) Remove or replace RevealUI branding (white-label).
+  (f) Use the Software for multiple tenants within the Licensee's
+      organization or customer base.
+
+3. RESTRICTIONS
+
+The Licensee SHALL NOT:
+
+  (a) Provide the Software, or any portion of it, to third parties as a
+      hosted or managed service that competes with RevealUI.
+  (b) Redistribute, sublicense, sell, or otherwise transfer the Software
+      or any portion of it to third parties.
+  (c) Remove, alter, or circumvent the license key verification
+      functionality of the Software.
+  (d) Use the Software in Production without a valid License Key.
+  (e) Share, publish, or make the License Key available to unauthorized
+      parties.
+
+4. EVALUATION
+
+The Software may be used for evaluation and local development purposes
+without a License Key. Evaluation use does not grant any rights to
+Production Use.
+
+5. SUBSCRIPTION AND PAYMENT
+
+This License is valid only during the term of an active paid subscription.
+Upon cancellation or expiration of the subscription:
+
+  (a) The License terminates automatically.
+  (b) A grace period of fourteen (14) days is provided for the Licensee
+      to transition away from Production Use.
+  (c) After the grace period, the Licensee must cease all Production Use
+      of the Software.
+
+6. INTELLECTUAL PROPERTY
+
+The Software is and remains the intellectual property of RevealUI Studio.
+This License does not grant any ownership rights. Contributions to
+commercial portions of the Software require a Contributor License Agreement.
+
+7. OPEN SOURCE COMPONENTS
+
+This License applies only to files and directories designated as commercial.
+Files under the MIT License (as indicated in the root LICENSE file) are not
+subject to this commercial license and may be used freely under MIT terms.
+
+8. DISCLAIMER OF WARRANTY
+
+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.
+
+9. LIMITATION OF LIABILITY
+
+IN NO EVENT SHALL REVEALUI STUDIO 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, EXCEEDING THE AMOUNT PAID BY THE LICENSEE IN
+THE TWELVE (12) MONTHS PRECEDING THE CLAIM.
+
+10. GOVERNING LAW
+
+This License shall be governed by the laws of the State of California,
+United States of America, without regard to its conflict of law provisions.
+
+11. ENTIRE AGREEMENT
+
+This License constitutes the entire agreement between the parties with
+respect to the commercial portions of the Software and supersedes all
+prior agreements, understandings, and communications.
+
+For licensing inquiries: founder@revealui.com
+For pricing and subscriptions: https://revealui.com/pricing

package/README.md

@@ -0,0 +1,314 @@
+# @revealui/ai
+
+AI system for RevealUI - memory, LLM, orchestration, and tools.
+
+## Features
+
+- **Memory System**: CRDT-based persistent memory (Working, Episodic, Semantic)
+- **LLM Integration**: Provider abstractions for Anthropic, GROQ, Ollama, and more
+- **Agent Orchestration**: Runtime and execution engine for AI agents
+- **Tool Calling**: Tool registry and execution system
+- **Vector Search**: Semantic search with pgvector
+- **Type-safe**: Full TypeScript support
+- **Performant**: Optimized for low-latency operations
+
+## Installation
+
+```bash
+pnpm add @revealui/ai
+```
+
+## Quick Start
+
+```typescript
+import { EpisodicMemory } from '@revealui/ai/memory/stores'
+import { NodeIdService } from '@revealui/ai/memory/services'
+import { createClient } from '@revealui/db/client'
+
+const db = createClient({ connectionString: process.env.POSTGRES_URL! })
+const nodeIdService = new NodeIdService(db)
+const nodeId = await nodeIdService.getNodeId('user', 'user-123')
+const memory = new EpisodicMemory('user-123', nodeId, db)
+```
+
+## Testing
+
+⚠️ **Important**: This package has known testing limitations. See [TESTING.md](./TESTING.md) for details.
+
+### Quick Commands
+
+```bash
+# Unit tests (always work)
+pnpm --filter @revealui/ai test
+
+# Integration tests (require Neon instance)
+POSTGRES_URL="postgresql://..." pnpm --filter @revealui/ai test __tests__/integration
+
+# Production validation
+POSTGRES_URL="postgresql://..." ./scripts/validate-production.sh
+```
+
+### Testing Limitations
+
+- ❌ Local PostgreSQL testing not possible (Neon HTTP driver limitation)
+- ⚠️ Mock database tests may fail (known limitation, not a bug)
+
+**Full documentation**: See [TESTING.md](./TESTING.md)
+
+## Documentation
+
+- **[TESTING.md](./TESTING.md)**: Complete testing guide, limitations, and validation plan
+- **[OBSERVABILITY.md](./OBSERVABILITY.md)**: Observability and monitoring guide
+- **Source Code**: `packages/ai/src/memory/`
+- **Helper Functions**: `packages/ai/src/memory/utils/sql-helpers.ts`
+
+## API Reference
+
+### Memory System
+
+#### EpisodicMemory
+
+Long-term memory for conversation history and agent memories.
+
+```typescript
+import { EpisodicMemory } from '@revealui/ai/memory/stores'
+
+const memory = new EpisodicMemory(userId, nodeId, db)
+await memory.add(agentMemory)
+await memory.save()
+const memories = await memory.getAll()
+```
+
+#### NodeIdService
+
+Deterministic node IDs for CRDT operations.
+
+```typescript
+import { NodeIdService } from '@revealui/ai/memory/services'
+
+const nodeIdService = new NodeIdService(db)
+const nodeId = await nodeIdService.getNodeId('user', 'user-123')
+```
+
+#### CRDTPersistence
+
+Generic adapter for saving/loading CRDT state.
+
+```typescript
+import { CRDTPersistence } from '@revealui/ai/memory/persistence'
+
+const persistence = new CRDTPersistence(db)
+await persistence.saveCRDTState(crdtId, 'lww_register', data)
+const state = await persistence.loadCRDTState(crdtId, 'lww_register')
+```
+
+### LLM Integration
+
+Provider abstractions and unified client for Anthropic, GROQ, and Ollama.
+
+```typescript
+import { LLMClient, createLLMClientFromEnv } from '@revealui/ai/llm/client'
+
+const client = createLLMClientFromEnv()
+const response = await client.chat([
+  { role: 'user', content: 'Hello!' }
+])
+```
+
+#### Vultr (Vultr AI / Serverless Inference)
+
+You can configure the client to use Vultr Serverless Inference by setting `LLM_PROVIDER=vultr` and providing the `VULTR_API_KEY` and optionally `VULTR_BASE_URL` env vars. Example:
+
+```
+LLM_PROVIDER=vultr
+VULTR_API_KEY=your_inference_api_key
+VULTR_BASE_URL=https://api.vultrinference.com/v1  # optional
+```
+
+The `VultrProvider` supports the chat and (if available for the selected model) embeddings endpoints. Streaming is attempted via the chat streaming endpoint when supported by the API.
+
+Demo: quick test script
+
+You can run a quick demo script that exercises chat and embeddings endpoints. From the repository root:
+
+```bash
+# replace with real values
+VULTR_API_KEY=your_key VULTR_MODEL=your-model-id ts-node packages/ai/scripts/test-vultr.ts
+```
+
+The script prints the raw API responses and a simplified assistant output.
+
+
+### Agent Orchestration
+
+Agent runtime and execution engine for autonomous agents.
+
+```typescript
+import { AgentRuntime } from '@revealui/ai/orchestration/runtime'
+import { AgentOrchestrator } from '@revealui/ai/orchestration/orchestrator'
+
+const runtime = new AgentRuntime()
+const orchestrator = new AgentOrchestrator()
+```
+
+### Tools
+
+Tool registry and execution system with MCP integration.
+
+```typescript
+import { ToolRegistry } from '@revealui/ai/tools/registry'
+import { registerMCPTools } from '@revealui/ai/tools/mcp-adapter'
+
+const registry = new ToolRegistry()
+await registerMCPTools(mcpClient, registry)
+```
+
+## Performance Considerations
+
+The memory system uses deep cloning to ensure immutability and prevent data corruption. Understanding the cloning strategy is important for performance optimization.
+
+### Cloning Layers
+
+1. **LWWRegister Level** (Core CRDT)
+   - `get()`: Clones object/array values on every call
+   - `set()`: Clones values when storing
+   - `merge()`: Clones winning values during merge
+   - `toData()`: Clones values when serializing
+
+2. **WorkingMemory Level**
+   - `getContext()`: Returns cloned context from LWWRegister
+   - `getContextValue()`: Returns value from cloned context (no additional cloning)
+   - `setContext()`: Clones entire context object
+   - `updateContext()`: Clones context once for multiple updates
+
+3. **AgentContextManager Level**
+   - `getContext()`: Returns value from cloned context (no additional cloning)
+   - `getAllContext()`: Returns cloned context from WorkingMemory
+   - `setContext()`: Validates then sets (cloning happens in WorkingMemory)
+   - `updateContext()`: Validates then updates (cloning happens in WorkingMemory)
+
+### Performance Implications
+
+#### ✅ Efficient Operations
+
+- **Single key access**: `getContext(key)` - No double cloning
+- **Multiple updates**: `updateContext({ k1: v1, k2: v2 })` - Single clone
+- **Primitive values**: No cloning overhead
+
+#### ⚠️ Performance Considerations
+
+- **Large contexts**: Every `getContext()` clones the entire context
+- **Frequent updates**: Each update clones the context
+- **Deep nesting**: Deep cloning is recursive and can be slow for very deep objects
+
+### Best Practices
+
+**1. Batch Updates**: Use `updateContext()` for multiple changes instead of multiple `setContext()` calls
+
+```typescript
+// ❌ Bad: Clones context 3 times
+manager.setContext('key1', 'value1')
+manager.setContext('key2', 'value2')
+manager.setContext('key3', 'value3')
+
+// ✅ Good: Clones context once
+manager.updateContext({
+  key1: 'value1',
+  key2: 'value2',
+  key3: 'value3',
+})
+```
+
+**2. Cache Context**: If you need to access multiple values, get the full context once
+
+```typescript
+// ❌ Bad: Clones context multiple times
+const value1 = manager.getContext('key1')
+const value2 = manager.getContext('key2')
+const value3 = manager.getContext('key3')
+
+// ✅ Good: Clone once, access multiple times
+const context = manager.getAllContext()
+const value1 = context.key1
+const value2 = context.key2
+const value3 = context.key3
+```
+
+**3. Avoid Deep Nesting**: Keep context structure relatively flat
+
+```typescript
+// ❌ Bad: Very deep nesting
+context: {
+  user: {
+    profile: {
+      settings: {
+        theme: {
+          color: 'dark'
+        }
+      }
+    }
+  }
+}
+
+// ✅ Good: Flatter structure
+context: {
+  'user.profile.settings.theme.color': 'dark'
+}
+```
+
+**4. Use Primitives When Possible**: Primitives don't require cloning
+
+```typescript
+// ✅ Good: Primitives are fast
+manager.setContext('count', 42)
+manager.setContext('name', 'John')
+
+// ⚠️ Consider: Objects require cloning
+manager.setContext('user', { name: 'John', age: 30 })
+```
+
+### Size Limits
+
+The system enforces limits to prevent performance issues:
+
+- **Max Context Keys**: 10,000 keys
+- **Max Context Size**: ~10MB (approximate)
+- **Max Object Depth**: 100 levels
+
+These limits prevent:
+- Memory exhaustion
+- Stack overflow from deep recursion
+- Performance degradation from huge objects
+
+### Monitoring Performance
+
+If you experience performance issues:
+
+1. **Profile Context Size**: Check how large your contexts are
+2. **Monitor Clone Operations**: Count how many times contexts are cloned
+3. **Check Depth**: Ensure objects aren't too deeply nested
+4. **Review Update Patterns**: Look for opportunities to batch updates
+
+### Future Optimizations
+
+Potential optimizations (not yet implemented):
+
+- **Lazy Cloning**: Only clone when values are actually accessed
+- **Structural Sharing**: Share unchanged parts of objects
+- **Caching**: Cache cloned values for frequently accessed keys
+- **Incremental Updates**: Only clone changed parts of context
+
+## Requirements
+
+- Node.js 18+
+- PostgreSQL with pgvector extension
+- Neon Postgres (for production) or compatible database
+
+## License
+
+Commercial — see [LICENSE.commercial](../../LICENSE.commercial)
+
+---
+
+**Last Updated**: 2026-03-04
+**Consolidated**: 2026-01-31 (Merged PERFORMANCE.md into this README)

package/dist/a2a/card.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A2A Agent Card Registry
+ *
+ * In-memory registry of AgentDefinitions. Generates A2A Agent Cards on demand
+ * by mapping AgentDefinition → A2AAgentCard via @revealui/contracts mappers.
+ *
+ * Pre-seeded with the RevealUI platform agent ("The Creator") and the TicketAgent.
+ */
+import type { AgentDefinition } from '@revealui/contracts';
+import { type A2AAgentCard } from '@revealui/contracts';
+declare class AgentCardRegistry {
+    private readonly defs;
+    constructor();
+    register(def: AgentDefinition): void;
+    unregister(agentId: string): boolean;
+    update(agentId: string, patch: Partial<Omit<AgentDefinition, 'id' | 'version'>>): boolean;
+    getDef(agentId: string): AgentDefinition | undefined;
+    getCard(agentId: string, baseUrl: string): A2AAgentCard | null;
+    listCards(baseUrl: string): A2AAgentCard[];
+    listDefs(): AgentDefinition[];
+    has(agentId: string): boolean;
+}
+/** 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

@@ -0,0 +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,CAAA;AAC1D,OAAO,EAAE,KAAK,YAAY,EAAyB,MAAM,qBAAqB,CAAA;AAwI9E,cAAM,iBAAiB;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;;IAO1D,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,CAAA;AAExD,YAAY,EAAE,eAAe,EAAE,CAAA"}

package/dist/a2a/card.js

@@ -0,0 +1,173 @@
+/**
+ * A2A Agent Card Registry
+ *
+ * In-memory registry of AgentDefinitions. Generates A2A Agent Cards on demand
+ * by mapping AgentDefinition → A2AAgentCard via @revealui/contracts mappers.
+ *
+ * Pre-seeded with the RevealUI platform agent ("The Creator") and the TicketAgent.
+ */
+import { agentDefinitionToCard } from '@revealui/contracts';
+// =============================================================================
+// Built-in agent definitions
+// =============================================================================
+/** RevealUI platform meta-agent — "The Creator" */
+const THE_CREATOR_DEF = {
+    id: 'revealui-creator',
+    version: 1,
+    name: 'The Creator',
+    description: 'The RevealUI platform agent. Scaffolds new AI agents, manages agent lifecycles, ' +
+        'orchestrates multi-agent workflows, and acts as the primary interface for AI capabilities ' +
+        'on the RevealUI platform.',
+    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.',
+    tools: [
+        {
+            name: 'scaffoldAgent',
+            description: 'Scaffold a new AI agent from a template with name, capabilities, and system prompt',
+            parameters: {
+                name: { type: 'string', description: 'Agent name', required: true },
+                template: {
+                    type: 'string',
+                    description: 'Agent template',
+                    required: true,
+                    enum: ['content', 'code', 'support', 'analytics'],
+                },
+                description: { type: 'string', description: 'Agent description', required: true },
+                systemPrompt: { type: 'string', description: 'Agent system prompt', required: false },
+            },
+            destructive: false,
+        },
+        {
+            name: 'listAgents',
+            description: 'List all registered agents and their current status',
+            parameters: {},
+            destructive: false,
+        },
+        {
+            name: 'deployAgent',
+            description: 'Deploy a configured agent to the RevealUI platform',
+            parameters: {
+                agentId: { type: 'string', description: 'Agent ID to deploy', required: true },
+            },
+            destructive: false,
+        },
+        {
+            name: 'retireAgent',
+            description: 'Retire and deregister an agent from the platform',
+            parameters: {
+                agentId: { type: 'string', description: 'Agent ID to retire', required: true },
+            },
+            destructive: true,
+        },
+    ],
+    capabilities: ['agent-scaffolding', 'orchestration', 'lifecycle-management'],
+    temperature: 0.7,
+    maxTokens: 4096,
+    canDelegateToAgents: ['revealui-ticket-agent'],
+};
+/** RevealUI ticket / support agent */
+const TICKET_AGENT_DEF = {
+    id: 'revealui-ticket-agent',
+    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.',
+    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.',
+    tools: [
+        {
+            name: 'createTicket',
+            description: 'Create a new support ticket with title, description, priority, and board assignment',
+            parameters: {
+                title: { type: 'string', description: 'Ticket title', required: true },
+                description: { type: 'string', description: 'Ticket description', required: true },
+                priority: {
+                    type: 'string',
+                    description: 'Priority level',
+                    required: false,
+                    enum: ['low', 'medium', 'high', 'critical'],
+                },
+                boardId: { type: 'string', description: 'Board ID to assign ticket to', required: true },
+            },
+            destructive: false,
+        },
+        {
+            name: 'searchTickets',
+            description: 'Search existing tickets by keyword, status, or priority',
+            parameters: {
+                query: { type: 'string', description: 'Search query', required: true },
+                status: {
+                    type: 'string',
+                    description: 'Filter by status',
+                    required: false,
+                    enum: ['open', 'in-progress', 'resolved', 'closed'],
+                },
+            },
+            destructive: false,
+        },
+        {
+            name: 'updateTicketStatus',
+            description: 'Update the status of an existing ticket',
+            parameters: {
+                ticketId: { type: 'string', description: 'Ticket ID', required: true },
+                status: {
+                    type: 'string',
+                    description: 'New status',
+                    required: true,
+                    enum: ['open', 'in-progress', 'resolved', 'closed'],
+                },
+                note: { type: 'string', description: 'Status update note', required: false },
+            },
+            destructive: false,
+        },
+    ],
+    capabilities: ['ticket-management', 'search', 'escalation'],
+    temperature: 0.3,
+    maxTokens: 2048,
+};
+// =============================================================================
+// Registry
+// =============================================================================
+class AgentCardRegistry {
+    defs = new Map();
+    constructor() {
+        this.register(THE_CREATOR_DEF);
+        this.register(TICKET_AGENT_DEF);
+    }
+    register(def) {
+        this.defs.set(def.id, def);
+    }
+    unregister(agentId) {
+        return this.defs.delete(agentId);
+    }
+    update(agentId, patch) {
+        const existing = this.defs.get(agentId);
+        if (!existing)
+            return false;
+        this.defs.set(agentId, { ...existing, ...patch });
+        return true;
+    }
+    getDef(agentId) {
+        return this.defs.get(agentId);
+    }
+    getCard(agentId, baseUrl) {
+        const def = this.defs.get(agentId);
+        if (!def)
+            return null;
+        return agentDefinitionToCard(def, baseUrl);
+    }
+    listCards(baseUrl) {
+        return Array.from(this.defs.values()).map((def) => agentDefinitionToCard(def, baseUrl));
+    }
+    listDefs() {
+        return Array.from(this.defs.values());
+    }
+    has(agentId) {
+        return this.defs.has(agentId);
+    }
+}
+/** Singleton registry — import and use directly */
+export const agentCardRegistry = new AgentCardRegistry();

package/dist/a2a/handler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A2A JSON-RPC Handler
+ *
+ * Dispatches A2A JSON-RPC 2.0 methods to the appropriate implementation.
+ * 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)
+ */
+import type { A2AJsonRpcRequest, A2AJsonRpcResponse } from '@revealui/contracts';
+import type { LLMClient } from '../llm/client.js';
+declare const RPC_PARSE_ERROR = -32700;
+declare const RPC_INVALID_REQUEST = -32600;
+/**
+ * Handle an A2A JSON-RPC request and return a JSON-RPC response.
+ *
+ * @param req - Parsed JSON-RPC request body
+ * @param agentId - Optional agent ID (from X-Agent-ID header)
+ * @param llmClient - Optional LLM client for real inference (BYOK)
+ */
+export declare function handleA2AJsonRpc(req: A2AJsonRpcRequest, agentId?: string, llmClient?: LLMClient): Promise<A2AJsonRpcResponse>;
+export { RPC_PARSE_ERROR, RPC_INVALID_REQUEST };
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/a2a/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAGnB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAgBjD,QAAA,MAAM,eAAe,SAAS,CAAA;AAC9B,QAAA,MAAM,mBAAmB,SAAS,CAAA;AA0JlC;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,iBAAiB,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAoB7B;AAED,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAA"}