learngraph 0.5.0 → 0.8.0

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,cAAc,kBAAkB,CAAC;AAMjC;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,YAAY,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,cAAc,kBAAkB,CAAC;AAKjC,OAAO,EAEL,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EAEnB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,8BAA8B,EAC9B,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EAEnB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EAEvB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EAEL,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EAExB,sBAAsB,EACtB,4BAA4B,EAE5B,qBAAqB,EACrB,2BAA2B,EAE3B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAMrC;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,YAAY,eAAe,CAAC"}

package/dist/types/llm/adapters/anthropic.d.ts

@@ -1,10 +1,70 @@
 /**
  * Anthropic adapter for LLM integration
  *
+ * Supports all Claude models including the latest Claude 4.5 family.
+ *
  * @packageDocumentation
  */
 import type { LLMProvider, AnthropicConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
 import { BaseLLMAdapter } from './base.js';
+/**
+ * Claude 4.5 Models (Latest - November 2025)
+ * - Opus 4.5: Most intelligent, complex reasoning
+ * - Sonnet 4.5: Best for coding & agents
+ * - Haiku 4.5: Fast & cost-effective
+ */
+export declare const CLAUDE_4_5_MODELS: {
+    readonly 'opus-4.5': "claude-opus-4-5-20251101";
+    readonly 'sonnet-4.5': "claude-sonnet-4-5-20250514";
+    readonly 'haiku-4.5': "claude-haiku-4-5-20251001";
+};
+/**
+ * Claude 4 Models (May-August 2025)
+ */
+export declare const CLAUDE_4_MODELS: {
+    readonly 'opus-4.1': "claude-opus-4-1-20250805";
+    readonly 'opus-4': "claude-opus-4-20250514";
+    readonly 'sonnet-4': "claude-sonnet-4-20250514";
+};
+/**
+ * Claude 3.5 Models (Legacy - 2024)
+ */
+export declare const CLAUDE_3_5_MODELS: {
+    readonly 'sonnet-3.5': "claude-3-5-sonnet-20241022";
+    readonly 'haiku-3.5': "claude-3-5-haiku-20241022";
+};
+/**
+ * Claude 3 Models (Legacy - Early 2024)
+ */
+export declare const CLAUDE_3_MODELS: {
+    readonly 'opus-3': "claude-3-opus-20240229";
+    readonly 'sonnet-3': "claude-3-sonnet-20240229";
+    readonly 'haiku-3': "claude-3-haiku-20240307";
+};
+/**
+ * All available Claude models
+ */
+export declare const CLAUDE_MODELS: {
+    readonly 'opus-3': "claude-3-opus-20240229";
+    readonly 'sonnet-3': "claude-3-sonnet-20240229";
+    readonly 'haiku-3': "claude-3-haiku-20240307";
+    readonly 'sonnet-3.5': "claude-3-5-sonnet-20241022";
+    readonly 'haiku-3.5': "claude-3-5-haiku-20241022";
+    readonly 'opus-4.1': "claude-opus-4-1-20250805";
+    readonly 'opus-4': "claude-opus-4-20250514";
+    readonly 'sonnet-4': "claude-sonnet-4-20250514";
+    readonly 'opus-4.5': "claude-opus-4-5-20251101";
+    readonly 'sonnet-4.5': "claude-sonnet-4-5-20250514";
+    readonly 'haiku-4.5': "claude-haiku-4-5-20251001";
+};
+/**
+ * Model alias type for convenient model selection
+ */
+export type ClaudeModelAlias = keyof typeof CLAUDE_MODELS;
+/**
+ * Resolve a model alias or ID to the full model ID
+ */
+export declare function resolveClaudeModel(modelOrAlias: string): string;
 /**
  * Anthropic adapter for Claude models
  */
@@ -16,6 +76,29 @@ export declare class AnthropicAdapter extends BaseLLMAdapter {
 }
 /**
  * Create an Anthropic adapter from environment variables
+ *
+ * @param model - Model ID or alias (e.g., 'sonnet-4.5', 'opus-4.5', 'haiku-4.5')
+ *                Use aliases for convenience or full model IDs for specific versions.
+ *                Any valid Claude model ID will work - not limited to the aliases.
+ *
+ * @example
+ * ```typescript
+ * // Using aliases (recommended)
+ * const adapter = createAnthropicAdapter('sonnet-4.5');
+ *
+ * // Using full model ID
+ * const adapter = createAnthropicAdapter('claude-opus-4-5-20251101');
+ *
+ * // Using a future model (when released)
+ * const adapter = createAnthropicAdapter('claude-opus-5-20260101');
+ * ```
+ */
+export declare function createAnthropicAdapter(model?: ClaudeModelAlias | string, overrides?: Partial<AnthropicConfig>): AnthropicAdapter;
+/**
+ * List all available Claude model aliases
  */
-export declare function createAnthropicAdapter(model?: string, overrides?: Partial<AnthropicConfig>): AnthropicAdapter;
+export declare function listClaudeModels(): {
+    alias: string;
+    modelId: string;
+}[];
 //# sourceMappingURL=anthropic.d.ts.map

package/dist/types/llm/adapters/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAiCrE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,eAAe;IAKnC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAyGxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,SAA+B,EACpC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACnC,gBAAgB,CAclB"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAQrE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;CAKhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D;AAiCD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,eAAe;IAKnC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAyGxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,gBAAgB,GAAG,MAAqB,EAC/C,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACnC,gBAAgB,CAclB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAKvE"}

package/dist/types/llm/adapters/gemini.d.ts

@@ -1,18 +1,79 @@
 /**
  * Google Gemini LLM adapter
  *
+ * Supports all Gemini models including the latest Gemini 3 family.
+ *
  * @packageDocumentation
  */
 import type { LLMProvider, GeminiConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
 import { BaseLLMAdapter } from './base.js';
+/**
+ * Gemini 3 Models (Latest - December 2025)
+ * - gemini-3-pro: Most intelligent, PhD-level reasoning
+ * - gemini-3-flash: Fast frontier performance
+ * - gemini-3-deep-think: Extended reasoning mode
+ */
+export declare const GEMINI_3_MODELS: {
+    readonly 'gemini-3-pro': "gemini-3.0-pro";
+    readonly 'gemini-3-flash': "gemini-3.0-flash";
+    readonly 'gemini-3-deep-think': "gemini-3.0-deep-think";
+};
+/**
+ * Gemini 2.5 Models (2025)
+ * - Best price-performance ratio
+ */
+export declare const GEMINI_2_5_MODELS: {
+    readonly 'gemini-2.5-pro': "gemini-2.5-pro";
+    readonly 'gemini-2.5-flash': "gemini-2.5-flash";
+    readonly 'gemini-2.5-flash-lite': "gemini-2.5-flash-lite";
+};
+/**
+ * Gemini 2.0 Models (Late 2024 - Early 2025)
+ */
+export declare const GEMINI_2_0_MODELS: {
+    readonly 'gemini-2.0-flash': "gemini-2.0-flash";
+    readonly 'gemini-2.0-flash-exp': "gemini-2.0-flash-exp";
+};
+/**
+ * Gemini 1.5 Models (Legacy - 2024)
+ */
+export declare const GEMINI_1_5_MODELS: {
+    readonly 'gemini-1.5-pro': "gemini-1.5-pro";
+    readonly 'gemini-1.5-flash': "gemini-1.5-flash";
+};
+/**
+ * All available Gemini models
+ */
+export declare const GEMINI_MODELS: {
+    readonly 'gemini-1.5-pro': "gemini-1.5-pro";
+    readonly 'gemini-1.5-flash': "gemini-1.5-flash";
+    readonly 'gemini-2.0-flash': "gemini-2.0-flash";
+    readonly 'gemini-2.0-flash-exp': "gemini-2.0-flash-exp";
+    readonly 'gemini-2.5-pro': "gemini-2.5-pro";
+    readonly 'gemini-2.5-flash': "gemini-2.5-flash";
+    readonly 'gemini-2.5-flash-lite': "gemini-2.5-flash-lite";
+    readonly 'gemini-3-pro': "gemini-3.0-pro";
+    readonly 'gemini-3-flash': "gemini-3.0-flash";
+    readonly 'gemini-3-deep-think': "gemini-3.0-deep-think";
+};
+/**
+ * Model alias type for convenient model selection
+ */
+export type GeminiModelAlias = keyof typeof GEMINI_MODELS;
+/**
+ * Resolve a model alias or ID to the full model ID
+ */
+export declare function resolveGeminiModel(modelOrAlias: string): string;
 /**
  * Adapter for Google Gemini models
  *
- * Supports:
- * - gemini-2.0-flash-exp
- * - gemini-1.5-pro
- * - gemini-1.5-flash
- * - gemini-1.0-pro
+ * Supports all Gemini models including:
+ * - Gemini 3: gemini-3-pro, gemini-3-flash, gemini-3-deep-think
+ * - Gemini 2.5: gemini-2.5-pro, gemini-2.5-flash
+ * - Gemini 2.0: gemini-2.0-flash
+ * - Legacy: gemini-1.5-pro, gemini-1.5-flash
+ *
+ * Any valid Gemini model ID will work.
  */
 export declare class GeminiAdapter extends BaseLLMAdapter {
     private readonly baseUrl;
@@ -25,6 +86,32 @@ export declare class GeminiAdapter extends BaseLLMAdapter {
 }
 /**
  * Create a Gemini adapter from environment variables
+ *
+ * @param model - Model ID or alias (e.g., 'gemini-3-flash', 'gemini-3-pro', 'gemini-2.5-flash')
+ *                Use aliases for convenience or full model IDs for specific versions.
+ *                Any valid Gemini model ID will work - not limited to the aliases.
+ *
+ * @example
+ * ```typescript
+ * // Using latest fast model
+ * const adapter = createGeminiAdapter('gemini-3-flash');
+ *
+ * // Using most capable model
+ * const adapter = createGeminiAdapter('gemini-3-pro');
+ *
+ * // Using cost-effective option
+ * const adapter = createGeminiAdapter('gemini-2.5-flash');
+ *
+ * // Using a future model (when released)
+ * const adapter = createGeminiAdapter('gemini-4-ultra');
+ * ```
+ */
+export declare function createGeminiAdapter(model?: GeminiModelAlias | string, overrides?: Partial<GeminiConfig>): GeminiAdapter;
+/**
+ * List all available Gemini model aliases
  */
-export declare function createGeminiAdapter(model?: string, overrides?: Partial<GeminiConfig>): GeminiAdapter;
+export declare function listGeminiModels(): {
+    alias: string;
+    modelId: string;
+}[];
 //# sourceMappingURL=gemini.d.ts.map

package/dist/types/llm/adapters/gemini.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAY,MAAM,WAAW,CAAC;AAsCrD;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAOhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2BvE,OAAO,CAAC,YAAY;YAgCN,cAAc;IAyC5B,OAAO,CAAC,aAAa;CA6CtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,SAAyB,EAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAkBf"}
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAY,MAAM,WAAW,CAAC;AAQrD;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;CAKhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D;AAsCD;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAOhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2BvE,OAAO,CAAC,YAAY;YAgCN,cAAc;IAyC5B,OAAO,CAAC,aAAa;CA6CtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,GAAE,gBAAgB,GAAG,MAAyB,EACnD,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAkBf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAKvE"}

package/dist/types/llm/adapters/index.d.ts

@@ -1,14 +1,23 @@
 /**
  * LLM adapter exports
  *
+ * All adapters support flexible model selection:
+ * - Use model aliases for convenience (e.g., 'sonnet-4.5', 'gpt-5', 'gemini-3-flash')
+ * - Use full model IDs for specific versions
+ * - Use any valid model ID string for future models
+ *
  * @packageDocumentation
  */
 export { BaseLLMAdapter, LLMError, DEFAULT_CONFIG } from './base.js';
 export type { LLMErrorCode } from './base.js';
-export { OpenAIAdapter, createOpenAIAdapter } from './openai.js';
-export { AnthropicAdapter, createAnthropicAdapter } from './anthropic.js';
-export { OllamaAdapter, createOllamaAdapter } from './ollama.js';
-export { GeminiAdapter, createGeminiAdapter } from './gemini.js';
+export { OpenAIAdapter, createOpenAIAdapter, resolveOpenAIModel, listOpenAIModels, OPENAI_MODELS, GPT_5_MODELS, O_SERIES_MODELS, GPT_4_1_MODELS, GPT_4O_MODELS, GPT_4_LEGACY_MODELS, } from './openai.js';
+export type { OpenAIModelAlias } from './openai.js';
+export { AnthropicAdapter, createAnthropicAdapter, resolveClaudeModel, listClaudeModels, CLAUDE_MODELS, CLAUDE_4_5_MODELS, CLAUDE_4_MODELS, CLAUDE_3_5_MODELS, CLAUDE_3_MODELS, } from './anthropic.js';
+export type { ClaudeModelAlias } from './anthropic.js';
+export { OllamaAdapter, createOllamaAdapter, resolveOllamaModel, listOllamaModels, OLLAMA_MODELS, LLAMA_MODELS, MISTRAL_MODELS, QWEN_MODELS, CODING_MODELS, SMALL_MODELS, } from './ollama.js';
+export type { OllamaModelAlias } from './ollama.js';
+export { GeminiAdapter, createGeminiAdapter, resolveGeminiModel, listGeminiModels, GEMINI_MODELS, GEMINI_3_MODELS, GEMINI_2_5_MODELS, GEMINI_2_0_MODELS, GEMINI_1_5_MODELS, } from './gemini.js';
+export type { GeminiModelAlias } from './gemini.js';
 export { OpenRouterAdapter, createOpenRouterAdapter, OPENROUTER_MODELS } from './openrouter.js';
 export { MediaPipeAdapter, createMediaPipeAdapter, MEDIAPIPE_MODELS } from './mediapipe.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/llm/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGhG,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/llm/adapters/ollama.d.ts

@@ -1,10 +1,109 @@
 /**
  * Ollama adapter for local LLM integration
  *
+ * Supports any model available through Ollama including Llama, Mistral, Qwen, and more.
+ *
  * @packageDocumentation
  */
 import type { LLMProvider, OllamaConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
 import { BaseLLMAdapter } from './base.js';
+/**
+ * Meta Llama Models (Latest)
+ * - llama3.3: 70B parameter model, excellent general purpose
+ * - llama3.2: Available in 1B, 3B, and vision variants
+ */
+export declare const LLAMA_MODELS: {
+    readonly 'llama3.3': "llama3.3";
+    readonly 'llama3.3:70b': "llama3.3:70b";
+    readonly 'llama3.2': "llama3.2";
+    readonly 'llama3.2:1b': "llama3.2:1b";
+    readonly 'llama3.2:3b': "llama3.2:3b";
+    readonly 'llama3.2-vision': "llama3.2-vision";
+    readonly 'llama3.1': "llama3.1";
+    readonly 'llama3.1:8b': "llama3.1:8b";
+    readonly 'llama3.1:70b': "llama3.1:70b";
+};
+/**
+ * Mistral Models
+ * - mistral-large: Most capable Mistral model
+ * - mistral-nemo: Fast, efficient
+ * - mixtral: Mixture of experts
+ */
+export declare const MISTRAL_MODELS: {
+    readonly 'mistral-large': "mistral-large";
+    readonly 'mistral-nemo': "mistral-nemo";
+    readonly mistral: "mistral";
+    readonly mixtral: "mixtral";
+    readonly 'mixtral:8x7b': "mixtral:8x7b";
+};
+/**
+ * Qwen Models (Alibaba)
+ * - qwen2.5: Latest Qwen release
+ * - qwen2.5-coder: Optimized for coding
+ */
+export declare const QWEN_MODELS: {
+    readonly 'qwen2.5': "qwen2.5";
+    readonly 'qwen2.5:72b': "qwen2.5:72b";
+    readonly 'qwen2.5-coder': "qwen2.5-coder";
+    readonly qwen2: "qwen2";
+};
+/**
+ * Coding-Focused Models
+ */
+export declare const CODING_MODELS: {
+    readonly codellama: "codellama";
+    readonly 'deepseek-coder-v2': "deepseek-coder-v2";
+    readonly codegemma: "codegemma";
+    readonly starcoder2: "starcoder2";
+};
+/**
+ * Small/Fast Models
+ */
+export declare const SMALL_MODELS: {
+    readonly phi3: "phi3";
+    readonly 'phi3:mini': "phi3:mini";
+    readonly gemma2: "gemma2";
+    readonly 'gemma2:2b': "gemma2:2b";
+};
+/**
+ * All popular Ollama models
+ */
+export declare const OLLAMA_MODELS: {
+    readonly phi3: "phi3";
+    readonly 'phi3:mini': "phi3:mini";
+    readonly gemma2: "gemma2";
+    readonly 'gemma2:2b': "gemma2:2b";
+    readonly codellama: "codellama";
+    readonly 'deepseek-coder-v2': "deepseek-coder-v2";
+    readonly codegemma: "codegemma";
+    readonly starcoder2: "starcoder2";
+    readonly 'qwen2.5': "qwen2.5";
+    readonly 'qwen2.5:72b': "qwen2.5:72b";
+    readonly 'qwen2.5-coder': "qwen2.5-coder";
+    readonly qwen2: "qwen2";
+    readonly 'mistral-large': "mistral-large";
+    readonly 'mistral-nemo': "mistral-nemo";
+    readonly mistral: "mistral";
+    readonly mixtral: "mixtral";
+    readonly 'mixtral:8x7b': "mixtral:8x7b";
+    readonly 'llama3.3': "llama3.3";
+    readonly 'llama3.3:70b': "llama3.3:70b";
+    readonly 'llama3.2': "llama3.2";
+    readonly 'llama3.2:1b': "llama3.2:1b";
+    readonly 'llama3.2:3b': "llama3.2:3b";
+    readonly 'llama3.2-vision': "llama3.2-vision";
+    readonly 'llama3.1': "llama3.1";
+    readonly 'llama3.1:8b': "llama3.1:8b";
+    readonly 'llama3.1:70b': "llama3.1:70b";
+};
+/**
+ * Model alias type for convenient model selection
+ */
+export type OllamaModelAlias = keyof typeof OLLAMA_MODELS;
+/**
+ * Resolve a model alias or name (passthrough for Ollama since names are direct)
+ */
+export declare function resolveOllamaModel(modelOrAlias: string): string;
 /**
  * Ollama adapter for local models
  */
@@ -25,6 +124,32 @@ export declare class OllamaAdapter extends BaseLLMAdapter {
 }
 /**
  * Create an Ollama adapter
+ *
+ * @param model - Any model name that's been pulled via `ollama pull <model>`
+ *                Common models: llama3.3, mistral, qwen2.5, codellama
+ *                Run `ollama list` to see installed models.
+ *
+ * @example
+ * ```typescript
+ * // Using latest Llama model
+ * const adapter = createOllamaAdapter('llama3.3');
+ *
+ * // Using Mistral
+ * const adapter = createOllamaAdapter('mistral-large');
+ *
+ * // Using coding-focused model
+ * const adapter = createOllamaAdapter('qwen2.5-coder');
+ *
+ * // Using any custom or fine-tuned model
+ * const adapter = createOllamaAdapter('my-custom-model');
+ * ```
+ */
+export declare function createOllamaAdapter(model?: OllamaModelAlias | string, overrides?: Partial<OllamaConfig>): OllamaAdapter;
+/**
+ * List popular Ollama model aliases
  */
-export declare function createOllamaAdapter(model?: string, overrides?: Partial<OllamaConfig>): OllamaAdapter;
+export declare function listOllamaModels(): {
+    alias: string;
+    modelId: string;
+}[];
 //# sourceMappingURL=ollama.d.ts.map

package/dist/types/llm/adapters/ollama.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/ollama.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAuBrE;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAKhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAED,YAAY,IAAI,OAAO;IAIjB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+GvE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAgBtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,SAAa,EAClB,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAOf"}
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AASrE;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D;AAuBD;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAKhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAED,YAAY,IAAI,OAAO;IAIjB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+GvE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAgBtC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,GAAE,gBAAgB,GAAG,MAAmB,EAC7C,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAOf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAKvE"}

package/dist/types/llm/adapters/openai.d.ts

@@ -1,10 +1,87 @@
 /**
  * OpenAI adapter for LLM integration
  *
+ * Supports all OpenAI models including GPT-5, o3, and GPT-4.1 families.
+ *
  * @packageDocumentation
  */
 import type { LLMProvider, OpenAIConfig, CompletionRequest, CompletionResponse } from '../../types/llm.js';
 import { BaseLLMAdapter } from './base.js';
+/**
+ * GPT-5 Models (Latest - 2025)
+ * - gpt-5: Flagship model for general-purpose and agentic use
+ * - gpt-5-mini: Smaller, faster version
+ * - gpt-5-nano: Smallest, most cost-effective
+ */
+export declare const GPT_5_MODELS: {
+    readonly 'gpt-5': "gpt-5";
+    readonly 'gpt-5-mini': "gpt-5-mini";
+    readonly 'gpt-5-nano': "gpt-5-nano";
+};
+/**
+ * o-Series Reasoning Models (Latest - 2025)
+ * - o3: Most powerful reasoning model
+ * - o3-pro: Extended thinking for complex tasks
+ * - o4-mini: Fast, cost-efficient reasoning
+ */
+export declare const O_SERIES_MODELS: {
+    readonly o3: "o3";
+    readonly 'o3-pro': "o3-pro";
+    readonly 'o4-mini': "o4-mini";
+    readonly o1: "o1";
+};
+/**
+ * GPT-4.1 Models (2025)
+ * - Major gains in coding and instruction following
+ * - Up to 1M token context
+ */
+export declare const GPT_4_1_MODELS: {
+    readonly 'gpt-4.1': "gpt-4.1";
+    readonly 'gpt-4.1-mini': "gpt-4.1-mini";
+    readonly 'gpt-4.1-nano': "gpt-4.1-nano";
+};
+/**
+ * GPT-4o Models (2024-2025)
+ * - Optimized for speed and multimodal
+ */
+export declare const GPT_4O_MODELS: {
+    readonly 'gpt-4o': "gpt-4o";
+    readonly 'gpt-4o-mini': "gpt-4o-mini";
+};
+/**
+ * Legacy GPT-4 Models
+ */
+export declare const GPT_4_LEGACY_MODELS: {
+    readonly 'gpt-4-turbo': "gpt-4-turbo";
+    readonly 'gpt-4': "gpt-4";
+};
+/**
+ * All available OpenAI models
+ */
+export declare const OPENAI_MODELS: {
+    readonly 'gpt-4-turbo': "gpt-4-turbo";
+    readonly 'gpt-4': "gpt-4";
+    readonly 'gpt-4o': "gpt-4o";
+    readonly 'gpt-4o-mini': "gpt-4o-mini";
+    readonly 'gpt-4.1': "gpt-4.1";
+    readonly 'gpt-4.1-mini': "gpt-4.1-mini";
+    readonly 'gpt-4.1-nano': "gpt-4.1-nano";
+    readonly o3: "o3";
+    readonly 'o3-pro': "o3-pro";
+    readonly 'o4-mini': "o4-mini";
+    readonly o1: "o1";
+    readonly 'gpt-5': "gpt-5";
+    readonly 'gpt-5-mini': "gpt-5-mini";
+    readonly 'gpt-5-nano': "gpt-5-nano";
+};
+/**
+ * Model alias type for convenient model selection
+ */
+export type OpenAIModelAlias = keyof typeof OPENAI_MODELS;
+/**
+ * Resolve a model alias or ID to the full model ID
+ */
+export declare function resolveOpenAIModel(modelOrAlias: string): string;
 /**
  * OpenAI adapter for chat completions
  */
@@ -17,6 +94,32 @@ export declare class OpenAIAdapter extends BaseLLMAdapter {
 }
 /**
  * Create an OpenAI adapter from environment variables
+ *
+ * @param model - Model ID or alias (e.g., 'gpt-5', 'o3', 'gpt-4.1', 'gpt-4o')
+ *                Use aliases for convenience or full model IDs for specific versions.
+ *                Any valid OpenAI model ID will work - not limited to the aliases.
+ *
+ * @example
+ * ```typescript
+ * // Using current flagship model
+ * const adapter = createOpenAIAdapter('gpt-5');
+ *
+ * // Using reasoning model for complex tasks
+ * const adapter = createOpenAIAdapter('o3');
+ *
+ * // Using fast, cost-effective reasoning
+ * const adapter = createOpenAIAdapter('o4-mini');
+ *
+ * // Using a future model (when released)
+ * const adapter = createOpenAIAdapter('gpt-6');
+ * ```
+ */
+export declare function createOpenAIAdapter(model?: OpenAIModelAlias | string, overrides?: Partial<OpenAIConfig>): OpenAIAdapter;
+/**
+ * List all available OpenAI model aliases
  */
-export declare function createOpenAIAdapter(model?: string, overrides?: Partial<OpenAIConfig>): OpenAIAdapter;
+export declare function listOpenAIModels(): {
+    alias: string;
+    modelId: string;
+}[];
 //# sourceMappingURL=openai.d.ts.map

package/dist/types/llm/adapters/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAuCrE;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;gBAE3B,MAAM,EAAE,YAAY;IAQhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuGxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,SAAW,EAChB,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAcf"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/llm/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AAQrE;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;CAMhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D;AAuCD;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;gBAE3B,MAAM,EAAE,YAAY;IAQhC,IAAI,QAAQ,IAAI,WAAW,CAE1B;IAEK,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuGxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,GAAE,gBAAgB,GAAG,MAAiB,EAC3C,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,aAAa,CAcf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAKvE"}