@invect/core 0.0.1

package/dist/services/ai/openrouter-adapter.js

@@ -0,0 +1,122 @@
+import { OpenAIAdapter } from "./openai-adapter.js";
+import OpenAI from "openai";
+//#region src/services/ai/openrouter-adapter.ts
+/**
+* OpenRouter Provider Adapter
+*
+* OpenRouter provides access to multiple AI models through a unified OpenAI-compatible API.
+* This adapter extends the OpenAI adapter since OpenRouter uses the same API format.
+*
+* Key differences from OpenAI:
+* - Does NOT support batch processing
+* - Has its own model listing endpoint
+* - Supports additional headers (HTTP-Referer, X-Title)
+* - Can route to multiple underlying providers
+*/
+/**
+* OpenRouter Provider Adapter
+*
+* Extends OpenAI adapter since OpenRouter uses an OpenAI-compatible API.
+* Overrides specific methods for OpenRouter-specific behavior.
+*/
+var OpenRouterAdapter = class extends OpenAIAdapter {
+	_defaultModel;
+	appName;
+	siteUrl;
+	get providerId() {
+		return "OPENROUTER";
+	}
+	get defaultModel() {
+		return this._defaultModel;
+	}
+	get capabilities() {
+		return {
+			supportsStreaming: true,
+			supportsParallelToolCalls: true,
+			supportsStructuredOutput: true,
+			supportsBatch: false,
+			supportsJsonMode: true
+		};
+	}
+	constructor(logger, apiKey, defaultModelOverride, options) {
+		super(logger, apiKey, defaultModelOverride, "https://openrouter.ai/api/v1");
+		this._defaultModel = defaultModelOverride || "openai/gpt-4o-mini";
+		this.appName = options?.appName || "Invect";
+		this.siteUrl = options?.siteUrl || "https://invect.dev";
+		this.client = new OpenAI({
+			apiKey: this.apiKey,
+			baseURL: "https://openrouter.ai/api/v1",
+			defaultHeaders: {
+				"HTTP-Referer": this.siteUrl,
+				"X-Title": this.appName
+			}
+		});
+	}
+	/**
+	* OpenRouter does NOT support batch processing
+	*/
+	async submitBatch(_batchJobId, _requestData) {
+		throw new Error("OpenRouter does not support batch processing. Use direct API calls instead.");
+	}
+	/**
+	* OpenRouter does NOT support batch processing
+	*/
+	async pollBatch(_externalBatchId) {
+		throw new Error("OpenRouter does not support batch processing.");
+	}
+	/**
+	* List available models from OpenRouter
+	* OpenRouter has its own model listing endpoint
+	*/
+	async listModels() {
+		try {
+			const response = await fetch("https://openrouter.ai/api/v1/models", { headers: {
+				Authorization: `Bearer ${this.apiKey}`,
+				"HTTP-Referer": this.siteUrl || "https://invect.dev",
+				"X-Title": this.appName || "Invect"
+			} });
+			if (!response.ok) throw new Error(`Failed to fetch OpenRouter models: ${response.statusText}`);
+			return (await response.json()).data.filter((model) => {
+				const modality = model.architecture?.modality;
+				return modality === "text->text" || modality === "text+image->text";
+			}).map((model) => ({
+				id: model.id,
+				name: model.name || model.id,
+				provider: "openrouter",
+				supportsStructuredOutput: this.modelSupportsStructuredOutput(model.id)
+			}));
+		} catch (error) {
+			this.logger.error("Failed to fetch OpenRouter models:", error);
+			throw this.wrapError(error, "model listing");
+		}
+	}
+	/**
+	* Check if a model supports structured output
+	* For OpenRouter, this depends on the underlying model
+	*/
+	modelSupportsStructuredOutput(modelId) {
+		return [
+			"openai/gpt-4o",
+			"openai/gpt-4-turbo",
+			"anthropic/claude-3",
+			"google/gemini",
+			"meta-llama/llama-3"
+		].some((prefix) => modelId.toLowerCase().startsWith(prefix.toLowerCase()));
+	}
+	/**
+	* Check if a model supports JSON mode
+	*/
+	modelSupportsJsonMode(modelId) {
+		return [
+			"openai/",
+			"anthropic/",
+			"google/",
+			"meta-llama/llama-3",
+			"mistralai/"
+		].some((prefix) => modelId.toLowerCase().startsWith(prefix.toLowerCase()));
+	}
+};
+//#endregion
+export { OpenRouterAdapter };
+
+//# sourceMappingURL=openrouter-adapter.js.map

package/dist/services/ai/openrouter-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter-adapter.js","names":[],"sources":["../../../src/services/ai/openrouter-adapter.ts"],"sourcesContent":["/**\n * OpenRouter Provider Adapter\n *\n * OpenRouter provides access to multiple AI models through a unified OpenAI-compatible API.\n * This adapter extends the OpenAI adapter since OpenRouter uses the same API format.\n *\n * Key differences from OpenAI:\n * - Does NOT support batch processing\n * - Has its own model listing endpoint\n * - Supports additional headers (HTTP-Referer, X-Title)\n * - Can route to multiple underlying providers\n */\n\nimport OpenAI from 'openai';\nimport { Logger } from 'src/types/schemas';\nimport { Model, BatchPollResult, BatchSubmissionResult } from './ai-types';\nimport { BatchRequest } from '../node-data.service';\nimport { OpenAIAdapter } from './openai-adapter';\nimport { ProviderCapabilities } from './provider-adapter';\n\n/**\n * OpenRouter model info from their API\n */\ninterface OpenRouterModel {\n  id: string;\n  name: string;\n  description?: string;\n  pricing?: {\n    prompt: string;\n    completion: string;\n  };\n  context_length?: number;\n  architecture?: {\n    modality: string;\n    tokenizer: string;\n    instruct_type?: string;\n  };\n  top_provider?: {\n    context_length?: number;\n    max_completion_tokens?: number;\n  };\n}\n\n/**\n * OpenRouter Provider Adapter\n *\n * Extends OpenAI adapter since OpenRouter uses an OpenAI-compatible API.\n * Overrides specific methods for OpenRouter-specific behavior.\n */\nexport class OpenRouterAdapter extends OpenAIAdapter {\n  private readonly _defaultModel: string;\n  private readonly appName: string;\n  private readonly siteUrl: string;\n\n  // Override getters from parent class\n  override get providerId(): string {\n    return 'OPENROUTER';\n  }\n\n  override get defaultModel(): string {\n    return this._defaultModel;\n  }\n\n  override get capabilities(): ProviderCapabilities {\n    return {\n      supportsStreaming: true,\n      supportsParallelToolCalls: true,\n      supportsStructuredOutput: true,\n      supportsBatch: false, // OpenRouter does NOT support batch\n      supportsJsonMode: true,\n    };\n  }\n\n  constructor(\n    logger: Logger,\n    apiKey: string,\n    defaultModelOverride?: string,\n    options?: {\n      appName?: string;\n      siteUrl?: string;\n    },\n  ) {\n    // Initialize with OpenRouter's base URL\n    super(logger, apiKey, defaultModelOverride, 'https://openrouter.ai/api/v1');\n\n    this._defaultModel = defaultModelOverride || 'openai/gpt-4o-mini';\n    this.appName = options?.appName || 'Invect';\n    this.siteUrl = options?.siteUrl || 'https://invect.dev';\n\n    // Recreate client with OpenRouter-specific headers\n    this.client = new OpenAI({\n      apiKey: this.apiKey,\n      baseURL: 'https://openrouter.ai/api/v1',\n      defaultHeaders: {\n        'HTTP-Referer': this.siteUrl,\n        'X-Title': this.appName,\n      },\n    });\n  }\n\n  /**\n   * OpenRouter does NOT support batch processing\n   */\n  override async submitBatch(\n    _batchJobId: string,\n    _requestData: BatchRequest,\n  ): Promise<BatchSubmissionResult> {\n    throw new Error('OpenRouter does not support batch processing. Use direct API calls instead.');\n  }\n\n  /**\n   * OpenRouter does NOT support batch processing\n   */\n  override async pollBatch(_externalBatchId: string): Promise<BatchPollResult> {\n    throw new Error('OpenRouter does not support batch processing.');\n  }\n\n  /**\n   * List available models from OpenRouter\n   * OpenRouter has its own model listing endpoint\n   */\n  override async listModels(): Promise<Model[]> {\n    try {\n      // OpenRouter has a dedicated models endpoint\n      const response = await fetch('https://openrouter.ai/api/v1/models', {\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'HTTP-Referer': this.siteUrl || 'https://invect.dev',\n          'X-Title': this.appName || 'Invect',\n        },\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch OpenRouter models: ${response.statusText}`);\n      }\n\n      const data = (await response.json()) as { data: OpenRouterModel[] };\n\n      // Filter to chat models and map to our format\n      const models: Model[] = data.data\n        .filter((model) => {\n          // Filter out embedding and other non-chat models\n          const modality = model.architecture?.modality;\n          return modality === 'text->text' || modality === 'text+image->text';\n        })\n        .map((model) => ({\n          id: model.id,\n          name: model.name || model.id,\n          provider: 'openrouter' as const,\n          supportsStructuredOutput: this.modelSupportsStructuredOutput(model.id),\n        }));\n\n      return models;\n    } catch (error) {\n      this.logger.error('Failed to fetch OpenRouter models:', error);\n      throw this.wrapError(error, 'model listing');\n    }\n  }\n\n  /**\n   * Check if a model supports structured output\n   * For OpenRouter, this depends on the underlying model\n   */\n  override modelSupportsStructuredOutput(modelId: string): boolean {\n    // Models known to support structured output\n    const supportedPrefixes = [\n      'openai/gpt-4o',\n      'openai/gpt-4-turbo',\n      'anthropic/claude-3',\n      'google/gemini',\n      'meta-llama/llama-3',\n    ];\n    return supportedPrefixes.some((prefix) =>\n      modelId.toLowerCase().startsWith(prefix.toLowerCase()),\n    );\n  }\n\n  /**\n   * Check if a model supports JSON mode\n   */\n  override modelSupportsJsonMode(modelId: string): boolean {\n    // Most modern models support JSON mode through OpenRouter\n    const supportedPrefixes = [\n      'openai/',\n      'anthropic/',\n      'google/',\n      'meta-llama/llama-3',\n      'mistralai/',\n    ];\n    return supportedPrefixes.some((prefix) =>\n      modelId.toLowerCase().startsWith(prefix.toLowerCase()),\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAiDA,IAAa,oBAAb,cAAuC,cAAc;CACnD;CACA;CACA;CAGA,IAAa,aAAqB;AAChC,SAAO;;CAGT,IAAa,eAAuB;AAClC,SAAO,KAAK;;CAGd,IAAa,eAAqC;AAChD,SAAO;GACL,mBAAmB;GACnB,2BAA2B;GAC3B,0BAA0B;GAC1B,eAAe;GACf,kBAAkB;GACnB;;CAGH,YACE,QACA,QACA,sBACA,SAIA;AAEA,QAAM,QAAQ,QAAQ,sBAAsB,+BAA+B;AAE3E,OAAK,gBAAgB,wBAAwB;AAC7C,OAAK,UAAU,SAAS,WAAW;AACnC,OAAK,UAAU,SAAS,WAAW;AAGnC,OAAK,SAAS,IAAI,OAAO;GACvB,QAAQ,KAAK;GACb,SAAS;GACT,gBAAgB;IACd,gBAAgB,KAAK;IACrB,WAAW,KAAK;IACjB;GACF,CAAC;;;;;CAMJ,MAAe,YACb,aACA,cACgC;AAChC,QAAM,IAAI,MAAM,8EAA8E;;;;;CAMhG,MAAe,UAAU,kBAAoD;AAC3E,QAAM,IAAI,MAAM,gDAAgD;;;;;;CAOlE,MAAe,aAA+B;AAC5C,MAAI;GAEF,MAAM,WAAW,MAAM,MAAM,uCAAuC,EAClE,SAAS;IACP,eAAe,UAAU,KAAK;IAC9B,gBAAgB,KAAK,WAAW;IAChC,WAAW,KAAK,WAAW;IAC5B,EACF,CAAC;AAEF,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,sCAAsC,SAAS,aAAa;AAmB9E,WAhBc,MAAM,SAAS,MAAM,EAGN,KAC1B,QAAQ,UAAU;IAEjB,MAAM,WAAW,MAAM,cAAc;AACrC,WAAO,aAAa,gBAAgB,aAAa;KACjD,CACD,KAAK,WAAW;IACf,IAAI,MAAM;IACV,MAAM,MAAM,QAAQ,MAAM;IAC1B,UAAU;IACV,0BAA0B,KAAK,8BAA8B,MAAM,GAAG;IACvE,EAAE;WAGE,OAAO;AACd,QAAK,OAAO,MAAM,sCAAsC,MAAM;AAC9D,SAAM,KAAK,UAAU,OAAO,gBAAgB;;;;;;;CAQhD,8BAAuC,SAA0B;AAS/D,SAP0B;GACxB;GACA;GACA;GACA;GACA;GACD,CACwB,MAAM,WAC7B,QAAQ,aAAa,CAAC,WAAW,OAAO,aAAa,CAAC,CACvD;;;;;CAMH,sBAA+B,SAA0B;AASvD,SAP0B;GACxB;GACA;GACA;GACA;GACA;GACD,CACwB,MAAM,WAC7B,QAAQ,aAAa,CAAC,WAAW,OAAO,aAAa,CAAC,CACvD"}

package/dist/services/ai/provider-adapter.cjs

@@ -0,0 +1,72 @@
+//#region src/services/ai/provider-adapter.ts
+/**
+* Base adapter class with shared utility methods
+*/
+var BaseProviderAdapter = class {
+	constructor(logger, apiKey, defaultModelOverride) {
+		this.logger = logger;
+		this.apiKey = apiKey;
+		this.defaultModelOverride = defaultModelOverride;
+	}
+	/**
+	* Validate API key - call from subclass constructor
+	*/
+	validateApiKey() {
+		if (!this.apiKey) throw new Error(`API key required for ${this.providerId} provider`);
+	}
+	/**
+	* Get the effective default model (override or provider default)
+	*/
+	getEffectiveDefaultModel() {
+		return this.defaultModelOverride || this.defaultModel;
+	}
+	/**
+	* Parse tool calls from response into normalized format
+	*/
+	normalizeToolCalls(rawToolCalls) {
+		return rawToolCalls.map((tc) => {
+			let parsedInput = {};
+			if (tc.input && typeof tc.input === "object") parsedInput = tc.input;
+			else if (tc.arguments) try {
+				parsedInput = JSON.parse(tc.arguments);
+			} catch {
+				this.logger.warn("Failed to parse tool arguments", { arguments: tc.arguments });
+			}
+			return {
+				id: tc.id,
+				toolId: tc.name || tc.toolId || "",
+				input: parsedInput
+			};
+		});
+	}
+	/**
+	* Create a text-only response
+	*/
+	createTextResponse(content) {
+		return {
+			type: "text",
+			content
+		};
+	}
+	/**
+	* Create a tool use response
+	*/
+	createToolUseResponse(content, toolCalls) {
+		return {
+			type: "tool_use",
+			content,
+			toolCalls
+		};
+	}
+	/**
+	* Wrap errors with provider context
+	*/
+	wrapError(error, operation) {
+		const message = error instanceof Error ? error.message : String(error);
+		return /* @__PURE__ */ new Error(`${this.providerId} ${operation} failed: ${message}`);
+	}
+};
+//#endregion
+exports.BaseProviderAdapter = BaseProviderAdapter;
+
+//# sourceMappingURL=provider-adapter.cjs.map

package/dist/services/ai/provider-adapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.cjs","names":[],"sources":["../../../src/services/ai/provider-adapter.ts"],"sourcesContent":["/**\n * Provider Adapter Interface\n *\n * Defines the contract for AI provider adapters that handle provider-specific\n * transformations while allowing shared logic to live in BaseAIClient.\n *\n * This abstraction enables easy addition of new providers (e.g., OpenRouter)\n * by implementing just the adapter interface.\n */\n\nimport { Logger } from 'src/types/schemas';\nimport {\n  AgentToolDefinition,\n  AgentMessage,\n  AgentPromptResult,\n  AgentToolCall,\n} from 'src/types/agent-tool.types';\nimport { BatchRequest, PromptRequest } from '../node-data.service';\nimport {\n  AgentPromptRequest,\n  BatchPollResult,\n  BatchSubmissionResult,\n  Model,\n  PromptResult,\n} from './base-client';\n\n/**\n * Provider capabilities - what features each provider supports\n */\nexport interface ProviderCapabilities {\n  /** Supports streaming responses */\n  supportsStreaming: boolean;\n  /** Supports parallel tool calls in a single response */\n  supportsParallelToolCalls: boolean;\n  /** Supports structured output (JSON schema) */\n  supportsStructuredOutput: boolean;\n  /** Supports batch API */\n  supportsBatch: boolean;\n  /** Supports JSON mode (weaker than structured output) */\n  supportsJsonMode: boolean;\n}\n\n/**\n * Configuration for creating an adapter\n */\nexport interface ProviderAdapterConfig {\n  apiKey: string;\n  defaultModel?: string;\n  baseURL?: string;\n  logger: Logger;\n}\n\n/**\n * Normalized tool format for conversion\n */\nexport interface NormalizedTool {\n  id: string;\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n}\n\n/**\n * Provider Adapter Interface\n *\n * Each AI provider implements this interface to handle provider-specific\n * message formats, tool schemas, and API calls.\n */\nexport interface ProviderAdapter {\n  /** Provider identifier (e.g., \"OPENAI\", \"ANTHROPIC\", \"OPENROUTER\") */\n  readonly providerId: string;\n\n  /** Default model for this provider */\n  readonly defaultModel: string;\n\n  /** API key for authentication */\n  readonly apiKey: string;\n\n  /** Provider capabilities */\n  readonly capabilities: ProviderCapabilities;\n\n  /**\n   * Convert AgentToolDefinition[] to provider-specific format\n   */\n  convertTools(tools: AgentToolDefinition[]): unknown[];\n\n  /**\n   * Convert AgentMessage[] to provider-specific message format\n   */\n  convertMessages(messages: AgentMessage[], systemPrompt?: string): unknown[];\n\n  /**\n   * Build tool_choice parameter in provider-specific format\n   */\n  buildToolChoice(\n    choice: 'auto' | 'none' | { type: 'tool'; name: string } | undefined,\n    hasTools: boolean,\n  ): unknown;\n\n  /**\n   * Execute agent prompt and return normalized result\n   */\n  executeAgentPrompt(request: AgentPromptRequest): Promise<AgentPromptResult>;\n\n  /**\n   * Execute a simple prompt (non-agent)\n   */\n  executePrompt(request: PromptRequest): Promise<PromptResult>;\n\n  /**\n   * Submit a batch request\n   */\n  submitBatch(batchJobId: string, requestData: BatchRequest): Promise<BatchSubmissionResult>;\n\n  /**\n   * Poll batch status\n   */\n  pollBatch(externalBatchId: string): Promise<BatchPollResult>;\n\n  /**\n   * List available models\n   */\n  listModels(): Promise<Model[]>;\n\n  /**\n   * Check if a specific model supports structured output\n   */\n  modelSupportsStructuredOutput(modelId: string): boolean;\n\n  /**\n   * Check if a specific model supports JSON mode\n   */\n  modelSupportsJsonMode(modelId: string): boolean;\n}\n\n/**\n * Base adapter class with shared utility methods\n */\nexport abstract class BaseProviderAdapter implements ProviderAdapter {\n  abstract readonly providerId: string;\n  abstract readonly defaultModel: string;\n  abstract readonly capabilities: ProviderCapabilities;\n\n  constructor(\n    protected readonly logger: Logger,\n    readonly apiKey: string,\n    protected readonly defaultModelOverride?: string,\n  ) {\n    // Note: apiKey validation is done in subclass constructors\n    // after providerId is available\n  }\n\n  /**\n   * Validate API key - call from subclass constructor\n   */\n  protected validateApiKey(): void {\n    if (!this.apiKey) {\n      throw new Error(`API key required for ${this.providerId} provider`);\n    }\n  }\n\n  abstract convertTools(tools: AgentToolDefinition[]): unknown[];\n  abstract convertMessages(messages: AgentMessage[], systemPrompt?: string): unknown[];\n  abstract buildToolChoice(\n    choice: 'auto' | 'none' | { type: 'tool'; name: string } | undefined,\n    hasTools: boolean,\n  ): unknown;\n  abstract executeAgentPrompt(request: AgentPromptRequest): Promise<AgentPromptResult>;\n  abstract executePrompt(request: PromptRequest): Promise<PromptResult>;\n  abstract submitBatch(\n    batchJobId: string,\n    requestData: BatchRequest,\n  ): Promise<BatchSubmissionResult>;\n  abstract pollBatch(externalBatchId: string): Promise<BatchPollResult>;\n  abstract listModels(): Promise<Model[]>;\n  abstract modelSupportsStructuredOutput(modelId: string): boolean;\n  abstract modelSupportsJsonMode(modelId: string): boolean;\n\n  /**\n   * Get the effective default model (override or provider default)\n   */\n  protected getEffectiveDefaultModel(): string {\n    return this.defaultModelOverride || this.defaultModel;\n  }\n\n  /**\n   * Parse tool calls from response into normalized format\n   */\n  protected normalizeToolCalls(\n    rawToolCalls: Array<{\n      id: string;\n      name?: string;\n      toolId?: string;\n      input?: unknown;\n      arguments?: string;\n    }>,\n  ): AgentToolCall[] {\n    return rawToolCalls.map((tc) => {\n      let parsedInput: Record<string, unknown> = {};\n\n      if (tc.input && typeof tc.input === 'object') {\n        parsedInput = tc.input as Record<string, unknown>;\n      } else if (tc.arguments) {\n        try {\n          parsedInput = JSON.parse(tc.arguments);\n        } catch {\n          this.logger.warn('Failed to parse tool arguments', { arguments: tc.arguments });\n        }\n      }\n\n      return {\n        id: tc.id,\n        toolId: tc.name || tc.toolId || '',\n        input: parsedInput,\n      };\n    });\n  }\n\n  /**\n   * Create a text-only response\n   */\n  protected createTextResponse(content: string): AgentPromptResult {\n    return {\n      type: 'text',\n      content,\n    };\n  }\n\n  /**\n   * Create a tool use response\n   */\n  protected createToolUseResponse(content: string, toolCalls: AgentToolCall[]): AgentPromptResult {\n    return {\n      type: 'tool_use',\n      content,\n      toolCalls,\n    };\n  }\n\n  /**\n   * Wrap errors with provider context\n   */\n  protected wrapError(error: unknown, operation: string): Error {\n    const message = error instanceof Error ? error.message : String(error);\n    return new Error(`${this.providerId} ${operation} failed: ${message}`);\n  }\n}\n"],"mappings":";;;;AA0IA,IAAsB,sBAAtB,MAAqE;CAKnE,YACE,QACA,QACA,sBACA;AAHmB,OAAA,SAAA;AACV,OAAA,SAAA;AACU,OAAA,uBAAA;;;;;CASrB,iBAAiC;AAC/B,MAAI,CAAC,KAAK,OACR,OAAM,IAAI,MAAM,wBAAwB,KAAK,WAAW,WAAW;;;;;CAwBvE,2BAA6C;AAC3C,SAAO,KAAK,wBAAwB,KAAK;;;;;CAM3C,mBACE,cAOiB;AACjB,SAAO,aAAa,KAAK,OAAO;GAC9B,IAAI,cAAuC,EAAE;AAE7C,OAAI,GAAG,SAAS,OAAO,GAAG,UAAU,SAClC,eAAc,GAAG;YACR,GAAG,UACZ,KAAI;AACF,kBAAc,KAAK,MAAM,GAAG,UAAU;WAChC;AACN,SAAK,OAAO,KAAK,kCAAkC,EAAE,WAAW,GAAG,WAAW,CAAC;;AAInF,UAAO;IACL,IAAI,GAAG;IACP,QAAQ,GAAG,QAAQ,GAAG,UAAU;IAChC,OAAO;IACR;IACD;;;;;CAMJ,mBAA6B,SAAoC;AAC/D,SAAO;GACL,MAAM;GACN;GACD;;;;;CAMH,sBAAgC,SAAiB,WAA+C;AAC9F,SAAO;GACL,MAAM;GACN;GACA;GACD;;;;;CAMH,UAAoB,OAAgB,WAA0B;EAC5D,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,yBAAO,IAAI,MAAM,GAAG,KAAK,WAAW,GAAG,UAAU,WAAW,UAAU"}

package/dist/services/ai/provider-adapter.d.cts

@@ -0,0 +1,81 @@
+import { AgentMessage, AgentPromptResult, AgentToolDefinition } from "../../types/agent-tool.types.cjs";
+import { BatchRequest, PromptRequest } from "../node-data.service.cjs";
+import { AgentPromptRequest, BatchPollResult, BatchSubmissionResult, Model, PromptResult } from "./ai-types.cjs";
+//#region src/services/ai/provider-adapter.d.ts
+/**
+ * Provider capabilities - what features each provider supports
+ */
+interface ProviderCapabilities {
+  /** Supports streaming responses */
+  supportsStreaming: boolean;
+  /** Supports parallel tool calls in a single response */
+  supportsParallelToolCalls: boolean;
+  /** Supports structured output (JSON schema) */
+  supportsStructuredOutput: boolean;
+  /** Supports batch API */
+  supportsBatch: boolean;
+  /** Supports JSON mode (weaker than structured output) */
+  supportsJsonMode: boolean;
+}
+/**
+ * Provider Adapter Interface
+ *
+ * Each AI provider implements this interface to handle provider-specific
+ * message formats, tool schemas, and API calls.
+ */
+interface ProviderAdapter {
+  /** Provider identifier (e.g., "OPENAI", "ANTHROPIC", "OPENROUTER") */
+  readonly providerId: string;
+  /** Default model for this provider */
+  readonly defaultModel: string;
+  /** API key for authentication */
+  readonly apiKey: string;
+  /** Provider capabilities */
+  readonly capabilities: ProviderCapabilities;
+  /**
+   * Convert AgentToolDefinition[] to provider-specific format
+   */
+  convertTools(tools: AgentToolDefinition[]): unknown[];
+  /**
+   * Convert AgentMessage[] to provider-specific message format
+   */
+  convertMessages(messages: AgentMessage[], systemPrompt?: string): unknown[];
+  /**
+   * Build tool_choice parameter in provider-specific format
+   */
+  buildToolChoice(choice: 'auto' | 'none' | {
+    type: 'tool';
+    name: string;
+  } | undefined, hasTools: boolean): unknown;
+  /**
+   * Execute agent prompt and return normalized result
+   */
+  executeAgentPrompt(request: AgentPromptRequest): Promise<AgentPromptResult>;
+  /**
+   * Execute a simple prompt (non-agent)
+   */
+  executePrompt(request: PromptRequest): Promise<PromptResult>;
+  /**
+   * Submit a batch request
+   */
+  submitBatch(batchJobId: string, requestData: BatchRequest): Promise<BatchSubmissionResult>;
+  /**
+   * Poll batch status
+   */
+  pollBatch(externalBatchId: string): Promise<BatchPollResult>;
+  /**
+   * List available models
+   */
+  listModels(): Promise<Model[]>;
+  /**
+   * Check if a specific model supports structured output
+   */
+  modelSupportsStructuredOutput(modelId: string): boolean;
+  /**
+   * Check if a specific model supports JSON mode
+   */
+  modelSupportsJsonMode(modelId: string): boolean;
+}
+//#endregion
+export { ProviderAdapter, ProviderCapabilities };
+//# sourceMappingURL=provider-adapter.d.cts.map

package/dist/services/ai/provider-adapter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.d.cts","names":[],"sources":["../../../src/services/ai/provider-adapter.ts"],"mappings":";;;;;;;UA6BiB,oBAAA;EAuCA;EArCf,iBAAA;;EAEA,yBAAA;EAmDoB;EAjDpB,wBAAA;EAmE4B;EAjE5B,aAAA;EAiEiD;EA/DjD,gBAAA;AAAA;;;;;;;UA6Be,eAAA;EA2Bb;EAAA,SAzBO,UAAA;EAgCT;EAAA,SA7BS,YAAA;EA6BU;EAAA,SA1BV,MAAA;EA0BgD;EAAA,SAvBhD,YAAA,EAAc,oBAAA;EA4BA;;;EAvBvB,YAAA,CAAa,KAAA,EAAO,mBAAA;EA4BpB;;;EAvBA,eAAA,CAAgB,QAAA,EAAU,YAAA,IAAgB,YAAA;EAuBkB;;;EAlB5D,eAAA,CACE,MAAA;IAA4B,IAAA;IAAc,IAAA;EAAA,eAC1C,QAAA;EA0BY;;;EApBd,kBAAA,CAAmB,OAAA,EAAS,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;EA8BzD;;;EAzBA,aAAA,CAAc,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;;;;EAK/C,WAAA,CAAY,UAAA,UAAoB,WAAA,EAAa,YAAA,GAAe,OAAA,CAAQ,qBAAA;;;;EAKpE,SAAA,CAAU,eAAA,WAA0B,OAAA,CAAQ,eAAA;;;;EAK5C,UAAA,IAAc,OAAA,CAAQ,KAAA;;;;EAKtB,6BAAA,CAA8B,OAAA;;;;EAK9B,qBAAA,CAAsB,OAAA;AAAA"}

package/dist/services/ai/provider-adapter.d.ts

@@ -0,0 +1,81 @@
+import { AgentMessage, AgentPromptResult, AgentToolDefinition } from "../../types/agent-tool.types.js";
+import { BatchRequest, PromptRequest } from "../node-data.service.js";
+import { AgentPromptRequest, BatchPollResult, BatchSubmissionResult, Model, PromptResult } from "./ai-types.js";
+//#region src/services/ai/provider-adapter.d.ts
+/**
+ * Provider capabilities - what features each provider supports
+ */
+interface ProviderCapabilities {
+  /** Supports streaming responses */
+  supportsStreaming: boolean;
+  /** Supports parallel tool calls in a single response */
+  supportsParallelToolCalls: boolean;
+  /** Supports structured output (JSON schema) */
+  supportsStructuredOutput: boolean;
+  /** Supports batch API */
+  supportsBatch: boolean;
+  /** Supports JSON mode (weaker than structured output) */
+  supportsJsonMode: boolean;
+}
+/**
+ * Provider Adapter Interface
+ *
+ * Each AI provider implements this interface to handle provider-specific
+ * message formats, tool schemas, and API calls.
+ */
+interface ProviderAdapter {
+  /** Provider identifier (e.g., "OPENAI", "ANTHROPIC", "OPENROUTER") */
+  readonly providerId: string;
+  /** Default model for this provider */
+  readonly defaultModel: string;
+  /** API key for authentication */
+  readonly apiKey: string;
+  /** Provider capabilities */
+  readonly capabilities: ProviderCapabilities;
+  /**
+   * Convert AgentToolDefinition[] to provider-specific format
+   */
+  convertTools(tools: AgentToolDefinition[]): unknown[];
+  /**
+   * Convert AgentMessage[] to provider-specific message format
+   */
+  convertMessages(messages: AgentMessage[], systemPrompt?: string): unknown[];
+  /**
+   * Build tool_choice parameter in provider-specific format
+   */
+  buildToolChoice(choice: 'auto' | 'none' | {
+    type: 'tool';
+    name: string;
+  } | undefined, hasTools: boolean): unknown;
+  /**
+   * Execute agent prompt and return normalized result
+   */
+  executeAgentPrompt(request: AgentPromptRequest): Promise<AgentPromptResult>;
+  /**
+   * Execute a simple prompt (non-agent)
+   */
+  executePrompt(request: PromptRequest): Promise<PromptResult>;
+  /**
+   * Submit a batch request
+   */
+  submitBatch(batchJobId: string, requestData: BatchRequest): Promise<BatchSubmissionResult>;
+  /**
+   * Poll batch status
+   */
+  pollBatch(externalBatchId: string): Promise<BatchPollResult>;
+  /**
+   * List available models
+   */
+  listModels(): Promise<Model[]>;
+  /**
+   * Check if a specific model supports structured output
+   */
+  modelSupportsStructuredOutput(modelId: string): boolean;
+  /**
+   * Check if a specific model supports JSON mode
+   */
+  modelSupportsJsonMode(modelId: string): boolean;
+}
+//#endregion
+export { ProviderAdapter, ProviderCapabilities };
+//# sourceMappingURL=provider-adapter.d.ts.map

package/dist/services/ai/provider-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.d.ts","names":[],"sources":["../../../src/services/ai/provider-adapter.ts"],"mappings":";;;;;;;UA6BiB,oBAAA;EAUC;EARhB,iBAAA;EAqC8B;EAnC9B,yBAAA;EA8CuB;EA5CvB,wBAAA;EAsD0B;EApD1B,aAAA;EAiEyD;EA/DzD,gBAAA;AAAA;;;;;;;UA6Be,eAAA;EA2B6B;EAAA,SAzBnC,UAAA;EA0BP;EAAA,SAvBO,YAAA;EA6BmB;EAAA,SA1BnB,MAAA;EA0BwC;EAAA,SAvBxC,YAAA,EAAc,oBAAA;EA4BvB;;;EAvBA,YAAA,CAAa,KAAA,EAAO,mBAAA;EAuB2B;;;EAlB/C,eAAA,CAAgB,QAAA,EAAU,YAAA,IAAgB,YAAA;EAuBV;;;EAlBhC,eAAA,CACE,MAAA;IAA4B,IAAA;IAAc,IAAA;EAAA,eAC1C,QAAA;EA0BF;;;EApBA,kBAAA,CAAmB,OAAA,EAAS,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;EAyB3B;;;EApB9B,aAAA,CAAc,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EAyBV;;;EApBrC,WAAA,CAAY,UAAA,UAAoB,WAAA,EAAa,YAAA,GAAe,OAAA,CAAQ,qBAAA;;;;EAKpE,SAAA,CAAU,eAAA,WAA0B,OAAA,CAAQ,eAAA;;;;EAK5C,UAAA,IAAc,OAAA,CAAQ,KAAA;;;;EAKtB,6BAAA,CAA8B,OAAA;;;;EAK9B,qBAAA,CAAsB,OAAA;AAAA"}

package/dist/services/ai/provider-adapter.js

@@ -0,0 +1,72 @@
+//#region src/services/ai/provider-adapter.ts
+/**
+* Base adapter class with shared utility methods
+*/
+var BaseProviderAdapter = class {
+	constructor(logger, apiKey, defaultModelOverride) {
+		this.logger = logger;
+		this.apiKey = apiKey;
+		this.defaultModelOverride = defaultModelOverride;
+	}
+	/**
+	* Validate API key - call from subclass constructor
+	*/
+	validateApiKey() {
+		if (!this.apiKey) throw new Error(`API key required for ${this.providerId} provider`);
+	}
+	/**
+	* Get the effective default model (override or provider default)
+	*/
+	getEffectiveDefaultModel() {
+		return this.defaultModelOverride || this.defaultModel;
+	}
+	/**
+	* Parse tool calls from response into normalized format
+	*/
+	normalizeToolCalls(rawToolCalls) {
+		return rawToolCalls.map((tc) => {
+			let parsedInput = {};
+			if (tc.input && typeof tc.input === "object") parsedInput = tc.input;
+			else if (tc.arguments) try {
+				parsedInput = JSON.parse(tc.arguments);
+			} catch {
+				this.logger.warn("Failed to parse tool arguments", { arguments: tc.arguments });
+			}
+			return {
+				id: tc.id,
+				toolId: tc.name || tc.toolId || "",
+				input: parsedInput
+			};
+		});
+	}
+	/**
+	* Create a text-only response
+	*/
+	createTextResponse(content) {
+		return {
+			type: "text",
+			content
+		};
+	}
+	/**
+	* Create a tool use response
+	*/
+	createToolUseResponse(content, toolCalls) {
+		return {
+			type: "tool_use",
+			content,
+			toolCalls
+		};
+	}
+	/**
+	* Wrap errors with provider context
+	*/
+	wrapError(error, operation) {
+		const message = error instanceof Error ? error.message : String(error);
+		return /* @__PURE__ */ new Error(`${this.providerId} ${operation} failed: ${message}`);
+	}
+};
+//#endregion
+export { BaseProviderAdapter };
+
+//# sourceMappingURL=provider-adapter.js.map

package/dist/services/ai/provider-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.js","names":[],"sources":["../../../src/services/ai/provider-adapter.ts"],"sourcesContent":["/**\n * Provider Adapter Interface\n *\n * Defines the contract for AI provider adapters that handle provider-specific\n * transformations while allowing shared logic to live in BaseAIClient.\n *\n * This abstraction enables easy addition of new providers (e.g., OpenRouter)\n * by implementing just the adapter interface.\n */\n\nimport { Logger } from 'src/types/schemas';\nimport {\n  AgentToolDefinition,\n  AgentMessage,\n  AgentPromptResult,\n  AgentToolCall,\n} from 'src/types/agent-tool.types';\nimport { BatchRequest, PromptRequest } from '../node-data.service';\nimport {\n  AgentPromptRequest,\n  BatchPollResult,\n  BatchSubmissionResult,\n  Model,\n  PromptResult,\n} from './base-client';\n\n/**\n * Provider capabilities - what features each provider supports\n */\nexport interface ProviderCapabilities {\n  /** Supports streaming responses */\n  supportsStreaming: boolean;\n  /** Supports parallel tool calls in a single response */\n  supportsParallelToolCalls: boolean;\n  /** Supports structured output (JSON schema) */\n  supportsStructuredOutput: boolean;\n  /** Supports batch API */\n  supportsBatch: boolean;\n  /** Supports JSON mode (weaker than structured output) */\n  supportsJsonMode: boolean;\n}\n\n/**\n * Configuration for creating an adapter\n */\nexport interface ProviderAdapterConfig {\n  apiKey: string;\n  defaultModel?: string;\n  baseURL?: string;\n  logger: Logger;\n}\n\n/**\n * Normalized tool format for conversion\n */\nexport interface NormalizedTool {\n  id: string;\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n}\n\n/**\n * Provider Adapter Interface\n *\n * Each AI provider implements this interface to handle provider-specific\n * message formats, tool schemas, and API calls.\n */\nexport interface ProviderAdapter {\n  /** Provider identifier (e.g., \"OPENAI\", \"ANTHROPIC\", \"OPENROUTER\") */\n  readonly providerId: string;\n\n  /** Default model for this provider */\n  readonly defaultModel: string;\n\n  /** API key for authentication */\n  readonly apiKey: string;\n\n  /** Provider capabilities */\n  readonly capabilities: ProviderCapabilities;\n\n  /**\n   * Convert AgentToolDefinition[] to provider-specific format\n   */\n  convertTools(tools: AgentToolDefinition[]): unknown[];\n\n  /**\n   * Convert AgentMessage[] to provider-specific message format\n   */\n  convertMessages(messages: AgentMessage[], systemPrompt?: string): unknown[];\n\n  /**\n   * Build tool_choice parameter in provider-specific format\n   */\n  buildToolChoice(\n    choice: 'auto' | 'none' | { type: 'tool'; name: string } | undefined,\n    hasTools: boolean,\n  ): unknown;\n\n  /**\n   * Execute agent prompt and return normalized result\n   */\n  executeAgentPrompt(request: AgentPromptRequest): Promise<AgentPromptResult>;\n\n  /**\n   * Execute a simple prompt (non-agent)\n   */\n  executePrompt(request: PromptRequest): Promise<PromptResult>;\n\n  /**\n   * Submit a batch request\n   */\n  submitBatch(batchJobId: string, requestData: BatchRequest): Promise<BatchSubmissionResult>;\n\n  /**\n   * Poll batch status\n   */\n  pollBatch(externalBatchId: string): Promise<BatchPollResult>;\n\n  /**\n   * List available models\n   */\n  listModels(): Promise<Model[]>;\n\n  /**\n   * Check if a specific model supports structured output\n   */\n  modelSupportsStructuredOutput(modelId: string): boolean;\n\n  /**\n   * Check if a specific model supports JSON mode\n   */\n  modelSupportsJsonMode(modelId: string): boolean;\n}\n\n/**\n * Base adapter class with shared utility methods\n */\nexport abstract class BaseProviderAdapter implements ProviderAdapter {\n  abstract readonly providerId: string;\n  abstract readonly defaultModel: string;\n  abstract readonly capabilities: ProviderCapabilities;\n\n  constructor(\n    protected readonly logger: Logger,\n    readonly apiKey: string,\n    protected readonly defaultModelOverride?: string,\n  ) {\n    // Note: apiKey validation is done in subclass constructors\n    // after providerId is available\n  }\n\n  /**\n   * Validate API key - call from subclass constructor\n   */\n  protected validateApiKey(): void {\n    if (!this.apiKey) {\n      throw new Error(`API key required for ${this.providerId} provider`);\n    }\n  }\n\n  abstract convertTools(tools: AgentToolDefinition[]): unknown[];\n  abstract convertMessages(messages: AgentMessage[], systemPrompt?: string): unknown[];\n  abstract buildToolChoice(\n    choice: 'auto' | 'none' | { type: 'tool'; name: string } | undefined,\n    hasTools: boolean,\n  ): unknown;\n  abstract executeAgentPrompt(request: AgentPromptRequest): Promise<AgentPromptResult>;\n  abstract executePrompt(request: PromptRequest): Promise<PromptResult>;\n  abstract submitBatch(\n    batchJobId: string,\n    requestData: BatchRequest,\n  ): Promise<BatchSubmissionResult>;\n  abstract pollBatch(externalBatchId: string): Promise<BatchPollResult>;\n  abstract listModels(): Promise<Model[]>;\n  abstract modelSupportsStructuredOutput(modelId: string): boolean;\n  abstract modelSupportsJsonMode(modelId: string): boolean;\n\n  /**\n   * Get the effective default model (override or provider default)\n   */\n  protected getEffectiveDefaultModel(): string {\n    return this.defaultModelOverride || this.defaultModel;\n  }\n\n  /**\n   * Parse tool calls from response into normalized format\n   */\n  protected normalizeToolCalls(\n    rawToolCalls: Array<{\n      id: string;\n      name?: string;\n      toolId?: string;\n      input?: unknown;\n      arguments?: string;\n    }>,\n  ): AgentToolCall[] {\n    return rawToolCalls.map((tc) => {\n      let parsedInput: Record<string, unknown> = {};\n\n      if (tc.input && typeof tc.input === 'object') {\n        parsedInput = tc.input as Record<string, unknown>;\n      } else if (tc.arguments) {\n        try {\n          parsedInput = JSON.parse(tc.arguments);\n        } catch {\n          this.logger.warn('Failed to parse tool arguments', { arguments: tc.arguments });\n        }\n      }\n\n      return {\n        id: tc.id,\n        toolId: tc.name || tc.toolId || '',\n        input: parsedInput,\n      };\n    });\n  }\n\n  /**\n   * Create a text-only response\n   */\n  protected createTextResponse(content: string): AgentPromptResult {\n    return {\n      type: 'text',\n      content,\n    };\n  }\n\n  /**\n   * Create a tool use response\n   */\n  protected createToolUseResponse(content: string, toolCalls: AgentToolCall[]): AgentPromptResult {\n    return {\n      type: 'tool_use',\n      content,\n      toolCalls,\n    };\n  }\n\n  /**\n   * Wrap errors with provider context\n   */\n  protected wrapError(error: unknown, operation: string): Error {\n    const message = error instanceof Error ? error.message : String(error);\n    return new Error(`${this.providerId} ${operation} failed: ${message}`);\n  }\n}\n"],"mappings":";;;;AA0IA,IAAsB,sBAAtB,MAAqE;CAKnE,YACE,QACA,QACA,sBACA;AAHmB,OAAA,SAAA;AACV,OAAA,SAAA;AACU,OAAA,uBAAA;;;;;CASrB,iBAAiC;AAC/B,MAAI,CAAC,KAAK,OACR,OAAM,IAAI,MAAM,wBAAwB,KAAK,WAAW,WAAW;;;;;CAwBvE,2BAA6C;AAC3C,SAAO,KAAK,wBAAwB,KAAK;;;;;CAM3C,mBACE,cAOiB;AACjB,SAAO,aAAa,KAAK,OAAO;GAC9B,IAAI,cAAuC,EAAE;AAE7C,OAAI,GAAG,SAAS,OAAO,GAAG,UAAU,SAClC,eAAc,GAAG;YACR,GAAG,UACZ,KAAI;AACF,kBAAc,KAAK,MAAM,GAAG,UAAU;WAChC;AACN,SAAK,OAAO,KAAK,kCAAkC,EAAE,WAAW,GAAG,WAAW,CAAC;;AAInF,UAAO;IACL,IAAI,GAAG;IACP,QAAQ,GAAG,QAAQ,GAAG,UAAU;IAChC,OAAO;IACR;IACD;;;;;CAMJ,mBAA6B,SAAoC;AAC/D,SAAO;GACL,MAAM;GACN;GACD;;;;;CAMH,sBAAgC,SAAiB,WAA+C;AAC9F,SAAO;GACL,MAAM;GACN;GACA;GACD;;;;;CAMH,UAAoB,OAAgB,WAA0B;EAC5D,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,yBAAO,IAAI,MAAM,GAAG,KAAK,WAAW,GAAG,UAAU,WAAW,UAAU"}