@nixxie-cms/ai 1.0.0 → 1.0.1

package/dist/declarations/src/AnthropicProvider.d.ts

@@ -0,0 +1,15 @@
+import type { NixxieAiCompleteOptions, NixxieAiCompletion, NixxieAiMessage, NixxieAiService } from '@nixxie-cms/core';
+import type { AiConfig } from "./types.js";
+/** Anthropic (Claude) provider, backed by the official @anthropic-ai/sdk. */
+export declare class AnthropicProvider implements NixxieAiService {
+    private config;
+    private model;
+    private maxTokens;
+    private client;
+    constructor(config: AiConfig);
+    complete(prompt: string, options?: NixxieAiCompleteOptions): Promise<NixxieAiCompletion>;
+    chat(messages: NixxieAiMessage[], options?: NixxieAiCompleteOptions): Promise<NixxieAiCompletion>;
+    embed(text: string): Promise<number[]>;
+    embedMany(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=AnthropicProvider.d.ts.map

package/dist/declarations/src/AnthropicProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicProvider.d.ts","sourceRoot":"../../../src","sources":["AnthropicProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,eAAe,EAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAe;AAcvC,6EAA6E;AAC7E,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAK;gBAEP,MAAM,EAAE,QAAQ;IAQtB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIxF,IAAI,CACR,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,kBAAkB,CAAC;IAqCxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMtC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CA6BtD"}

package/dist/declarations/src/OpenAiProvider.d.ts

@@ -0,0 +1,15 @@
+import type { NixxieAiCompleteOptions, NixxieAiCompletion, NixxieAiMessage, NixxieAiService } from '@nixxie-cms/core';
+import type { AiConfig } from "./types.js";
+/** OpenAI provider, backed by the official openai SDK. */
+export declare class OpenAiProvider implements NixxieAiService {
+    private config;
+    private model;
+    private maxTokens;
+    private client;
+    constructor(config: AiConfig);
+    complete(prompt: string, options?: NixxieAiCompleteOptions): Promise<NixxieAiCompletion>;
+    chat(messages: NixxieAiMessage[], options?: NixxieAiCompleteOptions): Promise<NixxieAiCompletion>;
+    embed(text: string): Promise<number[]>;
+    embedMany(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=OpenAiProvider.d.ts.map

package/dist/declarations/src/OpenAiProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAiProvider.d.ts","sourceRoot":"../../../src","sources":["OpenAiProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,eAAe,EAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAe;AAavC,0DAA0D;AAC1D,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAK;gBAEP,MAAM,EAAE,QAAQ;IAQtB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIxF,IAAI,CACR,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,kBAAkB,CAAC;IAuBxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMtC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAetD"}

package/dist/declarations/src/index.d.ts

@@ -0,0 +1,9 @@
+import type { NixxieAiService } from '@nixxie-cms/core';
+import { AnthropicProvider } from "./AnthropicProvider.js";
+import { OpenAiProvider } from "./OpenAiProvider.js";
+import type { AiConfig } from "./types.js";
+export declare function createAi(config: AiConfig): NixxieAiService;
+export { AnthropicProvider, OpenAiProvider };
+export type { AiConfig, AiProvider } from "./types.js";
+export type { NixxieAiService, NixxieAiMessage, NixxieAiCompleteOptions, NixxieAiCompletion, } from '@nixxie-cms/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/declarations/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../src","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,+BAA2B;AACvD,OAAO,EAAE,cAAc,EAAE,4BAAwB;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAe;AAEvC,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,CAW1D;AAED,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAA;AAC5C,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAe;AACnD,YAAY,EACV,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/declarations/src/types.d.ts

@@ -0,0 +1,26 @@
+import type { NixxieAiCompleteOptions, NixxieAiCompletion, NixxieAiMessage, NixxieAiService } from '@nixxie-cms/core';
+export type { NixxieAiCompleteOptions, NixxieAiCompletion, NixxieAiMessage, NixxieAiService };
+export type AiProvider = 'anthropic' | 'openai';
+export type AiConfig = {
+    /** LLM provider. Default: 'anthropic'. */
+    provider?: AiProvider;
+    /** API key for the provider. */
+    apiKey: string;
+    /**
+     * Default model for completions. Defaults to 'claude-opus-4-8' (Anthropic) or 'gpt-4o' (OpenAI).
+     */
+    model?: string;
+    /** Override the API base URL (proxies, gateways, Azure, etc.). */
+    baseUrl?: string;
+    /** Default max output tokens. Default: 4096. */
+    maxTokens?: number;
+    /**
+     * Model used for `embed`/`embedMany`. Anthropic has no native embeddings endpoint, so for the
+     * Anthropic provider embeddings are produced via Voyage AI (set `voyageApiKey`). Defaults to
+     * 'voyage-3' (Voyage) or 'text-embedding-3-small' (OpenAI).
+     */
+    embeddingModel?: string;
+    /** Voyage AI key, used for embeddings when `provider` is 'anthropic'. */
+    voyageApiKey?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/declarations/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"../../../src","sources":["types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,CAAA;AAE7F,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE/C,MAAM,MAAM,QAAQ,GAAG;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA"}

package/dist/nixxie-cms-ai.cjs.d.ts

@@ -1,2 +1,2 @@
-export * from "../src/index.js";
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibml4eGllLWNtcy1haS5janMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSJ9
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibml4eGllLWNtcy1haS5janMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4vZGVjbGFyYXRpb25zL3NyYy9pbmRleC5kLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBIn0=

package/dist/nixxie-cms-ai.cjs.js

@@ -1,16 +1,192 @@
-"use strict";
-// this file might look strange and you might be wondering what it's for
-// it's lets you import your source files by importing this entrypoint
-// as you would import it if it was built with preconstruct build
-// this file is slightly different to some others though
-// it has a require hook which compiles your code with Babel
-// this means that you don't have to set up @babel/register or anything like that
-// but you can still require this module and it'll be compiled
+'use strict';
 
-// this bit of code imports the require hook and registers it
-let unregister = require("../../../node_modules/.pnpm/@preconstruct+hook@0.4.0/node_modules/@preconstruct/hook").___internalHook(typeof __dirname === 'undefined' ? undefined : __dirname, "../../..", "..");
+Object.defineProperty(exports, '__esModule', { value: true });
 
-// this re-exports the source file
-module.exports = require("../src/index.ts");
+const DEFAULT_MODEL$1 = 'claude-opus-4-8';
+function loadAnthropic() {
+  try {
+    var _require$default;
+    return (_require$default = require('@anthropic-ai/sdk').default) !== null && _require$default !== void 0 ? _require$default : require('@anthropic-ai/sdk');
+  } catch {
+    throw new Error('The Anthropic provider requires @anthropic-ai/sdk. Run: npm install @anthropic-ai/sdk');
+  }
+}
 
-unregister();
+/** Anthropic (Claude) provider, backed by the official @anthropic-ai/sdk. */
+class AnthropicProvider {
+  constructor(config) {
+    var _config$model, _config$maxTokens;
+    this.config = config;
+    this.model = (_config$model = config.model) !== null && _config$model !== void 0 ? _config$model : DEFAULT_MODEL$1;
+    this.maxTokens = (_config$maxTokens = config.maxTokens) !== null && _config$maxTokens !== void 0 ? _config$maxTokens : 4096;
+    const Anthropic = loadAnthropic();
+    this.client = new Anthropic({
+      apiKey: config.apiKey,
+      baseURL: config.baseUrl
+    });
+  }
+  async complete(prompt, options) {
+    return this.chat([{
+      role: 'user',
+      content: prompt
+    }], options);
+  }
+  async chat(messages, options) {
+    var _options$model, _options$maxTokens, _response$content, _response$model, _response$usage, _response$usage2;
+    // Anthropic takes the system prompt as a top-level field, not a message.
+    const system = [options === null || options === void 0 ? void 0 : options.system, ...messages.filter(m => m.role === 'system').map(m => m.content)].filter(Boolean).join('\n\n');
+    const turns = messages.filter(m => m.role !== 'system').map(m => ({
+      role: m.role,
+      content: m.content
+    }));
+    const model = (_options$model = options === null || options === void 0 ? void 0 : options.model) !== null && _options$model !== void 0 ? _options$model : this.model;
+    const response = await this.client.messages.create({
+      model,
+      max_tokens: (_options$maxTokens = options === null || options === void 0 ? void 0 : options.maxTokens) !== null && _options$maxTokens !== void 0 ? _options$maxTokens : this.maxTokens,
+      system: system || undefined,
+      messages: turns,
+      ...((options === null || options === void 0 ? void 0 : options.temperature) !== undefined ? {
+        temperature: options.temperature
+      } : {})
+    });
+    const text = ((_response$content = response.content) !== null && _response$content !== void 0 ? _response$content : []).filter(block => block.type === 'text').map(block => block.text).join('');
+    return {
+      text,
+      model: (_response$model = response.model) !== null && _response$model !== void 0 ? _response$model : model,
+      usage: {
+        inputTokens: (_response$usage = response.usage) === null || _response$usage === void 0 ? void 0 : _response$usage.input_tokens,
+        outputTokens: (_response$usage2 = response.usage) === null || _response$usage2 === void 0 ? void 0 : _response$usage2.output_tokens
+      }
+    };
+  }
+  async embed(text) {
+    const [vector] = await this.embedMany([text]);
+    if (!vector) throw new Error('Embedding provider returned no vector');
+    return vector;
+  }
+  async embedMany(texts) {
+    var _this$config$embeddin, _data$data;
+    if (!this.config.voyageApiKey) {
+      throw new Error('Anthropic has no native embeddings endpoint. Set `voyageApiKey` to generate embeddings via Voyage AI, or use the OpenAI provider.');
+    }
+    const model = (_this$config$embeddin = this.config.embeddingModel) !== null && _this$config$embeddin !== void 0 ? _this$config$embeddin : 'voyage-3';
+    const res = await fetch('https://api.voyageai.com/v1/embeddings', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${this.config.voyageApiKey}`
+      },
+      body: JSON.stringify({
+        input: texts,
+        model
+      })
+    });
+    if (!res.ok) throw new Error(`Voyage embeddings failed (${res.status}): ${await res.text()}`);
+    const data = await res.json();
+    const items = (_data$data = data.data) !== null && _data$data !== void 0 ? _data$data : [];
+    if (items.length !== texts.length) {
+      throw new Error(`Voyage returned ${items.length} embeddings for ${texts.length} inputs`);
+    }
+    // The API does not guarantee response order matches input order — sort by `index`.
+    return items.slice().sort((a, b) => {
+      var _a$index, _b$index;
+      return ((_a$index = a.index) !== null && _a$index !== void 0 ? _a$index : 0) - ((_b$index = b.index) !== null && _b$index !== void 0 ? _b$index : 0);
+    }).map(d => d.embedding);
+  }
+}
+
+const DEFAULT_MODEL = 'gpt-4o';
+const DEFAULT_EMBEDDING_MODEL = 'text-embedding-3-small';
+function loadOpenAi() {
+  try {
+    var _require$default;
+    return (_require$default = require('openai').default) !== null && _require$default !== void 0 ? _require$default : require('openai');
+  } catch {
+    throw new Error('The OpenAI provider requires the openai package. Run: npm install openai');
+  }
+}
+
+/** OpenAI provider, backed by the official openai SDK. */
+class OpenAiProvider {
+  constructor(config) {
+    var _config$model, _config$maxTokens;
+    this.config = config;
+    this.model = (_config$model = config.model) !== null && _config$model !== void 0 ? _config$model : DEFAULT_MODEL;
+    this.maxTokens = (_config$maxTokens = config.maxTokens) !== null && _config$maxTokens !== void 0 ? _config$maxTokens : 4096;
+    const OpenAI = loadOpenAi();
+    this.client = new OpenAI({
+      apiKey: config.apiKey,
+      baseURL: config.baseUrl
+    });
+  }
+  async complete(prompt, options) {
+    return this.chat([{
+      role: 'user',
+      content: prompt
+    }], options);
+  }
+  async chat(messages, options) {
+    var _options$model, _options$maxTokens, _response$choices$0$m, _response$choices, _response$model, _response$usage, _response$usage2;
+    const allMessages = options !== null && options !== void 0 && options.system ? [{
+      role: 'system',
+      content: options.system
+    }, ...messages] : messages;
+    const model = (_options$model = options === null || options === void 0 ? void 0 : options.model) !== null && _options$model !== void 0 ? _options$model : this.model;
+    const response = await this.client.chat.completions.create({
+      model,
+      max_tokens: (_options$maxTokens = options === null || options === void 0 ? void 0 : options.maxTokens) !== null && _options$maxTokens !== void 0 ? _options$maxTokens : this.maxTokens,
+      messages: allMessages,
+      ...((options === null || options === void 0 ? void 0 : options.temperature) !== undefined ? {
+        temperature: options.temperature
+      } : {})
+    });
+    return {
+      text: (_response$choices$0$m = (_response$choices = response.choices) === null || _response$choices === void 0 || (_response$choices = _response$choices[0]) === null || _response$choices === void 0 || (_response$choices = _response$choices.message) === null || _response$choices === void 0 ? void 0 : _response$choices.content) !== null && _response$choices$0$m !== void 0 ? _response$choices$0$m : '',
+      model: (_response$model = response.model) !== null && _response$model !== void 0 ? _response$model : model,
+      usage: {
+        inputTokens: (_response$usage = response.usage) === null || _response$usage === void 0 ? void 0 : _response$usage.prompt_tokens,
+        outputTokens: (_response$usage2 = response.usage) === null || _response$usage2 === void 0 ? void 0 : _response$usage2.completion_tokens
+      }
+    };
+  }
+  async embed(text) {
+    const [vector] = await this.embedMany([text]);
+    if (!vector) throw new Error('Embedding provider returned no vector');
+    return vector;
+  }
+  async embedMany(texts) {
+    var _this$config$embeddin, _response$data;
+    const response = await this.client.embeddings.create({
+      model: (_this$config$embeddin = this.config.embeddingModel) !== null && _this$config$embeddin !== void 0 ? _this$config$embeddin : DEFAULT_EMBEDDING_MODEL,
+      input: texts
+    });
+    const items = (_response$data = response.data) !== null && _response$data !== void 0 ? _response$data : [];
+    if (items.length !== texts.length) {
+      throw new Error(`OpenAI returned ${items.length} embeddings for ${texts.length} inputs`);
+    }
+    // The API does not guarantee response order matches input order — sort by `index`.
+    return items.slice().sort((a, b) => {
+      var _a$index, _b$index;
+      return ((_a$index = a.index) !== null && _a$index !== void 0 ? _a$index : 0) - ((_b$index = b.index) !== null && _b$index !== void 0 ? _b$index : 0);
+    }).map(d => d.embedding);
+  }
+}
+
+function createAi(config) {
+  var _config$provider;
+  switch ((_config$provider = config.provider) !== null && _config$provider !== void 0 ? _config$provider : 'anthropic') {
+    case 'anthropic':
+      return new AnthropicProvider(config);
+    case 'openai':
+      return new OpenAiProvider(config);
+    default:
+      {
+        const exhaustive = config.provider;
+        throw new Error(`Unknown AI provider: ${exhaustive}`);
+      }
+  }
+}
+
+exports.AnthropicProvider = AnthropicProvider;
+exports.OpenAiProvider = OpenAiProvider;
+exports.createAi = createAi;

package/dist/nixxie-cms-ai.esm.js

@@ -0,0 +1,186 @@
+const DEFAULT_MODEL$1 = 'claude-opus-4-8';
+function loadAnthropic() {
+  try {
+    var _require$default;
+    return (_require$default = require('@anthropic-ai/sdk').default) !== null && _require$default !== void 0 ? _require$default : require('@anthropic-ai/sdk');
+  } catch {
+    throw new Error('The Anthropic provider requires @anthropic-ai/sdk. Run: npm install @anthropic-ai/sdk');
+  }
+}
+
+/** Anthropic (Claude) provider, backed by the official @anthropic-ai/sdk. */
+class AnthropicProvider {
+  constructor(config) {
+    var _config$model, _config$maxTokens;
+    this.config = config;
+    this.model = (_config$model = config.model) !== null && _config$model !== void 0 ? _config$model : DEFAULT_MODEL$1;
+    this.maxTokens = (_config$maxTokens = config.maxTokens) !== null && _config$maxTokens !== void 0 ? _config$maxTokens : 4096;
+    const Anthropic = loadAnthropic();
+    this.client = new Anthropic({
+      apiKey: config.apiKey,
+      baseURL: config.baseUrl
+    });
+  }
+  async complete(prompt, options) {
+    return this.chat([{
+      role: 'user',
+      content: prompt
+    }], options);
+  }
+  async chat(messages, options) {
+    var _options$model, _options$maxTokens, _response$content, _response$model, _response$usage, _response$usage2;
+    // Anthropic takes the system prompt as a top-level field, not a message.
+    const system = [options === null || options === void 0 ? void 0 : options.system, ...messages.filter(m => m.role === 'system').map(m => m.content)].filter(Boolean).join('\n\n');
+    const turns = messages.filter(m => m.role !== 'system').map(m => ({
+      role: m.role,
+      content: m.content
+    }));
+    const model = (_options$model = options === null || options === void 0 ? void 0 : options.model) !== null && _options$model !== void 0 ? _options$model : this.model;
+    const response = await this.client.messages.create({
+      model,
+      max_tokens: (_options$maxTokens = options === null || options === void 0 ? void 0 : options.maxTokens) !== null && _options$maxTokens !== void 0 ? _options$maxTokens : this.maxTokens,
+      system: system || undefined,
+      messages: turns,
+      ...((options === null || options === void 0 ? void 0 : options.temperature) !== undefined ? {
+        temperature: options.temperature
+      } : {})
+    });
+    const text = ((_response$content = response.content) !== null && _response$content !== void 0 ? _response$content : []).filter(block => block.type === 'text').map(block => block.text).join('');
+    return {
+      text,
+      model: (_response$model = response.model) !== null && _response$model !== void 0 ? _response$model : model,
+      usage: {
+        inputTokens: (_response$usage = response.usage) === null || _response$usage === void 0 ? void 0 : _response$usage.input_tokens,
+        outputTokens: (_response$usage2 = response.usage) === null || _response$usage2 === void 0 ? void 0 : _response$usage2.output_tokens
+      }
+    };
+  }
+  async embed(text) {
+    const [vector] = await this.embedMany([text]);
+    if (!vector) throw new Error('Embedding provider returned no vector');
+    return vector;
+  }
+  async embedMany(texts) {
+    var _this$config$embeddin, _data$data;
+    if (!this.config.voyageApiKey) {
+      throw new Error('Anthropic has no native embeddings endpoint. Set `voyageApiKey` to generate embeddings via Voyage AI, or use the OpenAI provider.');
+    }
+    const model = (_this$config$embeddin = this.config.embeddingModel) !== null && _this$config$embeddin !== void 0 ? _this$config$embeddin : 'voyage-3';
+    const res = await fetch('https://api.voyageai.com/v1/embeddings', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${this.config.voyageApiKey}`
+      },
+      body: JSON.stringify({
+        input: texts,
+        model
+      })
+    });
+    if (!res.ok) throw new Error(`Voyage embeddings failed (${res.status}): ${await res.text()}`);
+    const data = await res.json();
+    const items = (_data$data = data.data) !== null && _data$data !== void 0 ? _data$data : [];
+    if (items.length !== texts.length) {
+      throw new Error(`Voyage returned ${items.length} embeddings for ${texts.length} inputs`);
+    }
+    // The API does not guarantee response order matches input order — sort by `index`.
+    return items.slice().sort((a, b) => {
+      var _a$index, _b$index;
+      return ((_a$index = a.index) !== null && _a$index !== void 0 ? _a$index : 0) - ((_b$index = b.index) !== null && _b$index !== void 0 ? _b$index : 0);
+    }).map(d => d.embedding);
+  }
+}
+
+const DEFAULT_MODEL = 'gpt-4o';
+const DEFAULT_EMBEDDING_MODEL = 'text-embedding-3-small';
+function loadOpenAi() {
+  try {
+    var _require$default;
+    return (_require$default = require('openai').default) !== null && _require$default !== void 0 ? _require$default : require('openai');
+  } catch {
+    throw new Error('The OpenAI provider requires the openai package. Run: npm install openai');
+  }
+}
+
+/** OpenAI provider, backed by the official openai SDK. */
+class OpenAiProvider {
+  constructor(config) {
+    var _config$model, _config$maxTokens;
+    this.config = config;
+    this.model = (_config$model = config.model) !== null && _config$model !== void 0 ? _config$model : DEFAULT_MODEL;
+    this.maxTokens = (_config$maxTokens = config.maxTokens) !== null && _config$maxTokens !== void 0 ? _config$maxTokens : 4096;
+    const OpenAI = loadOpenAi();
+    this.client = new OpenAI({
+      apiKey: config.apiKey,
+      baseURL: config.baseUrl
+    });
+  }
+  async complete(prompt, options) {
+    return this.chat([{
+      role: 'user',
+      content: prompt
+    }], options);
+  }
+  async chat(messages, options) {
+    var _options$model, _options$maxTokens, _response$choices$0$m, _response$choices, _response$model, _response$usage, _response$usage2;
+    const allMessages = options !== null && options !== void 0 && options.system ? [{
+      role: 'system',
+      content: options.system
+    }, ...messages] : messages;
+    const model = (_options$model = options === null || options === void 0 ? void 0 : options.model) !== null && _options$model !== void 0 ? _options$model : this.model;
+    const response = await this.client.chat.completions.create({
+      model,
+      max_tokens: (_options$maxTokens = options === null || options === void 0 ? void 0 : options.maxTokens) !== null && _options$maxTokens !== void 0 ? _options$maxTokens : this.maxTokens,
+      messages: allMessages,
+      ...((options === null || options === void 0 ? void 0 : options.temperature) !== undefined ? {
+        temperature: options.temperature
+      } : {})
+    });
+    return {
+      text: (_response$choices$0$m = (_response$choices = response.choices) === null || _response$choices === void 0 || (_response$choices = _response$choices[0]) === null || _response$choices === void 0 || (_response$choices = _response$choices.message) === null || _response$choices === void 0 ? void 0 : _response$choices.content) !== null && _response$choices$0$m !== void 0 ? _response$choices$0$m : '',
+      model: (_response$model = response.model) !== null && _response$model !== void 0 ? _response$model : model,
+      usage: {
+        inputTokens: (_response$usage = response.usage) === null || _response$usage === void 0 ? void 0 : _response$usage.prompt_tokens,
+        outputTokens: (_response$usage2 = response.usage) === null || _response$usage2 === void 0 ? void 0 : _response$usage2.completion_tokens
+      }
+    };
+  }
+  async embed(text) {
+    const [vector] = await this.embedMany([text]);
+    if (!vector) throw new Error('Embedding provider returned no vector');
+    return vector;
+  }
+  async embedMany(texts) {
+    var _this$config$embeddin, _response$data;
+    const response = await this.client.embeddings.create({
+      model: (_this$config$embeddin = this.config.embeddingModel) !== null && _this$config$embeddin !== void 0 ? _this$config$embeddin : DEFAULT_EMBEDDING_MODEL,
+      input: texts
+    });
+    const items = (_response$data = response.data) !== null && _response$data !== void 0 ? _response$data : [];
+    if (items.length !== texts.length) {
+      throw new Error(`OpenAI returned ${items.length} embeddings for ${texts.length} inputs`);
+    }
+    // The API does not guarantee response order matches input order — sort by `index`.
+    return items.slice().sort((a, b) => {
+      var _a$index, _b$index;
+      return ((_a$index = a.index) !== null && _a$index !== void 0 ? _a$index : 0) - ((_b$index = b.index) !== null && _b$index !== void 0 ? _b$index : 0);
+    }).map(d => d.embedding);
+  }
+}
+
+function createAi(config) {
+  var _config$provider;
+  switch ((_config$provider = config.provider) !== null && _config$provider !== void 0 ? _config$provider : 'anthropic') {
+    case 'anthropic':
+      return new AnthropicProvider(config);
+    case 'openai':
+      return new OpenAiProvider(config);
+    default:
+      {
+        const exhaustive = config.provider;
+        throw new Error(`Unknown AI provider: ${exhaustive}`);
+      }
+  }
+}
+
+export { AnthropicProvider, OpenAiProvider, createAi };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nixxie-cms/ai",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "license": "MIT",
   "main": "dist/nixxie-cms-ai.cjs.js",
   "module": "dist/nixxie-cms-ai.esm.js",
@@ -16,10 +16,10 @@
     "@babel/runtime": "^7.24.7"
   },
   "devDependencies": {
-    "@nixxie-cms/core": "^1.0.0"
+    "@nixxie-cms/core": "^1.0.1"
   },
   "peerDependencies": {
-    "@nixxie-cms/core": "^1.0.0"
+    "@nixxie-cms/core": "^1.0.1"
   },
   "optionalDependencies": {
     "@anthropic-ai/sdk": "^0.69.0",