@chanl-ai/sdk 2.0.1

package/dist/modules/mcp.d.ts

@@ -0,0 +1,140 @@
+/**
+ * McpModule - SDK module for MCP server configuration and status
+ *
+ * Provides access to MCP server configuration and health status.
+ * Used by CLI and admin UI to get ready-to-use agent configurations.
+ */
+import { ChanlSDK } from '../client';
+import { ApiResponse } from '../types/config';
+export interface AgentConfig {
+    url: string;
+    headers: Record<string, string>;
+    transport?: string;
+}
+export interface AgentConfigs {
+    claude: {
+        mcpServers: {
+            chanl: AgentConfig;
+        };
+    };
+    cursor: {
+        mcpServers: {
+            chanl: AgentConfig;
+        };
+    };
+    generic: AgentConfig;
+}
+export interface McpConfigResponse {
+    serverUrl: string;
+    environment: 'production' | 'staging' | 'development';
+    status: 'active' | 'disabled';
+    toolCount: number;
+    resourceCount: number;
+    promptCount: number;
+    toolsetId?: string;
+    toolsetName?: string;
+    agentConfigs: AgentConfigs;
+}
+export interface McpStatusResponse {
+    healthy: boolean;
+    message: string;
+    responseTimeMs?: number;
+    error?: string;
+}
+export interface McpConfigOptions {
+    toolsetId?: string;
+}
+export interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface McpToolCallResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError?: boolean;
+}
+export declare class McpModule {
+    private sdk;
+    constructor(sdk: ChanlSDK);
+    /**
+     * Get MCP configuration for a workspace
+     *
+     * @param options - Optional configuration options (e.g., toolsetId filter)
+     * @returns MCP configuration including server URL and agent configs
+     *
+     * @example
+     * typescript
+     * const { data } = await sdk.mcp.getConfig('ws_123');
+     * console.log(data.serverUrl);
+     * console.log(data.agentConfigs.claude);
+     */
+    getConfig(options?: McpConfigOptions): Promise<ApiResponse<McpConfigResponse>>;
+    /**
+     * Check MCP server health status
+     *
+     * @returns Health status of the MCP server
+     *
+     * @example
+     * typescript
+     * const { data } = await sdk.mcp.getStatus('ws_123');
+     * if (data.healthy) {
+     *   console.log('MCP server is running');
+     * }
+     */
+    getStatus(): Promise<ApiResponse<McpStatusResponse>>;
+    /**
+     * List MCP tools available for an agent
+     *
+     * @param agentId - Agent ID to list tools for
+     * @returns List of MCP tools with their schemas
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.mcp.listTools('ws_123', 'agent_456');
+     * for (const tool of data.tools) {
+     *   console.log(tool.name, tool.description);
+     * }
+     * ```
+     */
+    listTools(agentId: string): Promise<ApiResponse<{
+        tools: McpTool[];
+    }>>;
+    /**
+     * Call an MCP tool by name
+     *
+     * @param agentId - Agent ID that owns the tool
+     * @param toolName - Name of the tool to invoke
+     * @param args - Optional arguments to pass to the tool
+     * @returns Tool call result with content array
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.mcp.callTool('ws_123', 'agent_456', 'get_weather', { city: 'London' });
+     * if (!data.isError) {
+     *   console.log(data.content[0].text);
+     * }
+     * ```
+     */
+    callTool(agentId: string, toolName: string, args?: Record<string, unknown>): Promise<ApiResponse<McpToolCallResult>>;
+    /**
+     * Get details and schema for a specific MCP tool
+     *
+     * @param agentId - Agent ID that owns the tool
+     * @param toolName - Name of the tool to inspect
+     * @returns Tool details including input schema
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.mcp.getTool('ws_123', 'agent_456', 'get_weather');
+     * console.log(data.tool.inputSchema);
+     * ```
+     */
+    getTool(agentId: string, toolName: string): Promise<ApiResponse<{
+        tool: McpTool;
+    }>>;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/modules/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/modules/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAM9C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QACN,UAAU,EAAE;YACV,KAAK,EAAE,WAAW,CAAC;SACpB,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,UAAU,EAAE;YACV,KAAK,EAAE,WAAW,CAAC;SACpB,CAAC;KACH,CAAC;IACF,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;IACtD,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,qBAAa,SAAS;IACR,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,QAAQ;IAEjC;;;;;;;;;;;OAWG;IACG,SAAS,CACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAY1C;;;;;;;;;;;OAWG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAI1D;;;;;;;;;;;;;OAaG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IAI7C;;;;;;;;;;;;;;;OAeG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAO1C;;;;;;;;;;;;OAYG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAG3C"}

package/dist/modules/mcp.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * McpModule - SDK module for MCP server configuration and status
+ *
+ * Provides access to MCP server configuration and health status.
+ * Used by CLI and admin UI to get ready-to-use agent configurations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpModule = void 0;
+// ============================================================================
+// MCP MODULE
+// ============================================================================
+class McpModule {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Get MCP configuration for a workspace
+     *
+     * @param options - Optional configuration options (e.g., toolsetId filter)
+     * @returns MCP configuration including server URL and agent configs
+     *
+     * @example
+     * typescript
+     * const { data } = await sdk.mcp.getConfig('ws_123');
+     * console.log(data.serverUrl);
+     * console.log(data.agentConfigs.claude);
+     */
+    async getConfig(options) {
+        const queryParams = new URLSearchParams();
+        if (options?.toolsetId) {
+            queryParams.append('toolsetId', options.toolsetId);
+        }
+        const queryString = queryParams.toString();
+        const url = '/api/v1/mcp/config' + (queryString ? '?' + queryString : '');
+        return this.sdk.request('GET', url);
+    }
+    /**
+     * Check MCP server health status
+     *
+     * @returns Health status of the MCP server
+     *
+     * @example
+     * typescript
+     * const { data } = await sdk.mcp.getStatus('ws_123');
+     * if (data.healthy) {
+     *   console.log('MCP server is running');
+     * }
+     */
+    async getStatus() {
+        return this.sdk.request('GET', '/api/v1/mcp/status');
+    }
+    /**
+     * List MCP tools available for an agent
+     *
+     * @param agentId - Agent ID to list tools for
+     * @returns List of MCP tools with their schemas
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.mcp.listTools('ws_123', 'agent_456');
+     * for (const tool of data.tools) {
+     *   console.log(tool.name, tool.description);
+     * }
+     * ```
+     */
+    async listTools(agentId) {
+        return this.sdk.request('GET', `/api/v1/mcp/agents/${agentId}/tools`);
+    }
+    /**
+     * Call an MCP tool by name
+     *
+     * @param agentId - Agent ID that owns the tool
+     * @param toolName - Name of the tool to invoke
+     * @param args - Optional arguments to pass to the tool
+     * @returns Tool call result with content array
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.mcp.callTool('ws_123', 'agent_456', 'get_weather', { city: 'London' });
+     * if (!data.isError) {
+     *   console.log(data.content[0].text);
+     * }
+     * ```
+     */
+    async callTool(agentId, toolName, args) {
+        return this.sdk.request('POST', `/api/v1/mcp/agents/${agentId}/tools/call`, {
+            name: toolName,
+            arguments: args,
+        });
+    }
+    /**
+     * Get details and schema for a specific MCP tool
+     *
+     * @param agentId - Agent ID that owns the tool
+     * @param toolName - Name of the tool to inspect
+     * @returns Tool details including input schema
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.mcp.getTool('ws_123', 'agent_456', 'get_weather');
+     * console.log(data.tool.inputSchema);
+     * ```
+     */
+    async getTool(agentId, toolName) {
+        return this.sdk.request('GET', `/api/v1/mcp/agents/${agentId}/tools/${toolName}`);
+    }
+}
+exports.McpModule = McpModule;
+//# sourceMappingURL=mcp.js.map

package/dist/modules/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/modules/mcp.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA+DH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,SAAS;IACpB,YAAoB,GAAa;QAAb,QAAG,GAAH,GAAG,CAAU;IAAG,CAAC;IAErC;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,CACb,OAA0B;QAE1B,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAE1C,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,oBAAoB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,SAAS,CACb,OAAe;QAEf,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,OAAO,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,QAAgB,EAChB,IAA8B;QAE9B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,OAAO,aAAa,EAAE;YAC1E,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,OAAO,CACX,OAAe,EACf,QAAgB;QAEhB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,OAAO,UAAU,QAAQ,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AA/GD,8BA+GC"}

package/dist/modules/memory.d.ts

@@ -0,0 +1,163 @@
+/**
+ * MemoryModule - SDK module for agent memory management
+ *
+ * Provides CRUD operations for memories, semantic search,
+ * and bulk deletion. All methods require a workspaceId which
+ * is passed via the x-workspace-id header.
+ */
+import { ChanlSDK } from '../client';
+import { ApiResponse } from '../types/config';
+import type { CreateMemoryInput, UpdateMemoryInput, SearchMemoryInput, ExtractMemoryInput, BulkDeleteMemoryInput, MemoryFilters, MemoryResponse, MemoryListResponse, MemorySearchResponse, MemoryExtractResponse, MemoryDeleteResponse, MemoryBulkDeleteResponse } from '../types/memory';
+export declare class MemoryModule {
+    private sdk;
+    constructor(sdk: ChanlSDK);
+    /**
+     * List memories with optional filters
+     *
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of memories
+     *
+     * @example
+     * ```typescript
+     * // List all memories
+     * const { data } = await sdk.memory.list();
+     *
+     * // Filter by entity type and agent
+     * const { data } = await sdk.memory.list({
+     *   entityType: 'customer',
+     *   agentId: 'agent_abc',
+     *   isActive: true,
+     *   page: 1,
+     *   limit: 20
+     * });
+     * ```
+     */
+    list(filters?: MemoryFilters): Promise<ApiResponse<MemoryListResponse>>;
+    /**
+     * Get a single memory by ID
+     *
+     * @param id - Memory ID
+     * @returns Memory details
+     * @throws NotFoundError if memory doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.get('mem_abc123');
+     * console.log(data.memory.content);
+     * ```
+     */
+    get(id: string): Promise<ApiResponse<MemoryResponse>>;
+    /**
+     * Create a new memory
+     *
+     * @param input - Memory creation data
+     * @returns Created memory
+     * @throws ValidationError if input is invalid
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.create({
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   content: 'Customer prefers email communication',
+     *   metadata: { source: 'conversation', confidence: 0.95 }
+     * });
+     * ```
+     */
+    create(input: CreateMemoryInput): Promise<ApiResponse<MemoryResponse>>;
+    /**
+     * Update an existing memory
+     *
+     * @param id - Memory ID
+     * @param input - Update data
+     * @returns Updated memory
+     * @throws NotFoundError if memory doesn't exist
+     * @throws ValidationError if input is invalid
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.update('mem_abc123', {
+     *   content: 'Updated preference: customer prefers phone calls',
+     *   isActive: true
+     * });
+     * ```
+     */
+    update(id: string, input: UpdateMemoryInput): Promise<ApiResponse<MemoryResponse>>;
+    /**
+     * Delete a memory
+     *
+     * @param id - Memory ID
+     * @returns Deletion confirmation
+     * @throws NotFoundError if memory doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.delete('mem_abc123');
+     * console.log(data.deleted); // true
+     * ```
+     */
+    delete(id: string): Promise<ApiResponse<MemoryDeleteResponse>>;
+    /**
+     * Search memories using semantic similarity
+     *
+     * @param input - Search parameters
+     * @returns Matching memories with relevance scores
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.search({
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   query: 'communication preferences',
+     *   limit: 5,
+     *   minScore: 0.7
+     * });
+     * data.memories.forEach(m => {
+     *   console.log(`${m.content} (score: ${m.score})`);
+     * });
+     * ```
+     */
+    search(input: SearchMemoryInput): Promise<ApiResponse<MemorySearchResponse>>;
+    /**
+     * Extract structured facts from text using LLM
+     *
+     * Analyzes free-form text and extracts key facts (preferences, personal details,
+     * account info). Optionally saves them as memory entries with source='extraction'.
+     *
+     * @param input - Extraction parameters
+     * @returns Extracted facts with content, key, value, and confidence
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.extract({
+     *   text: 'Customer moved from Seattle to Portland, prefers email.',
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   save: true,
+     * });
+     * data.facts.forEach(f => {
+     *   console.log(`${f.key}: ${f.value} (confidence: ${f.confidence})`);
+     * });
+     * ```
+     */
+    extract(input: ExtractMemoryInput): Promise<ApiResponse<MemoryExtractResponse>>;
+    /**
+     * Bulk delete memories matching criteria
+     *
+     * @param input - Deletion criteria
+     * @returns Deletion confirmation with count
+     *
+     * @example
+     * ```typescript
+     * // Delete all inactive memories for an entity
+     * const { data } = await sdk.memory.bulkDelete('ws_123', {
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   inactiveOnly: true
+     * });
+     * console.log(`Deleted ${data.deletedCount} memories`);
+     * ```
+     */
+    bulkDelete(input: BulkDeleteMemoryInput): Promise<ApiResponse<MemoryBulkDeleteResponse>>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/modules/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/modules/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAMzB,qBAAa,YAAY;IACX,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,QAAQ;IAEjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IA8B7E;;;;;;;;;;;;OAYG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAI3D;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAI5E;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAIxF;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAIpE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAIlF;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAIrF;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;CAG/F"}

package/dist/modules/memory.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * MemoryModule - SDK module for agent memory management
+ *
+ * Provides CRUD operations for memories, semantic search,
+ * and bulk deletion. All methods require a workspaceId which
+ * is passed via the x-workspace-id header.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryModule = void 0;
+// ============================================================================
+// MEMORY MODULE
+// ============================================================================
+class MemoryModule {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * List memories with optional filters
+     *
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of memories
+     *
+     * @example
+     * ```typescript
+     * // List all memories
+     * const { data } = await sdk.memory.list();
+     *
+     * // Filter by entity type and agent
+     * const { data } = await sdk.memory.list({
+     *   entityType: 'customer',
+     *   agentId: 'agent_abc',
+     *   isActive: true,
+     *   page: 1,
+     *   limit: 20
+     * });
+     * ```
+     */
+    async list(filters) {
+        const params = new URLSearchParams();
+        if (filters?.entityType) {
+            params.append('entityType', filters.entityType);
+        }
+        if (filters?.entityId) {
+            params.append('entityId', filters.entityId);
+        }
+        if (filters?.agentId) {
+            params.append('agentId', filters.agentId);
+        }
+        if (filters?.source) {
+            params.append('source', filters.source);
+        }
+        if (filters?.isActive !== undefined) {
+            params.append('isActive', String(filters.isActive));
+        }
+        if (filters?.page) {
+            params.append('page', String(filters.page));
+        }
+        if (filters?.limit) {
+            params.append('limit', String(filters.limit));
+        }
+        const query = params.toString();
+        const url = `/api/v1/memory${query ? `?${query}` : ''}`;
+        return this.sdk.request('GET', url);
+    }
+    /**
+     * Get a single memory by ID
+     *
+     * @param id - Memory ID
+     * @returns Memory details
+     * @throws NotFoundError if memory doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.get('mem_abc123');
+     * console.log(data.memory.content);
+     * ```
+     */
+    async get(id) {
+        return this.sdk.request('GET', `/api/v1/memory/${id}`);
+    }
+    /**
+     * Create a new memory
+     *
+     * @param input - Memory creation data
+     * @returns Created memory
+     * @throws ValidationError if input is invalid
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.create({
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   content: 'Customer prefers email communication',
+     *   metadata: { source: 'conversation', confidence: 0.95 }
+     * });
+     * ```
+     */
+    async create(input) {
+        return this.sdk.request('POST', '/api/v1/memory', input);
+    }
+    /**
+     * Update an existing memory
+     *
+     * @param id - Memory ID
+     * @param input - Update data
+     * @returns Updated memory
+     * @throws NotFoundError if memory doesn't exist
+     * @throws ValidationError if input is invalid
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.update('mem_abc123', {
+     *   content: 'Updated preference: customer prefers phone calls',
+     *   isActive: true
+     * });
+     * ```
+     */
+    async update(id, input) {
+        return this.sdk.request('PATCH', `/api/v1/memory/${id}`, input);
+    }
+    /**
+     * Delete a memory
+     *
+     * @param id - Memory ID
+     * @returns Deletion confirmation
+     * @throws NotFoundError if memory doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.delete('mem_abc123');
+     * console.log(data.deleted); // true
+     * ```
+     */
+    async delete(id) {
+        return this.sdk.request('DELETE', `/api/v1/memory/${id}`);
+    }
+    /**
+     * Search memories using semantic similarity
+     *
+     * @param input - Search parameters
+     * @returns Matching memories with relevance scores
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.search({
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   query: 'communication preferences',
+     *   limit: 5,
+     *   minScore: 0.7
+     * });
+     * data.memories.forEach(m => {
+     *   console.log(`${m.content} (score: ${m.score})`);
+     * });
+     * ```
+     */
+    async search(input) {
+        return this.sdk.request('POST', '/api/v1/memory/search', input);
+    }
+    /**
+     * Extract structured facts from text using LLM
+     *
+     * Analyzes free-form text and extracts key facts (preferences, personal details,
+     * account info). Optionally saves them as memory entries with source='extraction'.
+     *
+     * @param input - Extraction parameters
+     * @returns Extracted facts with content, key, value, and confidence
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.memory.extract({
+     *   text: 'Customer moved from Seattle to Portland, prefers email.',
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   save: true,
+     * });
+     * data.facts.forEach(f => {
+     *   console.log(`${f.key}: ${f.value} (confidence: ${f.confidence})`);
+     * });
+     * ```
+     */
+    async extract(input) {
+        return this.sdk.request('POST', '/api/v1/memory/extract', input);
+    }
+    /**
+     * Bulk delete memories matching criteria
+     *
+     * @param input - Deletion criteria
+     * @returns Deletion confirmation with count
+     *
+     * @example
+     * ```typescript
+     * // Delete all inactive memories for an entity
+     * const { data } = await sdk.memory.bulkDelete('ws_123', {
+     *   entityType: 'customer',
+     *   entityId: 'cust_456',
+     *   inactiveOnly: true
+     * });
+     * console.log(`Deleted ${data.deletedCount} memories`);
+     * ```
+     */
+    async bulkDelete(input) {
+        return this.sdk.request('DELETE', '/api/v1/memory', input);
+    }
+}
+exports.MemoryModule = MemoryModule;
+//# sourceMappingURL=memory.js.map

package/dist/modules/memory.js.map

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