cencori 1.2.1 → 1.3.1

package/dist/vision/index.js

@@ -0,0 +1,144 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vision/index.ts
+var vision_exports = {};
+__export(vision_exports, {
+  VisionNamespace: () => VisionNamespace
+});
+module.exports = __toCommonJS(vision_exports);
+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;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VisionNamespace
+});
+//# sourceMappingURL=index.js.map

package/dist/vision/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vision/index.ts"],"sourcesContent":["/**\n * Vision API — analyze, describe, OCR, and classify images.\n *\n * @example\n *   const result = await cencori.vision.analyze({\n *       image: { url: 'https://example.com/photo.jpg' },\n *       prompt: 'What breed of dog is this?',\n *   });\n *\n * @example\n *   const { text } = await cencori.vision.ocr({ image: { base64, mimeType: 'image/png' } });\n */\n\nimport type { CencoriConfig } from '../types';\n\nexport type VisionProvider = 'openai' | 'anthropic' | 'google';\n\nexport type VisionTask = 'analyze' | 'describe' | 'ocr' | 'classify';\n\nexport interface VisionImage {\n    /** https:// URL or data: URL. Exactly one of `url` or `base64` must be set. */\n    url?: string;\n    /** Raw base64 (no data: prefix). Requires `mimeType`. */\n    base64?: string;\n    /** Image mime type. Required when using `base64`. */\n    mimeType?: string;\n}\n\nexport interface VisionRequest {\n    image: VisionImage;\n    prompt?: string;\n    model?: string;\n    maxTokens?: number;\n    temperature?: number;\n    responseFormat?: 'text' | 'json';\n}\n\nexport interface VisionStreamChunk {\n    delta?: string;\n    done?: boolean;\n    model?: string;\n    provider?: VisionProvider;\n    usage?: VisionUsage;\n    cost?: VisionCost;\n    error?: string;\n}\n\nexport interface VisionUsage {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n}\n\nexport interface VisionCost {\n    providerCostUsd: number;\n    cencoriChargeUsd: number;\n    markupPercentage: number;\n}\n\nexport interface VisionResult {\n    analysis: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\nexport interface VisionDescribeResult {\n    description: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\nexport interface VisionOcrResult {\n    text: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\nexport interface VisionClassification {\n    primary_category?: string;\n    tags?: string[];\n    objects?: string[];\n    safe_for_work?: boolean;\n    confidence?: number;\n    summary?: string;\n    [key: string]: unknown;\n}\n\nexport interface VisionClassifyResult {\n    classification: VisionClassification | string;\n    raw: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\ninterface JsonBody {\n    image_url?: string;\n    image_base64?: string;\n    mime_type?: string;\n    prompt?: string;\n    model?: string;\n    max_tokens?: number;\n    temperature?: number;\n    response_format?: 'text' | 'json';\n}\n\nfunction toBody(request: VisionRequest): JsonBody {\n    const body: JsonBody = {\n        prompt: request.prompt,\n        model: request.model,\n        max_tokens: request.maxTokens,\n        temperature: request.temperature,\n        response_format: request.responseFormat,\n    };\n    if (request.image.url) {\n        body.image_url = request.image.url;\n    } else if (request.image.base64) {\n        body.image_base64 = request.image.base64;\n        body.mime_type = request.image.mimeType;\n    } else {\n        throw new Error('vision request requires image.url or image.base64');\n    }\n    return body;\n}\n\nexport class VisionNamespace {\n    private config: Required<CencoriConfig>;\n\n    constructor(config: Required<CencoriConfig>) {\n        this.config = config;\n    }\n\n    /**\n     * General image analysis — provide your own prompt.\n     * Default prompt: \"Describe this image in detail.\"\n     */\n    async analyze(request: VisionRequest): Promise<VisionResult> {\n        return this.post<VisionResult>('/api/ai/vision', request);\n    }\n\n    /** Describe the image in rich detail. */\n    async describe(request: VisionRequest): Promise<VisionDescribeResult> {\n        return this.post<VisionDescribeResult>('/api/ai/vision/describe', request);\n    }\n\n    /** Extract all visible text from the image. */\n    async ocr(request: VisionRequest): Promise<VisionOcrResult> {\n        return this.post<VisionOcrResult>('/api/ai/vision/ocr', request);\n    }\n\n    /** Return structured tags, objects, and category classification. */\n    async classify(request: VisionRequest): Promise<VisionClassifyResult> {\n        return this.post<VisionClassifyResult>('/api/ai/vision/classify', request);\n    }\n\n    /**\n     * Stream a vision analysis. Yields `{ delta }` chunks as text arrives, then\n     * a final `{ done: true, model, provider, usage, cost }` chunk with totals.\n     *\n     * @example\n     * for await (const chunk of cencori.vision.analyzeStream({ image: { url } })) {\n     *   if (chunk.delta) process.stdout.write(chunk.delta);\n     *   if (chunk.done) console.log(chunk.cost);\n     * }\n     */\n    async *analyzeStream(request: VisionRequest): AsyncGenerator<VisionStreamChunk, void, unknown> {\n        const body = { ...toBody(request), stream: true };\n        const response = await fetch(`${this.config.baseUrl}/api/ai/vision`, {\n            method: 'POST',\n            headers: {\n                'CENCORI_API_KEY': this.config.apiKey,\n                'Content-Type': 'application/json',\n                ...this.config.headers,\n            },\n            body: JSON.stringify(body),\n        });\n        if (!response.ok) {\n            const data = await response.json().catch(() => ({}));\n            const message =\n                (data && typeof data === 'object' && 'message' in data && typeof data.message === 'string')\n                    ? data.message\n                    : `Vision stream request failed with status ${response.status}`;\n            throw new Error(message);\n        }\n        if (!response.body) throw new Error('Response body is null');\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = '';\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) break;\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                buffer = lines.pop() ?? '';\n                for (const line of lines) {\n                    if (!line.startsWith('data: ')) continue;\n                    const data = line.slice(6);\n                    if (data === '[DONE]') return;\n                    try {\n                        yield JSON.parse(data) as VisionStreamChunk;\n                    } catch {\n                        // skip malformed frame\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    private async post<T>(path: string, request: VisionRequest): Promise<T> {\n        const response = await fetch(`${this.config.baseUrl}${path}`, {\n            method: 'POST',\n            headers: {\n                'CENCORI_API_KEY': this.config.apiKey,\n                'Content-Type': 'application/json',\n                ...this.config.headers,\n            },\n            body: JSON.stringify(toBody(request)),\n        });\n        const data = await response.json();\n        if (!response.ok) {\n            const message =\n                (data && typeof data === 'object' && 'message' in data && typeof data.message === 'string')\n                    ? data.message\n                    : `Vision request failed with status ${response.status}`;\n            const code =\n                (data && typeof data === 'object' && 'error' in data && typeof data.error === 'string')\n                    ? data.error\n                    : 'request_failed';\n            const err = new Error(message) as Error & { code?: string; details?: unknown };\n            err.code = code;\n            err.details = data;\n            throw err;\n        }\n        return data as T;\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/vision/index.mjs

@@ -0,0 +1,119 @@
+// 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;
+  }
+};
+export {
+  VisionNamespace
+};
+//# sourceMappingURL=index.mjs.map

package/dist/vision/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vision/index.ts"],"sourcesContent":["/**\n * Vision API — analyze, describe, OCR, and classify images.\n *\n * @example\n *   const result = await cencori.vision.analyze({\n *       image: { url: 'https://example.com/photo.jpg' },\n *       prompt: 'What breed of dog is this?',\n *   });\n *\n * @example\n *   const { text } = await cencori.vision.ocr({ image: { base64, mimeType: 'image/png' } });\n */\n\nimport type { CencoriConfig } from '../types';\n\nexport type VisionProvider = 'openai' | 'anthropic' | 'google';\n\nexport type VisionTask = 'analyze' | 'describe' | 'ocr' | 'classify';\n\nexport interface VisionImage {\n    /** https:// URL or data: URL. Exactly one of `url` or `base64` must be set. */\n    url?: string;\n    /** Raw base64 (no data: prefix). Requires `mimeType`. */\n    base64?: string;\n    /** Image mime type. Required when using `base64`. */\n    mimeType?: string;\n}\n\nexport interface VisionRequest {\n    image: VisionImage;\n    prompt?: string;\n    model?: string;\n    maxTokens?: number;\n    temperature?: number;\n    responseFormat?: 'text' | 'json';\n}\n\nexport interface VisionStreamChunk {\n    delta?: string;\n    done?: boolean;\n    model?: string;\n    provider?: VisionProvider;\n    usage?: VisionUsage;\n    cost?: VisionCost;\n    error?: string;\n}\n\nexport interface VisionUsage {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n}\n\nexport interface VisionCost {\n    providerCostUsd: number;\n    cencoriChargeUsd: number;\n    markupPercentage: number;\n}\n\nexport interface VisionResult {\n    analysis: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\nexport interface VisionDescribeResult {\n    description: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\nexport interface VisionOcrResult {\n    text: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\nexport interface VisionClassification {\n    primary_category?: string;\n    tags?: string[];\n    objects?: string[];\n    safe_for_work?: boolean;\n    confidence?: number;\n    summary?: string;\n    [key: string]: unknown;\n}\n\nexport interface VisionClassifyResult {\n    classification: VisionClassification | string;\n    raw: string;\n    model: string;\n    provider: VisionProvider;\n    usage: VisionUsage;\n    cost: VisionCost;\n}\n\ninterface JsonBody {\n    image_url?: string;\n    image_base64?: string;\n    mime_type?: string;\n    prompt?: string;\n    model?: string;\n    max_tokens?: number;\n    temperature?: number;\n    response_format?: 'text' | 'json';\n}\n\nfunction toBody(request: VisionRequest): JsonBody {\n    const body: JsonBody = {\n        prompt: request.prompt,\n        model: request.model,\n        max_tokens: request.maxTokens,\n        temperature: request.temperature,\n        response_format: request.responseFormat,\n    };\n    if (request.image.url) {\n        body.image_url = request.image.url;\n    } else if (request.image.base64) {\n        body.image_base64 = request.image.base64;\n        body.mime_type = request.image.mimeType;\n    } else {\n        throw new Error('vision request requires image.url or image.base64');\n    }\n    return body;\n}\n\nexport class VisionNamespace {\n    private config: Required<CencoriConfig>;\n\n    constructor(config: Required<CencoriConfig>) {\n        this.config = config;\n    }\n\n    /**\n     * General image analysis — provide your own prompt.\n     * Default prompt: \"Describe this image in detail.\"\n     */\n    async analyze(request: VisionRequest): Promise<VisionResult> {\n        return this.post<VisionResult>('/api/ai/vision', request);\n    }\n\n    /** Describe the image in rich detail. */\n    async describe(request: VisionRequest): Promise<VisionDescribeResult> {\n        return this.post<VisionDescribeResult>('/api/ai/vision/describe', request);\n    }\n\n    /** Extract all visible text from the image. */\n    async ocr(request: VisionRequest): Promise<VisionOcrResult> {\n        return this.post<VisionOcrResult>('/api/ai/vision/ocr', request);\n    }\n\n    /** Return structured tags, objects, and category classification. */\n    async classify(request: VisionRequest): Promise<VisionClassifyResult> {\n        return this.post<VisionClassifyResult>('/api/ai/vision/classify', request);\n    }\n\n    /**\n     * Stream a vision analysis. Yields `{ delta }` chunks as text arrives, then\n     * a final `{ done: true, model, provider, usage, cost }` chunk with totals.\n     *\n     * @example\n     * for await (const chunk of cencori.vision.analyzeStream({ image: { url } })) {\n     *   if (chunk.delta) process.stdout.write(chunk.delta);\n     *   if (chunk.done) console.log(chunk.cost);\n     * }\n     */\n    async *analyzeStream(request: VisionRequest): AsyncGenerator<VisionStreamChunk, void, unknown> {\n        const body = { ...toBody(request), stream: true };\n        const response = await fetch(`${this.config.baseUrl}/api/ai/vision`, {\n            method: 'POST',\n            headers: {\n                'CENCORI_API_KEY': this.config.apiKey,\n                'Content-Type': 'application/json',\n                ...this.config.headers,\n            },\n            body: JSON.stringify(body),\n        });\n        if (!response.ok) {\n            const data = await response.json().catch(() => ({}));\n            const message =\n                (data && typeof data === 'object' && 'message' in data && typeof data.message === 'string')\n                    ? data.message\n                    : `Vision stream request failed with status ${response.status}`;\n            throw new Error(message);\n        }\n        if (!response.body) throw new Error('Response body is null');\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = '';\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) break;\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                buffer = lines.pop() ?? '';\n                for (const line of lines) {\n                    if (!line.startsWith('data: ')) continue;\n                    const data = line.slice(6);\n                    if (data === '[DONE]') return;\n                    try {\n                        yield JSON.parse(data) as VisionStreamChunk;\n                    } catch {\n                        // skip malformed frame\n                    }\n                }\n            }\n        } finally {\n            reader.releaseLock();\n        }\n    }\n\n    private async post<T>(path: string, request: VisionRequest): Promise<T> {\n        const response = await fetch(`${this.config.baseUrl}${path}`, {\n            method: 'POST',\n            headers: {\n                'CENCORI_API_KEY': this.config.apiKey,\n                'Content-Type': 'application/json',\n                ...this.config.headers,\n            },\n            body: JSON.stringify(toBody(request)),\n        });\n        const data = await response.json();\n        if (!response.ok) {\n            const message =\n                (data && typeof data === 'object' && 'message' in data && typeof data.message === 'string')\n                    ? data.message\n                    : `Vision request failed with status ${response.status}`;\n            const code =\n                (data && typeof data === 'object' && 'error' in data && typeof data.error === 'string')\n                    ? data.error\n                    : 'request_failed';\n            const err = new Error(message) as Error & { code?: string; details?: unknown };\n            err.code = code;\n            err.details = data;\n            throw err;\n        }\n        return data as T;\n    }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "cencori",
-    "version": "1.2.1",
+    "version": "1.3.1",
     "description": "Cencori - The unified infrastructure layer for AI applications. One SDK for AI Gateway, Compute, Workflow, and Storage.",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -27,6 +27,16 @@
             "import": "./dist/ai/index.mjs",
             "require": "./dist/ai/index.js"
         },
+        "./vision": {
+            "types": "./dist/vision/index.d.ts",
+            "import": "./dist/vision/index.mjs",
+            "require": "./dist/vision/index.js"
+        },
+        "./react": {
+            "types": "./dist/react/index.d.ts",
+            "import": "./dist/react/index.mjs",
+            "require": "./dist/react/index.js"
+        },
         "./compute": {
             "types": "./dist/compute/index.d.ts",
             "import": "./dist/compute/index.mjs",
@@ -87,11 +97,19 @@
         "prepublishOnly": "npm run build"
     },
     "peerDependencies": {
-        "@ai-sdk/provider": ">=1.0.0"
+        "@ai-sdk/provider": ">=1.0.0",
+        "react": ">=18.0.0",
+        "lucide-react": ">=0.400.0"
     },
     "peerDependenciesMeta": {
         "@ai-sdk/provider": {
             "optional": true
+        },
+        "react": {
+            "optional": true
+        },
+        "lucide-react": {
+            "optional": true
         }
     },
     "devDependencies": {