@meetsmore-oss/use-ai-server 1.2.3 → 1.2.4

package/dist/agents/plugins/types.d.ts.map

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

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { UseAIServer } from './server';
 export type { UseAIServerConfig, McpEndpointConfig, ToolDefinition, CorsOptions } from './types';
 export type { ClientSession } from './server';
 export type { Agent, AgentInput, EventEmitter, AgentResult } from './agents';
-export { AISDKAgent, type AISDKAgentConfig } from './agents';
+export { AISDKAgent, type AISDKAgentConfig, type MessageWithCacheContext, type CacheTtl, type CacheBreakpointResult, type CacheBreakpointFn } from './agents';
 export type { UseAIServerPlugin, MessageHandler } from './plugins';
 export { logger } from './logger';
 export { createClientToolExecutor, isRemoteTool, createGlobFilter, and, or, not, } from './utils';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG7D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAChB,GAAG,EACH,EAAE,EACF,GAAG,GACJ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,QAAQ,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG9J,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAChB,GAAG,EACH,EAAE,EACF,GAAG,GACJ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -80244,6 +80244,53 @@ function initializeLangfuse() {
   }
 }
 
+// src/agents/anthropicCache.ts
+function isAnthropicModel(model) {
+  if (typeof model === "string") {
+    return model.startsWith("anthropic/");
+  }
+  const provider = model.provider;
+  return provider?.startsWith("anthropic") ?? false;
+}
+function applyCacheBreakpoints(messages, cacheBreakpoint, model) {
+  if (!cacheBreakpoint || !isAnthropicModel(model)) {
+    return messages;
+  }
+  const totalCount = messages.length;
+  let cacheBreakpointCount = 0;
+  const result = messages.map((message, index) => {
+    const context = {
+      ...message,
+      index,
+      totalCount,
+      isFirst: index === 0,
+      isLast: index === totalCount - 1
+    };
+    const breakpointResult = cacheBreakpoint(context);
+    if (breakpointResult) {
+      cacheBreakpointCount++;
+      const cacheControl = typeof breakpointResult === "string" ? { type: "ephemeral", ttl: breakpointResult } : { type: "ephemeral" };
+      return {
+        ...message,
+        providerOptions: {
+          ...message.providerOptions,
+          anthropic: {
+            cacheControl
+          }
+        }
+      };
+    }
+    return message;
+  });
+  if (cacheBreakpointCount > 0) {
+    logger2.debug("Applied cache breakpoints", {
+      totalMessages: totalCount,
+      cacheBreakpointCount
+    });
+  }
+  return result;
+}
+
 // src/agents/AISDKAgent.ts
 class AISDKAgent {
   model;
@@ -80252,12 +80299,14 @@ class AISDKAgent {
   langfuse;
   toolFilter;
   systemPrompt;
+  cacheBreakpoint;
   constructor(config2) {
     this.model = config2.model;
     this.name = config2.name || "ai-sdk";
     this.annotation = config2.annotation;
     this.toolFilter = config2.toolFilter;
     this.systemPrompt = config2.systemPrompt;
+    this.cacheBreakpoint = config2.cacheBreakpoint;
     this.langfuse = initializeLangfuse();
   }
   getName() {
@@ -80312,9 +80361,10 @@ class AISDKAgent {
         })),
         systemMessages: systemMessages?.map((m) => m.content.substring(0, 80) + (m.content.length > 80 ? "..." : ""))
       });
+      const messagesWithCache = applyCacheBreakpoints(messagesWithSystem, this.cacheBreakpoint, this.model);
       const stream = streamText({
         model: this.model,
-        messages: messagesWithSystem,
+        messages: messagesWithCache,
         tools: tools.length > 0 ? this.sanitizeToolsForAPI(this.filterTools(tools), session) : undefined,
         stopWhen: stepCountIs(10),
         maxOutputTokens: 4096,

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

@@ -1,6 +1,7 @@
 import { LanguageModel } from 'ai';
 import type { Agent, AgentInput, EventEmitter, AgentResult } from './types';
 import type { ToolDefinition } from '../types';
+import { type CacheBreakpointFn } from './anthropicCache';
 /**
  * Configuration for AISDKAgent.
  */
@@ -99,6 +100,53 @@ export interface AISDKAgentConfig {
      * ```
      */
     toolFilter?: (tool: ToolDefinition) => boolean;
+    /**
+     * Anthropic-specific: Configure cache breakpoints for prompt caching.
+     * 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.
+     *
+     * @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
+     * }
+     *
+     * // System prompt with 1h TTL, last message with 5m TTL
+     * {
+     *   cacheBreakpoint: (msg) => {
+     *     if (msg.role === 'system') return '1h';
+     *     if (msg.isLast) return '5m';
+     *     return false;
+     *   }
+     * }
+     * ```
+     */
+    cacheBreakpoint?: CacheBreakpointFn;
 }
 /**
  * Agent implementation for AI SDK models (Anthropic, OpenAI, Google, etc.).
@@ -151,6 +199,7 @@ export declare class AISDKAgent implements Agent {
     private langfuse;
     private toolFilter?;
     private systemPrompt?;
+    private cacheBreakpoint?;
     constructor(config: AISDKAgentConfig);
     getName(): string;
     getAnnotation(): string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,aAAa,EAA2D,MAAM,IAAI,CAAC;AAIpH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA8C/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,UAAW,YAAW,KAAK;IACtC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAC,CAAoC;IACvD,OAAO,CAAC,YAAY,CAAC,CAA4C;gBAErD,MAAM,EAAE,gBAAgB;IAUpC,OAAO,IAAI,MAAM;IAIjB,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAqXxE;;;;;OAKG;YACW,mBAAmB;IAcjC;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,mBAAmB;IA2B3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAMpC;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAKlC;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAI9B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAMtC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAM1B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAqC;IAEhF;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}
+{"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,aAAa,EAA2D,MAAM,IAAI,CAAC;AAIpH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAqB/C,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA0BjF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC;IAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,UAAW,YAAW,KAAK;IACtC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAC,CAAoC;IACvD,OAAO,CAAC,YAAY,CAAC,CAA4C;IACjE,OAAO,CAAC,eAAe,CAAC,CAAoB;gBAEhC,MAAM,EAAE,gBAAgB;IAWpC,OAAO,IAAI,MAAM;IAIjB,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA6XxE;;;;;OAKG;YACW,mBAAmB;IAcjC;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,mBAAmB;IA2B3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAMpC;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAKlC;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAI9B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAMtC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAM1B;IAEX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAqC;IAEhF;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}

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

@@ -0,0 +1,65 @@
+/**
+ * Anthropic prompt caching utilities for AI SDK Agent.
+ *
+ * This module handles cache breakpoint configuration for Anthropic models (Claude).
+ * Prompt caching reduces costs and latency by caching message prefixes.
+ *
+ * @see https://platform.claude.com/docs/en/build-with-claude/prompt-caching
+ */
+import type { LanguageModel, ModelMessage } from 'ai';
+/**
+ * ModelMessage extended with positional context for cache breakpoint decisions.
+ * Used by the cacheBreakpoint config to determine which messages should have
+ * Anthropic's cache_control breakpoints applied.
+ *
+ * System prompt is included as role: 'system' at index 0 when present.
+ */
+export type MessageWithCacheContext = ModelMessage & {
+    /** Position in the messages array (0-indexed, system prompt is 0 if present) */
+    index: number;
+    /** Total number of messages including system prompt */
+    totalCount: number;
+    /** True if this is the first message */
+    isFirst: boolean;
+    /** True if this is the last message */
+    isLast: boolean;
+};
+/**
+ * Cache TTL options for Anthropic prompt caching.
+ * - '5m': 5-minute cache (default, refreshed on each use at no cost)
+ * - '1h': 1-hour cache (additional cost, useful for infrequent access patterns)
+ *
+ * @see https://platform.claude.com/docs/en/build-with-claude/prompt-caching#1-hour-cache-duration
+ */
+export type CacheTtl = '5m' | '1h';
+/**
+ * Return type for cacheBreakpoint function.
+ * - `false` / `null` / `undefined`: No cache breakpoint
+ * - `true`: Cache breakpoint with default TTL (5m)
+ * - `'5m'` / `'1h'`: Cache breakpoint with specified TTL
+ */
+export type CacheBreakpointResult = boolean | CacheTtl | null | undefined;
+/**
+ * Function type for determining cache breakpoints.
+ */
+export type CacheBreakpointFn = (message: MessageWithCacheContext) => CacheBreakpointResult;
+/**
+ * Checks if the given model is an Anthropic model (Claude).
+ */
+export declare function isAnthropicModel(model: LanguageModel): boolean;
+/**
+ * Applies cache breakpoints to messages for Anthropic prompt caching.
+ * Only applies when:
+ * 1. cacheBreakpoint config is provided
+ * 2. Model is an Anthropic model
+ *
+ * Adds providerOptions.anthropic.cacheControl to messages where
+ * the cacheBreakpoint function returns true.
+ *
+ * @param messages - The messages array (system prompt should be prepended as role: 'system')
+ * @param cacheBreakpoint - Function to determine which messages should have cache breakpoints
+ * @param model - The AI SDK LanguageModel to check if it's Anthropic
+ * @returns Messages with cache control providerOptions added where applicable
+ */
+export declare function applyCacheBreakpoints(messages: ModelMessage[], cacheBreakpoint: CacheBreakpointFn | undefined, model: LanguageModel): ModelMessage[];
+//# sourceMappingURL=anthropicCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropicCache.d.ts","sourceRoot":"","sources":["../../../src/agents/anthropicCache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAGtD;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG;IACnD,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,qBAAqB,CAAC;AAE5F;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAQ9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,EACxB,eAAe,EAAE,iBAAiB,GAAG,SAAS,EAC9C,KAAK,EAAE,aAAa,GACnB,YAAY,EAAE,CAyDhB"}

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

@@ -4,4 +4,5 @@
  */
 export type { Agent, AgentInput, EventEmitter, AgentResult, ClientSession } from './types';
 export { AISDKAgent, type AISDKAgentConfig } from './AISDKAgent';
+export { applyCacheBreakpoints, isAnthropicModel, type MessageWithCacheContext, type CacheTtl, type CacheBreakpointResult, type CacheBreakpointFn, } from './anthropicCache';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/src/agents/plugins/__tests__/runner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.test.d.ts.map

package/dist/src/agents/plugins/__tests__/runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.test.d.ts","sourceRoot":"","sources":["../../../../../src/agents/plugins/__tests__/runner.test.ts"],"names":[],"mappings":""}

package/dist/src/agents/plugins/citations/citationPlugin.d.ts

@@ -0,0 +1,72 @@
+import type { AgentPlugin } from '../types';
+/**
+ * Citation source that can be included in tool results.
+ * Tools (like RAG) can return citations in their results using this format.
+ *
+ * @example
+ * ```typescript
+ * // In your RAG tool implementation:
+ * return {
+ *   answer: "Based on the documentation...",
+ *   _citations: [
+ *     { url: "https://docs.example.com/api", title: "API Reference" },
+ *     { url: "https://docs.example.com/guide", title: "Getting Started Guide" },
+ *   ]
+ * };
+ * ```
+ */
+export interface ToolCitationSource {
+    /** URL of the source document */
+    url: string;
+    /** Title of the source (optional) */
+    title?: string;
+    /** Additional metadata (optional) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Available citation types.
+ *
+ * - `anthropic`: Extracts from Anthropic web search source chunks (streaming) and result.sources
+ * - `openai`: Extracts from OpenAI url_citation annotations in response messages
+ * - `rag`: Extracts from tool results with `_citations`, `citations`, or `sources` fields
+ */
+export type CitationType = 'rag';
+/**
+ * Plugin that handles citation collection and emission.
+ *
+ * Supports multiple citation sources:
+ * - **rag**: Citations in tool results via `_citations`, `citations`, or `sources` fields
+ * - **anthropic**: Source chunks during streaming + result.sources (for future use)
+ * - **openai**: url_citation annotations in response (for future use)
+ *
+ * @param enabledTypes - Which extractors to enable. If not provided, all extractors are enabled.
+ *                       Extractors run in the order specified.
+ *
+ * @example
+ * ```typescript
+ * // With custom RAG tool - return citations in the tool result
+ * import { AISDKAgent, citationPlugin } from '@meetsmore-oss/use-ai-server';
+ *
+ * const ragTool = defineTool(
+ *   'Search internal documentation',
+ *   z.object({ query: z.string() }),
+ *   async ({ query }) => {
+ *     const results = await vectorDb.search(query);
+ *     return {
+ *       answer: results.map(r => r.content).join('\n'),
+ *       _citations: results.map(r => ({
+ *         url: r.sourceUrl,
+ *         title: r.title,
+ *       })),
+ *     };
+ *   }
+ * );
+ *
+ * const agent = new AISDKAgent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   plugins: [citationPlugin(['rag'])],
+ * });
+ * ```
+ */
+export declare function citationPlugin(enabledTypes?: CitationType[]): AgentPlugin;
+//# sourceMappingURL=citationPlugin.d.ts.map

package/dist/src/agents/plugins/citations/citationPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citationPlugin.d.ts","sourceRoot":"","sources":["../../../../../src/agents/plugins/citations/citationPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAgF,MAAM,UAAU,CAAC;AAI1H;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC;AAoPjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,WAAW,CA4CzE"}

package/dist/src/agents/plugins/citations/citationPlugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=citationPlugin.test.d.ts.map

package/dist/src/agents/plugins/citations/citationPlugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citationPlugin.test.d.ts","sourceRoot":"","sources":["../../../../../src/agents/plugins/citations/citationPlugin.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,7 @@
+/**
+ * Citation plugin for AISDKAgent.
+ * Collects sources from AI responses and emits citation events.
+ */
+export { citationPlugin } from './citationPlugin';
+export type { ToolCitationSource, CitationType } from './citationPlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/agents/plugins/citations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Agent plugin system for extending AISDKAgent functionality.
+ *
+ * Plugins can hook into the agent lifecycle to:
+ * - Modify inputs before sending to AI
+ * - Transform streaming chunks
+ * - Intercept or modify tool calls
+ * - Process and transform responses
+ * - Handle errors
+ *
+ * @example
+ * ```typescript
+ * import { AISDKAgent } from '@meetsmore-oss/use-ai-server';
+ * import type { AgentPlugin } from '@meetsmore-oss/use-ai-server';
+ *
+ * const loggingPlugin: AgentPlugin = {
+ *   id: 'logging',
+ *   onUserMessage(input, ctx) {
+ *     ctx.logger.info('Message received');
+ *     return input;
+ *   },
+ * };
+ *
+ * const agent = new AISDKAgent({
+ *   model: anthropic('claude-3-5-sonnet-20241022'),
+ *   plugins: [loggingPlugin],
+ * });
+ * ```
+ */
+export type { AgentPlugin, AgentPluginContext, AgentRunInput, AgentRunResult, ToolCallInfo, ToolResultInfo, StreamChunk, TextDeltaChunk, ReasoningDeltaChunk, SourceChunk, ToolInputStartChunk, ToolInputDeltaChunk, ToolCallChunk, ToolResultChunk, StartStepChunk, FinishStepChunk, ErrorChunk, UnknownChunk, } from './types';
+export { AgentPluginRunner } from './runner';
+export { citationPlugin } from './citations';
+export type { ToolCitationSource, CitationType } from './citations';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EAEd,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/agents/plugins/runner.d.ts

@@ -0,0 +1,76 @@
+import type { AgentPlugin, AgentPluginContext, AgentRunInput, AgentRunResult, ToolCallInfo, ToolResultInfo, StreamChunk } from './types';
+/**
+ * Orchestrates plugin execution for AISDKAgent.
+ *
+ * Plugins are executed in the order they were registered.
+ * Each hook is called sequentially, with the output of one plugin
+ * becoming the input of the next.
+ *
+ * @example
+ * ```typescript
+ * const runner = new AgentPluginRunner([
+ *   loggingPlugin,
+ *   metricsPlugin,
+ * ]);
+ *
+ * // Initialize plugins
+ * await runner.initialize({ provider: 'anthropic' });
+ *
+ * // Use in agent run
+ * const processedInput = await runner.onUserMessage(input, context);
+ * ```
+ */
+export declare class AgentPluginRunner {
+    private plugins;
+    constructor(plugins?: AgentPlugin[]);
+    /**
+     * Initialize all plugins.
+     * Called once when the agent is created.
+     */
+    initialize(context: {
+        provider: string;
+    }): Promise<void>;
+    /**
+     * Run onUserMessage hook for all plugins.
+     * Each plugin receives the output of the previous plugin.
+     */
+    onUserMessage(input: AgentRunInput, context: AgentPluginContext): Promise<AgentRunInput>;
+    /**
+     * Run onAgentResponse hook for all plugins.
+     * Each plugin receives the output of the previous plugin.
+     */
+    onAgentResponse(result: AgentRunResult, context: AgentPluginContext): Promise<AgentRunResult>;
+    /**
+     * Run onTextChunk hook for all plugins.
+     * Returns the transformed chunk (or original if no transform).
+     */
+    onTextChunk(chunk: string, context: AgentPluginContext): Promise<string>;
+    /**
+     * Run onBeforeToolCall hook for all plugins.
+     * Returns null if any plugin returns null (tool call should be skipped).
+     */
+    onBeforeToolCall(toolCall: ToolCallInfo, context: AgentPluginContext): Promise<ToolCallInfo | null>;
+    /**
+     * Run onAfterToolCall hook for all plugins.
+     * Returns the final transformed result.
+     */
+    onAfterToolCall(toolResult: ToolResultInfo, context: AgentPluginContext): Promise<unknown>;
+    /**
+     * Run onChunk hook for all plugins.
+     * Called for each chunk from the AI SDK stream.
+     */
+    onChunk(chunk: StreamChunk, context: AgentPluginContext): Promise<void>;
+    /**
+     * Destroy all plugins and release resources.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Check if any plugins are registered.
+     */
+    hasPlugins(): boolean;
+    /**
+     * Get the number of registered plugins.
+     */
+    get pluginCount(): number;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/agents/plugins/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,GAAE,WAAW,EAAO;IAIvC;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D;;;OAGG;IACG,aAAa,CACjB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC;IAUzB;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,cAAc,CAAC;IAU1B;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC;IAalB;;;OAGG;IACG,gBAAgB,CACpB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAW/B;;;OAGG;IACG,eAAe,CACnB,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC;IAUnB;;;OAGG;IACG,OAAO,CACX,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}