agent-framework-js 0.1.2 → 0.3.0

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

@@ -1,10 +1,10 @@
-import { M as Message } from './types-Cn1g9Tg4.cjs';
+import { M as Message } from './types-AlvjoTyS.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 { T as Tool } from './tool-BZg_znMZ.cjs';
+import { a as GenerateRequest, b as GenerateResponse, P as Provider } from './provider-B807EuDV.cjs';
+import { T as Tool } from './tool-D9Uodu9Y.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-BzwE1OnJ.cjs';
+import { T as ToolRegistry } from './registry-BCkSIe0E.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.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 chunk2WBJEXNY_cjs = require('./chunk-2WBJEXNY.cjs');
+var chunkFDCTSJMB_cjs = require('./chunk-FDCTSJMB.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 chunkV6O6SYAN_cjs = require('./chunk-V6O6SYAN.cjs');
-var chunkQJ5XHA6S_cjs = require('./chunk-QJ5XHA6S.cjs');
-var chunkLMN75W3W_cjs = require('./chunk-LMN75W3W.cjs');
+var chunkGYDY3KX5_cjs = require('./chunk-GYDY3KX5.cjs');
+var chunkIHMPSELC_cjs = require('./chunk-IHMPSELC.cjs');
+var chunkI55OVD23_cjs = require('./chunk-I55OVD23.cjs');
 var chunkFOTCUNP5_cjs = require('./chunk-FOTCUNP5.cjs');
-var chunkTLACSVEZ_cjs = require('./chunk-TLACSVEZ.cjs');
+var chunkXMDGLQFL_cjs = require('./chunk-XMDGLQFL.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 chunk2WBJEXNY_cjs.loadAgentDefinition; }
 });
 Object.defineProperty(exports, "buildMessages", {
   enumerable: true,
-  get: function () { return chunkYBFLWRO5_cjs.buildMessages; }
+  get: function () { return chunkFDCTSJMB_cjs.buildMessages; }
 });
 Object.defineProperty(exports, "createAgent", {
   enumerable: true,
-  get: function () { return chunkYBFLWRO5_cjs.createAgent; }
+  get: function () { return chunkFDCTSJMB_cjs.createAgent; }
 });
 Object.defineProperty(exports, "runLoop", {
   enumerable: true,
-  get: function () { return chunkYBFLWRO5_cjs.runLoop; }
+  get: function () { return chunkFDCTSJMB_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; }
@@ -136,37 +128,45 @@ Object.defineProperty(exports, "withSpan", {
   enumerable: true,
   get: function () { return chunkV6O6SYAN_cjs.withSpan; }
 });
+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, "ThreadPersistence", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.ThreadPersistence; }
+  get: function () { return chunkIHMPSELC_cjs.ThreadPersistence; }
 });
 Object.defineProperty(exports, "createBrowserStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createBrowserStore; }
+  get: function () { return chunkIHMPSELC_cjs.createBrowserStore; }
 });
 Object.defineProperty(exports, "createMemoryStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createMemoryStore; }
+  get: function () { return chunkIHMPSELC_cjs.createMemoryStore; }
 });
 Object.defineProperty(exports, "Thread", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.Thread; }
+  get: function () { return chunkI55OVD23_cjs.Thread; }
 });
 Object.defineProperty(exports, "estimateTokens", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.estimateTokens; }
+  get: function () { return chunkI55OVD23_cjs.estimateTokens; }
 });
 Object.defineProperty(exports, "hasImage", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.hasImage; }
+  get: function () { return chunkI55OVD23_cjs.hasImage; }
 });
 Object.defineProperty(exports, "messageText", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.messageText; }
+  get: function () { return chunkI55OVD23_cjs.messageText; }
 });
 Object.defineProperty(exports, "textMessage", {
   enumerable: true,
-  get: function () { return chunkLMN75W3W_cjs.textMessage; }
+  get: function () { return chunkI55OVD23_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 chunkXMDGLQFL_cjs.createCopilotProvider; }
 });
 Object.defineProperty(exports, "createOpenAICompatibleProvider", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.createOpenAICompatibleProvider; }
+  get: function () { return chunkXMDGLQFL_cjs.createOpenAICompatibleProvider; }
 });
 Object.defineProperty(exports, "providerErrorFromStatus", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.providerErrorFromStatus; }
+  get: function () { return chunkXMDGLQFL_cjs.providerErrorFromStatus; }
+});
+Object.defineProperty(exports, "resolveModels", {
+  enumerable: true,
+  get: function () { return chunkXMDGLQFL_cjs.resolveModels; }
 });
 Object.defineProperty(exports, "withRetry", {
   enumerable: true,
-  get: function () { return chunkTLACSVEZ_cjs.withRetry; }
+  get: function () { return chunkXMDGLQFL_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 ContentPart, J as JSONSchema, M as Message, a as MessageToolCall, b as ModelCapabilities, R as Role, h as hasImage, m as messageText, t as textMessage } from './types-AlvjoTyS.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-B807EuDV.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 { T as Tool, d as defineTool } from './tool-D9Uodu9Y.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-BCkSIe0E.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-b1oTo3Lv.cjs';
+export { T as Thread, a as ThreadOptions, e as estimateTokens } from './thread-BzwE1OnJ.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 ContentPart, J as JSONSchema, M as Message, a as MessageToolCall, b as ModelCapabilities, R as Role, h as hasImage, m as messageText, t as textMessage } from './types-AlvjoTyS.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-CvU3I-Xo.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 { T as Tool, d as defineTool } from './tool-LPMc4QQd.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-D-CmT0gk.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-C22fqyZQ.js';
+export { T as Thread, a as ThreadOptions, e as estimateTokens } from './thread-COljUAtD.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-55NB43FN.js';
+export { buildMessages, createAgent, runLoop } from './chunk-KOPGBIES.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 { 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 { connectMCP, mcpToolToTool } from './chunk-YH5746OF.js';
+export { ThreadPersistence, createBrowserStore, createMemoryStore } from './chunk-PYIZ4PT3.js';
+export { Thread, estimateTokens, hasImage, messageText, textMessage } from './chunk-LC54DGGR.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-QD2FFISV.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/mcp/index.d.cts

@@ -1,5 +1,5 @@
-import { T as Tool } from '../tool-BZg_znMZ.cjs';
-import '../types-Cn1g9Tg4.cjs';
+import { T as Tool } from '../tool-D9Uodu9Y.cjs';
+import '../types-AlvjoTyS.cjs';
 
 /**
  * MCP (Model Context Protocol) integration. Connects to MCP servers and exposes

package/dist/mcp/index.d.ts

@@ -1,5 +1,5 @@
-import { T as Tool } from '../tool-CSCC87OD.js';
-import '../types-Cn1g9Tg4.js';
+import { T as Tool } from '../tool-LPMc4QQd.js';
+import '../types-AlvjoTyS.js';
 
 /**
  * MCP (Model Context Protocol) integration. Connects to MCP servers and exposes

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 '../types-Cn1g9Tg4.cjs';
+import { a as AgentConfig, M as Middleware } from '../index-b1oTo3Lv.cjs';
+export { d as MiddlewareContext, N as Next, i as composeMiddleware } from '../index-b1oTo3Lv.cjs';
+import '../types-AlvjoTyS.cjs';
 import '../errors-CjVz4W_5.cjs';
-import '../provider-CMAymr1b.cjs';
-import '../tool-BZg_znMZ.cjs';
+import '../provider-B807EuDV.cjs';
+import '../tool-D9Uodu9Y.cjs';
 import '../skill-DfNChtJN.cjs';
-import '../thread-Dfo9LLf7.cjs';
-import '../registry-D4fThGiN.cjs';
+import '../thread-BzwE1OnJ.cjs';
+import '../registry-BCkSIe0E.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 '../types-Cn1g9Tg4.js';
+import { a as AgentConfig, M as Middleware } from '../index-C22fqyZQ.js';
+export { d as MiddlewareContext, N as Next, i as composeMiddleware } from '../index-C22fqyZQ.js';
+import '../types-AlvjoTyS.js';
 import '../errors-CjVz4W_5.js';
-import '../provider-osAtfZ7x.js';
-import '../tool-CSCC87OD.js';
+import '../provider-CvU3I-Xo.js';
+import '../tool-LPMc4QQd.js';
 import '../skill-DfNChtJN.js';
-import '../thread-CWVzTyti.js';
-import '../registry-CpO0yH5v.js';
+import '../thread-COljUAtD.js';
+import '../registry-D-CmT0gk.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 chunkIHMPSELC_cjs = require('../chunk-IHMPSELC.cjs');
+require('../chunk-I55OVD23.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 chunkIHMPSELC_cjs.ThreadPersistence; }
 });
 Object.defineProperty(exports, "createBrowserStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createBrowserStore; }
+  get: function () { return chunkIHMPSELC_cjs.createBrowserStore; }
 });
 Object.defineProperty(exports, "createMemoryStore", {
   enumerable: true,
-  get: function () { return chunkQJ5XHA6S_cjs.createMemoryStore; }
+  get: function () { return chunkIHMPSELC_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 '../types-Cn1g9Tg4.cjs';
-import '../provider-CMAymr1b.cjs';
+import { T as Thread } from '../thread-BzwE1OnJ.cjs';
+import '../types-AlvjoTyS.cjs';
+import '../provider-B807EuDV.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 '../types-Cn1g9Tg4.js';
-import '../provider-osAtfZ7x.js';
+import { T as Thread } from '../thread-COljUAtD.js';
+import '../types-AlvjoTyS.js';
+import '../provider-CvU3I-Xo.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-PYIZ4PT3.js';
+import '../chunk-LC54DGGR.js';
 import '../chunk-ACBIHS5H.js';
 import '../chunk-IXV4UIF5.js';
 import '../chunk-DEABART4.js';

package/dist/provider-B807EuDV.d.cts

@@ -0,0 +1,132 @@
+import { b as ModelCapabilities, M as Message } from './types-AlvjoTyS.cjs';
+
+/**
+ * LLM provider abstraction. Agents and workflows depend only on this interface,
+ * never on a concrete provider, so new providers can be added without changing
+ * agent/workflow code. (FR-007)
+ *
+ * Credentials are always obtained via a caller-supplied callback and are never
+ * bundled, persisted, or logged by the framework. (FR-005a, FR-008)
+ *
+ * @packageDocumentation
+ */
+
+/** A caller-supplied source of credentials. The framework never stores the value. */
+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;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/** A request to generate a model response. */
+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;
+}
+/** A tool call requested by the model. */
+interface ToolCall {
+    id: string;
+    name: string;
+    /** Raw JSON arguments (validated by the tools module before invocation). */
+    arguments: unknown;
+}
+/** A complete (non-streaming) model response. */
+interface GenerateResponse {
+    /** Final answer text. */
+    text: string;
+    /** Reasoning/thinking content — only present for reasoning-capable models. (FR-003a) */
+    reasoning?: string;
+    /**
+     * Opaque reasoning blob (e.g. Claude thinking signature) to round-trip on the
+     * next assistant turn for thinking continuity. Never logged or inspected.
+     */
+    reasoningOpaque?: string;
+    /** Tool calls the model wants to make, if any. */
+    toolCalls?: ToolCall[];
+    /** Approximate token usage if reported by the provider. */
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+/** An incremental streaming chunk. */
+type GenerateChunk = {
+    type: "text";
+    text: string;
+} | {
+    type: "reasoning";
+    text: string;
+} | {
+    type: "tool-call";
+    toolCall: ToolCall;
+} | {
+    type: "done";
+    response: GenerateResponse;
+};
+/**
+ * An LLM backend. Implementations adapt a concrete API (Copilot, OpenAI-compatible)
+ * onto this uniform surface.
+ */
+interface Provider {
+    /** Stable provider identifier, e.g. `"openai-compatible"`. */
+    readonly name: string;
+    /** 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, 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-CvU3I-Xo.d.ts

@@ -0,0 +1,132 @@
+import { b as ModelCapabilities, M as Message } from './types-AlvjoTyS.js';
+
+/**
+ * LLM provider abstraction. Agents and workflows depend only on this interface,
+ * never on a concrete provider, so new providers can be added without changing
+ * agent/workflow code. (FR-007)
+ *
+ * Credentials are always obtained via a caller-supplied callback and are never
+ * bundled, persisted, or logged by the framework. (FR-005a, FR-008)
+ *
+ * @packageDocumentation
+ */
+
+/** A caller-supplied source of credentials. The framework never stores the value. */
+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;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/** A request to generate a model response. */
+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;
+}
+/** A tool call requested by the model. */
+interface ToolCall {
+    id: string;
+    name: string;
+    /** Raw JSON arguments (validated by the tools module before invocation). */
+    arguments: unknown;
+}
+/** A complete (non-streaming) model response. */
+interface GenerateResponse {
+    /** Final answer text. */
+    text: string;
+    /** Reasoning/thinking content — only present for reasoning-capable models. (FR-003a) */
+    reasoning?: string;
+    /**
+     * Opaque reasoning blob (e.g. Claude thinking signature) to round-trip on the
+     * next assistant turn for thinking continuity. Never logged or inspected.
+     */
+    reasoningOpaque?: string;
+    /** Tool calls the model wants to make, if any. */
+    toolCalls?: ToolCall[];
+    /** Approximate token usage if reported by the provider. */
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+/** An incremental streaming chunk. */
+type GenerateChunk = {
+    type: "text";
+    text: string;
+} | {
+    type: "reasoning";
+    text: string;
+} | {
+    type: "tool-call";
+    toolCall: ToolCall;
+} | {
+    type: "done";
+    response: GenerateResponse;
+};
+/**
+ * An LLM backend. Implementations adapt a concrete API (Copilot, OpenAI-compatible)
+ * onto this uniform surface.
+ */
+interface Provider {
+    /** Stable provider identifier, e.g. `"openai-compatible"`. */
+    readonly name: string;
+    /** 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, 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 };