@meetsmore-oss/use-ai-server 1.16.0 → 1.17.0

package/dist/index.js

@@ -144951,6 +144951,26 @@ var uiMessagesSchema = lazySchema(() => zodSchema(exports_external2.array(export
   ])).nonempty("Message must contain at least one part")
 })).nonempty("Messages array must not be empty")));
 var originalGenerateId3 = createIdGenerator({ prefix: "aiobj", size: 24 });
+function simulateReadableStream({
+  chunks,
+  initialDelayInMs = 0,
+  chunkDelayInMs = 0,
+  _internal
+}) {
+  var _a152;
+  const delay2 = (_a152 = _internal == null ? undefined : _internal.delay) != null ? _a152 : delay;
+  let index = 0;
+  return new ReadableStream({
+    async pull(controller) {
+      if (index < chunks.length) {
+        await delay2(index === 0 ? initialDelayInMs : chunkDelayInMs);
+        controller.enqueue(chunks[index++]);
+      } else {
+        controller.close();
+      }
+    }
+  });
+}
 var originalGenerateId4 = createIdGenerator({ prefix: "aiobj", size: 24 });
 var name142 = "AI_NoSuchProviderError";
 var marker142 = `vercel.ai.error.${name142}`;
@@ -145167,27 +145187,17 @@ function extractReasoningSignature(providerMetadata) {
 }
 
 class AISDKAgent {
-  model;
-  providerOptions;
   name;
   annotation;
   toolFilter;
-  systemPrompt;
   cacheBreakpoint;
-  maxOutputTokens;
-  temperature;
-  maxSteps;
+  loadConfig;
   constructor(config2) {
-    this.model = config2.model;
-    this.providerOptions = config2.providerOptions;
     this.name = config2.name || "ai-sdk";
     this.annotation = config2.annotation;
     this.toolFilter = config2.toolFilter;
-    this.systemPrompt = config2.systemPrompt;
     this.cacheBreakpoint = config2.cacheBreakpoint;
-    this.maxOutputTokens = config2.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS;
-    this.temperature = config2.temperature;
-    this.maxSteps = config2.maxSteps ?? DEFAULT_MAX_STEPS;
+    this.loadConfig = config2.hooks.loadConfig;
   }
   getName() {
     return this.name;
@@ -145199,7 +145209,13 @@ class AISDKAgent {
     await flushTelemetry();
   }
   async run(input, events) {
-    const ctx = await this.createRunContext(input);
+    let runConfig;
+    try {
+      runConfig = await this.loadConfig();
+    } catch (error40) {
+      return this.handleConfigLoadError(error40, input, events);
+    }
+    const ctx = this.createRunContext(input, runConfig);
     this.emitRunStartEvents(ctx, events);
     const span = this.startTelemetrySpan(ctx);
     try {
@@ -145210,12 +145226,12 @@ class AISDKAgent {
       return this.handleRunError(error40, ctx, events, span);
     }
   }
-  async createRunContext(input) {
+  createRunContext(input, runConfig) {
     const { session, runId, messages, tools, state, systemPrompt: runtimeSystemPrompt, originalInput } = input;
     if (session.tools.length === 0 && tools.length > 0) {
       session.tools = tools;
     }
-    const configSystemPrompt = await this.resolveSystemPrompt();
+    const configSystemPrompt = runConfig.systemPrompt || undefined;
     const staticSystemMessages = this.buildStaticSystemMessages(configSystemPrompt, runtimeSystemPrompt);
     const sanitizedInputMessages = this.sanitizeMessages(messages);
     return {
@@ -145226,6 +145242,13 @@ class AISDKAgent {
       state,
       originalInput,
       staticSystemMessages,
+      resolved: {
+        model: runConfig.model,
+        temperature: runConfig.temperature,
+        maxOutputTokens: runConfig.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS,
+        maxSteps: runConfig.maxSteps ?? DEFAULT_MAX_STEPS,
+        providerOptions: runConfig.providerOptions
+      },
       streamTextStarted: false,
       finalText: "",
       currentStepNumber: 0,
@@ -145238,6 +145261,30 @@ class AISDKAgent {
       pendingTextMessageId: null
     };
   }
+  handleConfigLoadError(error40, input, events) {
+    const errorMessage = error40 instanceof Error ? error40.message : String(error40);
+    logger2.error("hooks.loadConfig failed; aborting run", {
+      clientId: input.session.clientId,
+      error: errorMessage
+    });
+    events.emit({
+      type: EventType.RUN_STARTED,
+      threadId: input.session.threadId,
+      runId: input.runId,
+      input: input.originalInput,
+      timestamp: Date.now()
+    });
+    events.emit({
+      type: EventType.RUN_ERROR,
+      message: ErrorCode.UNKNOWN_ERROR,
+      timestamp: Date.now()
+    });
+    return {
+      success: false,
+      error: errorMessage,
+      conversationHistory: input.messages
+    };
+  }
   emitRunStartEvents(ctx, events) {
     events.emit({
       type: EventType.RUN_STARTED,
@@ -145282,8 +145329,8 @@ class AISDKAgent {
     });
   }
   async executeStepLoop(ctx, events, span) {
-    for (let stepIteration = 0;stepIteration <= this.maxSteps; stepIteration++) {
-      const isGracefulSummaryStep = stepIteration === this.maxSteps;
+    for (let stepIteration = 0;stepIteration <= ctx.resolved.maxSteps; stepIteration++) {
+      const isGracefulSummaryStep = stepIteration === ctx.resolved.maxSteps;
       if (isGracefulSummaryStep && !ctx.lastStepHadToolCalls)
         break;
       const isTruncationFallbackStep = ctx.truncationFallbackPending;
@@ -145324,18 +145371,18 @@ class AISDKAgent {
       this.applyGracefulSummaryOverrides(isGracefulSummaryStep, stepConfig);
       this.applyTruncationFallbackOverrides(isTruncationFallbackStep, stepConfig);
       logger2.debug("Starting step iteration", { stepIteration, ...stepConfig.metadata });
-      const messagesWithCache = applyCacheBreakpoints(stepConfig.messages, this.cacheBreakpoint, this.model);
+      const messagesWithCache = applyCacheBreakpoints(stepConfig.messages, this.cacheBreakpoint, ctx.resolved.model);
       ctx.streamTextStarted = true;
-      const stepMaxOutputTokens = isTruncationFallbackStep ? Math.min(this.maxOutputTokens, TRUNCATION_FALLBACK_MAX_TOKENS) : this.maxOutputTokens;
+      const stepMaxOutputTokens = isTruncationFallbackStep ? Math.min(ctx.resolved.maxOutputTokens, TRUNCATION_FALLBACK_MAX_TOKENS) : ctx.resolved.maxOutputTokens;
       const createStream = () => streamText({
-        model: this.model,
+        model: ctx.resolved.model,
         messages: messagesWithCache,
         tools: stepConfig.tools,
         stopWhen: stepCountIs(1),
         maxOutputTokens: stepMaxOutputTokens,
-        temperature: this.temperature,
+        temperature: ctx.resolved.temperature,
         abortSignal: ctx.session.abortController?.signal,
-        providerOptions: this.providerOptions,
+        providerOptions: ctx.resolved.providerOptions,
         experimental_telemetry: span.active ? { isEnabled: true, functionId: "use-ai", metadata: stepConfig.metadata } : undefined,
         onStepFinish: ({ usage, finishReason }) => {
           logger2.debug("Step finished", { usage, finishReason, stepIteration });
@@ -145435,14 +145482,14 @@ class AISDKAgent {
     ctx.currentMessages = [...ctx.currentMessages, fallbackMessage];
     ctx.truncationFallbackPending = true;
     logger2.warn("Output truncated mid-text/reasoning by maxOutputTokens; running fallback iteration", {
-      maxOutputTokens: this.maxOutputTokens,
+      maxOutputTokens: ctx.resolved.maxOutputTokens,
       appendingToMessageId: ctx.pendingTextMessageId ?? undefined
     });
     return true;
   }
   handleIncompleteToolCalls(ctx, stepCtx) {
     const incompleteToolCalls = [...stepCtx.activeToolCalls.entries()].filter(([id]) => !stepCtx.completedToolCalls.has(id)).map(([id, call]) => ({ id, ...call }));
-    const recoveryMessages = buildRecoveryToolResults(incompleteToolCalls, stepCtx.stepFinishReason, this.maxOutputTokens);
+    const recoveryMessages = buildRecoveryToolResults(incompleteToolCalls, stepCtx.stepFinishReason, ctx.resolved.maxOutputTokens);
     if (recoveryMessages.length === 0) {
       return false;
     }
@@ -145775,16 +145822,6 @@ class AISDKAgent {
       conversationHistory: ctx.messages
     };
   }
-  async resolveSystemPrompt() {
-    if (!this.systemPrompt) {
-      return;
-    }
-    if (typeof this.systemPrompt === "string") {
-      return this.systemPrompt;
-    }
-    const result = await this.systemPrompt();
-    return result || undefined;
-  }
   buildStaticSystemMessages(configPrompt, runtimePrompt) {
     const messages = [];
     if (configPrompt) {
@@ -146064,26 +146101,6 @@ var MockLanguageModelV3 = class {
     return this._supportedUrls();
   }
 };
-function simulateReadableStream({
-  chunks,
-  initialDelayInMs = 0,
-  chunkDelayInMs = 0,
-  _internal
-}) {
-  const delay2 = _internal?.delay ?? delay;
-  let index = 0;
-  return new ReadableStream({
-    async pull(controller) {
-      if (index < chunks.length) {
-        await delay2(index === 0 ? initialDelayInMs : chunkDelayInMs);
-        controller.enqueue(chunks[index++]);
-      } else {
-        controller.close();
-      }
-    }
-  });
-}
-var simulateReadableStream2 = simulateReadableStream;
 
 // src/agents/testing/MockReasoningModel.ts
 var CHUNK_DELAY_MS = 100;
@@ -146161,7 +146178,7 @@ function toolCallChunks(toolCallId, toolName, input) {
 }
 function makeStreamResponse(chunks, content) {
   return {
-    stream: simulateReadableStream2({ chunks, chunkDelayInMs: CHUNK_DELAY_MS }),
+    stream: simulateReadableStream({ chunks, chunkDelayInMs: CHUNK_DELAY_MS }),
     response: {
       id: `mock-response-${Date.now()}`,
       timestamp: new Date,

package/dist/plugins/FeedbackPlugin.d.ts

@@ -17,7 +17,7 @@ import type { ClientSession } from '../agents/types';
  * import { FeedbackPlugin } from '@meetsmore-oss/use-ai-server';
  *
  * const server = new UseAIServer({
- *   agents: { claude: new AISDKAgent({ model }) },
+ *   agents: { claude: new AISDKAgent({ hooks: { loadConfig: () => ({ model }) } }) },
  *   defaultAgent: 'claude',
  *   plugins: [
  *     new FeedbackPlugin(),

package/dist/server.d.ts

@@ -26,7 +26,7 @@ export type { ClientSession } from './agents/types';
  *   apiKey: process.env.ANTHROPIC_API_KEY,
  * });
  * const claudeAgent = new AISDKAgent({
- *   model: anthropic('claude-sonnet-4-20250514'),
+ *   hooks: { loadConfig: () => ({ model: anthropic('claude-sonnet-4-20250514') }) },
  * });
  * const server = new UseAIServer({
  *   port: 8081,
@@ -36,7 +36,7 @@ export type { ClientSession } from './agents/types';
  *
  * // Multiple agents (Claude + OpenAI)
  * const gptAgent = new AISDKAgent({
- *   model: openai('gpt-4-turbo'),
+ *   hooks: { loadConfig: () => ({ model: openai('gpt-4-turbo') }) },
  * });
  * const multiServer = new UseAIServer({
  *   port: 8081,

package/dist/src/agents/AISDKAgent.d.ts

@@ -3,81 +3,141 @@ import type { Agent, AgentInput, EventEmitter, AgentResult } from './types';
 import type { ToolDefinition } from '../types';
 import { type CacheBreakpointFn } from './anthropicCache';
 /**
- * Configuration for AISDKAgent.
+ * The generation configuration for a single run(), returned by
+ * {@link AISDKAgentHooks.loadConfig}.
+ *
+ * Because `loadConfig` is called once per run, returning different values here
+ * changes the model / parameters for the next run without a server restart
+ * (e.g. values fetched from Langfuse prompt config).
+ *
+ * Only `model` is required. Omitted optional fields use library defaults.
  */
-export interface AISDKAgentConfig {
+export interface AISDKRunConfig {
     /**
-     * AI SDK Language Model (works with any provider).
+     * AI SDK Language Model (works with any provider). Accepts a model instance
+     * or a gateway model ID string.
+     *
+     * Required: use-ai is provider-agnostic and cannot pick a default model.
      *
      * @example
      * ```typescript
      * import { anthropic } from '@ai-sdk/anthropic';
-     * import { openai } from '@ai-sdk/openai';
-     * import { google } from '@ai-sdk/google';
-     *
-     * // With Anthropic Claude
-     * { model: anthropic('claude-3-5-sonnet-20241022') }
-     *
-     * // With OpenAI GPT
-     * { model: openai('gpt-4-turbo') }
-     *
-     * // With Google Gemini
-     * { model: google('gemini-pro') }
+     * { model: anthropic('claude-3-5-sonnet-20241022') }   // model instance
+     * { model: 'anthropic/claude-3-5-sonnet-20241022' }    // gateway model ID
      * ```
      */
     model: LanguageModel;
     /**
-     * Agent name for identification (defaults to 'ai-sdk').
-     * Use this to differentiate multiple AI SDK agents.
+     * System prompt for this run, set on the backend and not exposed to the
+     * frontend (suitable for sensitive instructions). An empty string is treated
+     * as absent. When the request also carries a system prompt (AgentInput), the
+     * two are sent as separate system messages with this one first.
      */
-    name?: string;
+    systemPrompt?: string;
     /**
-     * Optional annotation/description for the agent.
-     * Displayed in the use-ai agent selector UI to help users understand
-     * the agent's capabilities or purpose.
+     * Temperature for model responses. Lower (e.g. 0) is more deterministic.
+     * @default undefined (uses the model's default)
+     */
+    temperature?: number;
+    /**
+     * Maximum number of tokens the model can output per response.
+     * @default 4096
+     */
+    maxOutputTokens?: number;
+    /**
+     * Maximum number of model step iterations per run. Each iteration performs
+     * one model invocation and may include tool calls.
+     * @default 10
+     */
+    maxSteps?: number;
+    /**
+     * Provider-specific options passed directly to `streamText`.
+     * Used for AI Gateway features like model fallbacks and provider routing.
      *
      * @example
      * ```typescript
-     * { annotation: 'Fast responses for simple tasks' }
-     * { annotation: 'Deep thinking mode for complex reasoning' }
+     * {
+     *   providerOptions: {
+     *     gateway: {
+     *       models: ['anthropic/claude-opus-4.6', 'google/gemini-3.1-pro-preview'],
+     *       order: ['azure', 'openai'],
+     *     },
+     *   },
+     * }
      * ```
      */
-    annotation?: string;
+    providerOptions?: Record<string, Record<string, JSONValue>>;
+}
+/**
+ * Function-valued configuration points for {@link AISDKAgent}.
+ *
+ * Anything that can change at runtime is supplied through a hook rather than a
+ * static config field, so there is a single source of truth and no "static
+ * value vs. override" ambiguity.
+ */
+export interface AISDKAgentHooks {
     /**
-     * Optional system prompt to configure the agent's behavior.
-     * This prompt is set on the backend and not exposed to the frontend,
-     * making it suitable for sensitive instructions.
+     * Loads the generation config for a run.
+     *
+     * Called once at the start of every run(), so a value fetched from an external
+     * source (e.g. Langfuse prompt config) takes effect on the next request
+     * without a server restart. The agent does not cache the result.
      *
-     * Can be a string, a function returning a string, or an async function
-     * returning a Promise<string>. Use a function when the prompt needs to
-     * be dynamically resolved (e.g., fetched from Langfuse or other external
-     * sources) so updates take effect immediately without server restart.
+     * Required, because it is the only source of the model. For a static setup,
+     * return a constant object.
      *
-     * When both this and the runtime systemPrompt (from AgentInput) are provided,
-     * they are combined with this config prompt coming first.
+     * If it throws, the run fails with RUN_ERROR — there is no static fallback.
+     * Implement resilience (e.g. return a default on a Langfuse outage) inside the
+     * hook itself.
      *
      * @example
      * ```typescript
-     * // Static prompt
-     * {
-     *   systemPrompt: 'You are a helpful assistant.'
-     * }
+     * // Static
+     * { loadConfig: () => ({ model: anthropic('claude-3-5-sonnet-20241022') }) }
      *
-     * // Sync function (e.g., reading from cache)
+     * // Dynamic, fetched from Langfuse (with a fallback owned by the host)
      * {
-     *   systemPrompt: () => promptCache.get('my-prompt')
+     *   loadConfig: async () => {
+     *     try {
+     *       const prompt = await langfuse.prompt.get('my-prompt', { type: 'text' });
+     *       return { model: prompt.config.model, systemPrompt: prompt.prompt };
+     *     } catch {
+     *       return { model: 'anthropic/claude-3-5-sonnet-20241022' };
+     *     }
+     *   },
      * }
+     * ```
+     */
+    loadConfig: () => AISDKRunConfig | Promise<AISDKRunConfig>;
+}
+/**
+ * Configuration for AISDKAgent.
+ *
+ * Structural settings (name, tool filtering, cache breakpoints) live here;
+ * everything that can vary per run is supplied via {@link AISDKAgentHooks}.
+ */
+export interface AISDKAgentConfig {
+    /**
+     * Function-valued configuration. `hooks.loadConfig` (required) supplies the
+     * model and generation parameters for each run.
+     */
+    hooks: AISDKAgentHooks;
+    /**
+     * Agent name for identification (defaults to 'ai-sdk').
+     * Use this to differentiate multiple AI SDK agents.
+     */
+    name?: string;
+    /**
+     * Optional annotation/description for the agent.
+     * Displayed in the use-ai agent selector UI to help users understand
+     * the agent's capabilities or purpose.
      *
-     * // Async function (e.g., fetching from Langfuse)
-     * {
-     *   systemPrompt: async () => {
-     *     const prompt = await langfuse.getPrompt('my-prompt');
-     *     return prompt.compile();
-     *   }
-     * }
+     * @example
+     * ```typescript
+     * { annotation: 'Fast responses for simple tasks' }
      * ```
      */
-    systemPrompt?: string | (() => string | Promise<string>);
+    annotation?: string;
     /**
      * Optional filter function for tools.
      * Use this to control which tools are available to this agent.
@@ -86,17 +146,7 @@ export interface AISDKAgentConfig {
      * @example
      * ```typescript
      * // Only allow MCP tools starting with 'db_'
-     * {
-     *   toolFilter: (tool) =>
-     *     !tool._remote || tool.name.startsWith('db_')
-     * }
-     *
-     * // Block dangerous MCP tools
-     * {
-     *   toolFilter: (tool) =>
-     *     !tool._remote ||
-     *     (!tool.name.includes('delete') && !tool.name.includes('drop'))
-     * }
+     * { toolFilter: (tool) => !tool._remote || tool.name.startsWith('db_') }
      * ```
      */
     toolFilter?: (tool: ToolDefinition) => boolean;
@@ -105,36 +155,16 @@ export interface AISDKAgentConfig {
      * Only applies when using Anthropic models (Claude).
      *
      * Prompt caching reduces costs and latency by caching message prefixes.
-     * Cache breakpoints mark where the cacheable prefix ends.
-     *
      * The function receives each message with positional context and returns
-     * true to add a cache breakpoint after that message.
-     *
-     * System prompt is included as role: 'system' at index 0 when present.
+     * true to add a cache breakpoint after that message. System prompt is
+     * included as role: 'system' at index 0 when present.
      *
      * @see https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching
      *
      * @example
      * ```typescript
      * // Cache system prompt + last message (most common pattern)
-     * {
-     *   cacheBreakpoint: (msg) => msg.role === 'system' || msg.isLast
-     * }
-     *
-     * // Cache only the last message
-     * {
-     *   cacheBreakpoint: (msg) => msg.isLast
-     * }
-     *
-     * // Cache system prompt only
-     * {
-     *   cacheBreakpoint: (msg) => msg.role === 'system'
-     * }
-     *
-     * // Cache first 3 messages + last
-     * {
-     *   cacheBreakpoint: (msg) => msg.index < 3 || msg.isLast
-     * }
+     * { cacheBreakpoint: (msg) => msg.role === 'system' || msg.isLast }
      *
      * // System prompt with 1h TTL, last message with 5m TTL
      * {
@@ -147,52 +177,6 @@ export interface AISDKAgentConfig {
      * ```
      */
     cacheBreakpoint?: CacheBreakpointFn;
-    /**
-     * Provider-specific options passed directly to `streamText`.
-     * Can be used for AI Gateway features like model fallbacks, provider routing, etc.
-     *
-     * @example
-     * ```typescript
-     * // Model fallbacks via AI Gateway
-     * {
-     *   providerOptions: {
-     *     gateway: {
-     *       models: ['anthropic/claude-opus-4.6', 'google/gemini-3.1-pro-preview'],
-     *     },
-     *   },
-     * }
-     *
-     * // Model fallbacks + provider routing
-     * {
-     *   providerOptions: {
-     *     gateway: {
-     *       models: ['openai/gpt-5-nano', 'anthropic/claude-opus-4.6'],
-     *       order: ['azure', 'openai'],
-     *     },
-     *   },
-     * }
-     * ```
-     */
-    providerOptions?: Record<string, Record<string, JSONValue>>;
-    /**
-     * Maximum number of tokens the model can output per response.
-     * @default 4096
-     */
-    maxOutputTokens?: number;
-    /**
-     * Temperature for model responses.
-     * Lower values (e.g., 0) make responses more deterministic.
-     * Higher values (e.g., 1) make responses more creative/random.
-     * Useful for testing where deterministic behavior is desired.
-     * @default undefined (uses model's default)
-     */
-    temperature?: number;
-    /**
-     * Maximum number of model step iterations per run.
-     * Each iteration performs one model invocation and may include tool calls.
-     * @default 10
-     */
-    maxSteps?: number;
 }
 /**
  * Agent implementation for AI SDK models (Anthropic, OpenAI, Google, etc.).
@@ -226,12 +210,12 @@ export interface AISDKAgentConfig {
  * // With Claude
  * const anthropic = createAnthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
  * const claudeAgent = new AISDKAgent({
- *   model: anthropic('claude-3-5-sonnet-20241022'),
+ *   hooks: { loadConfig: () => ({ model: anthropic('claude-3-5-sonnet-20241022') }) },
  * });
  *
  * // With GPT-4
  * const gptAgent = new AISDKAgent({
- *   model: openai('gpt-4-turbo'),
+ *   hooks: { loadConfig: () => ({ model: openai('gpt-4-turbo') }) },
  * });
  *
  * // Agent names come from agents object keys, not from agent config
@@ -245,16 +229,11 @@ export interface AISDKAgentConfig {
  * ```
  */
 export declare class AISDKAgent implements Agent {
-    private model;
-    private providerOptions?;
     private name;
     private annotation?;
     private toolFilter?;
-    private systemPrompt?;
     private cacheBreakpoint?;
-    private maxOutputTokens;
-    private temperature?;
-    private maxSteps;
+    private loadConfig;
     constructor(config: AISDKAgentConfig);
     getName(): string;
     getAnnotation(): string | undefined;
@@ -265,10 +244,17 @@ export declare class AISDKAgent implements Agent {
     flushTelemetry(): Promise<void>;
     run(input: AgentInput, events: EventEmitter): Promise<AgentResult>;
     /**
-     * Creates the RunContext for a single run() invocation.
-     * Resolves system prompt and initializes all mutable state.
+     * Creates the RunContext for a single run() invocation from the loaded run
+     * config. Builds the system messages and initializes all mutable state.
      */
     private createRunContext;
+    /**
+     * Handles a failure of the `hooks.loadConfig` hook, which runs before the
+     * RunContext exists. Emits a well-formed lifecycle (RUN_STARTED then
+     * RUN_ERROR) built from the input so the client is not left hanging, and
+     * returns a failed AgentResult.
+     */
+    private handleConfigLoadError;
     /**
      * Emits initial lifecycle events: RUN_STARTED, MESSAGES_SNAPSHOT, STATE_SNAPSHOT.
      */
@@ -359,18 +345,11 @@ export declare class AISDKAgent implements Agent {
      * emits RUN_ERROR, and returns the AgentResult.
      */
     private handleRunError;
-    /**
-     * Resolves the systemPrompt configuration value.
-     * Handles string, sync function, and async function cases.
-     *
-     * @returns The resolved system prompt string, or undefined if not configured or empty
-     */
-    private resolveSystemPrompt;
     /**
      * Builds an array of static system messages from config and runtime prompts.
      * These are built once per run and remain constant across steps (cacheable prefix).
      *
-     * @param configPrompt - Resolved system prompt from agent config (already resolved via resolveSystemPrompt)
+     * @param configPrompt - Resolved system prompt from the run config (empty string already normalized to undefined)
      * @param runtimePrompt - System prompt from AgentInput (static instructions from server)
      * @returns Array of SystemModelMessage objects, or undefined if both are empty
      */

package/dist/src/agents/AISDKAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"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"}

package/dist/src/agents/index.d.ts

@@ -3,7 +3,7 @@
  * Provides pluggable AI agent backends that emit AG-UI protocol events.
  */
 export type { Agent, AgentInput, EventEmitter, AgentResult, ClientSession } from './types';
-export { AISDKAgent, type AISDKAgentConfig } from './AISDKAgent';
+export { AISDKAgent, type AISDKAgentConfig, type AISDKAgentHooks, type AISDKRunConfig } from './AISDKAgent';
 export { createMockReasoningModel } from './testing/MockReasoningModel';
 export { applyCacheBreakpoints, isAnthropicModel, type MessageWithCacheContext, type CacheTtl, type CacheBreakpointResult, type CacheBreakpointFn, } from './anthropicCache';
 export { toolNeedsApproval, createApprovalWrapper, waitForApproval, type ToolArguments, type ToolResult, type ToolExecutor, } from './toolApproval';

package/dist/src/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC"}