agent-framework-js 0.1.2 → 0.2.0

package/dist/declarative/index.d.ts

@@ -1,11 +1,11 @@
 import { a as ModelCapabilities } from '../types-Cn1g9Tg4.js';
-import { P as Provider } from '../provider-osAtfZ7x.js';
+import { P as Provider } from '../provider-C_rgZvmX.js';
 import { T as Tool } from '../tool-CSCC87OD.js';
 import { S as Skill } from '../skill-DfNChtJN.js';
-import { A as Agent } from '../index-D7-znzrc.js';
+import { A as Agent } from '../index-Dog-CyOK.js';
 import '../errors-CjVz4W_5.js';
-import '../thread-CWVzTyti.js';
-import '../registry-CpO0yH5v.js';
+import '../thread-COV135Ja.js';
+import '../registry-KMWN0p4Z.js';
 
 /**
  * Declarative agent definitions. Agents can be defined in YAML or JSON against a

package/dist/declarative/index.js

@@ -1,9 +1,9 @@
-export { loadAgentDefinition } from '../chunk-VLSVL5N2.js';
-import '../chunk-RD5YUB2E.js';
+export { loadAgentDefinition } from '../chunk-S5776DOL.js';
+import '../chunk-WEKU7735.js';
 import '../chunk-YCBDEEAV.js';
 import '../chunk-HGEPXJDG.js';
 import '../chunk-7ZXUIHLH.js';
-import '../chunk-XPXTXOYQ.js';
+import '../chunk-E4VTVUYU.js';
 import '../chunk-IXV4UIF5.js';
 import '../chunk-DEABART4.js';
 //# sourceMappingURL=index.js.map

package/dist/{index-DdYZeNIu.d.cts → index-5eIhfrC1.d.cts}

@@ -1,10 +1,10 @@
 import { M as Message } from './types-Cn1g9Tg4.cjs';
 import { P as ProviderError } from './errors-CjVz4W_5.cjs';
-import { a as GenerateRequest, b as GenerateResponse, P as Provider } from './provider-CMAymr1b.cjs';
+import { a as GenerateRequest, b as GenerateResponse, P as Provider } from './provider-IJnfNhCX.cjs';
 import { T as Tool } from './tool-BZg_znMZ.cjs';
 import { S as Skill } from './skill-DfNChtJN.cjs';
-import { T as Thread } from './thread-Dfo9LLf7.cjs';
-import { T as ToolRegistry } from './registry-D4fThGiN.cjs';
+import { T as Thread } from './thread-D3zaGK1Y.cjs';
+import { T as ToolRegistry } from './registry-B-hicOxp.cjs';
 
 /**
  * Middleware pipeline for intercepting and processing agent provider calls —
@@ -87,6 +87,8 @@ interface AgentConfig {
     name: string;
     instructions: string;
     provider: Provider;
+    /** Which of the provider's models to use; defaults to the provider's default model. */
+    model?: string;
     tools?: Tool[];
     skills?: Skill[];
     /** Max tool-call iterations per run; -1 = unlimited. Default 10. (FR-012b) */

package/dist/{index-D7-znzrc.d.ts → index-Dog-CyOK.d.ts}

@@ -1,10 +1,10 @@
 import { M as Message } from './types-Cn1g9Tg4.js';
 import { P as ProviderError } from './errors-CjVz4W_5.js';
-import { a as GenerateRequest, b as GenerateResponse, P as Provider } from './provider-osAtfZ7x.js';
+import { a as GenerateRequest, b as GenerateResponse, P as Provider } from './provider-C_rgZvmX.js';
 import { T as Tool } from './tool-CSCC87OD.js';
 import { S as Skill } from './skill-DfNChtJN.js';
-import { T as Thread } from './thread-CWVzTyti.js';
-import { T as ToolRegistry } from './registry-CpO0yH5v.js';
+import { T as Thread } from './thread-COV135Ja.js';
+import { T as ToolRegistry } from './registry-KMWN0p4Z.js';
 
 /**
  * Middleware pipeline for intercepting and processing agent provider calls —
@@ -87,6 +87,8 @@ interface AgentConfig {
     name: string;
     instructions: string;
     provider: Provider;
+    /** Which of the provider's models to use; defaults to the provider's default model. */
+    model?: string;
     tools?: Tool[];
     skills?: Skill[];
     /** Max tool-call iterations per run; -1 = unlimited. Default 10. (FR-012b) */

package/dist/index.cjs

@@ -3,18 +3,18 @@
 var chunkIU3LS5FC_cjs = require('./chunk-IU3LS5FC.cjs');
 var chunkRZP2ZUUX_cjs = require('./chunk-RZP2ZUUX.cjs');
 require('./chunk-5M6ER4ZX.cjs');
-var chunkYKZJRE32_cjs = require('./chunk-YKZJRE32.cjs');
-var chunkYBFLWRO5_cjs = require('./chunk-YBFLWRO5.cjs');
+var chunk245NZAGV_cjs = require('./chunk-245NZAGV.cjs');
+var chunkNURRGYIU_cjs = require('./chunk-NURRGYIU.cjs');
 var chunkWSMYH2IN_cjs = require('./chunk-WSMYH2IN.cjs');
 var chunkTAMJ5HSR_cjs = require('./chunk-TAMJ5HSR.cjs');
-var chunkGYDY3KX5_cjs = require('./chunk-GYDY3KX5.cjs');
 var chunkKEI3EALJ_cjs = require('./chunk-KEI3EALJ.cjs');
 var chunkFSDMBWQV_cjs = require('./chunk-FSDMBWQV.cjs');
+var chunkGYDY3KX5_cjs = require('./chunk-GYDY3KX5.cjs');
 var chunkV6O6SYAN_cjs = require('./chunk-V6O6SYAN.cjs');
-var chunkQJ5XHA6S_cjs = require('./chunk-QJ5XHA6S.cjs');
-var chunkLMN75W3W_cjs = require('./chunk-LMN75W3W.cjs');
+var chunkUIXNKPLQ_cjs = require('./chunk-UIXNKPLQ.cjs');
+var chunkILBKDEEL_cjs = require('./chunk-ILBKDEEL.cjs');
 var chunkFOTCUNP5_cjs = require('./chunk-FOTCUNP5.cjs');
-var chunkTLACSVEZ_cjs = require('./chunk-TLACSVEZ.cjs');
+var chunkU64OEHG6_cjs = require('./chunk-U64OEHG6.cjs');
 var chunkMQ2XTH3S_cjs = require('./chunk-MQ2XTH3S.cjs');
 var chunkIJASUMIQ_cjs = require('./chunk-IJASUMIQ.cjs');
 
@@ -66,19 +66,19 @@ Object.defineProperty(exports, "stepSequential", {
 });
 Object.defineProperty(exports, "loadAgentDefinition", {
   enumerable: true,
-  get: function () { return chunkYKZJRE32_cjs.loadAgentDefinition; }
+  get: function () { return chunk245NZAGV_cjs.loadAgentDefinition; }
 });
 Object.defineProperty(exports, "buildMessages", {
   enumerable: true,
-  get: function () { return chunkYBFLWRO5_cjs.buildMessages; }
+  get: function () { return chunkNURRGYIU_cjs.buildMessages; }
 });
 Object.defineProperty(exports, "createAgent", {
   enumerable: true,
-  get: function () { return chunkYBFLWRO5_cjs.createAgent; }
+  get: function () { return chunkNURRGYIU_cjs.createAgent; }
 });
 Object.defineProperty(exports, "runLoop", {
   enumerable: true,
-  get: function () { return chunkYBFLWRO5_cjs.runLoop; }
+  get: function () { return chunkNURRGYIU_cjs.runLoop; }
 });
 Object.defineProperty(exports, "SkillIndex", {
   enumerable: true,
@@ -104,14 +104,6 @@ Object.defineProperty(exports, "validateArgs", {
   enumerable: true,
   get: function () { return chunkTAMJ5HSR_cjs.validateArgs; }
 });
-Object.defineProperty(exports, "connectMCP", {
-  enumerable: true,
-  get: function () { return chunkGYDY3KX5_cjs.connectMCP; }
-});
-Object.defineProperty(exports, "mcpToolToTool", {
-  enumerable: true,
-  get: function () { return chunkGYDY3KX5_cjs.mcpToolToTool; }
-});
 Object.defineProperty(exports, "useMiddleware", {
   enumerable: true,
   get: function () { return chunkKEI3EALJ_cjs.useMiddleware; }
@@ -120,6 +112,14 @@ Object.defineProperty(exports, "composeMiddleware", {
   enumerable: true,
   get: function () { return chunkFSDMBWQV_cjs.composeMiddleware; }
 });
+Object.defineProperty(exports, "connectMCP", {
+  enumerable: true,
+  get: function () { return chunkGYDY3KX5_cjs.connectMCP; }
+});
+Object.defineProperty(exports, "mcpToolToTool", {
+  enumerable: true,
+  get: function () { return chunkGYDY3KX5_cjs.mcpToolToTool; }
+});
 Object.defineProperty(exports, "configureObservability", {
   enumerable: true,
   get: function () { return chunkV6O6SYAN_cjs.configureObservability; }
@@ -138,35 +138,35 @@ Object.defineProperty(exports, "withSpan", {
 });
 Object.defineProperty(exports, "ThreadPersistence", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.ThreadPersistence; }
+  get: function () { return chunkUIXNKPLQ_cjs.ThreadPersistence; }
 });
 Object.defineProperty(exports, "createBrowserStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createBrowserStore; }
+  get: function () { return chunkUIXNKPLQ_cjs.createBrowserStore; }
 });
 Object.defineProperty(exports, "createMemoryStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createMemoryStore; }
+  get: function () { return chunkUIXNKPLQ_cjs.createMemoryStore; }
 });
 Object.defineProperty(exports, "Thread", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.Thread; }
+  get: function () { return chunkILBKDEEL_cjs.Thread; }
 });
 Object.defineProperty(exports, "estimateTokens", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.estimateTokens; }
+  get: function () { return chunkILBKDEEL_cjs.estimateTokens; }
 });
 Object.defineProperty(exports, "hasImage", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.hasImage; }
+  get: function () { return chunkILBKDEEL_cjs.hasImage; }
 });
 Object.defineProperty(exports, "messageText", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.messageText; }
+  get: function () { return chunkILBKDEEL_cjs.messageText; }
 });
 Object.defineProperty(exports, "textMessage", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.textMessage; }
+  get: function () { return chunkILBKDEEL_cjs.textMessage; }
 });
 Object.defineProperty(exports, "detectRuntime", {
   enumerable: true,
@@ -182,19 +182,23 @@ Object.defineProperty(exports, "resetRuntimeCache", {
 });
 Object.defineProperty(exports, "createCopilotProvider", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.createCopilotProvider; }
+  get: function () { return chunkU64OEHG6_cjs.createCopilotProvider; }
 });
 Object.defineProperty(exports, "createOpenAICompatibleProvider", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.createOpenAICompatibleProvider; }
+  get: function () { return chunkU64OEHG6_cjs.createOpenAICompatibleProvider; }
 });
 Object.defineProperty(exports, "providerErrorFromStatus", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.providerErrorFromStatus; }
+  get: function () { return chunkU64OEHG6_cjs.providerErrorFromStatus; }
+});
+Object.defineProperty(exports, "resolveModels", {
+  enumerable: true,
+  get: function () { return chunkU64OEHG6_cjs.resolveModels; }
 });
 Object.defineProperty(exports, "withRetry", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.withRetry; }
+  get: function () { return chunkU64OEHG6_cjs.withRetry; }
 });
 Object.defineProperty(exports, "CheckpointError", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,13 +1,13 @@
 export { C as ContentPart, J as JSONSchema, M as Message, a as ModelCapabilities, R as Role, h as hasImage, m as messageText, t as textMessage } from './types-Cn1g9Tg4.cjs';
 export { C as CheckpointError, a as CheckpointErrorReason, E as ErrorKind, F as FrameworkError, M as MCPError, P as ProviderError, b as ProviderErrorReason, R as RuntimeUnsupportedError, T as ToolError, c as ToolErrorReason, V as ValidationError } from './errors-CjVz4W_5.cjs';
 export { O as ObservabilityConfig, R as REDACTED, c as configureObservability, i as isObservabilityEnabled, r as redact, a as resetObservability, w as withSpan } from './index-C2vzfbBz.cjs';
-export { C as CredentialSource, G as GenerateChunk, a as GenerateRequest, b as GenerateResponse, P as Provider, T as ToolCall, c as ToolSpec } from './provider-CMAymr1b.cjs';
+export { C as CredentialSource, G as GenerateChunk, a as GenerateRequest, b as GenerateResponse, M as ModelSelectionOptions, P as Provider, R as ResolvedModels, T as ToolCall, c as ToolSpec, r as resolveModels } from './provider-IJnfNhCX.cjs';
 export { CopilotProviderOptions, OpenAICompatibleProviderOptions, RetryOptions, createCopilotProvider, createOpenAICompatibleProvider, providerErrorFromStatus, withRetry } from './providers/index.cjs';
 export { T as Tool, d as defineTool } from './tool-BZg_znMZ.cjs';
 export { validateArgs } from './tools/index.cjs';
-export { T as ToolRegistry, a as ToolResult, n as namespacedName } from './registry-D4fThGiN.cjs';
-export { A as Agent, a as AgentConfig, b as AgentInput, G as GenerateFn, L as LoopOptions, c as LoopResult, M as Middleware, d as MiddlewareContext, N as Next, R as RunChunk, e as RunOptions, f as RunResult, g as RunStatus, h as buildMessages, i as composeMiddleware, j as createAgent, r as runLoop } from './index-DdYZeNIu.cjs';
-export { T as Thread, a as ThreadOptions, e as estimateTokens } from './thread-Dfo9LLf7.cjs';
+export { T as ToolRegistry, a as ToolResult, n as namespacedName } from './registry-B-hicOxp.cjs';
+export { A as Agent, a as AgentConfig, b as AgentInput, G as GenerateFn, L as LoopOptions, c as LoopResult, M as Middleware, d as MiddlewareContext, N as Next, R as RunChunk, e as RunOptions, f as RunResult, g as RunStatus, h as buildMessages, i as composeMiddleware, j as createAgent, r as runLoop } from './index-5eIhfrC1.cjs';
+export { T as Thread, a as ThreadOptions, e as estimateTokens } from './thread-D3zaGK1Y.cjs';
 export { MCPConnection, MCPConnectionConfig, MCPTransport, connectMCP, mcpToolToTool } from './mcp/index.cjs';
 export { SkillIndex } from './skills/index.cjs';
 export { BranchResult, CHECKPOINT_VERSION, Checkpoint, FailurePolicy, PatternHooks, StepResult, Workflow, WorkflowConfig, WorkflowContext, WorkflowEvent, WorkflowPattern, WorkflowState, WorkflowStatus, createCheckpoint, createWorkflow, restoreCheckpoint, runBounded, serializeCheckpoint, stepConcurrent, stepGroup, stepHandoff, stepSequential } from './workflows/index.cjs';

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 export { C as ContentPart, J as JSONSchema, M as Message, a as ModelCapabilities, R as Role, h as hasImage, m as messageText, t as textMessage } from './types-Cn1g9Tg4.js';
 export { C as CheckpointError, a as CheckpointErrorReason, E as ErrorKind, F as FrameworkError, M as MCPError, P as ProviderError, b as ProviderErrorReason, R as RuntimeUnsupportedError, T as ToolError, c as ToolErrorReason, V as ValidationError } from './errors-CjVz4W_5.js';
 export { O as ObservabilityConfig, R as REDACTED, c as configureObservability, i as isObservabilityEnabled, r as redact, a as resetObservability, w as withSpan } from './index-C2vzfbBz.js';
-export { C as CredentialSource, G as GenerateChunk, a as GenerateRequest, b as GenerateResponse, P as Provider, T as ToolCall, c as ToolSpec } from './provider-osAtfZ7x.js';
+export { C as CredentialSource, G as GenerateChunk, a as GenerateRequest, b as GenerateResponse, M as ModelSelectionOptions, P as Provider, R as ResolvedModels, T as ToolCall, c as ToolSpec, r as resolveModels } from './provider-C_rgZvmX.js';
 export { CopilotProviderOptions, OpenAICompatibleProviderOptions, RetryOptions, createCopilotProvider, createOpenAICompatibleProvider, providerErrorFromStatus, withRetry } from './providers/index.js';
 export { T as Tool, d as defineTool } from './tool-CSCC87OD.js';
 export { validateArgs } from './tools/index.js';
-export { T as ToolRegistry, a as ToolResult, n as namespacedName } from './registry-CpO0yH5v.js';
-export { A as Agent, a as AgentConfig, b as AgentInput, G as GenerateFn, L as LoopOptions, c as LoopResult, M as Middleware, d as MiddlewareContext, N as Next, R as RunChunk, e as RunOptions, f as RunResult, g as RunStatus, h as buildMessages, i as composeMiddleware, j as createAgent, r as runLoop } from './index-D7-znzrc.js';
-export { T as Thread, a as ThreadOptions, e as estimateTokens } from './thread-CWVzTyti.js';
+export { T as ToolRegistry, a as ToolResult, n as namespacedName } from './registry-KMWN0p4Z.js';
+export { A as Agent, a as AgentConfig, b as AgentInput, G as GenerateFn, L as LoopOptions, c as LoopResult, M as Middleware, d as MiddlewareContext, N as Next, R as RunChunk, e as RunOptions, f as RunResult, g as RunStatus, h as buildMessages, i as composeMiddleware, j as createAgent, r as runLoop } from './index-Dog-CyOK.js';
+export { T as Thread, a as ThreadOptions, e as estimateTokens } from './thread-COV135Ja.js';
 export { MCPConnection, MCPConnectionConfig, MCPTransport, connectMCP, mcpToolToTool } from './mcp/index.js';
 export { SkillIndex } from './skills/index.js';
 export { BranchResult, CHECKPOINT_VERSION, Checkpoint, FailurePolicy, PatternHooks, StepResult, Workflow, WorkflowConfig, WorkflowContext, WorkflowEvent, WorkflowPattern, WorkflowState, WorkflowStatus, createCheckpoint, createWorkflow, restoreCheckpoint, runBounded, serializeCheckpoint, stepConcurrent, stepGroup, stepHandoff, stepSequential } from './workflows/index.js';

package/dist/index.js

@@ -1,18 +1,18 @@
 export { defineTool } from './chunk-RZ43WNHR.js';
 export { CHECKPOINT_VERSION, createCheckpoint, createWorkflow, restoreCheckpoint, runBounded, serializeCheckpoint, stepConcurrent, stepGroup, stepHandoff, stepSequential } from './chunk-T2GHJ5R4.js';
 import './chunk-MCLVWCOB.js';
-export { loadAgentDefinition } from './chunk-VLSVL5N2.js';
-export { buildMessages, createAgent, runLoop } from './chunk-RD5YUB2E.js';
+export { loadAgentDefinition } from './chunk-S5776DOL.js';
+export { buildMessages, createAgent, runLoop } from './chunk-WEKU7735.js';
 export { SkillIndex, defineSkill, loadSource } from './chunk-YCBDEEAV.js';
 export { ToolRegistry, namespacedName, validateArgs } from './chunk-HGEPXJDG.js';
-export { connectMCP, mcpToolToTool } from './chunk-YH5746OF.js';
 export { useMiddleware } from './chunk-IUKD54F7.js';
 export { composeMiddleware } from './chunk-7ZXUIHLH.js';
+export { connectMCP, mcpToolToTool } from './chunk-YH5746OF.js';
 export { configureObservability, isObservabilityEnabled, resetObservability, withSpan } from './chunk-5PDJOBTD.js';
-export { ThreadPersistence, createBrowserStore, createMemoryStore } from './chunk-V472N2PK.js';
-export { Thread, estimateTokens, hasImage, messageText, textMessage } from './chunk-XPXTXOYQ.js';
+export { ThreadPersistence, createBrowserStore, createMemoryStore } from './chunk-IGIFX6QO.js';
+export { Thread, estimateTokens, hasImage, messageText, textMessage } from './chunk-E4VTVUYU.js';
 export { detectRuntime, requireCapability, resetRuntimeCache } from './chunk-ACBIHS5H.js';
-export { createCopilotProvider, createOpenAICompatibleProvider, providerErrorFromStatus, withRetry } from './chunk-UVWQWOLO.js';
+export { createCopilotProvider, createOpenAICompatibleProvider, providerErrorFromStatus, resolveModels, withRetry } from './chunk-7M3EAGCA.js';
 export { CheckpointError, FrameworkError, MCPError, ProviderError, RuntimeUnsupportedError, ToolError, ValidationError } from './chunk-IXV4UIF5.js';
 export { REDACTED, redact } from './chunk-DEABART4.js';
 //# sourceMappingURL=index.js.map

package/dist/middleware/index.d.cts

@@ -1,12 +1,12 @@
-import { a as AgentConfig, M as Middleware } from '../index-DdYZeNIu.cjs';
-export { d as MiddlewareContext, N as Next, i as composeMiddleware } from '../index-DdYZeNIu.cjs';
+import { a as AgentConfig, M as Middleware } from '../index-5eIhfrC1.cjs';
+export { d as MiddlewareContext, N as Next, i as composeMiddleware } from '../index-5eIhfrC1.cjs';
 import '../types-Cn1g9Tg4.cjs';
 import '../errors-CjVz4W_5.cjs';
-import '../provider-CMAymr1b.cjs';
+import '../provider-IJnfNhCX.cjs';
 import '../tool-BZg_znMZ.cjs';
 import '../skill-DfNChtJN.cjs';
-import '../thread-Dfo9LLf7.cjs';
-import '../registry-D4fThGiN.cjs';
+import '../thread-D3zaGK1Y.cjs';
+import '../registry-B-hicOxp.cjs';
 
 /**
  * Convenience helper for attaching middleware to an agent configuration.

package/dist/middleware/index.d.ts

@@ -1,12 +1,12 @@
-import { a as AgentConfig, M as Middleware } from '../index-D7-znzrc.js';
-export { d as MiddlewareContext, N as Next, i as composeMiddleware } from '../index-D7-znzrc.js';
+import { a as AgentConfig, M as Middleware } from '../index-Dog-CyOK.js';
+export { d as MiddlewareContext, N as Next, i as composeMiddleware } from '../index-Dog-CyOK.js';
 import '../types-Cn1g9Tg4.js';
 import '../errors-CjVz4W_5.js';
-import '../provider-osAtfZ7x.js';
+import '../provider-C_rgZvmX.js';
 import '../tool-CSCC87OD.js';
 import '../skill-DfNChtJN.js';
-import '../thread-CWVzTyti.js';
-import '../registry-CpO0yH5v.js';
+import '../thread-COV135Ja.js';
+import '../registry-KMWN0p4Z.js';
 
 /**
  * Convenience helper for attaching middleware to an agent configuration.

package/dist/persistence/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkQJ5XHA6S_cjs = require('../chunk-QJ5XHA6S.cjs');
-require('../chunk-LMN75W3W.cjs');
+var chunkUIXNKPLQ_cjs = require('../chunk-UIXNKPLQ.cjs');
+require('../chunk-ILBKDEEL.cjs');
 require('../chunk-FOTCUNP5.cjs');
 require('../chunk-MQ2XTH3S.cjs');
 require('../chunk-IJASUMIQ.cjs');
@@ -10,15 +10,15 @@ require('../chunk-IJASUMIQ.cjs');
 
 Object.defineProperty(exports, "ThreadPersistence", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.ThreadPersistence; }
+  get: function () { return chunkUIXNKPLQ_cjs.ThreadPersistence; }
 });
 Object.defineProperty(exports, "createBrowserStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createBrowserStore; }
+  get: function () { return chunkUIXNKPLQ_cjs.createBrowserStore; }
 });
 Object.defineProperty(exports, "createMemoryStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createMemoryStore; }
+  get: function () { return chunkUIXNKPLQ_cjs.createMemoryStore; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/persistence/index.d.cts

@@ -1,6 +1,6 @@
-import { T as Thread } from '../thread-Dfo9LLf7.cjs';
+import { T as Thread } from '../thread-D3zaGK1Y.cjs';
 import '../types-Cn1g9Tg4.cjs';
-import '../provider-CMAymr1b.cjs';
+import '../provider-IJnfNhCX.cjs';
 
 /**
  * Pluggable storage abstraction for persisting conversation/thread state in a

package/dist/persistence/index.d.ts

@@ -1,6 +1,6 @@
-import { T as Thread } from '../thread-CWVzTyti.js';
+import { T as Thread } from '../thread-COV135Ja.js';
 import '../types-Cn1g9Tg4.js';
-import '../provider-osAtfZ7x.js';
+import '../provider-C_rgZvmX.js';
 
 /**
  * Pluggable storage abstraction for persisting conversation/thread state in a

package/dist/persistence/index.js

@@ -1,5 +1,5 @@
-export { ThreadPersistence, createBrowserStore, createMemoryStore } from '../chunk-V472N2PK.js';
-import '../chunk-XPXTXOYQ.js';
+export { ThreadPersistence, createBrowserStore, createMemoryStore } from '../chunk-IGIFX6QO.js';
+import '../chunk-E4VTVUYU.js';
 import '../chunk-ACBIHS5H.js';
 import '../chunk-IXV4UIF5.js';
 import '../chunk-DEABART4.js';

package/dist/{provider-osAtfZ7x.d.ts → provider-C_rgZvmX.d.ts}

@@ -16,6 +16,45 @@ interface CredentialSource {
     /** Return the current credential (token/api key). May be async. */
     getCredential(): string | Promise<string>;
 }
+/**
+ * Model configuration for a provider. A provider may expose **one or more** models
+ * (e.g. GitHub Copilot offers several; an OpenAI-compatible endpoint is usually one).
+ * Supply either a single `capabilities` object or an array via `models`.
+ */
+interface ModelSelectionOptions {
+    /** Single-model shorthand. */
+    capabilities?: ModelCapabilities;
+    /** One or more models this provider can use. */
+    models?: ModelCapabilities[];
+    /** Name of the default model (defaults to the first entry). */
+    defaultModel?: string;
+}
+/** Resolved model set with a default and a lookup helper. */
+interface ResolvedModels {
+    /** All configured models (at least one). */
+    models: ModelCapabilities[];
+    /** The default model used when a request does not specify one. */
+    defaultModel: ModelCapabilities;
+    /** Look up a model by name, or return the default when omitted. */
+    modelOf(name?: string): ModelCapabilities;
+}
+/**
+ * Normalize {@link ModelSelectionOptions} into a model list, a default, and a
+ * lookup helper. Throws {@link ValidationError} if no model is configured or a
+ * named model is missing.
+ *
+ * @example
+ * ```ts
+ * const { defaultModel, modelOf } = resolveModels({
+ *   models: [
+ *     { model: "gpt-4o", maxInputTokens: 128000, maxOutputTokens: 16000 },
+ *     { model: "o3-mini", maxInputTokens: 200000, maxOutputTokens: 100000, supportsReasoning: true },
+ *   ],
+ *   defaultModel: "gpt-4o",
+ * });
+ * ```
+ */
+declare function resolveModels(options: ModelSelectionOptions): ResolvedModels;
 /** A tool description passed to the provider so the model can decide to call it. */
 interface ToolSpec {
     name: string;
@@ -26,6 +65,8 @@ interface ToolSpec {
 interface GenerateRequest {
     messages: Message[];
     tools?: ToolSpec[];
+    /** Which configured model to use; defaults to the provider's default model. */
+    model?: string;
     /** Abort signal to cancel an in-flight request. */
     signal?: AbortSignal;
 }
@@ -71,12 +112,16 @@ type GenerateChunk = {
 interface Provider {
     /** Stable provider identifier, e.g. `"openai-compatible"`. */
     readonly name: string;
-    /** Per-model capability configuration supplied by the caller. (FR-007a) */
+    /** The default model's capability configuration. (FR-007a) */
     readonly capabilities: ModelCapabilities;
+    /** All models this provider is configured with (one or more). */
+    readonly models: ModelCapabilities[];
+    /** Look up a configured model by name, or the default when omitted. */
+    model(name?: string): ModelCapabilities;
     /** Generate a complete response. */
     generate(req: GenerateRequest): Promise<GenerateResponse>;
     /** Generate a streamed response. */
     generateStream(req: GenerateRequest): AsyncIterable<GenerateChunk>;
 }
 
-export type { CredentialSource as C, GenerateChunk as G, Provider as P, ToolCall as T, GenerateRequest as a, GenerateResponse as b, ToolSpec as c };
+export { type CredentialSource as C, type GenerateChunk as G, type ModelSelectionOptions as M, type Provider as P, type ResolvedModels as R, type ToolCall as T, type GenerateRequest as a, type GenerateResponse as b, type ToolSpec as c, resolveModels as r };

package/dist/{provider-CMAymr1b.d.cts → provider-IJnfNhCX.d.cts}

@@ -16,6 +16,45 @@ interface CredentialSource {
     /** Return the current credential (token/api key). May be async. */
     getCredential(): string | Promise<string>;
 }
+/**
+ * Model configuration for a provider. A provider may expose **one or more** models
+ * (e.g. GitHub Copilot offers several; an OpenAI-compatible endpoint is usually one).
+ * Supply either a single `capabilities` object or an array via `models`.
+ */
+interface ModelSelectionOptions {
+    /** Single-model shorthand. */
+    capabilities?: ModelCapabilities;
+    /** One or more models this provider can use. */
+    models?: ModelCapabilities[];
+    /** Name of the default model (defaults to the first entry). */
+    defaultModel?: string;
+}
+/** Resolved model set with a default and a lookup helper. */
+interface ResolvedModels {
+    /** All configured models (at least one). */
+    models: ModelCapabilities[];
+    /** The default model used when a request does not specify one. */
+    defaultModel: ModelCapabilities;
+    /** Look up a model by name, or return the default when omitted. */
+    modelOf(name?: string): ModelCapabilities;
+}
+/**
+ * Normalize {@link ModelSelectionOptions} into a model list, a default, and a
+ * lookup helper. Throws {@link ValidationError} if no model is configured or a
+ * named model is missing.
+ *
+ * @example
+ * ```ts
+ * const { defaultModel, modelOf } = resolveModels({
+ *   models: [
+ *     { model: "gpt-4o", maxInputTokens: 128000, maxOutputTokens: 16000 },
+ *     { model: "o3-mini", maxInputTokens: 200000, maxOutputTokens: 100000, supportsReasoning: true },
+ *   ],
+ *   defaultModel: "gpt-4o",
+ * });
+ * ```
+ */
+declare function resolveModels(options: ModelSelectionOptions): ResolvedModels;
 /** A tool description passed to the provider so the model can decide to call it. */
 interface ToolSpec {
     name: string;
@@ -26,6 +65,8 @@ interface ToolSpec {
 interface GenerateRequest {
     messages: Message[];
     tools?: ToolSpec[];
+    /** Which configured model to use; defaults to the provider's default model. */
+    model?: string;
     /** Abort signal to cancel an in-flight request. */
     signal?: AbortSignal;
 }
@@ -71,12 +112,16 @@ type GenerateChunk = {
 interface Provider {
     /** Stable provider identifier, e.g. `"openai-compatible"`. */
     readonly name: string;
-    /** Per-model capability configuration supplied by the caller. (FR-007a) */
+    /** The default model's capability configuration. (FR-007a) */
     readonly capabilities: ModelCapabilities;
+    /** All models this provider is configured with (one or more). */
+    readonly models: ModelCapabilities[];
+    /** Look up a configured model by name, or the default when omitted. */
+    model(name?: string): ModelCapabilities;
     /** Generate a complete response. */
     generate(req: GenerateRequest): Promise<GenerateResponse>;
     /** Generate a streamed response. */
     generateStream(req: GenerateRequest): AsyncIterable<GenerateChunk>;
 }
 
-export type { CredentialSource as C, GenerateChunk as G, Provider as P, ToolCall as T, GenerateRequest as a, GenerateResponse as b, ToolSpec as c };
+export { type CredentialSource as C, type GenerateChunk as G, type ModelSelectionOptions as M, type Provider as P, type ResolvedModels as R, type ToolCall as T, type GenerateRequest as a, type GenerateResponse as b, type ToolSpec as c, resolveModels as r };

package/dist/providers/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkTLACSVEZ_cjs = require('../chunk-TLACSVEZ.cjs');
+var chunkU64OEHG6_cjs = require('../chunk-U64OEHG6.cjs');
 require('../chunk-MQ2XTH3S.cjs');
 require('../chunk-IJASUMIQ.cjs');
 
@@ -8,19 +8,23 @@ require('../chunk-IJASUMIQ.cjs');
 
 Object.defineProperty(exports, "createCopilotProvider", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.createCopilotProvider; }
+  get: function () { return chunkU64OEHG6_cjs.createCopilotProvider; }
 });
 Object.defineProperty(exports, "createOpenAICompatibleProvider", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.createOpenAICompatibleProvider; }
+  get: function () { return chunkU64OEHG6_cjs.createOpenAICompatibleProvider; }
 });
 Object.defineProperty(exports, "providerErrorFromStatus", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.providerErrorFromStatus; }
+  get: function () { return chunkU64OEHG6_cjs.providerErrorFromStatus; }
+});
+Object.defineProperty(exports, "resolveModels", {
+  enumerable: true,
+  get: function () { return chunkU64OEHG6_cjs.resolveModels; }
 });
 Object.defineProperty(exports, "withRetry", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.withRetry; }
+  get: function () { return chunkU64OEHG6_cjs.withRetry; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map