cencori 1.2.0 → 1.3.0

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   AINamespace: () => AINamespace,
+  AgentsNamespace: () => AgentsNamespace,
   AuthenticationError: () => AuthenticationError,
   Cencori: () => Cencori,
   CencoriError: () => CencoriError,
@@ -28,8 +29,10 @@ __export(src_exports, {
   MemoryClient: () => MemoryClient,
   RateLimitError: () => RateLimitError,
   SafetyError: () => SafetyError,
+  SessionsNamespace: () => SessionsNamespace,
   StorageNamespace: () => StorageNamespace,
   TelemetryClient: () => TelemetryClient,
+  VisionNamespace: () => VisionNamespace,
   WorkflowNamespace: () => WorkflowNamespace,
   cencori: () => cencori,
   createCencori: () => createCencori,
@@ -392,6 +395,137 @@ var AINamespace = class {
       latencyMs: data.latency_ms
     };
   }
+  /**
+   * Send a request to the OpenAI-compatible Responses API.
+   * Supports built-in tools: web_search_preview, file_search, code_interpreter.
+   *
+   * @example
+   * const response = await cencori.ai.responses({
+   *   model: 'gpt-4o',
+   *   input: 'What is the weather in San Francisco?',
+   *   tools: [{ type: 'web_search_preview' }]
+   * });
+   * console.log(response.output[0].content?.[0]?.text);
+   */
+  async responses(request) {
+    const response = await fetch(`${this.config.baseUrl}/v1/responses`, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify({
+        model: request.model,
+        input: request.input,
+        instructions: request.instructions,
+        tools: request.tools,
+        tool_choice: request.tool_choice,
+        temperature: request.temperature,
+        max_output_tokens: request.max_output_tokens,
+        top_p: request.top_p,
+        store: request.store,
+        metadata: request.metadata,
+        previous_response_id: request.previous_response_id,
+        parallel_tool_calls: request.parallel_tool_calls,
+        truncation: request.truncation,
+        response_format: request.response_format,
+        include: request.include,
+        stream: false,
+        user: request.user
+      })
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(`Cencori API error: ${errorData.error || response.statusText}`);
+    }
+    return response.json();
+  }
+  /**
+   * Stream responses from the Responses API via SSE.
+   * Yields parsed events as they arrive.
+   *
+   * @example
+   * for await (const event of cencori.ai.responsesStream({
+   *   model: 'gpt-4o',
+   *   input: 'Tell me about AI',
+   * })) {
+   *   if (event.type === 'response.output_text.delta') {
+   *     process.stdout.write(event.data.delta);
+   *   }
+   * }
+   */
+  async *responsesStream(request) {
+    const response = await fetch(`${this.config.baseUrl}/v1/responses`, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify({
+        model: request.model,
+        input: request.input,
+        instructions: request.instructions,
+        tools: request.tools,
+        tool_choice: request.tool_choice,
+        temperature: request.temperature,
+        max_output_tokens: request.max_output_tokens,
+        top_p: request.top_p,
+        store: request.store,
+        metadata: request.metadata,
+        previous_response_id: request.previous_response_id,
+        parallel_tool_calls: request.parallel_tool_calls,
+        truncation: request.truncation,
+        response_format: request.response_format,
+        include: request.include,
+        stream: true,
+        user: request.user
+      })
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(`Cencori API error: ${errorData.error || response.statusText}`);
+    }
+    if (!response.body) {
+      throw new Error("Response body is null");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventType = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          if (line.trim() === "") {
+            eventType = "";
+            continue;
+          }
+          if (line.startsWith("event: ")) {
+            eventType = line.slice(7).trim();
+            continue;
+          }
+          if (line.startsWith("data: ")) {
+            const data = line.slice(6).trim();
+            if (!data) continue;
+            try {
+              const parsed = JSON.parse(data);
+              yield { type: eventType || "message", data: parsed };
+            } catch {
+            }
+            eventType = "";
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
   /**
    * Stream RAG responses with automatic memory context
    * 
@@ -458,6 +592,206 @@ var AINamespace = class {
   }
 };
 
+// src/agents/index.ts
+var AgentsNamespace = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, body) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method,
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(`Cencori API error: ${errorData.error?.message || response.statusText}`);
+    }
+    if (response.status === 204) return void 0;
+    return response.json();
+  }
+  async create(params) {
+    return this.request("POST", "/v1/agents", params);
+  }
+  async list() {
+    return this.request("GET", "/v1/agents");
+  }
+  async get(agentId) {
+    return this.request("GET", `/v1/agents/${agentId}`);
+  }
+  async updateConfig(agentId, params) {
+    return this.request("PATCH", `/v1/agents/${agentId}`, params);
+  }
+  async delete(agentId) {
+    return this.request("DELETE", `/v1/agents/${agentId}`);
+  }
+  async createKey(agentId, params) {
+    return this.request("POST", `/v1/agents/${agentId}/keys`, params || {});
+  }
+};
+
+// src/vision/index.ts
+function toBody(request) {
+  const body = {
+    prompt: request.prompt,
+    model: request.model,
+    max_tokens: request.maxTokens,
+    temperature: request.temperature,
+    response_format: request.responseFormat
+  };
+  if (request.image.url) {
+    body.image_url = request.image.url;
+  } else if (request.image.base64) {
+    body.image_base64 = request.image.base64;
+    body.mime_type = request.image.mimeType;
+  } else {
+    throw new Error("vision request requires image.url or image.base64");
+  }
+  return body;
+}
+var VisionNamespace = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * General image analysis — provide your own prompt.
+   * Default prompt: "Describe this image in detail."
+   */
+  async analyze(request) {
+    return this.post("/api/ai/vision", request);
+  }
+  /** Describe the image in rich detail. */
+  async describe(request) {
+    return this.post("/api/ai/vision/describe", request);
+  }
+  /** Extract all visible text from the image. */
+  async ocr(request) {
+    return this.post("/api/ai/vision/ocr", request);
+  }
+  /** Return structured tags, objects, and category classification. */
+  async classify(request) {
+    return this.post("/api/ai/vision/classify", request);
+  }
+  async post(path, request) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify(toBody(request))
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const message = data && typeof data === "object" && "message" in data && typeof data.message === "string" ? data.message : `Vision request failed with status ${response.status}`;
+      const code = data && typeof data === "object" && "error" in data && typeof data.error === "string" ? data.error : "request_failed";
+      const err = new Error(message);
+      err.code = code;
+      err.details = data;
+      throw err;
+    }
+    return data;
+  }
+};
+
+// src/sessions/index.ts
+var SessionsNamespace = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, body) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method,
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(`Cencori API error: ${errorData.error?.message || response.statusText}`);
+    }
+    if (response.status === 204) return void 0;
+    return response.json();
+  }
+  async create(params) {
+    return this.request("POST", "/v1/sessions", params || {});
+  }
+  async list(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.page) searchParams.set("page", String(params.page));
+    if (params?.limit) searchParams.set("limit", String(params.limit));
+    if (params?.status) searchParams.set("status", params.status);
+    if (params?.agent_id) searchParams.set("agent_id", params.agent_id);
+    const qs = searchParams.toString();
+    return this.request("GET", `/v1/sessions${qs ? `?${qs}` : ""}`);
+  }
+  async get(sessionId) {
+    return this.request("GET", `/v1/sessions/${sessionId}`);
+  }
+  async delete(sessionId) {
+    return this.request("DELETE", `/v1/sessions/${sessionId}`);
+  }
+  async submitTurn(sessionId, params) {
+    const url = `${this.config.baseUrl}/v1/sessions/${sessionId}/turns`;
+    return fetch(url, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify(params)
+    });
+  }
+  async submitTurnStream(sessionId, params) {
+    const response = await this.submitTurn(sessionId, params);
+    if (!response.ok) {
+      const err = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(`Cencori API error: ${err.error?.message || response.statusText}`);
+    }
+    return response.body;
+  }
+  async getEvents(sessionId, params) {
+    const searchParams = new URLSearchParams();
+    if (params?.page) searchParams.set("page", String(params.page));
+    if (params?.limit) searchParams.set("limit", String(params.limit));
+    if (params?.turn_number) searchParams.set("turn_number", String(params.turn_number));
+    const qs = searchParams.toString();
+    return this.request("GET", `/v1/sessions/${sessionId}/events${qs ? `?${qs}` : ""}`);
+  }
+  async approve(sessionId, params) {
+    const url = `${this.config.baseUrl}/v1/sessions/${sessionId}/approve`;
+    return fetch(url, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify(params)
+    });
+  }
+  async approveStream(sessionId, params) {
+    const response = await this.approve(sessionId, params);
+    if (!response.ok) {
+      const err = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(`Cencori API error: ${err.error?.message || response.statusText}`);
+    }
+    return response.body;
+  }
+  async reject(sessionId, params) {
+    return this.request("POST", `/v1/sessions/${sessionId}/reject`, params);
+  }
+};
+
 // src/compute/index.ts
 var ComputeNamespace = class {
   /**
@@ -545,7 +879,7 @@ var VectorsNamespace = class {
    */
   async search(query, options) {
     throw new Error(
-      `cencori.storage.vectors.search() is coming soon! Join our waitlist at https://cencori.com/storage`
+      `cencori.storage.vectors.search() is coming soon! Join our waitlist at https://cencori.com/memory`
     );
   }
   /**
@@ -555,7 +889,7 @@ var VectorsNamespace = class {
    */
   async upsert(vectors) {
     throw new Error(
-      `cencori.storage.vectors.upsert() is coming soon! Join our waitlist at https://cencori.com/storage`
+      `cencori.storage.vectors.upsert() is coming soon! Join our waitlist at https://cencori.com/memory`
     );
   }
   /**
@@ -565,7 +899,7 @@ var VectorsNamespace = class {
    */
   async delete(ids) {
     throw new Error(
-      `cencori.storage.vectors.delete() is coming soon! Join our waitlist at https://cencori.com/storage`
+      `cencori.storage.vectors.delete() is coming soon! Join our waitlist at https://cencori.com/memory`
     );
   }
 };
@@ -577,7 +911,7 @@ var KnowledgeNamespace = class {
    */
   async query(question) {
     throw new Error(
-      `cencori.storage.knowledge.query() is coming soon! Join our waitlist at https://cencori.com/storage`
+      `cencori.storage.knowledge.query() is coming soon! Join our waitlist at https://cencori.com/memory`
     );
   }
   /**
@@ -587,7 +921,7 @@ var KnowledgeNamespace = class {
    */
   async add(documents) {
     throw new Error(
-      `cencori.storage.knowledge.add() is coming soon! Join our waitlist at https://cencori.com/storage`
+      `cencori.storage.knowledge.add() is coming soon! Join our waitlist at https://cencori.com/memory`
     );
   }
 };
@@ -599,7 +933,7 @@ var FilesNamespace = class {
    */
   async upload(file, name) {
     throw new Error(
-      `cencori.storage.files.upload() is coming soon! Join our waitlist at https://cencori.com/storage`
+      `cencori.storage.files.upload() is coming soon! Join our waitlist at https://cencori.com/memory`
     );
   }
   /**
@@ -609,7 +943,7 @@ var FilesNamespace = class {
    */
   async process(fileId) {
     throw new Error(
-      `cencori.storage.files.process() is coming soon! Join our waitlist at https://cencori.com/storage`
+      `cencori.storage.files.process() is coming soon! Join our waitlist at https://cencori.com/memory`
     );
   }
 };
@@ -860,7 +1194,7 @@ var SafetyError = class _SafetyError extends CencoriError {
 };
 
 // src/cencori.ts
-var DEFAULT_BASE_URL = "https://cencori.com";
+var DEFAULT_BASE_URL = "https://api.cencori.com";
 var Cencori = class {
   /**
    * Create a new Cencori client
@@ -888,10 +1222,13 @@ var Cencori = class {
       headers: config.headers ?? {}
     };
     this.ai = new AINamespace(this.config);
+    this.vision = new VisionNamespace(this.config);
+    this.agents = new AgentsNamespace(this.config);
     this.compute = new ComputeNamespace();
     this.workflow = new WorkflowNamespace();
     this.storage = new StorageNamespace();
     this.memory = new MemoryClient(this.config);
+    this.sessions = new SessionsNamespace(this.config);
     this.telemetry = new TelemetryClient(this.config);
   }
   /**
@@ -1308,6 +1645,7 @@ cencori.chat = cencori;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AINamespace,
+  AgentsNamespace,
   AuthenticationError,
   Cencori,
   CencoriError,
@@ -1315,8 +1653,10 @@ cencori.chat = cencori;
   MemoryClient,
   RateLimitError,
   SafetyError,
+  SessionsNamespace,
   StorageNamespace,
   TelemetryClient,
+  VisionNamespace,
   WorkflowNamespace,
   cencori,
   createCencori,