@cilow/sdk 0.2.0

package/dist/index.mjs

@@ -0,0 +1,449 @@
+// src/errors.ts
+var CilowError = class _CilowError extends Error {
+  constructor(message, statusCode, details) {
+    super(message);
+    this.name = "CilowError";
+    this.statusCode = statusCode;
+    this.details = details;
+    Object.setPrototypeOf(this, _CilowError.prototype);
+  }
+};
+var ConnectionError = class _ConnectionError extends CilowError {
+  constructor(message, details) {
+    super(message, void 0, details);
+    this.name = "ConnectionError";
+    Object.setPrototypeOf(this, _ConnectionError.prototype);
+  }
+};
+var AuthenticationError = class _AuthenticationError extends CilowError {
+  constructor(message = "Invalid API key or unauthorized", details) {
+    super(message, 401, details);
+    this.name = "AuthenticationError";
+    Object.setPrototypeOf(this, _AuthenticationError.prototype);
+  }
+};
+var NotFoundError = class _NotFoundError extends CilowError {
+  constructor(message = "Resource not found", details) {
+    super(message, 404, details);
+    this.name = "NotFoundError";
+    Object.setPrototypeOf(this, _NotFoundError.prototype);
+  }
+};
+var ValidationError = class _ValidationError extends CilowError {
+  constructor(message = "Validation error", details) {
+    super(message, 422, details);
+    this.name = "ValidationError";
+    Object.setPrototypeOf(this, _ValidationError.prototype);
+  }
+};
+var RateLimitError = class _RateLimitError extends CilowError {
+  constructor(message = "Rate limit exceeded", retryAfter, details) {
+    super(message, 429, details);
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+    Object.setPrototypeOf(this, _RateLimitError.prototype);
+  }
+};
+
+// src/client.ts
+function toCamelCase(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => toCamelCase(item));
+  }
+  if (obj !== null && typeof obj === "object") {
+    return Object.entries(obj).reduce((acc, [key, value]) => {
+      const camelKey = key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+      acc[camelKey] = toCamelCase(value);
+      return acc;
+    }, {});
+  }
+  return obj;
+}
+function toSnakeCase(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => toSnakeCase(item));
+  }
+  if (obj !== null && typeof obj === "object") {
+    return Object.entries(obj).reduce((acc, [key, value]) => {
+      const snakeKey = key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+      acc[snakeKey] = toSnakeCase(value);
+      return acc;
+    }, {});
+  }
+  return obj;
+}
+var CilowClient = class {
+  constructor(config = {}) {
+    this.baseUrl = (config.baseUrl ?? "http://localhost:8080").replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.accessToken = config.accessToken;
+    this.timeout = config.timeout ?? 3e4;
+  }
+  /**
+   * Set the JWT access token for Bearer authentication
+   */
+  setAccessToken(token) {
+    this.accessToken = token;
+  }
+  /**
+   * Make API request with error handling
+   */
+  async request(method, endpoint, data, useAuth = true) {
+    const url = `${this.baseUrl}/api/v1${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (useAuth) {
+      if (this.apiKey) {
+        headers["X-API-Key"] = this.apiKey;
+      }
+      if (this.accessToken) {
+        headers["Authorization"] = `Bearer ${this.accessToken}`;
+      }
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: data ? JSON.stringify(toSnakeCase(data)) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorText = await response.text();
+        switch (response.status) {
+          case 401:
+            throw new AuthenticationError("Invalid API key or unauthorized");
+          case 404:
+            throw new NotFoundError(`Resource not found: ${endpoint}`);
+          case 422:
+            throw new ValidationError(`Validation error: ${errorText}`);
+          case 429:
+            const retryAfter = response.headers.get("Retry-After");
+            throw new RateLimitError(
+              "Rate limit exceeded",
+              retryAfter ? parseInt(retryAfter, 10) : void 0
+            );
+          default:
+            throw new CilowError(`API error ${response.status}: ${errorText}`, response.status);
+        }
+      }
+      const json = await response.json();
+      return toCamelCase(json);
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof CilowError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new ConnectionError("Request timeout");
+        }
+        throw new ConnectionError(`Failed to connect to Cilow API: ${error.message}`);
+      }
+      throw new ConnectionError("Unknown error occurred");
+    }
+  }
+  // ===========================================================================
+  // Health & Status
+  // ===========================================================================
+  /**
+   * Check API server health
+   */
+  async healthCheck() {
+    const response = await fetch(`${this.baseUrl}/health`);
+    const json = await response.json();
+    return toCamelCase(json);
+  }
+  // ===========================================================================
+  // Memory Operations
+  // ===========================================================================
+  /**
+   * Add a new memory to the system
+   */
+  async addMemory(options) {
+    const response = await this.request("POST", "/memory/add", options);
+    return response.memoryId;
+  }
+  /**
+   * Get a memory by ID
+   */
+  async getMemory(memoryId, userId) {
+    const endpoint = userId ? `/memory/${memoryId}?user_id=${userId}` : `/memory/${memoryId}`;
+    return this.request("GET", endpoint);
+  }
+  /**
+   * Update an existing memory
+   */
+  async updateMemory(memoryId, options) {
+    return this.request("PUT", `/memory/${memoryId}`, options);
+  }
+  /**
+   * Delete a memory
+   */
+  async deleteMemory(memoryId) {
+    await this.request("DELETE", `/memory/${memoryId}`);
+    return true;
+  }
+  /**
+   * Search memories with semantic similarity
+   */
+  async searchMemories(options) {
+    const response = await this.request(
+      "POST",
+      "/memory/search",
+      options
+    );
+    return Array.isArray(response) ? response : response.memories ?? [];
+  }
+  /**
+   * Get memory system statistics
+   */
+  async getMemoryStats() {
+    return this.request("GET", "/memory/stats");
+  }
+  /**
+   * List memories with pagination
+   */
+  async listMemories(options) {
+    const params = new URLSearchParams();
+    if (options?.limit) params.set("limit", options.limit.toString());
+    if (options?.offset) params.set("offset", options.offset.toString());
+    if (options?.tags) params.set("tags", options.tags.join(","));
+    if (options?.userId) params.set("user_id", options.userId);
+    const endpoint = params.toString() ? `/memory/list?${params}` : "/memory/list";
+    const response = await this.request("GET", endpoint);
+    return Array.isArray(response) ? response : response.memories ?? [];
+  }
+  // ===========================================================================
+  // Vector Operations
+  // ===========================================================================
+  /**
+   * Store a vector embedding directly
+   */
+  async storeVector(options) {
+    const response = await this.request(
+      "POST",
+      "/vectors",
+      options
+    );
+    return response.vectorId ?? response.id ?? "";
+  }
+  /**
+   * Search for similar vectors
+   */
+  async searchVectors(options) {
+    const response = await this.request("POST", "/vectors/search", options);
+    return response;
+  }
+  /**
+   * Get a vector by ID
+   */
+  async getVector(vectorId) {
+    return this.request("GET", `/vectors/${vectorId}`);
+  }
+  /**
+   * Delete a vector
+   */
+  async deleteVector(vectorId) {
+    await this.request("DELETE", `/vectors/${vectorId}`);
+    return true;
+  }
+  // ===========================================================================
+  // Graph Operations
+  // ===========================================================================
+  /**
+   * Query the knowledge graph with natural language
+   */
+  async queryGraph(query, limit = 10) {
+    const response = await this.request(
+      "POST",
+      "/graph/query",
+      { query, limit }
+    );
+    return Array.isArray(response) ? response : response.results ?? [];
+  }
+  /**
+   * Add a node to the knowledge graph
+   */
+  async addGraphNode(options) {
+    const response = await this.request(
+      "POST",
+      "/graph/nodes",
+      options
+    );
+    return response.nodeId ?? response.id ?? "";
+  }
+  /**
+   * Get a graph node by ID
+   */
+  async getGraphNode(nodeId) {
+    return this.request("GET", `/graph/nodes/${nodeId}`);
+  }
+  /**
+   * Delete a graph node
+   */
+  async deleteGraphNode(nodeId) {
+    await this.request("DELETE", `/graph/nodes/${nodeId}`);
+    return true;
+  }
+  /**
+   * Get knowledge graph statistics
+   */
+  async getGraphStats() {
+    return this.request("GET", "/graph/stats");
+  }
+  // ===========================================================================
+  // Agent Operations
+  // ===========================================================================
+  /**
+   * Create a new AI agent
+   */
+  async createAgent(options) {
+    const response = await this.request("POST", "/agents/create", {
+      name: options.name,
+      type: options.agentType ?? "react",
+      config: options.config
+    });
+    return response.agentId;
+  }
+  /**
+   * Get agent details
+   */
+  async getAgent(agentId) {
+    return this.request("GET", `/agents/${agentId}`);
+  }
+  /**
+   * Execute a task with an AI agent
+   */
+  async executeTask(agentId, options) {
+    return this.request("POST", `/agents/${agentId}/execute`, options);
+  }
+  // ===========================================================================
+  // Fact Extraction
+  // ===========================================================================
+  /**
+   * Extract facts from content using intelligent extraction
+   */
+  async extractFacts(content, sourceContext) {
+    const response = await this.request("POST", "/memory/extract", {
+      content,
+      sourceContext
+    });
+    return response.facts ?? [];
+  }
+  // ===========================================================================
+  // Authentication Operations
+  // ===========================================================================
+  /**
+   * Register a new user account
+   */
+  async register(email, password, name) {
+    const response = await this.request(
+      "POST",
+      "/auth/register",
+      { email, password, name },
+      false
+    );
+    this.accessToken = response.accessToken;
+    return response;
+  }
+  /**
+   * Login with email and password
+   */
+  async login(email, password) {
+    const response = await this.request(
+      "POST",
+      "/auth/login",
+      { email, password },
+      false
+    );
+    this.accessToken = response.accessToken;
+    return response;
+  }
+  /**
+   * Refresh the current access token
+   */
+  async refreshToken() {
+    const response = await this.request("POST", "/auth/refresh");
+    this.accessToken = response.accessToken;
+    return response;
+  }
+  /**
+   * Get the currently authenticated user
+   */
+  async getCurrentUser() {
+    return this.request("GET", "/auth/me");
+  }
+  /**
+   * Logout and invalidate current session
+   */
+  async logout() {
+    await this.request("POST", "/auth/logout");
+    this.accessToken = void 0;
+    return true;
+  }
+  /**
+   * Create a new API key for programmatic access
+   */
+  async createApiKey(options) {
+    const response = await this.request("POST", "/auth/api-keys", options);
+    return {
+      keyId: response.keyId ?? response.id ?? "",
+      name: response.name,
+      key: response.apiKey ?? response.key,
+      permissions: response.permissions ?? [],
+      expiresAt: response.expiresAt,
+      isActive: true
+    };
+  }
+  /**
+   * List all API keys for the current user
+   */
+  async listApiKeys() {
+    const response = await this.request("GET", "/auth/api-keys");
+    return Array.isArray(response) ? response : response.keys ?? [];
+  }
+  /**
+   * Revoke an API key
+   */
+  async revokeApiKey(keyId) {
+    await this.request("DELETE", `/auth/api-keys/${keyId}`);
+    return true;
+  }
+  /**
+   * List all active sessions for the current user
+   */
+  async listSessions() {
+    const response = await this.request(
+      "GET",
+      "/auth/sessions"
+    );
+    return Array.isArray(response) ? response : response.sessions ?? [];
+  }
+  /**
+   * Revoke a specific session
+   */
+  async revokeSession(sessionId) {
+    await this.request("DELETE", `/auth/sessions/${sessionId}`);
+    return true;
+  }
+  /**
+   * Revoke all sessions except the current one
+   */
+  async revokeAllSessions() {
+    await this.request("DELETE", "/auth/sessions");
+    return true;
+  }
+};
+export {
+  AuthenticationError,
+  CilowClient,
+  CilowError,
+  ConnectionError,
+  NotFoundError,
+  RateLimitError,
+  ValidationError
+};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@cilow/sdk",
+  "version": "0.2.0",
+  "description": "TypeScript/JavaScript SDK for Cilow AI Agent Platform - Production-ready memory system for AI agents with unlimited context",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run typecheck"
+  },
+  "keywords": [
+    "cilow",
+    "ai",
+    "memory",
+    "agents",
+    "sdk",
+    "llm",
+    "rag",
+    "vector-database",
+    "embeddings",
+    "knowledge-graph",
+    "ai-memory",
+    "agent-memory",
+    "long-term-memory",
+    "semantic-search"
+  ],
+  "author": "Cilow AI <team@cilow.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cilow-ai/cilow"
+  },
+  "homepage": "https://cilow.ai",
+  "bugs": {
+    "url": "https://github.com/cilow-ai/cilow/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.27",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false
+}