@cilow/sdk 0.2.0 → 0.2.1

package/dist/client.mjs

@@ -0,0 +1,505 @@
+// src/client.ts
+async function fetchWithRetry(url, options, config) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), config.timeout);
+  let lastError = null;
+  for (let attempt = 0; attempt <= config.retries; attempt++) {
+    try {
+      const response = await fetch(url, {
+        ...options,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorBody = await response.text();
+        let apiError;
+        try {
+          apiError = JSON.parse(errorBody);
+        } catch {
+          apiError = {
+            code: `HTTP_${response.status}`,
+            message: errorBody || response.statusText
+          };
+        }
+        throw new CilowApiError(apiError.message, apiError.code, response.status, apiError.details);
+      }
+      return response;
+    } catch (error) {
+      lastError = error;
+      if (error instanceof CilowApiError) {
+        throw error;
+      }
+      if (config.debug) {
+        console.warn(`Cilow API request failed (attempt ${attempt + 1}/${config.retries + 1}):`, error);
+      }
+      if (attempt < config.retries) {
+        await new Promise((resolve) => setTimeout(resolve, Math.pow(2, attempt) * 100));
+      }
+    }
+  }
+  clearTimeout(timeoutId);
+  throw lastError || new Error("Request failed");
+}
+var CilowApiError = class extends Error {
+  constructor(message, code, statusCode, details) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details;
+    this.name = "CilowApiError";
+  }
+};
+var CilowClient = class {
+  constructor(config) {
+    this.baseUrl = config.apiUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout ?? 3e4;
+    this.retries = config.retries ?? 3;
+    this.debug = config.debug ?? false;
+    const authHeaders = this.apiKey.startsWith("cilow_") ? { "X-API-Key": this.apiKey } : { Authorization: `Bearer ${this.apiKey}` };
+    this.headers = {
+      "Content-Type": "application/json",
+      ...authHeaders,
+      ...config.headers
+    };
+  }
+  /**
+   * Make an API request
+   */
+  async request(method, path, body, queryParams) {
+    let url = `${this.baseUrl}${path}`;
+    if (queryParams) {
+      const params = new URLSearchParams();
+      for (const [key, value] of Object.entries(queryParams)) {
+        if (value !== void 0) {
+          params.append(key, String(value));
+        }
+      }
+      const queryString = params.toString();
+      if (queryString) {
+        url += `?${queryString}`;
+      }
+    }
+    if (this.debug) {
+      console.log(`Cilow API: ${method} ${url}`);
+    }
+    const response = await fetchWithRetry(
+      url,
+      {
+        method,
+        headers: this.headers,
+        body: body ? JSON.stringify(body) : void 0
+      },
+      { timeout: this.timeout, retries: this.retries, debug: this.debug }
+    );
+    const text = await response.text();
+    if (!text) {
+      return void 0;
+    }
+    return JSON.parse(text);
+  }
+  // ===========================================================================
+  // Simple API (remember, recall, forget)
+  // ===========================================================================
+  /**
+   * Store a memory (simple API)
+   *
+   * @param content - The content to remember
+   * @param options - Optional configuration
+   * @returns The created memory ID
+   *
+   * @example
+   * ```typescript
+   * await cilow.remember("User prefers dark mode", {
+   *   tags: ["preference"],
+   *   userId: "user-123"
+   * });
+   * ```
+   */
+  async remember(content, options) {
+    const response = await this.request("POST", "/api/v1/memory/add", {
+      content,
+      tags: options?.tags ?? [],
+      user_id: options?.userId,
+      session_id: options?.sessionId,
+      metadata: options?.metadata,
+      type: options?.tier
+    });
+    return response.memory_id || response.id || "";
+  }
+  /**
+   * Search memories (simple API)
+   *
+   * @param query - Search query text
+   * @param options - Search options
+   * @returns Array of search results
+   *
+   * @example
+   * ```typescript
+   * const memories = await cilow.recall("user preferences", {
+   *   limit: 10,
+   *   tags: ["preference"]
+   * });
+   * ```
+   */
+  async recall(query, options) {
+    const response = await this.request("POST", "/api/v1/memory/search", {
+      query,
+      limit: options?.limit ?? 10,
+      min_score: options?.minRelevance ?? 0.3,
+      tags: options?.tags,
+      user_id: options?.userId
+    });
+    return (response.results ?? []).map((r) => ({
+      memory: {
+        id: r.memory_id,
+        content: r.content,
+        tags: r.tags ?? [],
+        tier: "hot",
+        status: "active",
+        accessCount: 0,
+        tokenCount: Math.ceil(r.content.length / 4),
+        metadata: {},
+        createdAt: r.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
+        updatedAt: r.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
+        lastAccessedAt: (/* @__PURE__ */ new Date()).toISOString()
+      },
+      score: r.similarity,
+      highlights: []
+    }));
+  }
+  /**
+   * Delete memories (simple API)
+   *
+   * @param filter - Filter criteria for deletion
+   * @returns Number of memories deleted
+   *
+   * @example
+   * ```typescript
+   * // Delete by tags
+   * await cilow.forget({ tags: ["temporary"] });
+   *
+   * // Delete by user
+   * await cilow.forget({ userId: "user-123" });
+   *
+   * // Delete specific memory
+   * await cilow.forget({ memoryId: "mem-abc" });
+   * ```
+   */
+  async forget(filter) {
+    if (filter.memoryId) {
+      await this.deleteMemory(filter.memoryId);
+      return 1;
+    }
+    const response = await this.request("DELETE", "/api/v1/memories/bulk", {
+      filter_tags: filter.tags,
+      user_id: filter.userId,
+      session_id: filter.sessionId,
+      older_than: filter.olderThan
+    });
+    return response.deleted ?? 0;
+  }
+  // ===========================================================================
+  // Memory CRUD Operations
+  // ===========================================================================
+  /**
+   * Create a new memory
+   */
+  async createMemory(content, options) {
+    return this.request("POST", "/api/v1/memories", {
+      content,
+      tags: options?.tags ?? [],
+      user_id: options?.userId,
+      session_id: options?.sessionId,
+      metadata: options?.metadata,
+      tier: options?.tier
+    });
+  }
+  /**
+   * Get a memory by ID
+   */
+  async getMemory(memoryId) {
+    return this.request("GET", `/api/v1/memories/${memoryId}`);
+  }
+  /**
+   * Update a memory
+   */
+  async updateMemory(memoryId, updates) {
+    return this.request("PATCH", `/api/v1/memories/${memoryId}`, {
+      content: updates.content,
+      tags: updates.tags,
+      metadata: updates.metadata,
+      tier: updates.tier
+    });
+  }
+  /**
+   * Delete a memory
+   */
+  async deleteMemory(memoryId) {
+    await this.request("DELETE", `/api/v1/memories/${memoryId}`);
+  }
+  /**
+   * List memories with pagination
+   */
+  async listMemories(options) {
+    const response = await this.request(
+      "GET",
+      "/api/v1/memory/list",
+      void 0,
+      {
+        limit: options?.limit ?? 20,
+        offset: options?.offset ?? 0,
+        user_id: options?.userId,
+        session_id: options?.sessionId,
+        tags: options?.tags?.join(","),
+        type: options?.tier
+      }
+    );
+    const items = (response.memories ?? []).map((m) => ({
+      id: m.memory_id || m.id || "",
+      content: m.content,
+      tags: m.tags ?? [],
+      createdAt: m.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
+      tier: m.type || "hot"
+    }));
+    const limit = options?.limit ?? 20;
+    const offset = options?.offset ?? 0;
+    const total = response.total ?? items.length;
+    return {
+      items,
+      total,
+      limit,
+      offset,
+      hasMore: offset + items.length < total
+    };
+  }
+  // ===========================================================================
+  // Search Operations
+  // ===========================================================================
+  /**
+   * Search memories with full options
+   */
+  async searchMemories(query) {
+    const response = await this.request("POST", "/api/v1/memories/search", {
+      text: query.text,
+      limit: query.limit ?? 10,
+      min_relevance: query.minRelevance ?? 0.3,
+      filter_tags: query.tags,
+      user_id: query.userId,
+      session_id: query.sessionId,
+      tier: query.tier,
+      created_after: query.createdAfter,
+      created_before: query.createdBefore,
+      include_archived: query.includeArchived,
+      mode: query.mode ?? "hybrid"
+    });
+    return response.results ?? [];
+  }
+  /**
+   * Advanced search with reranking and boosts
+   */
+  async advancedSearch(query) {
+    const response = await this.request("POST", "/api/v1/memories/search/advanced", {
+      text: query.text,
+      limit: query.limit ?? 10,
+      min_relevance: query.minRelevance ?? 0.3,
+      filter_tags: query.tags,
+      required_tags: query.requiredTags,
+      excluded_tags: query.excludedTags,
+      user_id: query.userId,
+      session_id: query.sessionId,
+      recency_boost: query.recencyBoost,
+      frequency_boost: query.frequencyBoost,
+      metadata_filters: query.metadataFilters,
+      reranker: query.reranker
+    });
+    return response.results ?? [];
+  }
+  /**
+   * Get context for AI applications
+   */
+  async getContext(query, options) {
+    const maxTokens = options?.maxTokens ?? 4e3;
+    const tokensPerChar = 0.25;
+    const results = await this.searchMemories({
+      text: query,
+      limit: 30,
+      minRelevance: 0.3,
+      userId: options?.userId,
+      tags: options?.tags
+    });
+    let context = "";
+    let estimatedTokens = 0;
+    const memoryIds = [];
+    const scores = [];
+    for (const result of results) {
+      const memoryText = `[Relevance: ${(result.score * 100).toFixed(0)}%]
+${result.memory.content}
+
+`;
+      const memoryTokens = Math.ceil(memoryText.length * tokensPerChar);
+      if (estimatedTokens + memoryTokens > maxTokens) break;
+      context += memoryText;
+      estimatedTokens += memoryTokens;
+      memoryIds.push(result.memory.id);
+      scores.push(result.score);
+    }
+    return {
+      context: context.trim(),
+      memoriesUsed: memoryIds.length,
+      estimatedTokens,
+      memoryIds,
+      scores
+    };
+  }
+  // ===========================================================================
+  // Conversation Operations
+  // ===========================================================================
+  /**
+   * Store a conversation turn
+   */
+  async storeConversation(turn) {
+    const content = `User: ${turn.userMessage}
+
+Assistant: ${turn.assistantResponse}`;
+    const tags = ["conversation"];
+    if (turn.sessionId) {
+      tags.push(`session:${turn.sessionId}`);
+    }
+    return this.remember(content, {
+      tags,
+      userId: turn.userId,
+      sessionId: turn.sessionId,
+      metadata: {
+        type: "conversation",
+        ...turn.metadata
+      }
+    });
+  }
+  /**
+   * Get conversation history for a session
+   */
+  async getConversationHistory(sessionId, options) {
+    const response = await this.listMemories({
+      sessionId,
+      tags: ["conversation"],
+      limit: options?.limit ?? 50,
+      offset: options?.offset ?? 0
+    });
+    return response.items;
+  }
+  // ===========================================================================
+  // Graph Operations
+  // ===========================================================================
+  /**
+   * Get a graph node
+   */
+  async getGraphNode(nodeId) {
+    return this.request("GET", `/api/v1/graph/nodes/${nodeId}`);
+  }
+  /**
+   * Create a graph node
+   */
+  async createGraphNode(type, name, properties) {
+    return this.request("POST", "/api/v1/graph/nodes", {
+      type,
+      name,
+      properties: properties ?? {}
+    });
+  }
+  /**
+   * Create a graph edge
+   */
+  async createGraphEdge(sourceId, targetId, type, properties) {
+    return this.request("POST", "/api/v1/graph/edges", {
+      source_id: sourceId,
+      target_id: targetId,
+      type,
+      properties: properties ?? {}
+    });
+  }
+  /**
+   * Traverse the graph from a starting node
+   */
+  async traverseGraph(options) {
+    return this.request("POST", "/api/v1/graph/traverse", {
+      start_node_id: options.startNodeId,
+      max_depth: options.maxDepth ?? 3,
+      relationship_types: options.relationshipTypes,
+      limit: options.limit ?? 100,
+      direction: options.direction ?? "both"
+    });
+  }
+  /**
+   * Get related nodes for a memory
+   */
+  async getRelatedNodes(memoryId) {
+    const response = await this.request(
+      "GET",
+      `/api/v1/memories/${memoryId}/related-nodes`
+    );
+    return response.nodes ?? [];
+  }
+  // ===========================================================================
+  // Statistics & Admin
+  // ===========================================================================
+  /**
+   * Get memory statistics
+   */
+  async getStats() {
+    return this.request("GET", "/api/v1/stats");
+  }
+  /**
+   * Get all tags with counts
+   */
+  async getTags() {
+    const response = await this.request("GET", "/api/v1/tags");
+    return response.tags ?? [];
+  }
+  /**
+   * Get user statistics
+   */
+  async getUserStats(userId) {
+    return this.request("GET", `/api/v1/users/${userId}/stats`);
+  }
+  /**
+   * Health check
+   */
+  async healthCheck() {
+    return this.request("GET", "/health");
+  }
+  // ===========================================================================
+  // Batch Operations
+  // ===========================================================================
+  /**
+   * Batch create memories
+   */
+  async batchCreate(items) {
+    const response = await this.request("POST", "/api/v1/memories/batch", {
+      memories: items.map((item) => ({
+        content: item.content,
+        tags: item.options?.tags ?? [],
+        user_id: item.options?.userId,
+        session_id: item.options?.sessionId,
+        metadata: item.options?.metadata
+      }))
+    });
+    return response.ids ?? [];
+  }
+  /**
+   * Batch delete memories
+   */
+  async batchDelete(memoryIds) {
+    const response = await this.request("DELETE", "/api/v1/memories/batch", {
+      ids: memoryIds
+    });
+    return response.deleted ?? 0;
+  }
+};
+function createClient(config) {
+  return new CilowClient(config);
+}
+
+export { CilowApiError, CilowClient, createClient };
+//# sourceMappingURL=client.mjs.map
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.mjs","sourcesContent":["/**\n * Cilow Client - Core HTTP Client for Cilow API\n *\n * Provides a clean, type-safe interface for interacting with the Cilow\n * memory system API.\n */\n\nimport type {\n  Memory,\n  MemorySummary,\n  SearchResult,\n  SearchQuery,\n  AdvancedSearchOptions,\n  GraphNode,\n  GraphEdge,\n  GraphSubgraph,\n  GraphTraversalOptions,\n  MemoryStats,\n  TagCount,\n  UserStats,\n  CilowConfig,\n  CreateMemoryOptions,\n  UpdateMemoryOptions,\n  PaginatedResponse,\n  HealthCheck,\n  ApiError,\n  ContextResult,\n  ConversationTurn,\n} from './types';\n\n/**\n * HTTP fetch wrapper with error handling and retries\n */\nasync function fetchWithRetry(\n  url: string,\n  options: RequestInit,\n  config: { timeout: number; retries: number; debug: boolean }\n): Promise<Response> {\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), config.timeout);\n\n  let lastError: Error | null = null;\n\n  for (let attempt = 0; attempt <= config.retries; attempt++) {\n    try {\n      const response = await fetch(url, {\n        ...options,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        const errorBody = await response.text();\n        let apiError: ApiError;\n\n        try {\n          apiError = JSON.parse(errorBody);\n        } catch {\n          apiError = {\n            code: `HTTP_${response.status}`,\n            message: errorBody || response.statusText,\n          };\n        }\n\n        throw new CilowApiError(apiError.message, apiError.code, response.status, apiError.details);\n      }\n\n      return response;\n    } catch (error) {\n      lastError = error as Error;\n\n      if (error instanceof CilowApiError) {\n        throw error;\n      }\n\n      if (config.debug) {\n        console.warn(`Cilow API request failed (attempt ${attempt + 1}/${config.retries + 1}):`, error);\n      }\n\n      if (attempt < config.retries) {\n        // Exponential backoff\n        await new Promise((resolve) => setTimeout(resolve, Math.pow(2, attempt) * 100));\n      }\n    }\n  }\n\n  clearTimeout(timeoutId);\n  throw lastError || new Error('Request failed');\n}\n\n/**\n * Custom error class for Cilow API errors\n */\nexport class CilowApiError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly statusCode: number,\n    public readonly details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'CilowApiError';\n  }\n}\n\n/**\n * CilowClient - Main client class for interacting with the Cilow API\n *\n * @example\n * ```typescript\n * const client = new CilowClient({\n *   apiUrl: 'https://api.cilow.ai',\n *   apiKey: 'your-api-key'\n * });\n *\n * // Store a memory\n * const memoryId = await client.remember(\"User prefers dark mode\", {\n *   tags: [\"preference\", \"ui\"]\n * });\n *\n * // Search memories\n * const results = await client.recall(\"user preferences\");\n *\n * // Delete memories\n * await client.forget({ tags: [\"old\"] });\n * ```\n */\nexport class CilowClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeout: number;\n  private readonly retries: number;\n  private readonly headers: Record<string, string>;\n  private readonly debug: boolean;\n\n  constructor(config: CilowConfig) {\n    this.baseUrl = config.apiUrl.replace(/\\/$/, '');\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout ?? 30000;\n    this.retries = config.retries ?? 3;\n    this.debug = config.debug ?? false;\n\n    // Support both API key and Bearer token auth\n    const authHeaders: Record<string, string> = this.apiKey.startsWith('cilow_')\n      ? { 'X-API-Key': this.apiKey }\n      : { Authorization: `Bearer ${this.apiKey}` };\n\n    this.headers = {\n      'Content-Type': 'application/json',\n      ...authHeaders,\n      ...config.headers,\n    };\n  }\n\n  /**\n   * Make an API request\n   */\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    queryParams?: Record<string, string | number | boolean | undefined>\n  ): Promise<T> {\n    let url = `${this.baseUrl}${path}`;\n\n    if (queryParams) {\n      const params = new URLSearchParams();\n      for (const [key, value] of Object.entries(queryParams)) {\n        if (value !== undefined) {\n          params.append(key, String(value));\n        }\n      }\n      const queryString = params.toString();\n      if (queryString) {\n        url += `?${queryString}`;\n      }\n    }\n\n    if (this.debug) {\n      console.log(`Cilow API: ${method} ${url}`);\n    }\n\n    const response = await fetchWithRetry(\n      url,\n      {\n        method,\n        headers: this.headers,\n        body: body ? JSON.stringify(body) : undefined,\n      },\n      { timeout: this.timeout, retries: this.retries, debug: this.debug }\n    );\n\n    const text = await response.text();\n    if (!text) {\n      return undefined as T;\n    }\n\n    return JSON.parse(text) as T;\n  }\n\n  // ===========================================================================\n  // Simple API (remember, recall, forget)\n  // ===========================================================================\n\n  /**\n   * Store a memory (simple API)\n   *\n   * @param content - The content to remember\n   * @param options - Optional configuration\n   * @returns The created memory ID\n   *\n   * @example\n   * ```typescript\n   * await cilow.remember(\"User prefers dark mode\", {\n   *   tags: [\"preference\"],\n   *   userId: \"user-123\"\n   * });\n   * ```\n   */\n  async remember(content: string, options?: CreateMemoryOptions): Promise<string> {\n    const response = await this.request<{ memory_id: string; id?: string }>('POST', '/api/v1/memory/add', {\n      content,\n      tags: options?.tags ?? [],\n      user_id: options?.userId,\n      session_id: options?.sessionId,\n      metadata: options?.metadata,\n      type: options?.tier,\n    });\n\n    return response.memory_id || response.id || '';\n  }\n\n  /**\n   * Search memories (simple API)\n   *\n   * @param query - Search query text\n   * @param options - Search options\n   * @returns Array of search results\n   *\n   * @example\n   * ```typescript\n   * const memories = await cilow.recall(\"user preferences\", {\n   *   limit: 10,\n   *   tags: [\"preference\"]\n   * });\n   * ```\n   */\n  async recall(\n    query: string,\n    options?: {\n      limit?: number;\n      minRelevance?: number;\n      tags?: string[];\n      userId?: string;\n    }\n  ): Promise<SearchResult[]> {\n    interface ApiSearchResult {\n      memory_id: string;\n      content: string;\n      score: number;\n      similarity: number;\n      tags?: string[];\n      created_at?: string;\n    }\n\n    const response = await this.request<{ results: ApiSearchResult[] }>('POST', '/api/v1/memory/search', {\n      query,\n      limit: options?.limit ?? 10,\n      min_score: options?.minRelevance ?? 0.3,\n      tags: options?.tags,\n      user_id: options?.userId,\n    });\n\n    // Transform API response to SDK format with defaults for required fields\n    return (response.results ?? []).map((r): SearchResult => ({\n      memory: {\n        id: r.memory_id,\n        content: r.content,\n        tags: r.tags ?? [],\n        tier: 'hot' as const,\n        status: 'active' as const,\n        accessCount: 0,\n        tokenCount: Math.ceil(r.content.length / 4),\n        metadata: {},\n        createdAt: r.created_at ?? new Date().toISOString(),\n        updatedAt: r.created_at ?? new Date().toISOString(),\n        lastAccessedAt: new Date().toISOString(),\n      },\n      score: r.similarity,\n      highlights: [],\n    }));\n  }\n\n  /**\n   * Delete memories (simple API)\n   *\n   * @param filter - Filter criteria for deletion\n   * @returns Number of memories deleted\n   *\n   * @example\n   * ```typescript\n   * // Delete by tags\n   * await cilow.forget({ tags: [\"temporary\"] });\n   *\n   * // Delete by user\n   * await cilow.forget({ userId: \"user-123\" });\n   *\n   * // Delete specific memory\n   * await cilow.forget({ memoryId: \"mem-abc\" });\n   * ```\n   */\n  async forget(filter: {\n    memoryId?: string;\n    tags?: string[];\n    userId?: string;\n    sessionId?: string;\n    olderThan?: string;\n  }): Promise<number> {\n    if (filter.memoryId) {\n      await this.deleteMemory(filter.memoryId);\n      return 1;\n    }\n\n    const response = await this.request<{ deleted: number }>('DELETE', '/api/v1/memories/bulk', {\n      filter_tags: filter.tags,\n      user_id: filter.userId,\n      session_id: filter.sessionId,\n      older_than: filter.olderThan,\n    });\n\n    return response.deleted ?? 0;\n  }\n\n  // ===========================================================================\n  // Memory CRUD Operations\n  // ===========================================================================\n\n  /**\n   * Create a new memory\n   */\n  async createMemory(content: string, options?: CreateMemoryOptions): Promise<Memory> {\n    return this.request<Memory>('POST', '/api/v1/memories', {\n      content,\n      tags: options?.tags ?? [],\n      user_id: options?.userId,\n      session_id: options?.sessionId,\n      metadata: options?.metadata,\n      tier: options?.tier,\n    });\n  }\n\n  /**\n   * Get a memory by ID\n   */\n  async getMemory(memoryId: string): Promise<Memory> {\n    return this.request<Memory>('GET', `/api/v1/memories/${memoryId}`);\n  }\n\n  /**\n   * Update a memory\n   */\n  async updateMemory(memoryId: string, updates: UpdateMemoryOptions): Promise<Memory> {\n    return this.request<Memory>('PATCH', `/api/v1/memories/${memoryId}`, {\n      content: updates.content,\n      tags: updates.tags,\n      metadata: updates.metadata,\n      tier: updates.tier,\n    });\n  }\n\n  /**\n   * Delete a memory\n   */\n  async deleteMemory(memoryId: string): Promise<void> {\n    await this.request<void>('DELETE', `/api/v1/memories/${memoryId}`);\n  }\n\n  /**\n   * List memories with pagination\n   */\n  async listMemories(options?: {\n    limit?: number;\n    offset?: number;\n    userId?: string;\n    sessionId?: string;\n    tags?: string[];\n    tier?: string;\n  }): Promise<PaginatedResponse<MemorySummary>> {\n    interface ApiMemory {\n      memory_id: string;\n      id?: string;\n      content: string;\n      tags?: string[];\n      created_at?: string;\n      type?: string;\n    }\n\n    const response = await this.request<{ memories: ApiMemory[]; total?: number }>(\n      'GET',\n      '/api/v1/memory/list',\n      undefined,\n      {\n        limit: options?.limit ?? 20,\n        offset: options?.offset ?? 0,\n        user_id: options?.userId,\n        session_id: options?.sessionId,\n        tags: options?.tags?.join(','),\n        type: options?.tier,\n      }\n    );\n\n    const items: MemorySummary[] = (response.memories ?? []).map((m) => ({\n      id: m.memory_id || m.id || '',\n      content: m.content,\n      tags: m.tags ?? [],\n      createdAt: m.created_at ?? new Date().toISOString(),\n      tier: (m.type as MemorySummary['tier']) || 'hot',\n    }));\n\n    const limit = options?.limit ?? 20;\n    const offset = options?.offset ?? 0;\n    const total = response.total ?? items.length;\n\n    return {\n      items,\n      total,\n      limit,\n      offset,\n      hasMore: offset + items.length < total,\n    };\n  }\n\n  // ===========================================================================\n  // Search Operations\n  // ===========================================================================\n\n  /**\n   * Search memories with full options\n   */\n  async searchMemories(query: SearchQuery): Promise<SearchResult[]> {\n    const response = await this.request<{ results: SearchResult[] }>('POST', '/api/v1/memories/search', {\n      text: query.text,\n      limit: query.limit ?? 10,\n      min_relevance: query.minRelevance ?? 0.3,\n      filter_tags: query.tags,\n      user_id: query.userId,\n      session_id: query.sessionId,\n      tier: query.tier,\n      created_after: query.createdAfter,\n      created_before: query.createdBefore,\n      include_archived: query.includeArchived,\n      mode: query.mode ?? 'hybrid',\n    });\n\n    return response.results ?? [];\n  }\n\n  /**\n   * Advanced search with reranking and boosts\n   */\n  async advancedSearch(query: AdvancedSearchOptions): Promise<SearchResult[]> {\n    const response = await this.request<{ results: SearchResult[] }>('POST', '/api/v1/memories/search/advanced', {\n      text: query.text,\n      limit: query.limit ?? 10,\n      min_relevance: query.minRelevance ?? 0.3,\n      filter_tags: query.tags,\n      required_tags: query.requiredTags,\n      excluded_tags: query.excludedTags,\n      user_id: query.userId,\n      session_id: query.sessionId,\n      recency_boost: query.recencyBoost,\n      frequency_boost: query.frequencyBoost,\n      metadata_filters: query.metadataFilters,\n      reranker: query.reranker,\n    });\n\n    return response.results ?? [];\n  }\n\n  /**\n   * Get context for AI applications\n   */\n  async getContext(\n    query: string,\n    options?: {\n      maxTokens?: number;\n      userId?: string;\n      tags?: string[];\n    }\n  ): Promise<ContextResult> {\n    const maxTokens = options?.maxTokens ?? 4000;\n    const tokensPerChar = 0.25;\n\n    const results = await this.searchMemories({\n      text: query,\n      limit: 30,\n      minRelevance: 0.3,\n      userId: options?.userId,\n      tags: options?.tags,\n    });\n\n    let context = '';\n    let estimatedTokens = 0;\n    const memoryIds: string[] = [];\n    const scores: number[] = [];\n\n    for (const result of results) {\n      const memoryText = `[Relevance: ${(result.score * 100).toFixed(0)}%]\\n${result.memory.content}\\n\\n`;\n      const memoryTokens = Math.ceil(memoryText.length * tokensPerChar);\n\n      if (estimatedTokens + memoryTokens > maxTokens) break;\n\n      context += memoryText;\n      estimatedTokens += memoryTokens;\n      memoryIds.push(result.memory.id);\n      scores.push(result.score);\n    }\n\n    return {\n      context: context.trim(),\n      memoriesUsed: memoryIds.length,\n      estimatedTokens,\n      memoryIds,\n      scores,\n    };\n  }\n\n  // ===========================================================================\n  // Conversation Operations\n  // ===========================================================================\n\n  /**\n   * Store a conversation turn\n   */\n  async storeConversation(turn: ConversationTurn & { userId: string }): Promise<string> {\n    const content = `User: ${turn.userMessage}\\n\\nAssistant: ${turn.assistantResponse}`;\n    const tags = ['conversation'];\n\n    if (turn.sessionId) {\n      tags.push(`session:${turn.sessionId}`);\n    }\n\n    return this.remember(content, {\n      tags,\n      userId: turn.userId,\n      sessionId: turn.sessionId,\n      metadata: {\n        type: 'conversation',\n        ...turn.metadata,\n      },\n    });\n  }\n\n  /**\n   * Get conversation history for a session\n   */\n  async getConversationHistory(\n    sessionId: string,\n    options?: { limit?: number; offset?: number }\n  ): Promise<MemorySummary[]> {\n    const response = await this.listMemories({\n      sessionId,\n      tags: ['conversation'],\n      limit: options?.limit ?? 50,\n      offset: options?.offset ?? 0,\n    });\n\n    return response.items;\n  }\n\n  // ===========================================================================\n  // Graph Operations\n  // ===========================================================================\n\n  /**\n   * Get a graph node\n   */\n  async getGraphNode(nodeId: string): Promise<GraphNode> {\n    return this.request<GraphNode>('GET', `/api/v1/graph/nodes/${nodeId}`);\n  }\n\n  /**\n   * Create a graph node\n   */\n  async createGraphNode(\n    type: string,\n    name: string,\n    properties?: Record<string, unknown>\n  ): Promise<GraphNode> {\n    return this.request<GraphNode>('POST', '/api/v1/graph/nodes', {\n      type,\n      name,\n      properties: properties ?? {},\n    });\n  }\n\n  /**\n   * Create a graph edge\n   */\n  async createGraphEdge(\n    sourceId: string,\n    targetId: string,\n    type: string,\n    properties?: Record<string, unknown>\n  ): Promise<GraphEdge> {\n    return this.request<GraphEdge>('POST', '/api/v1/graph/edges', {\n      source_id: sourceId,\n      target_id: targetId,\n      type,\n      properties: properties ?? {},\n    });\n  }\n\n  /**\n   * Traverse the graph from a starting node\n   */\n  async traverseGraph(options: GraphTraversalOptions): Promise<GraphSubgraph> {\n    return this.request<GraphSubgraph>('POST', '/api/v1/graph/traverse', {\n      start_node_id: options.startNodeId,\n      max_depth: options.maxDepth ?? 3,\n      relationship_types: options.relationshipTypes,\n      limit: options.limit ?? 100,\n      direction: options.direction ?? 'both',\n    });\n  }\n\n  /**\n   * Get related nodes for a memory\n   */\n  async getRelatedNodes(memoryId: string): Promise<GraphNode[]> {\n    const response = await this.request<{ nodes: GraphNode[] }>(\n      'GET',\n      `/api/v1/memories/${memoryId}/related-nodes`\n    );\n    return response.nodes ?? [];\n  }\n\n  // ===========================================================================\n  // Statistics & Admin\n  // ===========================================================================\n\n  /**\n   * Get memory statistics\n   */\n  async getStats(): Promise<MemoryStats> {\n    return this.request<MemoryStats>('GET', '/api/v1/stats');\n  }\n\n  /**\n   * Get all tags with counts\n   */\n  async getTags(): Promise<TagCount[]> {\n    const response = await this.request<{ tags: TagCount[] }>('GET', '/api/v1/tags');\n    return response.tags ?? [];\n  }\n\n  /**\n   * Get user statistics\n   */\n  async getUserStats(userId: string): Promise<UserStats> {\n    return this.request<UserStats>('GET', `/api/v1/users/${userId}/stats`);\n  }\n\n  /**\n   * Health check\n   */\n  async healthCheck(): Promise<HealthCheck> {\n    return this.request<HealthCheck>('GET', '/health');\n  }\n\n  // ===========================================================================\n  // Batch Operations\n  // ===========================================================================\n\n  /**\n   * Batch create memories\n   */\n  async batchCreate(\n    items: Array<{ content: string; options?: CreateMemoryOptions }>\n  ): Promise<string[]> {\n    const response = await this.request<{ ids: string[] }>('POST', '/api/v1/memories/batch', {\n      memories: items.map((item) => ({\n        content: item.content,\n        tags: item.options?.tags ?? [],\n        user_id: item.options?.userId,\n        session_id: item.options?.sessionId,\n        metadata: item.options?.metadata,\n      })),\n    });\n\n    return response.ids ?? [];\n  }\n\n  /**\n   * Batch delete memories\n   */\n  async batchDelete(memoryIds: string[]): Promise<number> {\n    const response = await this.request<{ deleted: number }>('DELETE', '/api/v1/memories/batch', {\n      ids: memoryIds,\n    });\n\n    return response.deleted ?? 0;\n  }\n}\n\n/**\n * Create a Cilow client instance (convenience function)\n */\nexport function createClient(config: CilowConfig): CilowClient {\n  return new CilowClient(config);\n}\n"]}