cencori 1.2.1 → 1.3.1

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,
@@ -589,6 +592,257 @@ 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);
+  }
+  /**
+   * Stream a vision analysis. Yields `{ delta }` chunks as text arrives, then
+   * a final `{ done: true, model, provider, usage, cost }` chunk with totals.
+   *
+   * @example
+   * for await (const chunk of cencori.vision.analyzeStream({ image: { url } })) {
+   *   if (chunk.delta) process.stdout.write(chunk.delta);
+   *   if (chunk.done) console.log(chunk.cost);
+   * }
+   */
+  async *analyzeStream(request) {
+    const body = { ...toBody(request), stream: true };
+    const response = await fetch(`${this.config.baseUrl}/api/ai/vision`, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const data = await response.json().catch(() => ({}));
+      const message = data && typeof data === "object" && "message" in data && typeof data.message === "string" ? data.message : `Vision stream request failed with status ${response.status}`;
+      throw new Error(message);
+    }
+    if (!response.body) throw new Error("Response body is null");
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    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.startsWith("data: ")) continue;
+          const data = line.slice(6);
+          if (data === "[DONE]") return;
+          try {
+            yield JSON.parse(data);
+          } catch {
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  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 {
   /**
@@ -991,7 +1245,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
@@ -1019,10 +1273,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);
   }
   /**
@@ -1439,6 +1696,7 @@ cencori.chat = cencori;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AINamespace,
+  AgentsNamespace,
   AuthenticationError,
   Cencori,
   CencoriError,
@@ -1446,8 +1704,10 @@ cencori.chat = cencori;
   MemoryClient,
   RateLimitError,
   SafetyError,
+  SessionsNamespace,
   StorageNamespace,
   TelemetryClient,
+  VisionNamespace,
   WorkflowNamespace,
   cencori,
   createCencori,