@agentick/core 0.0.1

package/dist/mcp/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * MCP (Model Context Protocol) Types
+ *
+ * Configuration types for MCP integration using @modelcontextprotocol/sdk
+ */
+/**
+ * Cursor-style MCP server configuration (simplified format)
+ * Used for both EngineConfig.mcpServers and MCPToolComponent config
+ */
+export interface MCPServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/**
+ * MCP transport types
+ * Note: 'websocket' maps to StreamableHTTP in the SDK
+ */
+export type MCPTransport = "stdio" | "sse" | "websocket";
+/**
+ * MCP server configuration
+ */
+export interface MCPConfig {
+    /**
+     * Unique identifier for this MCP server connection
+     */
+    serverName: string;
+    /**
+     * Transport type for MCP communication
+     */
+    transport: MCPTransport;
+    /**
+     * Connection details (transport-specific)
+     */
+    connection: {
+        /**
+         * For stdio: command and args to spawn
+         */
+        command?: string;
+        args?: string[];
+        /**
+         * For SSE/StreamableHTTP: server URL
+         */
+        url?: string;
+        /**
+         * Additional transport-specific options
+         */
+        [key: string]: any;
+    };
+    /**
+     * Optional authentication
+     */
+    auth?: {
+        type: "bearer" | "api_key" | "custom";
+        token?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * MCP tool definition (from server)
+ * Matches the SDK's Tool type structure
+ */
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,YAAY,CAAC;IAExB;;OAEG;IACH,UAAU,EAAE;QACV;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAEhB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACtC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH"}

package/dist/mcp/types.js

@@ -0,0 +1,6 @@
+/**
+ * MCP (Model Context Protocol) Types
+ *
+ * Configuration types for MCP integration using @modelcontextprotocol/sdk
+ */
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/middleware/defaults.d.ts

@@ -0,0 +1,9 @@
+import { type Middleware } from "@agentick/kernel";
+/**
+ * Error normalization middleware for engine procedures.
+ *
+ * Normalizes errors to EngineError format, classifies them, and determines recoverability.
+ * This allows components and error handlers to work with a consistent error format.
+ */
+export declare const errorMiddleware: Middleware;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/middleware/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/middleware/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AAIvE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,UAyC7B,CAAC"}

package/dist/middleware/defaults.js

@@ -0,0 +1,47 @@
+import { Context, Telemetry } from "@agentick/kernel";
+import {} from "../component/component";
+import { classifyError, isRecoverableError } from "../utils/classify-error";
+/**
+ * Error normalization middleware for engine procedures.
+ *
+ * Normalizes errors to EngineError format, classifies them, and determines recoverability.
+ * This allows components and error handlers to work with a consistent error format.
+ */
+export const errorMiddleware = async (args, envelope, next) => {
+    try {
+        return await next(args);
+    }
+    catch (error) {
+        // Don't wrap abort errors - let them propagate as-is
+        if (error?.name === "AbortError" || error?.message?.includes("aborted")) {
+            throw error;
+        }
+        // Normalize error to Error instance if needed
+        const normalizedError = error instanceof Error ? error : new Error(String(error));
+        // Classify the error
+        const errorType = classifyError(error);
+        const recoverable = isRecoverableError(error);
+        // Create EngineError with context (attached to normalized error for downstream handlers)
+        const _engineError = {
+            error: normalizedError,
+            phase: "unknown", // Middleware doesn't know the phase - will be set by engine if needed
+            recoverable,
+            context: {
+                error_type: errorType,
+                error_code: error.code,
+                error_status: error.status,
+                trace_id: Context.tryGet()?.traceId,
+                procedure_pid: Context.tryGet()?.procedurePid,
+                // Add any other relevant context
+            },
+        };
+        // Note: EngineError is created for future use when error handlers access it
+        // (normalizedError as any).engineError = _engineError;
+        // Record error in telemetry
+        Telemetry.recordError(normalizedError);
+        // Re-throw the normalized error
+        // Downstream handlers can access engineError via error.engineError
+        throw normalizedError;
+    }
+};
+//# sourceMappingURL=defaults.js.map

package/dist/middleware/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/middleware/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAoB,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAe,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IACxE,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,qDAAqD;QACrD,IAAI,KAAK,EAAE,IAAI,KAAK,YAAY,IAAI,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACxE,MAAM,KAAK,CAAC;QACd,CAAC;QAED,8CAA8C;QAC9C,MAAM,eAAe,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAElF,qBAAqB;QACrB,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAE9C,yFAAyF;QACzF,MAAM,YAAY,GAAgB;YAChC,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,SAAS,EAAE,sEAAsE;YACxF,WAAW;YACX,OAAO,EAAE;gBACP,UAAU,EAAE,SAAS;gBACrB,UAAU,EAAE,KAAK,CAAC,IAAI;gBACtB,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO;gBACnC,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,YAAY;gBAC7C,iCAAiC;aAClC;SACF,CAAC;QAEF,4EAA4E;QAC5E,uDAAuD;QAEvD,4BAA4B;QAC5B,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAEvC,gCAAgC;QAChC,mEAAmE;QACnE,MAAM,eAAe,CAAC;IACxB,CAAC;AACH,CAAC,CAAC"}

package/dist/model/adapter-helpers.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Adapter Helpers - Composable utilities for building adapters
+ *
+ * These are opt-in helpers adapters can import and use.
+ * No magic, no DSLs - just functions.
+ *
+ * @module agentick/model/adapter-helpers
+ */
+import type { ContentBlock, Message, UsageStats } from "@agentick/shared";
+import { StopReason } from "@agentick/shared";
+/**
+ * Extract system messages into a single string, return the rest.
+ */
+export declare function extractSystemPrompt(messages: Message[]): {
+    system: string | undefined;
+    messages: Message[];
+};
+/**
+ * Group consecutive tool results by their preceding assistant message.
+ * Useful for providers that expect tool results immediately after tool calls.
+ */
+export declare function groupToolResults(messages: Message[]): Array<{
+    message: Message;
+    toolResults?: Message;
+}>;
+/**
+ * Normalize message - handle string messages, ensure content array exists.
+ */
+export declare function normalizeMessage(msg: Message | string): Message;
+/**
+ * Filter empty messages (no content blocks).
+ */
+export declare function filterEmptyMessages(messages: Message[]): Message[];
+/**
+ * Extract text from content blocks.
+ */
+export declare function extractText(content: ContentBlock[]): string;
+/**
+ * Extract text blocks only.
+ */
+export declare function getTextBlocks(content: ContentBlock[]): Array<{
+    type: "text";
+    text: string;
+}>;
+/**
+ * Check if content has any images.
+ */
+export declare function hasImages(content: ContentBlock[]): boolean;
+/**
+ * Check if content has any tool uses.
+ */
+export declare function hasToolUses(content: ContentBlock[]): boolean;
+/**
+ * Get tool use blocks from content.
+ */
+export declare function getToolUseBlocks(content: ContentBlock[]): Array<{
+    type: "tool_use";
+    toolUseId: string;
+    name: string;
+    input: Record<string, unknown>;
+}>;
+/**
+ * Get tool result blocks from content.
+ */
+export declare function getToolResultBlocks(content: ContentBlock[]): Array<{
+    type: "tool_result";
+    toolUseId: string;
+    name: string;
+    content: ContentBlock[];
+    isError?: boolean;
+}>;
+/**
+ * Get image as base64 data (if available).
+ */
+export declare function imageToBase64(block: ContentBlock): string | undefined;
+/**
+ * Get image as URL (if available).
+ */
+export declare function imageToUrl(block: ContentBlock): string | undefined;
+/**
+ * Get image mime type.
+ */
+export declare function imageMimeType(block: ContentBlock): string | undefined;
+/**
+ * Check if image is base64.
+ */
+export declare function isBase64Image(block: ContentBlock): boolean;
+/**
+ * Check if image is URL.
+ */
+export declare function isUrlImage(block: ContentBlock): boolean;
+/**
+ * Get document as base64 data (if available).
+ */
+export declare function documentToBase64(block: ContentBlock): string | undefined;
+/**
+ * Get document as URL (if available).
+ */
+export declare function documentToUrl(block: ContentBlock): string | undefined;
+/**
+ * Normalize tool reference to { name, description, input } shape.
+ */
+export declare function normalizeToolDefinition(tool: unknown): {
+    name: string;
+    description: string;
+    input: unknown;
+} | null;
+/**
+ * Convert tool input schema to JSON Schema (if it's a Zod schema).
+ * Returns the schema as-is if it's already JSON Schema.
+ */
+export declare function toJsonSchema(schema: unknown): unknown;
+/**
+ * Convert tool result content to simple text/json format.
+ * Useful for providers that expect simple tool outputs.
+ */
+export declare function toolResultToSimple(content: ContentBlock[], isError?: boolean): {
+    type: "text" | "json" | "error";
+    value: unknown;
+};
+/**
+ * Normalize usage stats from various provider formats.
+ */
+export declare function normalizeUsage(raw: Record<string, unknown> | undefined): UsageStats;
+/**
+ * Merge two usage stats (take max of each field).
+ */
+export declare function mergeUsage(a: UsageStats, b: Partial<UsageStats>): UsageStats;
+/**
+ * Common stop reason mappings for various providers.
+ */
+export declare const STOP_REASON_MAP: {
+    readonly stop: StopReason.STOP;
+    readonly length: StopReason.MAX_TOKENS;
+    readonly tool_calls: StopReason.TOOL_USE;
+    readonly content_filter: StopReason.CONTENT_FILTER;
+    readonly function_call: StopReason.TOOL_USE;
+    readonly end_turn: StopReason.STOP;
+    readonly max_tokens: StopReason.MAX_TOKENS;
+    readonly stop_sequence: StopReason.STOP;
+    readonly "tool-calls": StopReason.TOOL_USE;
+    readonly other: StopReason.OTHER;
+    readonly error: StopReason.ERROR;
+    readonly STOP: StopReason.STOP;
+    readonly MAX_TOKENS: StopReason.MAX_TOKENS;
+    readonly SAFETY: StopReason.CONTENT_FILTER;
+    readonly RECITATION: StopReason.CONTENT_FILTER;
+};
+/**
+ * Map provider stop reason string to StopReason enum.
+ */
+export declare function mapStopReason(reason: string | undefined): StopReason;
+/**
+ * Safely get a nested field from an object.
+ */
+export declare function getField<T = unknown>(obj: unknown, ...path: string[]): T | undefined;
+/**
+ * Check if chunk has a specific type field.
+ */
+export declare function isChunkType(chunk: unknown, type: string): boolean;
+//# sourceMappingURL=adapter-helpers.d.ts.map

package/dist/model/adapter-helpers.d.ts.map

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

package/dist/model/adapter-helpers.js

@@ -0,0 +1,351 @@
+/**
+ * Adapter Helpers - Composable utilities for building adapters
+ *
+ * These are opt-in helpers adapters can import and use.
+ * No magic, no DSLs - just functions.
+ *
+ * @module agentick/model/adapter-helpers
+ */
+import { StopReason } from "@agentick/shared";
+// ============================================================================
+// Message Helpers
+// ============================================================================
+/**
+ * Extract system messages into a single string, return the rest.
+ */
+export function extractSystemPrompt(messages) {
+    let system;
+    const rest = [];
+    for (const msg of messages) {
+        if (msg.role === "system") {
+            const text = msg.content
+                .filter((b) => b.type === "text")
+                .map((b) => b.text)
+                .join("\n\n");
+            system = system ? `${system}\n\n${text}` : text;
+        }
+        else {
+            rest.push(msg);
+        }
+    }
+    return { system, messages: rest };
+}
+/**
+ * Group consecutive tool results by their preceding assistant message.
+ * Useful for providers that expect tool results immediately after tool calls.
+ */
+export function groupToolResults(messages) {
+    const result = [];
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        if (msg.role === "tool") {
+            // Attach to previous entry if it was assistant
+            if (result.length > 0 && result[result.length - 1].message.role === "assistant") {
+                result[result.length - 1].toolResults = msg;
+            }
+            else {
+                // Orphan tool result - include anyway
+                result.push({ message: msg });
+            }
+        }
+        else {
+            result.push({ message: msg });
+        }
+    }
+    return result;
+}
+/**
+ * Normalize message - handle string messages, ensure content array exists.
+ */
+export function normalizeMessage(msg) {
+    if (typeof msg === "string") {
+        return { role: "user", content: [{ type: "text", text: msg }] };
+    }
+    return msg;
+}
+/**
+ * Filter empty messages (no content blocks).
+ */
+export function filterEmptyMessages(messages) {
+    return messages.filter((m) => m.content && m.content.length > 0);
+}
+// ============================================================================
+// Content Block Helpers
+// ============================================================================
+/**
+ * Extract text from content blocks.
+ */
+export function extractText(content) {
+    return content
+        .filter((b) => b.type === "text")
+        .map((b) => b.text)
+        .join("");
+}
+/**
+ * Extract text blocks only.
+ */
+export function getTextBlocks(content) {
+    return content.filter((b) => b.type === "text");
+}
+/**
+ * Check if content has any images.
+ */
+export function hasImages(content) {
+    return content.some((b) => b.type === "image");
+}
+/**
+ * Check if content has any tool uses.
+ */
+export function hasToolUses(content) {
+    return content.some((b) => b.type === "tool_use");
+}
+/**
+ * Get tool use blocks from content.
+ */
+export function getToolUseBlocks(content) {
+    return content.filter((b) => b.type === "tool_use");
+}
+/**
+ * Get tool result blocks from content.
+ */
+export function getToolResultBlocks(content) {
+    return content.filter((b) => b.type === "tool_result");
+}
+/**
+ * Get image as base64 data (if available).
+ */
+export function imageToBase64(block) {
+    if (block.type !== "image")
+        return undefined;
+    const img = block;
+    if (img.source.type === "base64")
+        return img.source.data;
+    return undefined;
+}
+/**
+ * Get image as URL (if available).
+ */
+export function imageToUrl(block) {
+    if (block.type !== "image")
+        return undefined;
+    const img = block;
+    if (img.source.type === "url")
+        return img.source.url;
+    // Could also construct data: URL from base64
+    if (img.source.type === "base64") {
+        const mimeType = img.mimeType || "image/png";
+        return `data:${mimeType};base64,${img.source.data}`;
+    }
+    return undefined;
+}
+/**
+ * Get image mime type.
+ */
+export function imageMimeType(block) {
+    if (block.type !== "image")
+        return undefined;
+    const img = block;
+    return img.mimeType;
+}
+/**
+ * Check if image is base64.
+ */
+export function isBase64Image(block) {
+    if (block.type !== "image")
+        return false;
+    return block.source.type === "base64";
+}
+/**
+ * Check if image is URL.
+ */
+export function isUrlImage(block) {
+    if (block.type !== "image")
+        return false;
+    return block.source.type === "url";
+}
+/**
+ * Get document as base64 data (if available).
+ */
+export function documentToBase64(block) {
+    if (block.type !== "document")
+        return undefined;
+    const doc = block;
+    if (doc.source.type === "base64")
+        return doc.source.data;
+    return undefined;
+}
+/**
+ * Get document as URL (if available).
+ */
+export function documentToUrl(block) {
+    if (block.type !== "document")
+        return undefined;
+    const doc = block;
+    if (doc.source.type === "url")
+        return doc.source.url;
+    return undefined;
+}
+// ============================================================================
+// Tool Definition Helpers
+// ============================================================================
+/**
+ * Normalize tool reference to { name, description, input } shape.
+ */
+export function normalizeToolDefinition(tool) {
+    if (!tool || typeof tool !== "object")
+        return null;
+    // ExecutableTool shape: { metadata: { name, description, input } }
+    if ("metadata" in tool && typeof tool.metadata === "object") {
+        const meta = tool.metadata;
+        return {
+            name: meta.name || "",
+            description: meta.description || "",
+            input: meta.input,
+        };
+    }
+    // ToolDefinition shape: { name, description, input }
+    if ("name" in tool) {
+        return {
+            name: tool.name || "",
+            description: tool.description || "",
+            input: tool.input,
+        };
+    }
+    return null;
+}
+/**
+ * Convert tool input schema to JSON Schema (if it's a Zod schema).
+ * Returns the schema as-is if it's already JSON Schema.
+ */
+export function toJsonSchema(schema) {
+    if (!schema)
+        return {};
+    // Check if it's a Zod schema (has _def property)
+    if (typeof schema === "object" && "_def" in schema) {
+        // Zod schema - would need zod-to-json-schema to convert
+        // For now, return as-is and let the adapter handle it
+        return schema;
+    }
+    // Already JSON Schema or plain object
+    return schema;
+}
+// ============================================================================
+// Tool Result Helpers
+// ============================================================================
+/**
+ * Convert tool result content to simple text/json format.
+ * Useful for providers that expect simple tool outputs.
+ */
+export function toolResultToSimple(content, isError) {
+    if (!content || content.length === 0) {
+        return { type: isError ? "error" : "text", value: isError ? "Error" : "Success" };
+    }
+    // Single text block
+    if (content.length === 1 && content[0].type === "text") {
+        const text = content[0].text;
+        return { type: isError ? "error" : "text", value: text };
+    }
+    // Single JSON block
+    if (content.length === 1 && content[0].type === "json") {
+        const json = content[0];
+        const value = json.data ?? (json.text ? JSON.parse(json.text) : {});
+        return { type: isError ? "error" : "json", value };
+    }
+    // Multiple blocks - combine as text
+    const text = content
+        .map((b) => {
+        if (b.type === "text")
+            return b.text;
+        if (b.type === "json") {
+            const j = b;
+            return j.text || JSON.stringify(j.data);
+        }
+        return JSON.stringify(b);
+    })
+        .join("\n");
+    return { type: isError ? "error" : "text", value: text };
+}
+// ============================================================================
+// Usage Helpers
+// ============================================================================
+/**
+ * Normalize usage stats from various provider formats.
+ */
+export function normalizeUsage(raw) {
+    if (!raw)
+        return { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+    const inputTokens = (raw.inputTokens ?? raw.promptTokens ?? raw.prompt_tokens ?? 0);
+    const outputTokens = (raw.outputTokens ??
+        raw.completionTokens ??
+        raw.completion_tokens ??
+        0);
+    const totalTokens = (raw.totalTokens ?? raw.total_tokens ?? inputTokens + outputTokens);
+    return { inputTokens, outputTokens, totalTokens };
+}
+/**
+ * Merge two usage stats (take max of each field).
+ */
+export function mergeUsage(a, b) {
+    return {
+        inputTokens: Math.max(a.inputTokens, b.inputTokens ?? 0),
+        outputTokens: Math.max(a.outputTokens, b.outputTokens ?? 0),
+        totalTokens: Math.max(a.totalTokens, b.totalTokens ?? 0),
+    };
+}
+// ============================================================================
+// Stop Reason Helpers
+// ============================================================================
+/**
+ * Common stop reason mappings for various providers.
+ */
+export const STOP_REASON_MAP = {
+    // OpenAI
+    stop: StopReason.STOP,
+    length: StopReason.MAX_TOKENS,
+    tool_calls: StopReason.TOOL_USE,
+    content_filter: StopReason.CONTENT_FILTER,
+    function_call: StopReason.TOOL_USE,
+    // Anthropic
+    end_turn: StopReason.STOP,
+    max_tokens: StopReason.MAX_TOKENS,
+    stop_sequence: StopReason.STOP,
+    // AI SDK
+    "tool-calls": StopReason.TOOL_USE,
+    other: StopReason.OTHER,
+    error: StopReason.ERROR,
+    // Google
+    STOP: StopReason.STOP,
+    MAX_TOKENS: StopReason.MAX_TOKENS,
+    SAFETY: StopReason.CONTENT_FILTER,
+    RECITATION: StopReason.CONTENT_FILTER,
+};
+/**
+ * Map provider stop reason string to StopReason enum.
+ */
+export function mapStopReason(reason) {
+    if (!reason)
+        return StopReason.UNSPECIFIED;
+    return STOP_REASON_MAP[reason] ?? StopReason.UNSPECIFIED;
+}
+// ============================================================================
+// Chunk Helpers (for mapChunk implementations)
+// ============================================================================
+/**
+ * Safely get a nested field from an object.
+ */
+export function getField(obj, ...path) {
+    let current = obj;
+    for (const key of path) {
+        if (current == null || typeof current !== "object")
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Check if chunk has a specific type field.
+ */
+export function isChunkType(chunk, type) {
+    return typeof chunk === "object" && chunk !== null && chunk.type === type;
+}
+//# sourceMappingURL=adapter-helpers.js.map