@olane/o-intelligence 0.8.3 → 0.8.4

package/README.md

@@ -6,7 +6,7 @@ Multi-provider AI intelligence router for Olane OS that provides a unified inter
 
 ```bash
 # Installation
-npm install @olane/o-intelligence
+pnpm install @olane/o-intelligence
 ```
 
 ```typescript
@@ -87,7 +87,7 @@ console.log(result.result.data.message);
 Configure which AI provider to use and store preferences securely.
 
 **Parameters:**
-- `modelProvider` (string, optional): Provider to use (`anthropic`, `openai`, `ollama`, `perplexity`, `grok`)
+- `modelProvider` (string, optional): Provider to use (`anthropic`, `openai`, `ollama`, `perplexity`, `grok`, `gemini`)
 - `hostingProvider` (string, optional): Where models are hosted (`olane`, `local`)
 - `accessToken` (string, optional): Access token for hosted models
 - `address` (string, optional): Custom address for hosted models
@@ -111,18 +111,17 @@ Each provider node (`o://anthropic`, `o://openai`, etc.) exposes these tools:
 
 #### `completion` - Multi-Turn Conversation
 
-Generate responses with conversation history and system prompts.
+Generate responses with conversation history. This is the primary method for interacting with provider nodes.
 
-**Parameters:**
+**Parameters (from `LLM_PARAMS`):**
+- `model` (string, optional): Specific model to use (defaults to provider's default model)
 - `messages` (array, required): Conversation history
   - `role` (string): `user` or `assistant`
   - `content` (string | array): Message content
-- `model` (string, optional): Specific model to use
-- `system` (string, optional): System message for behavior control
-- `max_tokens` (number, optional): Maximum tokens to generate (default: 1000)
-- `temperature` (number, optional): Randomness control (0-1)
-- `top_p` (number, optional): Nucleus sampling (0-1)
-- `apiKey` (string, optional): Override API key
+- `options` (object, optional): Provider-specific generation options (e.g., `temperature`, `max_tokens`, `top_p`, `system`). See note on two-tier architecture below.
+- `stream` (boolean, optional): Whether to stream the response
+
+> **Note**: Parameters like `system`, `max_tokens`, `temperature`, `apiKey` are not defined in the `LLM_PARAMS` method definition. However, providers destructure additional parameters from `request.params` at runtime. Pass provider-specific options via the `options` object or as top-level params depending on the provider. See [Two-Tier Architecture](#two-tier-architecture) for details.
 
 **Returns:** Response with message, model info, and token usage
 
@@ -154,13 +153,11 @@ console.log(response.result.data);
 
 Generate text from a single prompt (simpler than completion).
 
-**Parameters:**
-- `prompt` (string, required): Input prompt
-- `model` (string, optional): Model to use
-- `system` (string, optional): System message
-- `max_tokens` (number, optional): Token limit
-- `temperature` (number, optional): Randomness
-- `apiKey` (string, optional): Override API key
+**Parameters (from `LLM_PARAMS`):**
+- `model` (string, required): The model to use for generation
+- `stream` (boolean, optional): Whether to stream the response
+
+> **Note**: The `LLM_PARAMS` method definition only specifies `model` and `stream`. However, provider implementations accept additional runtime parameters like `prompt`, `system`, `max_tokens`, and `apiKey` via `request.params`. See [Two-Tier Architecture](#two-tier-architecture) for details.
 
 **Returns:** Generated text response
 
@@ -171,6 +168,7 @@ const result = await intelligence.use(new oAddress('o://openai'), {
   params: {
     apiKey: process.env.OPENAI_API_KEY,
     prompt: 'Explain REST APIs in one paragraph',
+    model: 'gpt-4-turbo-preview',
     max_tokens: 200
   }
 });
@@ -252,6 +250,242 @@ console.log(status.result.data);
 // { success: true, status: 'ok', response: 'Anthropic API is accessible' }
 ```
 
+#### `pull_model` - Pull Model (Ollama)
+
+Download a model from the Ollama library to the local machine.
+
+**Parameters:**
+- `model` (string, required): The model name to pull (e.g., `llama2`, `codellama`)
+- `insecure` (boolean, optional): Whether to allow insecure connections
+
+**Returns:** Success confirmation with pull details
+
+**Example:**
+```typescript
+const result = await intelligence.use(new oAddress('o://ollama'), {
+  method: 'pull_model',
+  params: {
+    model: 'llama3.2:latest'
+  }
+});
+
+console.log(result.result.data);
+// { success: true, message: 'Model llama3.2:latest pulled successfully', details: '...' }
+```
+
+> **Note**: This method is only available on the Ollama provider (`o://ollama`).
+
+---
+
+#### `delete_model` - Delete Model (Ollama)
+
+Remove a model from the local Ollama installation.
+
+**Parameters:**
+- `model` (string, required): The model name to delete
+
+**Returns:** Success confirmation
+
+**Example:**
+```typescript
+const result = await intelligence.use(new oAddress('o://ollama'), {
+  method: 'delete_model',
+  params: {
+    model: 'llama2'
+  }
+});
+
+console.log(result.result.data);
+// { success: true, message: 'Model llama2 deleted successfully' }
+```
+
+> **Note**: This method is only available on the Ollama provider (`o://ollama`).
+
+---
+
+#### `embed_documents` - Generate Document Embeddings
+
+Generate vector embeddings for multiple text documents. Useful for semantic search and RAG applications.
+
+**Parameters:**
+- `input` (array, required): Array of text strings to embed
+- `model` (string, optional): The embedding model to use
+- `apiKey` (string, optional): API key (falls back to environment variable)
+- `dimensions` (number, optional): Number of embedding dimensions (only for text-embedding-3 models)
+
+**Returns:** Array of embedding vectors
+
+**Example:**
+```typescript
+const result = await intelligence.use(new oAddress('o://openai'), {
+  method: 'embed_documents',
+  params: {
+    input: ['First document text', 'Second document text'],
+    model: 'text-embedding-3-small',
+    apiKey: process.env.OPENAI_API_KEY
+  }
+});
+
+console.log(result.result.data);
+```
+
+> **Note**: Available on providers that support embeddings (OpenAI, Gemini, Ollama).
+
+---
+
+#### `embed_query` - Generate Query Embedding
+
+Generate a vector embedding for a single query string. Optimized for search queries.
+
+**Parameters:**
+- `input` (string, required): Text string to embed
+- `model` (string, optional): The embedding model to use
+- `apiKey` (string, optional): API key (falls back to environment variable)
+- `dimensions` (number, optional): Number of embedding dimensions (only for text-embedding-3 models)
+
+**Returns:** Embedding vector
+
+**Example:**
+```typescript
+const result = await intelligence.use(new oAddress('o://openai'), {
+  method: 'embed_query',
+  params: {
+    input: 'What is machine learning?',
+    model: 'text-embedding-3-small',
+    apiKey: process.env.OPENAI_API_KEY
+  }
+});
+
+console.log(result.result.data);
+```
+
+> **Note**: Available on providers that support embeddings (OpenAI, Gemini, Ollama).
+
+---
+
+#### `generate_image` - Generate Images (Gemini)
+
+Generate images from text prompts using Gemini image models.
+
+**Parameters:**
+- `prompt` (string, required): Text description of the desired image
+- `model` (string, optional): Model to use (`gemini-2.5-flash-image` (default) or `gemini-3-pro-image-preview`)
+- `aspectRatio` (string, optional): Aspect ratio (e.g., `1:1`, `16:9`, `9:16`). Default: `1:1`
+- `imageSize` (string, optional): Size (`1K`, `2K` (default), `4K`)
+- `negativePrompt` (string, optional): Description of what to avoid in the image
+
+**Returns:** Generated image data
+
+**Example:**
+```typescript
+const result = await intelligence.use(new oAddress('o://gemini'), {
+  method: 'generate_image',
+  params: {
+    prompt: 'A serene mountain landscape at sunset',
+    aspectRatio: '16:9',
+    imageSize: '2K'
+  }
+});
+
+console.log(result.result.data);
+```
+
+> **Note**: This method is only available on the Gemini provider (`o://gemini`).
+
+---
+
+#### `edit_image` - Edit Images (Gemini)
+
+Edit or transform an existing image using Gemini image models.
+
+**Parameters:**
+- `prompt` (string, required): Instructions for how to edit the image
+- `image` (string, required): Base64-encoded image data or file path (JPEG, PNG)
+- `model` (string, optional): Model to use (`gemini-2.5-flash-image` (default) or `gemini-3-pro-image-preview`)
+- `aspectRatio` (string, optional): Aspect ratio for the edited image
+- `imageSize` (string, optional): Size of the edited image (`1K`, `2K` (default), `4K`)
+
+**Returns:** Edited image data
+
+**Example:**
+```typescript
+const result = await intelligence.use(new oAddress('o://gemini'), {
+  method: 'edit_image',
+  params: {
+    prompt: 'Remove the background and replace with a white backdrop',
+    image: '/path/to/image.png',
+    imageSize: '2K'
+  }
+});
+
+console.log(result.result.data);
+```
+
+> **Note**: This method is only available on the Gemini provider (`o://gemini`).
+
+---
+
+## Two-Tier Architecture {#two-tier-architecture}
+
+`o-intelligence` uses a two-tier method parameter architecture:
+
+### `INTELLIGENCE_PARAMS` (Router Level)
+
+Defined in `intelligence.methods.ts`, these are the methods exposed by the `o://intelligence` router node:
+- `configure` - Set provider preferences (`modelProvider`, `hostingProvider`)
+- `prompt` - Simple AI prompting (`prompt`, `userMessage`, `stream`)
+
+These are high-level orchestration methods that handle provider selection and routing.
+
+### `LLM_PARAMS` (Provider Level)
+
+Defined in `llm.methods.ts`, these are the methods exposed by each provider child node (`o://anthropic`, `o://openai`, etc.):
+- `completion` - Multi-turn conversation (`model`, `messages`, `options`, `stream`)
+- `generate` - Simple text generation (`model`, `stream`)
+- `list_models` - List available models
+- `pull_model` - Pull model (Ollama-specific)
+- `delete_model` - Delete model (Ollama-specific)
+- `model_info` - Get model details (`model`)
+- `status` - Check provider health
+- `embed_documents` - Generate document embeddings
+- `embed_query` - Generate query embedding
+- `generate_image` - Generate images (Gemini-specific)
+- `edit_image` - Edit images (Gemini-specific)
+
+**Important**: The `LLM_PARAMS` definitions specify the formal parameter schema for AI discovery. However, individual provider implementations accept additional runtime parameters (like `apiKey`, `system`, `max_tokens`, `temperature`) that are destructured directly from `request.params`. This means you can pass these extra parameters when calling providers, even though they are not declared in the method schema.
+
+## Response Structure {#response-structure}
+
+When calling provider methods via `node.use()`, responses follow the standard Olane response pattern:
+
+```typescript
+const response = await intelligence.use(new oAddress('o://anthropic'), {
+  method: 'completion',
+  params: { messages: [...], model: 'claude-sonnet-4-5-20250929' }
+});
+
+// Always check success first
+if (response.result.success) {
+  const data = response.result.data;
+  console.log(data.message);  // The generated text
+  console.log(data.model);    // Model used
+  console.log(data.usage);    // Token usage info
+} else {
+  console.error(response.result.error);  // Error message string
+}
+
+// Full response shape:
+// {
+//   jsonrpc: "2.0",
+//   id: "request-id",
+//   result: {
+//     success: boolean,
+//     data: any,          // Present on success
+//     error?: string      // Present on failure
+//   }
+// }
+```
+
 ## Configuration {#configuration}
 
 ### Environment Variables
@@ -267,7 +501,7 @@ export GROK_API_KEY="..."
 export SONAR_API_KEY="..."  # Perplexity
 
 # Provider Selection
-export MODEL_PROVIDER_CHOICE="anthropic"  # anthropic, openai, ollama, perplexity, grok
+export MODEL_PROVIDER_CHOICE="anthropic"  # anthropic, openai, ollama, perplexity, grok, gemini
 ```
 
 ### Secure Storage
@@ -292,7 +526,7 @@ If no configuration is found, users will be prompted:
 
 ```bash
 # Terminal output when no provider is configured:
-? Which AI model do you want to use? (anthropic, openai, ollama, perplexity, grok)
+? Which AI model do you want to use? (anthropic, openai, ollama, perplexity, grok, gemini)
 > anthropic
 
 ? What is the API key for the anthropic model?
@@ -384,7 +618,7 @@ async function generateWithFallback(prompt: string) {
         }
       });
 
-      if (response.result.data.success !== false) {
+      if (response.result.success) {
         return response.result.data;
       }
     } catch (error) {
@@ -585,6 +819,8 @@ enum LLMProviders {
 }
 ```
 
+> **Note**: Gemini is supported as a provider (`o://gemini`) with `GeminiIntelligenceTool`, but is not currently listed in the `LLMProviders` enum. It can be used by directly addressing `o://gemini` when the provider is initialized.
+
 ### HostModelProvider
 
 Where AI models are hosted.
@@ -680,7 +916,7 @@ await intelligence.use(new oAddress('o://intelligence'), {
 
 **Solution:** Use a valid provider:
 ```bash
-export MODEL_PROVIDER_CHOICE="anthropic"  # anthropic, openai, ollama, perplexity, grok
+export MODEL_PROVIDER_CHOICE="anthropic"  # anthropic, openai, ollama, perplexity, grok, gemini
 ```
 
 ---

package/dist/src/enums/intelligence-storage-keys.enum.d.ts

@@ -1,5 +1,6 @@
 export declare enum IntelligenceStorageKeys {
     MODEL_PROVIDER_PREFERENCE = "model-provider-preference",
+    MODEL_CHOICE = "model-choice",
     API_KEY_SUFFIX = "api-key",
     HOSTING_PROVIDER_PREFERENCE = "hosting-provider-preference",
     ACCESS_TOKEN = "access-token",

package/dist/src/enums/intelligence-storage-keys.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intelligence-storage-keys.enum.d.ts","sourceRoot":"","sources":["../../../src/enums/intelligence-storage-keys.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,uBAAuB;IACjC,yBAAyB,8BAA8B;IACvD,cAAc,YAAY;IAC1B,2BAA2B,gCAAgC;IAC3D,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;CAChC"}
+{"version":3,"file":"intelligence-storage-keys.enum.d.ts","sourceRoot":"","sources":["../../../src/enums/intelligence-storage-keys.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,uBAAuB;IACjC,yBAAyB,8BAA8B;IACvD,YAAY,iBAAiB;IAC7B,cAAc,YAAY;IAC1B,2BAA2B,gCAAgC;IAC3D,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;CAChC"}

package/dist/src/enums/intelligence-storage-keys.enum.js

@@ -1,6 +1,7 @@
 export var IntelligenceStorageKeys;
 (function (IntelligenceStorageKeys) {
     IntelligenceStorageKeys["MODEL_PROVIDER_PREFERENCE"] = "model-provider-preference";
+    IntelligenceStorageKeys["MODEL_CHOICE"] = "model-choice";
     IntelligenceStorageKeys["API_KEY_SUFFIX"] = "api-key";
     IntelligenceStorageKeys["HOSTING_PROVIDER_PREFERENCE"] = "hosting-provider-preference";
     IntelligenceStorageKeys["ACCESS_TOKEN"] = "access-token";

package/dist/src/interfaces/configure.request.d.ts

@@ -8,6 +8,7 @@ export interface ConfigureRequest extends oRequest {
         hostingProvider: HostModelProvider;
         accessToken: string;
         address: string;
+        model: string;
     };
 }
 //# sourceMappingURL=configure.request.d.ts.map

package/dist/src/interfaces/configure.request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.request.d.ts","sourceRoot":"","sources":["../../../src/interfaces/configure.request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,MAAM,EAAE,aAAa,GAAG;QACtB,aAAa,EAAE,YAAY,CAAC;QAC5B,eAAe,EAAE,iBAAiB,CAAC;QACnC,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}
+{"version":3,"file":"configure.request.d.ts","sourceRoot":"","sources":["../../../src/interfaces/configure.request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,MAAM,EAAE,aAAa,GAAG;QACtB,aAAa,EAAE,YAAY,CAAC;QAC5B,eAAe,EAAE,iBAAiB,CAAC;QACnC,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/src/interfaces/prompt.request.d.ts

@@ -1,8 +1,11 @@
 import { oStreamRequest } from '@olane/o-node';
 import { RequestParams } from '@olane/o-protocol';
+import { LLMProviders } from '../enums/llm-providers.enum';
 export interface PromptRequest extends oStreamRequest {
     params: RequestParams & {
         prompt: string;
+        model?: string;
+        provider?: LLMProviders;
     };
 }
 //# sourceMappingURL=prompt.request.d.ts.map

package/dist/src/interfaces/prompt.request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.request.d.ts","sourceRoot":"","sources":["../../../src/interfaces/prompt.request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,MAAM,EAAE,aAAa,GAAG;QACtB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}
+{"version":3,"file":"prompt.request.d.ts","sourceRoot":"","sources":["../../../src/interfaces/prompt.request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,MAAM,EAAE,aAAa,GAAG;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,YAAY,CAAC;KACzB,CAAC;CACH"}

package/dist/src/methods/intelligence.methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intelligence.methods.d.ts","sourceRoot":"","sources":["../../../src/methods/intelligence.methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,eAAO,MAAM,mBAAmB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAiDzD,CAAC"}
+{"version":3,"file":"intelligence.methods.d.ts","sourceRoot":"","sources":["../../../src/methods/intelligence.methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,eAAO,MAAM,mBAAmB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAyEzD,CAAC"}

package/dist/src/methods/intelligence.methods.js

@@ -18,6 +18,13 @@ export const INTELLIGENCE_PARAMS = {
                 description: 'The hosting provider to use (olane, local)',
                 required: false,
             },
+            {
+                name: 'model',
+                type: 'string',
+                value: 'string',
+                description: 'Persistent model preference (e.g., claude-opus-4-20250514, gpt-4o). Stored in secure storage for future requests.',
+                required: false,
+            },
         ],
     },
     prompt: {
@@ -44,6 +51,20 @@ export const INTELLIGENCE_PARAMS = {
                 description: 'Whether to stream the response',
                 required: false,
             },
+            {
+                name: 'model',
+                type: 'string',
+                value: 'string',
+                description: 'Per-request model override (e.g., claude-opus-4-20250514, gpt-4o). Takes priority over configured model.',
+                required: false,
+            },
+            {
+                name: 'provider',
+                type: 'string',
+                value: 'string',
+                description: 'Per-request provider override (anthropic, openai, ollama, perplexity, grok, olane). Takes priority over configured provider.',
+                required: false,
+            },
         ],
     },
 };

package/dist/src/o-intelligence.tool.d.ts

@@ -15,10 +15,12 @@ export declare class IntelligenceTool extends oLaneTool {
     getProviderApiKey(provider: LLMProviders): Promise<{
         apiKey: string;
     }>;
+    getModelChoice(): Promise<string | undefined>;
     chooseIntelligence(request: PromptRequest): Promise<{
         choice: oAddress;
         apiKey: string;
         options: any;
+        model: string | undefined;
     }>;
     _tool_configure(request: ConfigureRequest): Promise<ToolResult>;
     _tool_prompt(request: PromptRequest): Promise<ToolResult>;

package/dist/src/o-intelligence.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-intelligence.tool.d.ts","sourceRoot":"","sources":["../../src/o-intelligence.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,QAAQ,EAAa,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ3C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,OAAO,CAAC,eAAe,CAAK;gBAChB,MAAM,EAAE,eAAe;IAuB7B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmBnD,gBAAgB,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA6DvD,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAsEtE,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;QACxD,MAAM,EAAE,QAAQ,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,GAAG,CAAC;KACd,CAAC;IAWI,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6C/D,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA0CzD,mBAAmB;IAsCnB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}
+{"version":3,"file":"o-intelligence.tool.d.ts","sourceRoot":"","sources":["../../src/o-intelligence.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,QAAQ,EAAa,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ3C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,OAAO,CAAC,eAAe,CAAK;gBAChB,MAAM,EAAE,eAAe;IAuB7B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmBnD,gBAAgB,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA6DvD,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAsEtE,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAa7C,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;QACxD,MAAM,EAAE,QAAQ,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,GAAG,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B,CAAC;IA6BI,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsD/D,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAyDzD,mBAAmB;IAsCnB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}

package/dist/src/o-intelligence.tool.js

@@ -162,18 +162,42 @@ export class IntelligenceTool extends oLaneTool {
             apiKey: apiKey,
         };
     }
+    async getModelChoice() {
+        if (process.env.MODEL_CHOICE) {
+            return process.env.MODEL_CHOICE;
+        }
+        const modelStored = await this.getSecureValue(IntelligenceStorageKeys.MODEL_CHOICE);
+        if (modelStored) {
+            return modelStored;
+        }
+        return undefined;
+    }
     async chooseIntelligence(request) {
-        // check to see if anthropic key is in vault
-        const { provider } = await this.getModelProvider();
+        const { provider: providerParam, model: modelParam } = request.params;
+        // Resolve provider: per-request param > env/storage/human flow
+        let provider;
+        if (providerParam) {
+            if (!Object.values(LLMProviders).includes(providerParam)) {
+                throw new Error(`Invalid provider '${providerParam}'. Must be one of: ${Object.values(LLMProviders).join(', ')}`);
+            }
+            provider = providerParam;
+        }
+        else {
+            const result = await this.getModelProvider();
+            provider = result.provider;
+        }
+        // Resolve model: per-request param > env/storage > undefined (child default)
+        const model = modelParam || (await this.getModelChoice());
         const { apiKey } = await this.getProviderApiKey(provider);
         return {
             choice: new oAddress(`o://${provider}`),
             apiKey,
             options: {},
+            model,
         };
     }
     async _tool_configure(request) {
-        const { modelProvider, hostingProvider, accessToken, address } = request.params;
+        const { modelProvider, hostingProvider, accessToken, address, model } = request.params;
         if (hostingProvider) {
             await this.use(new oAddress('o://secure'), {
                 method: 'put',
@@ -210,21 +234,36 @@ export class IntelligenceTool extends oLaneTool {
                 },
             });
         }
+        if (model) {
+            await this.use(new oAddress('o://secure'), {
+                method: 'put',
+                params: {
+                    key: `${IntelligenceStorageKeys.MODEL_CHOICE}`,
+                    value: model,
+                },
+            });
+        }
         return {
             success: true,
         };
     }
     // we cannot wrap this tool use in a plan because it is a core dependency in all planning
     async _tool_prompt(request) {
-        const { userMessage, prompt, _isStreaming = false } = request.params;
+        const { userMessage, prompt, _isStreaming = false, model, provider, } = request.params;
         const stream = request.stream;
+        const providerAddress = provider ? new oAddress(`o://${provider}`) : null;
         const intelligence = await this.chooseIntelligence(request);
-        const child = this.hierarchyManager.getChild(intelligence.choice);
+        const child = this.hierarchyManager.getChild(providerAddress || intelligence.choice);
         const response = await this.useChild(child || intelligence.choice, {
             method: 'completion',
             params: {
                 _isStreaming: _isStreaming,
                 apiKey: intelligence.apiKey,
+                ...(model
+                    ? { model }
+                    : intelligence.model
+                        ? { model: intelligence.model }
+                        : {}),
                 messages: !!userMessage
                     ? [
                         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-intelligence",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -54,13 +54,13 @@
     "typescript": "5.4.5"
   },
   "dependencies": {
-    "@olane/o-config": "0.8.3",
-    "@olane/o-core": "0.8.3",
-    "@olane/o-lane": "0.8.3",
-    "@olane/o-protocol": "0.8.3",
-    "@olane/o-tool": "0.8.3",
+    "@olane/o-config": "0.8.4",
+    "@olane/o-core": "0.8.4",
+    "@olane/o-lane": "0.8.4",
+    "@olane/o-protocol": "0.8.4",
+    "@olane/o-tool": "0.8.4",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0"
   },
-  "gitHead": "189c0cf7b6dd9d5d961f5424af21d37978092d9e"
+  "gitHead": "b53623b1ad4365133911722f80d5597a72b65bf2"
 }