agents-library 1.1.0

package/dist/kadi-event-publisher.js

@@ -0,0 +1,286 @@
+/**
+ * Shared KĀDI Event Publisher Utility
+ * ====================================
+ *
+ * Common publisher logic extracted from mcp-client-slack and mcp-client-discord
+ * to eliminate code duplication (DRY principle).
+ *
+ * Architecture:
+ * - Generic event publishing to KĀDI broker
+ * - Platform-agnostic connection management
+ * - Graceful degradation pattern (stub mode if broker unavailable)
+ * - Retry logic with exponential backoff
+ *
+ * Usage:
+ * ```typescript
+ * const publisher = new KadiEventPublisher({
+ *   brokerUrl: 'ws://localhost:8080/kadi',
+ *   clientName: 'mcp-client-slack',
+ *   networks: ['slack']
+ * });
+ * await publisher.connect();
+ * await publisher.publishEvent('slack.app_mention.U12345', event);
+ * ```
+ */
+import { KadiClient, z } from '@kadi.build/core';
+/**
+ * Validates topic pattern against standard format: {platform}.{event_type}.{bot_id}
+ *
+ * @param topic - Topic string to validate
+ * @returns True if topic matches pattern, false otherwise
+ *
+ * @example
+ * ```typescript
+ * validateTopicPattern('slack.app_mention.U12345') // true
+ * validateTopicPattern('discord.mention.67890') // true
+ * validateTopicPattern('invalid-topic') // false
+ * validateTopicPattern('slack.app_mention') // false (missing bot_id)
+ * ```
+ */
+export function validateTopicPattern(topic) {
+    // Pattern: {platform}.{event_type}.{bot_id}
+    // - platform: lowercase letters (e.g., 'slack', 'discord')
+    // - event_type: lowercase letters with underscores (e.g., 'app_mention', 'mention')
+    // - bot_id: alphanumeric with hyphens/underscores (e.g., 'U12345', 'bot-123')
+    const pattern = /^[a-z]+\.[a-z_]+\.[a-zA-Z0-9_-]+$/;
+    return pattern.test(topic);
+}
+/**
+ * Shared KĀDI Event Publisher
+ *
+ * Provides common event publishing functionality for all MCP clients.
+ * Handles connection management, retry logic, graceful degradation,
+ * and error handling.
+ */
+export class KadiEventPublisher {
+    client = null;
+    enabled = false;
+    config;
+    /**
+     * Create a new KĀDI Event Publisher
+     *
+     * @param config - Publisher configuration with broker URL, client name, and networks
+     *
+     * @example
+     * ```typescript
+     * const publisher = new KadiEventPublisher({
+     *   brokerUrl: 'ws://localhost:8080/kadi',
+     *   clientName: 'mcp-client-slack',
+     *   networks: ['slack']
+     * });
+     * ```
+     */
+    constructor(config) {
+        // Set defaults for optional fields
+        this.config = {
+            brokerUrl: config.brokerUrl,
+            clientName: config.clientName,
+            networks: config.networks,
+            version: config.version || '1.0.0'
+        };
+        // Graceful degradation: Check if broker URL is valid
+        const hasValidBrokerUrl = config.brokerUrl &&
+            (config.brokerUrl.startsWith('ws://') ||
+                config.brokerUrl.startsWith('wss://'));
+        if (hasValidBrokerUrl) {
+            this.enabled = true;
+        }
+        else {
+            console.log('⚠️  KĀDI broker URL not configured - running in stub mode');
+            console.log('   Set KADI_BROKER_URL to enable event publishing');
+        }
+    }
+    /**
+     * Create a new KadiClient instance
+     * Must be called before each connection attempt to avoid handshake state issues
+     *
+     * @private
+     */
+    createClient() {
+        const client = new KadiClient({
+            name: this.config.clientName,
+            version: this.config.version,
+            brokers: {
+                default: { url: this.config.brokerUrl, networks: this.config.networks }
+            },
+            defaultBroker: 'default',
+        });
+        // Register a dummy tool to make agent visible in system snapshots
+        // This is a test to verify that broker filters agents without tools
+        const addNumberInputSchema = z.object({
+            a: z.number().describe('First number'),
+            b: z.number().describe('Second number')
+        });
+        client.registerTool({
+            name: 'addNumber',
+            description: 'Dummy tool for testing - adds two numbers together',
+            input: addNumberInputSchema,
+            output: z.object({
+                result: z.number().describe('Sum of a and b')
+            })
+        }, async (params) => {
+            return { result: params.a + params.b };
+        });
+        return client;
+    }
+    /**
+     * Connect to KĀDI broker with retry logic
+     *
+     * Establishes WebSocket connection and performs authentication handshake.
+     * Retries with exponential backoff when broker is not ready (e.g., during startup).
+     * Logs connection status for debugging.
+     *
+     * Retry schedule: 5 attempts with exponential backoff (1s, 2s, 4s, 8s, 16s)
+     *
+     * @throws {Error} If connection fails after all retries
+     *
+     * @example
+     * ```typescript
+     * await publisher.connect();
+     * console.log('Connected to KĀDI broker');
+     * ```
+     */
+    async connect() {
+        if (!this.enabled) {
+            console.log('[KĀDI] Publisher: Event publishing disabled {mode: stub}');
+            return;
+        }
+        const maxRetries = 5;
+        const baseDelayMs = 1000;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            console.log(`[KĀDI] Publisher: Attempting connection to broker (attempt ${attempt}/${maxRetries})...`);
+            // Create a fresh client for each attempt to avoid handshake state issues
+            this.client = this.createClient();
+            try {
+                const agentId = await this.client.connect();
+                console.log(`[KĀDI] Publisher: Connected successfully {agentId: ${agentId ?? 'unknown'}, networks: ${JSON.stringify(this.config.networks)}}`);
+                return; // Success - exit retry loop
+            }
+            catch (error) {
+                const isLastAttempt = attempt === maxRetries;
+                // Disconnect failed client to clean up resources
+                try {
+                    await this.client.disconnect();
+                }
+                catch {
+                    // Ignore disconnect errors
+                }
+                if (isLastAttempt) {
+                    console.error(`[KĀDI] Publisher: Connection failed after ${maxRetries} attempts {error: ${error.message || 'Unknown error'}}`);
+                    this.client = null; // Clear client on final failure
+                    throw error; // Fail-fast after all retries exhausted
+                }
+                // Exponential backoff: 1s, 2s, 4s, 8s, 16s
+                const delayMs = baseDelayMs * Math.pow(2, attempt - 1);
+                console.warn(`[KĀDI] Publisher: Connection failed, retrying in ${delayMs}ms... {error: ${error.message || 'Unknown error'}}`);
+                await new Promise(resolve => setTimeout(resolve, delayMs));
+            }
+        }
+    }
+    /**
+     * Publish an event to a specific KĀDI broker topic
+     *
+     * Generic event publishing method. Accepts any event data and publishes
+     * it to the specified topic. Validation should be done by the caller.
+     *
+     * @param topic - Topic pattern (e.g., 'slack.app_mention.U12345', 'discord.mention.67890')
+     * @param event - Event data to publish (must be JSON-serializable)
+     * @param metadata - Optional metadata for logging (e.g., { eventId, user, textPreview })
+     *
+     * @throws {Error} If publish fails (fail-fast, no retry)
+     *
+     * @example
+     * ```typescript
+     * await publisher.publishEvent(
+     *   'slack.app_mention.U12345',
+     *   {
+     *     id: '1234567890.123456',
+     *     user: 'U12345678',
+     *     text: 'Hello bot!',
+     *     channel: 'C12345678',
+     *     bot_id: 'U87654321',
+     *     timestamp: '2025-11-29T12:00:00Z'
+     *   },
+     *   { eventId: '1234567890.123456', user: 'U12345678', textPreview: 'Hello bot!' }
+     * );
+     * ```
+     */
+    async publishEvent(topic, event, metadata) {
+        // Validate topic pattern
+        if (!validateTopicPattern(topic)) {
+            console.warn(`[KĀDI] Publisher: Topic pattern validation failed {topic: ${topic}, expected: {platform}.{event_type}.{bot_id}}`);
+        }
+        if (!this.client || !this.enabled) {
+            console.log('[KĀDI] Publisher: Event publishing disabled, event not published {mode: stub}');
+            return;
+        }
+        try {
+            await this.client.publish(topic, event, {
+                broker: 'default',
+                network: this.config.networks[0] || 'global'
+            });
+            // Log with metadata if provided, otherwise generic log
+            if (metadata) {
+                const logParts = [`topic: ${topic}`];
+                if (metadata.eventId)
+                    logParts.push(`eventId: ${metadata.eventId}`);
+                if (metadata.user)
+                    logParts.push(`user: ${metadata.user}`);
+                if (metadata.textPreview)
+                    logParts.push(`textPreview: "${metadata.textPreview}"`);
+                console.log(`[KĀDI] Publisher: Event published successfully {${logParts.join(', ')}}`);
+            }
+            else {
+                console.log(`[KĀDI] Publisher: Event published successfully {topic: ${topic}}`);
+            }
+        }
+        catch (error) {
+            // Fail-fast on publish errors (no retry)
+            console.error(`[KĀDI] Publisher: Event publication failed {topic: ${topic}, error: ${error.message || 'Unknown error'}}`);
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from KĀDI broker
+     *
+     * Performs cleanup and gracefully closes WebSocket connection.
+     * Safe to call multiple times (idempotent).
+     *
+     * @example
+     * ```typescript
+     * await publisher.disconnect();
+     * console.log('Disconnected from KĀDI broker');
+     * ```
+     */
+    async disconnect() {
+        if (!this.client || !this.enabled) {
+            return;
+        }
+        console.log('[KĀDI] Publisher: Disconnecting from broker...');
+        try {
+            await this.client.disconnect();
+            console.log('[KĀDI] Publisher: Disconnected successfully');
+        }
+        catch (error) {
+            console.error(`[KĀDI] Publisher: Disconnection failed {error: ${error.message || 'Unknown error'}}`);
+            // Don't throw - best effort cleanup
+        }
+    }
+    /**
+     * Check if publisher is connected and enabled
+     *
+     * @returns True if connected to broker and publishing is enabled
+     */
+    isConnected() {
+        return this.client !== null && this.enabled;
+    }
+    /**
+     * Get current publisher configuration
+     *
+     * @returns Current publisher configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=kadi-event-publisher.js.map

package/dist/kadi-event-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kadi-event-publisher.js","sourceRoot":"","sources":["../src/kadi-event-publisher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,4CAA4C;IAC5C,2DAA2D;IAC3D,oFAAoF;IACpF,8EAA8E;IAC9E,MAAM,OAAO,GAAG,mCAAmC,CAAC;IACpD,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAmBD;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAsB,IAAI,CAAC;IACjC,OAAO,GAAY,KAAK,CAAC;IACzB,MAAM,CAA4B;IAE1C;;;;;;;;;;;;;OAaG;IACH,YAAY,MAAuB;QACjC,mCAAmC;QACnC,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;SACnC,CAAC;QAEF,qDAAqD;QACrD,MAAM,iBAAiB,GACrB,MAAM,CAAC,SAAS;YAChB,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;gBACnC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE3C,IAAI,iBAAiB,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,YAAY;QAClB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE;gBACP,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;aACxE;YACD,aAAa,EAAE,SAAS;SACzB,CAAC,CAAC;QAEH,kEAAkE;QAClE,oEAAoE;QACpE,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;YACpC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACtC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;SACxC,CAAC,CAAC;QAEH,MAAM,CAAC,YAAY,CACjB;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,oDAAoD;YACjE,KAAK,EAAE,oBAAoB;YAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;aAC9C,CAAC;SACH,EACD,KAAK,EAAE,MAA4C,EAAE,EAAE;YACrD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC;QACzC,CAAC,CACF,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,CAAC;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC;QAEzB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,8DAA8D,OAAO,IAAI,UAAU,MAAM,CAAC,CAAC;YAEvG,yEAAyE;YACzE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAElC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,sDAAsD,OAAO,IAAI,SAAS,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC9I,OAAO,CAAC,4BAA4B;YACtC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,aAAa,GAAG,OAAO,KAAK,UAAU,CAAC;gBAE7C,iDAAiD;gBACjD,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;gBAED,IAAI,aAAa,EAAE,CAAC;oBAClB,OAAO,CAAC,KAAK,CAAC,6CAA6C,UAAU,qBAAqB,KAAK,CAAC,OAAO,IAAI,eAAe,GAAG,CAAC,CAAC;oBAC/H,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,gCAAgC;oBACpD,MAAM,KAAK,CAAC,CAAC,wCAAwC;gBACvD,CAAC;gBAED,2CAA2C;gBAC3C,MAAM,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,oDAAoD,OAAO,iBAAiB,KAAK,CAAC,OAAO,IAAI,eAAe,GAAG,CAAC,CAAC;gBAC9H,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,KAA0B,EAC1B,QAAoE;QAEpE,yBAAyB;QACzB,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CACV,6DAA6D,KAAK,+CAA+C,CAClH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,+EAA+E,CAAC,CAAC;YAC7F,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE;gBACtC,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ;aAC7C,CAAC,CAAC;YAEH,uDAAuD;YACvD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;gBACrC,IAAI,QAAQ,CAAC,OAAO;oBAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpE,IAAI,QAAQ,CAAC,IAAI;oBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3D,IAAI,QAAQ,CAAC,WAAW;oBAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC;gBAElF,OAAO,CAAC,GAAG,CAAC,mDAAmD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,0DAA0D,KAAK,GAAG,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,yCAAyC;YACzC,OAAO,CAAC,KAAK,CAAC,sDAAsD,KAAK,YAAY,KAAK,CAAC,OAAO,IAAI,eAAe,GAAG,CAAC,CAAC;YAC1H,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,kDAAkD,KAAK,CAAC,OAAO,IAAI,eAAe,GAAG,CAAC,CAAC;YACrG,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,WAAW;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACI,SAAS;QACd,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/memory/arcadedb-adapter.d.ts

@@ -0,0 +1,159 @@
+/**
+ * ArcadeDB Adapter
+ *
+ * Provides database operations for long-term memory storage using ArcadeDB.
+ * Supports vertex/edge operations and Cypher queries with connection pooling.
+ */
+import type { Result } from '../common/result.js';
+import type { DatabaseError } from '../common/types.js';
+/**
+ * ArcadeDB Client Configuration
+ */
+export interface ArcadeDBClientConfig {
+    host: string;
+    port: number;
+    database: string;
+    username: string;
+    password: string;
+    timeout?: number;
+}
+/**
+ * ArcadeDB Client
+ *
+ * Low-level HTTP client for ArcadeDB REST API
+ * Handles connection, authentication, and query execution
+ */
+export declare class ArcadeDBClient {
+    private readonly config;
+    private connected;
+    private readonly baseUrl;
+    private readonly auth;
+    private readonly timeout;
+    /**
+     * Create ArcadeDB Client
+     *
+     * @param config - Client configuration
+     */
+    constructor(config: ArcadeDBClientConfig);
+    /**
+     * Connect to ArcadeDB
+     *
+     * Verifies connectivity by executing a test query
+     *
+     * @returns Result indicating connection success or error
+     */
+    connect(): Promise<Result<void, DatabaseError>>;
+    /**
+     * Disconnect from ArcadeDB
+     *
+     * Marks client as disconnected (no persistent connection to close)
+     *
+     * @returns Result indicating disconnect success
+     */
+    disconnect(): Promise<Result<void, DatabaseError>>;
+    /**
+     * Check if client is connected
+     *
+     * @returns True if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Execute query
+     *
+     * Supports both SQL and Cypher languages
+     *
+     * @param command - Query command
+     * @param params - Optional query parameters
+     * @param language - Query language ('sql' or 'cypher'), defaults to 'sql'
+     * @returns Result with query results or error
+     */
+    query(command: string, params?: Record<string, any>, language?: 'sql' | 'cypher'): Promise<Result<any[], DatabaseError>>;
+}
+/**
+ * Vertex properties
+ */
+export interface VertexProperties {
+    [key: string]: any;
+}
+/**
+ * Edge properties
+ */
+export interface EdgeProperties {
+    [key: string]: any;
+}
+/**
+ * Vertex result with @rid
+ */
+export interface VertexResult {
+    '@rid': string;
+    [key: string]: any;
+}
+/**
+ * ArcadeDB Adapter
+ *
+ * High-level adapter for graph database operations
+ * Provides vertex/edge operations using Cypher queries
+ */
+export declare class ArcadeDBAdapter {
+    private readonly dbUrl;
+    private readonly username;
+    private readonly password;
+    private readonly timeout;
+    private client;
+    /**
+     * Create ArcadeDB Adapter
+     *
+     * @param dbUrl - Database connection URL (format: http://host:port/database)
+     * @param username - Database username
+     * @param password - Database password
+     * @param timeout - Query timeout in milliseconds
+     */
+    constructor(dbUrl: string, username?: string, password?: string, timeout?: number);
+    /**
+     * Parse database URL into config
+     *
+     * @returns Client configuration
+     */
+    private parseDbUrl;
+    /**
+     * Connect to database
+     *
+     * Creates client instance and establishes connection
+     *
+     * @returns Result indicating success or error
+     */
+    connect(): Promise<Result<void, DatabaseError>>;
+    /**
+     * Disconnect from database
+     *
+     * @returns Result indicating success or error
+     */
+    disconnect(): Promise<Result<void, DatabaseError>>;
+    /**
+     * Execute Cypher query
+     *
+     * @param cypher - Cypher query command
+     * @param params - Optional query parameters
+     * @returns Result with query results or error
+     */
+    query(cypher: string, params?: Record<string, any>): Promise<Result<any[], DatabaseError>>;
+    /**
+     * Create vertex
+     *
+     * @param type - Vertex type (label)
+     * @param properties - Vertex properties
+     * @returns Result with vertex @rid or error
+     */
+    createVertex(type: string, properties: VertexProperties): Promise<Result<string, DatabaseError>>;
+    /**
+     * Create edge
+     *
+     * @param fromRid - Source vertex @rid
+     * @param toRid - Target vertex @rid
+     * @param type - Edge type (label)
+     * @param properties - Optional edge properties
+     * @returns Result with edge @rid or error
+     */
+    createEdge(fromRid: string, toRid: string, type: string, properties?: EdgeProperties): Promise<Result<string, DatabaseError>>;
+}
+//# sourceMappingURL=arcadedb-adapter.d.ts.map

package/dist/memory/arcadedb-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcadedb-adapter.d.ts","sourceRoot":"","sources":["../../src/memory/arcadedb-adapter.ts"],"names":[],"mappings":"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"}