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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetsmore-oss/use-ai-server",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "license": "BUSL-1.1",
   "files": [
     "dist"
@@ -32,7 +32,7 @@
   "dependencies": {
     "@ai-sdk/anthropic": "3.0.0-beta.59",
     "@ai-sdk/openai": "3.0.0-beta.66",
-    "@meetsmore-oss/use-ai-core": "1.2.4",
+    "@meetsmore-oss/use-ai-core": "1.3.0",
     "ai": "6.0.0-beta.116",
     "picomatch": "^4.0.3",
     "socket.io": "^4.8.1",

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

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

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

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

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

@@ -1,72 +0,0 @@
-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/agents/plugins/citations/citationPlugin.d.ts.map

@@ -1 +0,0 @@
-{"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/agents/plugins/citations/citationPlugin.test.d.ts

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

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

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

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

@@ -1,7 +0,0 @@
-/**
- * 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/agents/plugins/citations/index.d.ts.map

@@ -1 +0,0 @@
-{"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/agents/plugins/index.d.ts

@@ -1,34 +0,0 @@
-/**
- * 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/agents/plugins/index.d.ts.map

@@ -1 +0,0 @@
-{"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/agents/plugins/runner.d.ts

@@ -1,76 +0,0 @@
-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/agents/plugins/runner.d.ts.map

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,280 +0,0 @@
-import type { ModelMessage, SystemModelMessage } from 'ai';
-import type { EventEmitter, ClientSession } from '../types';
-import type { ToolDefinition } from '../../types';
-import type { Logger } from '../../logger';
-/**
- * Context available to plugins during a run.
- * Contains session info, event emitter, and shared state.
- */
-export interface AgentPluginContext {
-    /** Unique identifier for this run */
-    runId: string;
-    /** Client identifier from the session */
-    clientId: string;
-    /** Thread identifier for the conversation */
-    threadId?: string;
-    /** AI provider name (e.g., 'openai', 'anthropic') */
-    provider: string;
-    /** Event emitter for sending AG-UI events */
-    events: EventEmitter;
-    /** Shared state between plugins within a single run */
-    state: Map<string, unknown>;
-    /** Logger instance */
-    logger: Logger;
-    /** The client session */
-    session: ClientSession;
-}
-/**
- * Input data passed to onUserMessage hook.
- * Plugins can modify these values before they're sent to the AI SDK.
- */
-export interface AgentRunInput {
-    /** Conversation messages in AI SDK format */
-    messages: ModelMessage[];
-    /** System messages (if any). Passed directly to AI SDK. */
-    systemMessages?: SystemModelMessage[];
-    /** Available tools for this run */
-    tools: ToolDefinition[];
-}
-/**
- * Result data passed to onAgentResponse hook.
- * Plugins can process or transform the response.
- */
-export interface AgentRunResult {
-    /** The generated text response */
-    text: string;
-    /** Sources/citations from the AI response */
-    sources?: unknown[];
-    /** Raw response object from AI SDK */
-    response?: {
-        messages: unknown[];
-    };
-    /** Provider-specific metadata */
-    providerMetadata?: Record<string, unknown>;
-    /** Tool calls made during the run */
-    toolCalls?: unknown[];
-    /** Results from tool executions */
-    toolResults?: unknown[];
-    /** Token usage information */
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-    };
-}
-/**
- * Information about a tool call (before execution).
- */
-export interface ToolCallInfo {
-    /** Unique identifier for this tool call */
-    id: string;
-    /** Name of the tool being called */
-    name: string;
-    /** Arguments passed to the tool */
-    args: unknown;
-}
-/**
- * Information about a tool result (after execution).
- */
-export interface ToolResultInfo extends ToolCallInfo {
-    /** Result returned from the tool */
-    result: unknown;
-    /** Error if the tool execution failed */
-    error?: Error;
-}
-/**
- * Known AI SDK stream chunk types.
- * These are the chunk types commonly emitted by the AI SDK fullStream.
- */
-/** Text content being streamed */
-export interface TextDeltaChunk {
-    type: 'text-delta';
-    text: string;
-}
-/** Extended thinking/reasoning content (Claude) */
-export interface ReasoningDeltaChunk {
-    type: 'reasoning-delta';
-    text: string;
-}
-/** Source/citation from web search or RAG */
-export interface SourceChunk {
-    type: 'source';
-    id: string;
-    sourceType: string;
-    url?: string;
-    title?: string;
-    providerMetadata?: Record<string, unknown>;
-}
-/** Tool call starting to stream */
-export interface ToolInputStartChunk {
-    type: 'tool-input-start';
-    id: string;
-    toolName: string;
-}
-/** Tool arguments being streamed */
-export interface ToolInputDeltaChunk {
-    type: 'tool-input-delta';
-    id: string;
-    delta: string;
-}
-/** Tool call complete with parsed input */
-export interface ToolCallChunk {
-    type: 'tool-call';
-    toolCallId: string;
-    toolName: string;
-    input: unknown;
-}
-/** Tool execution result */
-export interface ToolResultChunk {
-    type: 'tool-result';
-    toolCallId: string;
-    toolName: string;
-    output: unknown;
-}
-/** Step started in multi-step execution */
-export interface StartStepChunk {
-    type: 'start-step';
-}
-/** Step finished in multi-step execution */
-export interface FinishStepChunk {
-    type: 'finish-step';
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-    };
-    finishReason?: string;
-}
-/** Stream error */
-export interface ErrorChunk {
-    type: 'error';
-    error: Error;
-}
-/** Unknown chunk type (fallback for future AI SDK chunk types) */
-export interface UnknownChunk {
-    type: string;
-    [key: string]: unknown;
-}
-/**
- * Union of all known AI SDK stream chunk types.
- * Plugins can use type narrowing with `chunk.type` to handle specific chunk types.
- *
- * @example
- * ```typescript
- * onChunk(chunk, context) {
- *   if (chunk.type === 'source') {
- *     // TypeScript knows chunk is SourceChunk here
- *     console.log(chunk.url);
- *   }
- * }
- * ```
- */
-export type StreamChunk = TextDeltaChunk | ReasoningDeltaChunk | SourceChunk | ToolInputStartChunk | ToolInputDeltaChunk | ToolCallChunk | ToolResultChunk | StartStepChunk | FinishStepChunk | ErrorChunk | UnknownChunk;
-/**
- * Plugin interface for extending AISDKAgent functionality.
- *
- * Plugins can hook into various points of 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
- * const loggingPlugin: AgentPlugin = {
- *   id: 'logging',
- *
- *   onUserMessage(input, context) {
- *     context.logger.info('User message received', {
- *       messageCount: input.messages.length,
- *     });
- *     return input;
- *   },
- *
- *   onAgentResponse(result, context) {
- *     context.logger.info('Agent response', {
- *       textLength: result.text.length,
- *     });
- *     return result;
- *   },
- * };
- * ```
- */
-export interface AgentPlugin {
-    /** Unique plugin identifier */
-    id: string;
-    /**
-     * Initialize plugin (called once when agent is created).
-     * Use this to set up any resources the plugin needs.
-     *
-     * @param context - Initialization context with provider info
-     */
-    initialize?(context: {
-        provider: string;
-    }): void | Promise<void>;
-    /**
-     * Called before the user message is sent to AI SDK.
-     * Can modify messages, system prompt, or tools.
-     *
-     * @param input - The input data (messages, system prompt, tools)
-     * @param context - Plugin context with run info and shared state
-     * @returns Modified input or unchanged input
-     */
-    onUserMessage?(input: AgentRunInput, context: AgentPluginContext): AgentRunInput | Promise<AgentRunInput>;
-    /**
-     * Called after AI SDK completes processing (including all tool calls).
-     * Can process results, emit events, or transform the final text.
-     *
-     * @param result - The agent's response data
-     * @param context - Plugin context with run info and shared state
-     * @returns Modified result or unchanged result
-     */
-    onAgentResponse?(result: AgentRunResult, context: AgentPluginContext): AgentRunResult | Promise<AgentRunResult>;
-    /**
-     * Called for each streaming text chunk.
-     * Can transform chunks. Return undefined/void to keep chunk unchanged.
-     *
-     * @param chunk - The text chunk being streamed
-     * @param context - Plugin context with run info and shared state
-     * @returns Transformed chunk, or undefined to keep original
-     */
-    onTextChunk?(chunk: string, context: AgentPluginContext): string | void | Promise<string | void>;
-    /**
-     * Called before a tool is executed.
-     * Can modify the tool call or return null to skip execution.
-     *
-     * @param toolCall - Information about the tool being called
-     * @param context - Plugin context with run info and shared state
-     * @returns Modified tool call, null to skip, or unchanged
-     */
-    onBeforeToolCall?(toolCall: ToolCallInfo, context: AgentPluginContext): ToolCallInfo | null | Promise<ToolCallInfo | null>;
-    /**
-     * Called after a tool is executed.
-     * Can modify the tool result before it's sent back to the AI.
-     *
-     * @param toolResult - Information about the completed tool call
-     * @param context - Plugin context with run info and shared state
-     * @returns Modified result or unchanged result
-     */
-    onAfterToolCall?(toolResult: ToolResultInfo, context: AgentPluginContext): unknown | Promise<unknown>;
-    /**
-     * Called for each chunk from the AI SDK stream.
-     * Plugins can filter by chunk.type to handle specific chunk types.
-     *
-     * Common chunk types:
-     * - 'text-delta': Text content being streamed
-     * - 'source': Citation/source from web search or RAG
-     * - 'tool-call': Tool invocation
-     * - 'tool-result': Tool execution result
-     * - 'start-step', 'finish-step': Multi-step execution markers
-     *
-     * @param chunk - The stream chunk with type and type-specific properties
-     * @param context - Plugin context with run info and shared state
-     */
-    onChunk?(chunk: StreamChunk, context: AgentPluginContext): void | Promise<void>;
-    /**
-     * Cleanup (called when agent is destroyed).
-     * Use to release any resources the plugin acquired.
-     */
-    destroy?(): void | Promise<void>;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,72 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,7 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,34 +0,0 @@
-/**
- * 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