@krutai/ai-provider 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,248 @@
+import * as _openrouter_sdk_lib_event_streams_js from '@openrouter/sdk/lib/event-streams.js';
+import * as _openrouter_sdk_models from '@openrouter/sdk/models';
+import { OpenRouter } from '@openrouter/sdk';
+
+/**
+ * Types for @krutai/ai-provider
+ */
+/**
+ * Default model used when no model is specified
+ */
+declare const DEFAULT_MODEL: "qwen/qwen3-235b-a22b-thinking-2507";
+/**
+ * Configuration options for KrutAIProvider
+ */
+interface KrutAIProviderConfig {
+    /**
+     * KrutAI API key for service validation.
+     * @required
+     */
+    apiKey: string;
+    /**
+     * OpenRouter API key.
+     * Falls back to process.env.OPENROUTER_API_KEY if not provided.
+     */
+    openRouterApiKey?: string;
+    /**
+     * The AI model to use.
+     * @default "qwen/qwen3-235b-a22b-thinking-2507"
+     * @see https://openrouter.ai/models
+     */
+    model?: string;
+    /**
+     * Whether to validate the OpenRouter API key on initialization.
+     * @default true
+     */
+    validateOnInit?: boolean;
+    /**
+     * Custom POST endpoint for OpenRouter API key validation.
+     * Will be wired in once you deploy the route.
+     */
+    validationEndpoint?: string;
+}
+/**
+ * A single chat message (OpenRouter format)
+ */
+interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+/**
+ * Options for a single generate / stream call
+ */
+interface GenerateOptions {
+    /**
+     * Override the model for this specific call.
+     */
+    model?: string;
+    /**
+     * System prompt (prepended as a system message).
+     */
+    system?: string;
+    /**
+     * Maximum tokens to generate.
+     */
+    maxTokens?: number;
+    /**
+     * Temperature (0–2).
+     */
+    temperature?: number;
+}
+
+/**
+ * OpenRouter API Key Validator
+ *
+ * Validates the OpenRouter API key format and (optionally) its validity
+ * via a configurable POST endpoint.
+ *
+ * The user will later provide a live POST route; until then the
+ * service-level check is a placeholder that accepts any well-formed key.
+ */
+declare class OpenRouterKeyValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates the format of an OpenRouter API key.
+ * @throws {OpenRouterKeyValidationError}
+ */
+declare function validateOpenRouterKeyFormat(apiKey: string): void;
+/**
+ * Validates the OpenRouter API key with the KrutAI validation service.
+ *
+ * The user will provide a live POST route later. Until then this is a
+ * placeholder that accepts any key that passes format validation.
+ *
+ * @param apiKey - OpenRouter API key to validate
+ * @param validationEndpoint - Optional POST URL to validate against
+ */
+declare function validateOpenRouterKeyWithService(apiKey: string, validationEndpoint?: string): Promise<boolean>;
+
+/**
+ * KrutAIProvider — AI provider for KrutAI
+ *
+ * Wraps `@openrouter/sdk` and adds:
+ *  - OpenRouter API key format validation
+ *  - Configurable default model (defaults to qwen/qwen3-235b-a22b-thinking-2507)
+ *  - Optional pluggable validation endpoint
+ *
+ * @example
+ * ```typescript
+ * import { KrutAIProvider } from '@krutai/ai-provider';
+ *
+ * const ai = new KrutAIProvider({
+ *   apiKey: process.env.KRUTAI_API_KEY!,
+ *   openRouterApiKey: process.env.OPENROUTER_API_KEY!, // or set in env
+ * });
+ *
+ * await ai.initialize();
+ *
+ * const text = await ai.generate('Tell me a joke');
+ * console.log(text);
+ * ```
+ */
+declare class KrutAIProvider {
+    private readonly resolvedOpenRouterKey;
+    private readonly resolvedModel;
+    private readonly config;
+    private openRouterClient;
+    private initialized;
+    constructor(config: KrutAIProviderConfig);
+    /**
+     * Initialize the provider.
+     * Validates the OpenRouter API key (optionally against a service endpoint)
+     * and sets up the underlying OpenRouter client.
+     *
+     * @throws {OpenRouterKeyValidationError}
+     */
+    initialize(): Promise<void>;
+    /** @private */
+    private setupClient;
+    /**
+     * Get the raw OpenRouter SDK client instance.
+     * @throws {Error} If not initialized
+     */
+    getClient(): OpenRouter;
+    /**
+     * Get the currently configured default model.
+     */
+    getModel(): string;
+    /**
+     * Check whether the provider has been initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Generate a response for a prompt (non-streaming).
+     *
+     * @param prompt - The user prompt string
+     * @param options - Optional overrides (model, system, maxTokens, temperature)
+     * @returns The assistant's response text
+     */
+    generate(prompt: string, options?: GenerateOptions): Promise<string>;
+    /**
+     * Generate a streaming response for a prompt.
+     *
+     * @param prompt - The user prompt string
+     * @param options - Optional overrides (model, system, maxTokens, temperature)
+     * @returns An async iterable of server-sent event chunks
+     *
+     * @example
+     * ```typescript
+     * const stream = await ai.stream('Tell me a story');
+     * for await (const chunk of stream) {
+     *   process.stdout.write(chunk.choices?.[0]?.delta?.content ?? '');
+     * }
+     * ```
+     */
+    stream(prompt: string, options?: GenerateOptions): Promise<_openrouter_sdk_lib_event_streams_js.EventStream<_openrouter_sdk_models.ChatStreamingResponseChunkData>>;
+    /**
+     * Multi-turn conversation: pass a full message history.
+     *
+     * @param messages - Full conversation history
+     * @param options - Optional overrides (model, maxTokens, temperature)
+     */
+    chat(messages: ChatMessage[], options?: GenerateOptions): Promise<string>;
+}
+
+/**
+ * @krutai/ai-provider — AI Provider package for KrutAI
+ *
+ * A thin wrapper around `@openrouter/sdk`, mirroring the patterns from `@krutai/auth`.
+ *
+ * Default model: `qwen/qwen3-235b-a22b-thinking-2507`
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { krutAI } from '@krutai/ai-provider';
+ *
+ * const ai = krutAI(); // uses OPENROUTER_API_KEY env var
+ * await ai.initialize();
+ *
+ * const text = await ai.generate('Write a poem about TypeScript');
+ * console.log(text);
+ * ```
+ *
+ * @example With custom model
+ * ```typescript
+ * const ai = krutAI({ model: 'openai/gpt-4o' });
+ * await ai.initialize();
+ * const text = await ai.generate('Hello!');
+ * ```
+ *
+ * @example Streaming
+ * ```typescript
+ * const ai = krutAI();
+ * await ai.initialize();
+ *
+ * const stream = await ai.stream('Tell me a story');
+ * for await (const chunk of stream) {
+ *   process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * krutAI — convenience factory (mirrors `krutAuth` in @krutai/auth).
+ *
+ * Creates a `KrutAIProvider` instance. OpenRouter API key is read from
+ * `config.openRouterApiKey` or falls back to `process.env.OPENROUTER_API_KEY`.
+ *
+ * @param config - Provider configuration (all fields optional except apiKey)
+ * @returns A `KrutAIProvider` instance (call `.initialize()` before use)
+ *
+ * @example
+ * ```typescript
+ * import { krutAI } from '@krutai/ai-provider';
+ *
+ * const ai = krutAI(); // env OPENROUTER_API_KEY + default model
+ * await ai.initialize();
+ * const text = await ai.generate('Hello!');
+ * ```
+ */
+declare function krutAI(config?: Partial<KrutAIProviderConfig> & {
+    apiKey?: string;
+}): KrutAIProvider;
+declare const VERSION = "0.1.0";
+
+export { type ChatMessage, DEFAULT_MODEL, type GenerateOptions, KrutAIProvider, type KrutAIProviderConfig, OpenRouterKeyValidationError, VERSION, krutAI, validateOpenRouterKeyFormat, validateOpenRouterKeyWithService };

package/dist/index.js

@@ -0,0 +1,231 @@
+'use strict';
+
+var sdk = require('@openrouter/sdk');
+
+// src/types.ts
+var DEFAULT_MODEL = "qwen/qwen3-235b-a22b-thinking-2507";
+
+// src/validator.ts
+var OpenRouterKeyValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OpenRouterKeyValidationError";
+  }
+};
+var OPENROUTER_KEY_PREFIX = "sk-or-v1-";
+var OPENROUTER_KEY_MIN_LENGTH = 20;
+function validateOpenRouterKeyFormat(apiKey) {
+  if (!apiKey || typeof apiKey !== "string") {
+    throw new OpenRouterKeyValidationError("OpenRouter API key must be a non-empty string");
+  }
+  if (apiKey.trim().length === 0) {
+    throw new OpenRouterKeyValidationError("OpenRouter API key cannot be empty or whitespace");
+  }
+  if (!apiKey.startsWith(OPENROUTER_KEY_PREFIX)) {
+    throw new OpenRouterKeyValidationError(
+      `OpenRouter API key must start with "${OPENROUTER_KEY_PREFIX}"`
+    );
+  }
+  if (apiKey.length < OPENROUTER_KEY_MIN_LENGTH) {
+    throw new OpenRouterKeyValidationError(
+      `OpenRouter API key must be at least ${OPENROUTER_KEY_MIN_LENGTH} characters long`
+    );
+  }
+}
+async function validateOpenRouterKeyWithService(apiKey, validationEndpoint) {
+  validateOpenRouterKeyFormat(apiKey);
+  if (validationEndpoint) {
+    try {
+      const response = await fetch(validationEndpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ apiKey })
+      });
+      if (!response.ok) {
+        throw new OpenRouterKeyValidationError(
+          `OpenRouter API key validation failed: HTTP ${response.status}`
+        );
+      }
+      const data = await response.json();
+      if (data.valid === false) {
+        throw new OpenRouterKeyValidationError(
+          "OpenRouter API key rejected by validation service"
+        );
+      }
+      return true;
+    } catch (error) {
+      if (error instanceof OpenRouterKeyValidationError) throw error;
+      throw new OpenRouterKeyValidationError(
+        `Failed to reach validation endpoint: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+  return true;
+}
+
+// src/client.ts
+var KrutAIProvider = class {
+  resolvedOpenRouterKey;
+  resolvedModel;
+  config;
+  openRouterClient = null;
+  initialized = false;
+  constructor(config) {
+    this.config = config;
+    this.resolvedOpenRouterKey = config.openRouterApiKey ?? process.env.OPENROUTER_API_KEY ?? "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";
+    this.resolvedModel = config.model ?? DEFAULT_MODEL;
+    validateOpenRouterKeyFormat(this.resolvedOpenRouterKey);
+    if (config.validateOnInit === false) {
+      this.setupClient();
+    }
+  }
+  /**
+   * Initialize the provider.
+   * Validates the OpenRouter API key (optionally against a service endpoint)
+   * and sets up the underlying OpenRouter client.
+   *
+   * @throws {OpenRouterKeyValidationError}
+   */
+  async initialize() {
+    if (this.initialized) return;
+    if (this.config.validateOnInit !== false) {
+      await validateOpenRouterKeyWithService(
+        this.resolvedOpenRouterKey,
+        this.config.validationEndpoint
+      );
+    }
+    this.setupClient();
+    this.initialized = true;
+  }
+  /** @private */
+  setupClient() {
+    this.openRouterClient = new sdk.OpenRouter({
+      apiKey: this.resolvedOpenRouterKey
+    });
+  }
+  /**
+   * Get the raw OpenRouter SDK client instance.
+   * @throws {Error} If not initialized
+   */
+  getClient() {
+    if (!this.openRouterClient) {
+      throw new Error(
+        "KrutAIProvider not initialized. Call initialize() first or set validateOnInit to false."
+      );
+    }
+    return this.openRouterClient;
+  }
+  /**
+   * Get the currently configured default model.
+   */
+  getModel() {
+    return this.resolvedModel;
+  }
+  /**
+   * Check whether the provider has been initialized.
+   */
+  isInitialized() {
+    return this.initialized;
+  }
+  /**
+   * Generate a response for a prompt (non-streaming).
+   *
+   * @param prompt - The user prompt string
+   * @param options - Optional overrides (model, system, maxTokens, temperature)
+   * @returns The assistant's response text
+   */
+  async generate(prompt, options = {}) {
+    const client = this.getClient();
+    const model = options.model ?? this.resolvedModel;
+    const messages = [];
+    if (options.system) {
+      messages.push({ role: "system", content: options.system });
+    }
+    messages.push({ role: "user", content: prompt });
+    const result = await client.chat.send({
+      chatGenerationParams: {
+        model,
+        messages,
+        stream: false,
+        ...options.maxTokens !== void 0 ? { maxTokens: options.maxTokens } : {},
+        ...options.temperature !== void 0 ? { temperature: options.temperature } : {}
+      }
+    });
+    const response = result;
+    return response.choices?.[0]?.message?.content ?? "";
+  }
+  /**
+   * Generate a streaming response for a prompt.
+   *
+   * @param prompt - The user prompt string
+   * @param options - Optional overrides (model, system, maxTokens, temperature)
+   * @returns An async iterable of server-sent event chunks
+   *
+   * @example
+   * ```typescript
+   * const stream = await ai.stream('Tell me a story');
+   * for await (const chunk of stream) {
+   *   process.stdout.write(chunk.choices?.[0]?.delta?.content ?? '');
+   * }
+   * ```
+   */
+  async stream(prompt, options = {}) {
+    const client = this.getClient();
+    const model = options.model ?? this.resolvedModel;
+    const messages = [];
+    if (options.system) {
+      messages.push({ role: "system", content: options.system });
+    }
+    messages.push({ role: "user", content: prompt });
+    return client.chat.send({
+      chatGenerationParams: {
+        model,
+        messages,
+        stream: true,
+        ...options.maxTokens !== void 0 ? { maxTokens: options.maxTokens } : {},
+        ...options.temperature !== void 0 ? { temperature: options.temperature } : {}
+      }
+    });
+  }
+  /**
+   * Multi-turn conversation: pass a full message history.
+   *
+   * @param messages - Full conversation history
+   * @param options - Optional overrides (model, maxTokens, temperature)
+   */
+  async chat(messages, options = {}) {
+    const client = this.getClient();
+    const model = options.model ?? this.resolvedModel;
+    const result = await client.chat.send({
+      chatGenerationParams: {
+        model,
+        messages,
+        stream: false,
+        ...options.maxTokens !== void 0 ? { maxTokens: options.maxTokens } : {},
+        ...options.temperature !== void 0 ? { temperature: options.temperature } : {}
+      }
+    });
+    const response = result;
+    return response.choices?.[0]?.message?.content ?? "";
+  }
+};
+
+// src/index.ts
+function krutAI(config = {}) {
+  return new KrutAIProvider({
+    apiKey: config.apiKey ?? "krutai-internal",
+    model: config.model ?? DEFAULT_MODEL,
+    ...config
+  });
+}
+var VERSION = "0.1.0";
+
+exports.DEFAULT_MODEL = DEFAULT_MODEL;
+exports.KrutAIProvider = KrutAIProvider;
+exports.OpenRouterKeyValidationError = OpenRouterKeyValidationError;
+exports.VERSION = VERSION;
+exports.krutAI = krutAI;
+exports.validateOpenRouterKeyFormat = validateOpenRouterKeyFormat;
+exports.validateOpenRouterKeyWithService = validateOpenRouterKeyWithService;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/validator.ts","../src/client.ts","../src/index.ts"],"names":["OpenRouter"],"mappings":";;;;;AAOO,IAAM,aAAA,GAAgB;;;ACGtB,IAAM,4BAAA,GAAN,cAA2C,KAAA,CAAM;AAAA,EACpD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,8BAAA;AAAA,EAChB;AACJ;AAKA,IAAM,qBAAA,GAAwB,WAAA;AAC9B,IAAM,yBAAA,GAA4B,EAAA;AAM3B,SAAS,4BAA4B,MAAA,EAAsB;AAC9D,EAAA,IAAI,CAAC,MAAA,IAAU,OAAO,MAAA,KAAW,QAAA,EAAU;AACvC,IAAA,MAAM,IAAI,6BAA6B,+CAA+C,CAAA;AAAA,EAC1F;AAEA,EAAA,IAAI,MAAA,CAAO,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,EAAG;AAC5B,IAAA,MAAM,IAAI,6BAA6B,kDAAkD,CAAA;AAAA,EAC7F;AAEA,EAAA,IAAI,CAAC,MAAA,CAAO,UAAA,CAAW,qBAAqB,CAAA,EAAG;AAC3C,IAAA,MAAM,IAAI,4BAAA;AAAA,MACN,uCAAuC,qBAAqB,CAAA,CAAA;AAAA,KAChE;AAAA,EACJ;AAEA,EAAA,IAAI,MAAA,CAAO,SAAS,yBAAA,EAA2B;AAC3C,IAAA,MAAM,IAAI,4BAAA;AAAA,MACN,uCAAuC,yBAAyB,CAAA,gBAAA;AAAA,KACpE;AAAA,EACJ;AACJ;AAWA,eAAsB,gCAAA,CAClB,QACA,kBAAA,EACgB;AAEhB,EAAA,2BAAA,CAA4B,MAAM,CAAA;AAElC,EAAA,IAAI,kBAAA,EAAoB;AACpB,IAAA,IAAI;AACA,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,kBAAA,EAAoB;AAAA,QAC7C,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,QAC9C,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,EAAE,QAAQ;AAAA,OAClC,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,QAAA,MAAM,IAAI,4BAAA;AAAA,UACN,CAAA,2CAAA,EAA8C,SAAS,MAAM,CAAA;AAAA,SACjE;AAAA,MACJ;AAEA,MAAA,MAAM,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAClC,MAAA,IAAI,IAAA,CAAK,UAAU,KAAA,EAAO;AACtB,QAAA,MAAM,IAAI,4BAAA;AAAA,UACN;AAAA,SACJ;AAAA,MACJ;AAEA,MAAA,OAAO,IAAA;AAAA,IACX,SAAS,KAAA,EAAO;AACZ,MAAA,IAAI,KAAA,YAAiB,8BAA8B,MAAM,KAAA;AACzD,MAAA,MAAM,IAAI,4BAAA;AAAA,QACN,CAAA,qCAAA,EAAwC,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,eAAe,CAAA;AAAA,OACpG;AAAA,IACJ;AAAA,EACJ;AAIA,EAAA,OAAO,IAAA;AACX;;;AChEO,IAAM,iBAAN,MAAqB;AAAA,EACP,qBAAA;AAAA,EACA,aAAA;AAAA,EACA,MAAA;AAAA,EAET,gBAAA,GAAsC,IAAA;AAAA,EACtC,WAAA,GAAc,KAAA;AAAA,EAEtB,YAAY,MAAA,EAA8B;AACtC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAId,IAAA,IAAA,CAAK,qBAAA,GACD,MAAA,CAAO,gBAAA,IACP,OAAA,CAAQ,IAAI,kBAAA,IACZ,2EAAA;AAEJ,IAAA,IAAA,CAAK,aAAA,GAAgB,OAAO,KAAA,IAAS,aAAA;AAGrC,IAAA,2BAAA,CAA4B,KAAK,qBAAqB,CAAA;AAGtD,IAAA,IAAI,MAAA,CAAO,mBAAmB,KAAA,EAAO;AACjC,MAAA,IAAA,CAAK,WAAA,EAAY;AAAA,IACrB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,UAAA,GAA4B;AAC9B,IAAA,IAAI,KAAK,WAAA,EAAa;AAEtB,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,cAAA,KAAmB,KAAA,EAAO;AACtC,MAAA,MAAM,gCAAA;AAAA,QACF,IAAA,CAAK,qBAAA;AAAA,QACL,KAAK,MAAA,CAAO;AAAA,OAChB;AAAA,IACJ;AAEA,IAAA,IAAA,CAAK,WAAA,EAAY;AACjB,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AAAA,EACvB;AAAA;AAAA,EAGQ,WAAA,GAAoB;AACxB,IAAA,IAAA,CAAK,gBAAA,GAAmB,IAAIA,cAAA,CAAW;AAAA,MACnC,QAAQ,IAAA,CAAK;AAAA,KAChB,CAAA;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAA,GAAwB;AACpB,IAAA,IAAI,CAAC,KAAK,gBAAA,EAAkB;AACxB,MAAA,MAAM,IAAI,KAAA;AAAA,QACN;AAAA,OACJ;AAAA,IACJ;AACA,IAAA,OAAO,IAAA,CAAK,gBAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAAmB;AACf,IAAA,OAAO,IAAA,CAAK,aAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAA,GAAyB;AACrB,IAAA,OAAO,IAAA,CAAK,WAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAA,CAAS,MAAA,EAAgB,OAAA,GAA2B,EAAC,EAAoB;AAC3E,IAAA,MAAM,MAAA,GAAS,KAAK,SAAA,EAAU;AAC9B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,IAAS,IAAA,CAAK,aAAA;AAEpC,IAAA,MAAM,WAA0B,EAAC;AACjC,IAAA,IAAI,QAAQ,MAAA,EAAQ;AAChB,MAAA,QAAA,CAAS,KAAK,EAAE,IAAA,EAAM,UAAU,OAAA,EAAS,OAAA,CAAQ,QAAQ,CAAA;AAAA,IAC7D;AACA,IAAA,QAAA,CAAS,KAAK,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,QAAQ,CAAA;AAE/C,IAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,IAAA,CAAK,IAAA,CAAK;AAAA,MAClC,oBAAA,EAAsB;AAAA,QAClB,KAAA;AAAA,QACA,QAAA;AAAA,QACA,MAAA,EAAQ,KAAA;AAAA,QACR,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,QAC1E,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY,GAAI;AAAC;AACpF,KACH,CAAA;AAGD,IAAA,MAAM,QAAA,GAAW,MAAA;AACjB,IAAA,OAAO,QAAA,CAAS,OAAA,GAAU,CAAC,CAAA,EAAG,SAAS,OAAA,IAAW,EAAA;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAM,MAAA,CAAO,MAAA,EAAgB,OAAA,GAA2B,EAAC,EAAG;AACxD,IAAA,MAAM,MAAA,GAAS,KAAK,SAAA,EAAU;AAC9B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,IAAS,IAAA,CAAK,aAAA;AAEpC,IAAA,MAAM,WAA0B,EAAC;AACjC,IAAA,IAAI,QAAQ,MAAA,EAAQ;AAChB,MAAA,QAAA,CAAS,KAAK,EAAE,IAAA,EAAM,UAAU,OAAA,EAAS,OAAA,CAAQ,QAAQ,CAAA;AAAA,IAC7D;AACA,IAAA,QAAA,CAAS,KAAK,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,QAAQ,CAAA;AAE/C,IAAA,OAAO,MAAA,CAAO,KAAK,IAAA,CAAK;AAAA,MACpB,oBAAA,EAAsB;AAAA,QAClB,KAAA;AAAA,QACA,QAAA;AAAA,QACA,MAAA,EAAQ,IAAA;AAAA,QACR,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,QAC1E,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY,GAAI;AAAC;AACpF,KACH,CAAA;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAA,CAAK,QAAA,EAAyB,OAAA,GAA2B,EAAC,EAAoB;AAChF,IAAA,MAAM,MAAA,GAAS,KAAK,SAAA,EAAU;AAC9B,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,IAAS,IAAA,CAAK,aAAA;AAEpC,IAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,IAAA,CAAK,IAAA,CAAK;AAAA,MAClC,oBAAA,EAAsB;AAAA,QAClB,KAAA;AAAA,QACA,QAAA;AAAA,QACA,MAAA,EAAQ,KAAA;AAAA,QACR,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU,GAAI,EAAC;AAAA,QAC1E,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY,GAAI;AAAC;AACpF,KACH,CAAA;AAED,IAAA,MAAM,QAAA,GAAW,MAAA;AACjB,IAAA,OAAO,QAAA,CAAS,OAAA,GAAU,CAAC,CAAA,EAAG,SAAS,OAAA,IAAW,EAAA;AAAA,EACtD;AACJ;;;AC3IO,SAAS,MAAA,CACZ,MAAA,GAA8D,EAAC,EACjD;AACd,EAAA,OAAO,IAAI,cAAA,CAAe;AAAA,IACtB,MAAA,EAAQ,OAAO,MAAA,IAAU,iBAAA;AAAA,IACzB,KAAA,EAAO,OAAO,KAAA,IAAS,aAAA;AAAA,IACvB,GAAG;AAAA,GACN,CAAA;AACL;AAGO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["/**\n * Types for @krutai/ai-provider\n */\n\n/**\n * Default model used when no model is specified\n */\nexport const DEFAULT_MODEL = 'qwen/qwen3-235b-a22b-thinking-2507' as const;\n\n/**\n * Configuration options for KrutAIProvider\n */\nexport interface KrutAIProviderConfig {\n    /**\n     * KrutAI API key for service validation.\n     * @required\n     */\n    apiKey: string;\n\n    /**\n     * OpenRouter API key.\n     * Falls back to process.env.OPENROUTER_API_KEY if not provided.\n     */\n    openRouterApiKey?: string;\n\n    /**\n     * The AI model to use.\n     * @default \"qwen/qwen3-235b-a22b-thinking-2507\"\n     * @see https://openrouter.ai/models\n     */\n    model?: string;\n\n    /**\n     * Whether to validate the OpenRouter API key on initialization.\n     * @default true\n     */\n    validateOnInit?: boolean;\n\n    /**\n     * Custom POST endpoint for OpenRouter API key validation.\n     * Will be wired in once you deploy the route.\n     */\n    validationEndpoint?: string;\n}\n\n/**\n * A single chat message (OpenRouter format)\n */\nexport interface ChatMessage {\n    role: 'user' | 'assistant' | 'system';\n    content: string;\n}\n\n/**\n * Options for a single generate / stream call\n */\nexport interface GenerateOptions {\n    /**\n     * Override the model for this specific call.\n     */\n    model?: string;\n\n    /**\n     * System prompt (prepended as a system message).\n     */\n    system?: string;\n\n    /**\n     * Maximum tokens to generate.\n     */\n    maxTokens?: number;\n\n    /**\n     * Temperature (0–2).\n     */\n    temperature?: number;\n}\n","/**\n * OpenRouter API Key Validator\n *\n * Validates the OpenRouter API key format and (optionally) its validity\n * via a configurable POST endpoint.\n *\n * The user will later provide a live POST route; until then the\n * service-level check is a placeholder that accepts any well-formed key.\n */\n\nexport class OpenRouterKeyValidationError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = 'OpenRouterKeyValidationError';\n    }\n}\n\n/**\n * OpenRouter API keys start with \"sk-or-v1-\"\n */\nconst OPENROUTER_KEY_PREFIX = 'sk-or-v1-';\nconst OPENROUTER_KEY_MIN_LENGTH = 20;\n\n/**\n * Validates the format of an OpenRouter API key.\n * @throws {OpenRouterKeyValidationError}\n */\nexport function validateOpenRouterKeyFormat(apiKey: string): void {\n    if (!apiKey || typeof apiKey !== 'string') {\n        throw new OpenRouterKeyValidationError('OpenRouter API key must be a non-empty string');\n    }\n\n    if (apiKey.trim().length === 0) {\n        throw new OpenRouterKeyValidationError('OpenRouter API key cannot be empty or whitespace');\n    }\n\n    if (!apiKey.startsWith(OPENROUTER_KEY_PREFIX)) {\n        throw new OpenRouterKeyValidationError(\n            `OpenRouter API key must start with \"${OPENROUTER_KEY_PREFIX}\"`\n        );\n    }\n\n    if (apiKey.length < OPENROUTER_KEY_MIN_LENGTH) {\n        throw new OpenRouterKeyValidationError(\n            `OpenRouter API key must be at least ${OPENROUTER_KEY_MIN_LENGTH} characters long`\n        );\n    }\n}\n\n/**\n * Validates the OpenRouter API key with the KrutAI validation service.\n *\n * The user will provide a live POST route later. Until then this is a\n * placeholder that accepts any key that passes format validation.\n *\n * @param apiKey - OpenRouter API key to validate\n * @param validationEndpoint - Optional POST URL to validate against\n */\nexport async function validateOpenRouterKeyWithService(\n    apiKey: string,\n    validationEndpoint?: string\n): Promise<boolean> {\n    // Always validate format first\n    validateOpenRouterKeyFormat(apiKey);\n\n    if (validationEndpoint) {\n        try {\n            const response = await fetch(validationEndpoint, {\n                method: 'POST',\n                headers: { 'Content-Type': 'application/json' },\n                body: JSON.stringify({ apiKey }),\n            });\n\n            if (!response.ok) {\n                throw new OpenRouterKeyValidationError(\n                    `OpenRouter API key validation failed: HTTP ${response.status}`\n                );\n            }\n\n            const data = (await response.json()) as { valid?: boolean };\n            if (data.valid === false) {\n                throw new OpenRouterKeyValidationError(\n                    'OpenRouter API key rejected by validation service'\n                );\n            }\n\n            return true;\n        } catch (error) {\n            if (error instanceof OpenRouterKeyValidationError) throw error;\n            throw new OpenRouterKeyValidationError(\n                `Failed to reach validation endpoint: ${error instanceof Error ? error.message : 'Unknown error'}`\n            );\n        }\n    }\n\n    // TODO: Replace with live endpoint once provided\n    // Placeholder — accepts any correctly-formatted key\n    return true;\n}\n","import { OpenRouter } from '@openrouter/sdk';\nimport type { KrutAIProviderConfig, GenerateOptions, ChatMessage } from './types';\nimport { DEFAULT_MODEL } from './types';\nimport {\n    validateOpenRouterKeyFormat,\n    validateOpenRouterKeyWithService,\n    OpenRouterKeyValidationError,\n} from './validator';\n\nexport { OpenRouterKeyValidationError };\n\n/**\n * KrutAIProvider — AI provider for KrutAI\n *\n * Wraps `@openrouter/sdk` and adds:\n *  - OpenRouter API key format validation\n *  - Configurable default model (defaults to qwen/qwen3-235b-a22b-thinking-2507)\n *  - Optional pluggable validation endpoint\n *\n * @example\n * ```typescript\n * import { KrutAIProvider } from '@krutai/ai-provider';\n *\n * const ai = new KrutAIProvider({\n *   apiKey: process.env.KRUTAI_API_KEY!,\n *   openRouterApiKey: process.env.OPENROUTER_API_KEY!, // or set in env\n * });\n *\n * await ai.initialize();\n *\n * const text = await ai.generate('Tell me a joke');\n * console.log(text);\n * ```\n */\nexport class KrutAIProvider {\n    private readonly resolvedOpenRouterKey: string;\n    private readonly resolvedModel: string;\n    private readonly config: KrutAIProviderConfig;\n\n    private openRouterClient: OpenRouter | null = null;\n    private initialized = false;\n\n    constructor(config: KrutAIProviderConfig) {\n        this.config = config;\n\n        // Resolve OpenRouter key: explicit config → env var → hardcoded default (temporary)\n        // TODO: remove hardcoded key once validation endpoint is live\n        this.resolvedOpenRouterKey =\n            config.openRouterApiKey ??\n            process.env.OPENROUTER_API_KEY ??\n            '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';\n\n        this.resolvedModel = config.model ?? DEFAULT_MODEL;\n\n        // Validate OpenRouter key format immediately on construction\n        validateOpenRouterKeyFormat(this.resolvedOpenRouterKey);\n\n        // Skip async validation if the user opts out\n        if (config.validateOnInit === false) {\n            this.setupClient();\n        }\n    }\n\n    /**\n     * Initialize the provider.\n     * Validates the OpenRouter API key (optionally against a service endpoint)\n     * and sets up the underlying OpenRouter client.\n     *\n     * @throws {OpenRouterKeyValidationError}\n     */\n    async initialize(): Promise<void> {\n        if (this.initialized) return;\n\n        if (this.config.validateOnInit !== false) {\n            await validateOpenRouterKeyWithService(\n                this.resolvedOpenRouterKey,\n                this.config.validationEndpoint\n            );\n        }\n\n        this.setupClient();\n        this.initialized = true;\n    }\n\n    /** @private */\n    private setupClient(): void {\n        this.openRouterClient = new OpenRouter({\n            apiKey: this.resolvedOpenRouterKey,\n        });\n    }\n\n    /**\n     * Get the raw OpenRouter SDK client instance.\n     * @throws {Error} If not initialized\n     */\n    getClient(): OpenRouter {\n        if (!this.openRouterClient) {\n            throw new Error(\n                'KrutAIProvider not initialized. Call initialize() first or set validateOnInit to false.'\n            );\n        }\n        return this.openRouterClient;\n    }\n\n    /**\n     * Get the currently configured default model.\n     */\n    getModel(): string {\n        return this.resolvedModel;\n    }\n\n    /**\n     * Check whether the provider has been initialized.\n     */\n    isInitialized(): boolean {\n        return this.initialized;\n    }\n\n    /**\n     * Generate a response for a prompt (non-streaming).\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns The assistant's response text\n     */\n    async generate(prompt: string, options: GenerateOptions = {}): Promise<string> {\n        const client = this.getClient();\n        const model = options.model ?? this.resolvedModel;\n\n        const messages: ChatMessage[] = [];\n        if (options.system) {\n            messages.push({ role: 'system', content: options.system });\n        }\n        messages.push({ role: 'user', content: prompt });\n\n        const result = await client.chat.send({\n            chatGenerationParams: {\n                model,\n                messages,\n                stream: false,\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            },\n        });\n\n        // Non-streaming result: ChatResponse\n        const response = result as { choices: Array<{ message: { content: string } }> };\n        return response.choices?.[0]?.message?.content ?? '';\n    }\n\n    /**\n     * Generate a streaming response for a prompt.\n     *\n     * @param prompt - The user prompt string\n     * @param options - Optional overrides (model, system, maxTokens, temperature)\n     * @returns An async iterable of server-sent event chunks\n     *\n     * @example\n     * ```typescript\n     * const stream = await ai.stream('Tell me a story');\n     * for await (const chunk of stream) {\n     *   process.stdout.write(chunk.choices?.[0]?.delta?.content ?? '');\n     * }\n     * ```\n     */\n    async stream(prompt: string, options: GenerateOptions = {}) {\n        const client = this.getClient();\n        const model = options.model ?? this.resolvedModel;\n\n        const messages: ChatMessage[] = [];\n        if (options.system) {\n            messages.push({ role: 'system', content: options.system });\n        }\n        messages.push({ role: 'user', content: prompt });\n\n        return client.chat.send({\n            chatGenerationParams: {\n                model,\n                messages,\n                stream: true,\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            },\n        });\n    }\n\n    /**\n     * Multi-turn conversation: pass a full message history.\n     *\n     * @param messages - Full conversation history\n     * @param options - Optional overrides (model, maxTokens, temperature)\n     */\n    async chat(messages: ChatMessage[], options: GenerateOptions = {}): Promise<string> {\n        const client = this.getClient();\n        const model = options.model ?? this.resolvedModel;\n\n        const result = await client.chat.send({\n            chatGenerationParams: {\n                model,\n                messages,\n                stream: false,\n                ...(options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),\n                ...(options.temperature !== undefined ? { temperature: options.temperature } : {}),\n            },\n        });\n\n        const response = result as { choices: Array<{ message: { content: string } }> };\n        return response.choices?.[0]?.message?.content ?? '';\n    }\n}\n","/**\n * @krutai/ai-provider — AI Provider package for KrutAI\n *\n * A thin wrapper around `@openrouter/sdk`, mirroring the patterns from `@krutai/auth`.\n *\n * Default model: `qwen/qwen3-235b-a22b-thinking-2507`\n *\n * @example Basic usage\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI(); // uses OPENROUTER_API_KEY env var\n * await ai.initialize();\n *\n * const text = await ai.generate('Write a poem about TypeScript');\n * console.log(text);\n * ```\n *\n * @example With custom model\n * ```typescript\n * const ai = krutAI({ model: 'openai/gpt-4o' });\n * await ai.initialize();\n * const text = await ai.generate('Hello!');\n * ```\n *\n * @example Streaming\n * ```typescript\n * const ai = krutAI();\n * await ai.initialize();\n *\n * const stream = await ai.stream('Tell me a story');\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk.choices[0]?.delta?.content ?? '');\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { KrutAIProviderConfig } from './types';\nimport { DEFAULT_MODEL } from './types';\nimport { KrutAIProvider } from './client';\n\nexport { KrutAIProvider } from './client';\nexport { OpenRouterKeyValidationError } from './client';\nexport {\n    validateOpenRouterKeyFormat,\n    validateOpenRouterKeyWithService,\n} from './validator';\nexport type { KrutAIProviderConfig, GenerateOptions, ChatMessage } from './types';\nexport { DEFAULT_MODEL } from './types';\n\n/**\n * krutAI — convenience factory (mirrors `krutAuth` in @krutai/auth).\n *\n * Creates a `KrutAIProvider` instance. OpenRouter API key is read from\n * `config.openRouterApiKey` or falls back to `process.env.OPENROUTER_API_KEY`.\n *\n * @param config - Provider configuration (all fields optional except apiKey)\n * @returns A `KrutAIProvider` instance (call `.initialize()` before use)\n *\n * @example\n * ```typescript\n * import { krutAI } from '@krutai/ai-provider';\n *\n * const ai = krutAI(); // env OPENROUTER_API_KEY + default model\n * await ai.initialize();\n * const text = await ai.generate('Hello!');\n * ```\n */\nexport function krutAI(\n    config: Partial<KrutAIProviderConfig> & { apiKey?: string } = {}\n): KrutAIProvider {\n    return new KrutAIProvider({\n        apiKey: config.apiKey ?? 'krutai-internal',\n        model: config.model ?? DEFAULT_MODEL,\n        ...config,\n    });\n}\n\n// Package metadata\nexport const VERSION = '0.1.0';\n"]}