@openrouter/agent 0.1.0

package/README.md

@@ -0,0 +1,367 @@
+# OpenRouter Agent (Beta)
+
+Agent toolkit for building AI applications with [OpenRouter](https://openrouter.ai) — tool orchestration, streaming, multi-turn conversations, and format compatibility.
+
+> [!IMPORTANT]
+> This SDK is currently in beta. There may be breaking changes between versions.
+> We recommend pinning to a specific version in your `package.json`.
+
+## Installation
+
+```bash
+# npm
+npm install @openrouter/agent
+
+# pnpm
+pnpm add @openrouter/agent
+
+# bun
+bun add @openrouter/agent
+
+# yarn
+yarn add @openrouter/agent
+```
+
+> [!NOTE]
+> This package is ESM-only. If you are using CommonJS, you can use `await import('@openrouter/agent')`.
+
+## Quick Start
+
+```typescript
+import OpenRouter from '@openrouter/sdk';
+import { callModel, tool } from '@openrouter/agent';
+import { z } from 'zod';
+
+const client = new OpenRouter({ apiKey: 'YOUR_API_KEY' });
+
+const weatherTool = tool({
+  name: 'get_weather',
+  description: 'Get the current weather for a location',
+  inputSchema: z.object({ location: z.string() }),
+  execute: async ({ location }) => ({
+    temperature: 72,
+    condition: 'sunny',
+    location,
+  }),
+});
+
+const result = callModel(client, {
+  model: 'openai/gpt-4o',
+  input: 'What is the weather in San Francisco?',
+  tools: [weatherTool] as const,
+});
+
+// Get the final text response (tools are auto-executed)
+const text = await result.getText();
+console.log(text);
+```
+
+## Features
+
+### Multiple Response Consumption Patterns
+
+`callModel` returns a `ModelResult` that supports many ways to consume the response — all usable concurrently on the same result:
+
+```typescript
+const result = callModel(client, { model, input, tools });
+
+// Await the final text
+const text = await result.getText();
+
+// Await the full response with usage data
+const response = await result.getResponse();
+console.log(response.usage); // { inputTokens, outputTokens, cost, ... }
+
+// Stream text deltas
+for await (const delta of result.getTextStream()) {
+  process.stdout.write(delta);
+}
+
+// Stream reasoning deltas
+for await (const delta of result.getReasoningStream()) {
+  process.stdout.write(delta);
+}
+
+// Stream tool execution events
+for await (const event of result.getToolStream()) {
+  console.log(event);
+}
+
+// Stream structured tool calls
+for await (const toolCall of result.getToolCallsStream()) {
+  console.log(toolCall.name, toolCall.input);
+}
+
+// Get all tool calls after completion
+const toolCalls = await result.getToolCalls();
+```
+
+### Tool Types
+
+The `tool()` factory creates type-safe tools with full Zod schema inference. Three tool types are supported:
+
+**Regular tools** — automatically executed by the agent loop:
+
+```typescript
+const searchTool = tool({
+  name: 'search',
+  description: 'Search the web',
+  inputSchema: z.object({ query: z.string() }),
+  outputSchema: z.object({ results: z.array(z.string()) }),
+  execute: async ({ query }) => {
+    const results = await performSearch(query);
+    return { results };
+  },
+});
+```
+
+**Generator tools** — stream intermediate events during execution:
+
+```typescript
+const analysisTool = tool({
+  name: 'analyze',
+  inputSchema: z.object({ data: z.string() }),
+  eventSchema: z.object({ progress: z.number() }),
+  outputSchema: z.object({ summary: z.string() }),
+  execute: async function* ({ data }) {
+    yield { progress: 0.5 };
+    // ... processing ...
+    return { summary: 'Analysis complete' };
+  },
+});
+```
+
+**Manual tools** — reported to the model but not auto-executed (for human-in-the-loop flows):
+
+```typescript
+const confirmTool = tool({
+  name: 'confirm_action',
+  inputSchema: z.object({ action: z.string() }),
+  execute: false,
+});
+```
+
+### Stop Conditions
+
+Control when the agent loop stops executing tools:
+
+```typescript
+import { callModel, stepCountIs, hasToolCall, maxTokensUsed, maxCost } from '@openrouter/agent';
+
+const result = callModel(client, {
+  model: 'openai/gpt-4o',
+  input: 'Research this topic thoroughly',
+  tools: [searchTool, summarizeTool] as const,
+  // Single condition
+  stopWhen: stepCountIs(10),
+  // Or combine multiple (stops when ANY condition is met)
+  stopWhen: [stepCountIs(10), maxCost(0.50), hasToolCall('summarize')],
+});
+```
+
+Built-in stop conditions:
+
+| Condition | Description |
+|---|---|
+| `stepCountIs(n)` | Stop after `n` tool execution steps (default: 5) |
+| `hasToolCall(name)` | Stop when a specific tool is called |
+| `maxTokensUsed(n)` | Stop when total tokens exceed a threshold |
+| `maxCost(dollars)` | Stop when total cost exceeds a dollar amount |
+| `finishReasonIs(reason)` | Stop on a specific finish reason |
+
+### Tool Approval
+
+Gate tool execution with approval checks for sensitive operations:
+
+```typescript
+const deleteTool = tool({
+  name: 'delete_record',
+  inputSchema: z.object({ id: z.string() }),
+  requireApproval: true, // Always require approval
+  execute: async ({ id }) => { /* ... */ },
+});
+
+// Or use a function for conditional approval
+const writeTool = tool({
+  name: 'write_file',
+  inputSchema: z.object({ path: z.string(), content: z.string() }),
+  requireApproval: ({ path }) => path.startsWith('/etc'),
+  execute: async ({ path, content }) => { /* ... */ },
+});
+
+// Handle approvals at the callModel level
+const result = callModel(client, {
+  model: 'openai/gpt-4o',
+  input: 'Delete record abc-123',
+  tools: [deleteTool] as const,
+  approveToolCalls: async (toolCalls) => {
+    // Return IDs of approved tool calls
+    return toolCalls.map(tc => tc.id);
+  },
+});
+```
+
+### Tool Context
+
+Provide typed context data to tools without passing it through the model:
+
+```typescript
+const dbTool = tool({
+  name: 'query_db',
+  inputSchema: z.object({ sql: z.string() }),
+  contextSchema: z.object({ connectionString: z.string() }),
+  execute: async ({ sql }, ctx) => {
+    const db = connect(ctx?.context.connectionString);
+    return db.query(sql);
+  },
+});
+
+const result = callModel(client, {
+  model: 'openai/gpt-4o',
+  input: 'List all users',
+  tools: [dbTool] as const,
+  context: {
+    query_db: { connectionString: 'postgres://localhost/mydb' },
+  },
+});
+```
+
+### Shared Context
+
+Share mutable state across all tools in a conversation:
+
+```typescript
+const result = callModel(client, {
+  model: 'openai/gpt-4o',
+  input: 'Process these items',
+  tools: [toolA, toolB] as const,
+  sharedContextSchema: z.object({ processedIds: z.array(z.string()) }),
+  context: {
+    shared: { processedIds: [] },
+  },
+});
+```
+
+### Conversation State Management
+
+Persist multi-turn conversations with full state tracking:
+
+```typescript
+import { createInitialState, callModel } from '@openrouter/agent';
+
+// Start a conversation
+let state = createInitialState();
+
+// First turn
+const result1 = callModel(client, {
+  model: 'openai/gpt-4o',
+  input: 'Search for TypeScript best practices',
+  tools: [searchTool] as const,
+  state,
+});
+
+// State is updated with messages, tool calls, and metadata
+state = (await result1.getResponse()).state;
+
+// Continue the conversation
+const result2 = callModel(client, {
+  model: 'openai/gpt-4o',
+  input: 'Now summarize what you found',
+  tools: [searchTool] as const,
+  state,
+});
+```
+
+### Dynamic Parameters Between Turns
+
+Adjust model parameters dynamically based on tool execution:
+
+```typescript
+const searchTool = tool({
+  name: 'search',
+  inputSchema: z.object({ query: z.string() }),
+  nextTurnParams: {
+    temperature: (input) => input.query.includes('creative') ? 0.9 : 0.1,
+    maxOutputTokens: () => 2000,
+  },
+  execute: async ({ query }) => { /* ... */ },
+});
+```
+
+### Format Compatibility
+
+Convert between OpenRouter and other message formats:
+
+```typescript
+import { toClaudeMessage, fromClaudeMessages } from '@openrouter/agent';
+import { toChatMessage, fromChatMessages } from '@openrouter/agent';
+
+// Anthropic Claude format
+const claudeMsg = toClaudeMessage(openRouterMessage);
+const orMessages = fromClaudeMessages(claudeMessages);
+
+// Standard Chat format
+const chatMsg = toChatMessage(openRouterMessage);
+const orMessages2 = fromChatMessages(chatMessages);
+```
+
+## Subpath Exports
+
+For tree-shaking or targeted imports, the package provides granular subpath exports:
+
+```typescript
+import { callModel } from '@openrouter/agent/call-model';
+import { tool } from '@openrouter/agent/tool';
+import { ModelResult } from '@openrouter/agent/model-result';
+import { stepCountIs, maxCost } from '@openrouter/agent/stop-conditions';
+import { toClaudeMessage } from '@openrouter/agent/anthropic-compat';
+import { toChatMessage } from '@openrouter/agent/chat-compat';
+import { ToolContextStore } from '@openrouter/agent/tool-context';
+import { ToolEventBroadcaster } from '@openrouter/agent/tool-event-broadcaster';
+import { createInitialState } from '@openrouter/agent/conversation-state';
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run unit tests
+pnpm test
+
+# Run end-to-end tests (requires OPENROUTER_API_KEY in .env)
+pnpm test:e2e
+
+# Type check
+pnpm typecheck
+
+# Lint
+pnpm lint
+```
+
+### Running Tests
+
+Create a `.env` file with your OpenRouter API key:
+
+```env
+OPENROUTER_API_KEY=sk-or-...
+```
+
+Then run:
+
+```bash
+pnpm test        # Unit tests
+pnpm test:e2e    # Integration tests (requires API key)
+```
+
+## Documentation
+
+Full `callModel` documentation is available at [openrouter.ai/docs/sdks/typescript/call-model](https://openrouter.ai/docs/sdks/typescript/call-model/overview).
+
+## License
+
+Apache-2.0

package/esm/api-shape-helpers/claude-message.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Reason why the model stopped generating.
+ */
+export type ClaudeStopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | 'pause_turn' | 'refusal';
+/**
+ * Character-level citation location within a document.
+ */
+export type ClaudeCitationCharLocation = {
+    type: 'char_location';
+    cited_text: string;
+    document_index: number;
+    document_title: string;
+    file_id: string;
+    start_char_index: number;
+    end_char_index: number;
+};
+/**
+ * Page-level citation location within a document.
+ */
+export type ClaudeCitationPageLocation = {
+    type: 'page_location';
+    cited_text: string;
+    document_index: number;
+    document_title: string;
+    file_id: string;
+    start_page_number: number;
+    end_page_number: number;
+};
+/**
+ * Content block citation location within a document.
+ */
+export type ClaudeCitationContentBlockLocation = {
+    type: 'content_block_location';
+    cited_text: string;
+    document_index: number;
+    document_title: string;
+    file_id: string;
+    start_block_index: number;
+    end_block_index: number;
+};
+/**
+ * Web search result citation location.
+ */
+export type ClaudeCitationWebSearchResultLocation = {
+    type: 'web_search_result_location';
+    cited_text: string;
+    title: string;
+    url: string;
+    encrypted_index: string;
+};
+/**
+ * Search result citation location.
+ */
+export type ClaudeCitationSearchResultLocation = {
+    type: 'search_result_location';
+    cited_text: string;
+    title: string;
+    source: string;
+    start_block_index: number;
+    end_block_index: number;
+    search_result_index: number;
+};
+/**
+ * Union of all text citation types.
+ */
+export type ClaudeTextCitation = ClaudeCitationCharLocation | ClaudeCitationPageLocation | ClaudeCitationContentBlockLocation | ClaudeCitationWebSearchResultLocation | ClaudeCitationSearchResultLocation;
+/**
+ * Text content block.
+ */
+export type ClaudeTextBlock = {
+    type: 'text';
+    text: string;
+    citations?: ClaudeTextCitation[];
+};
+/**
+ * Extended thinking content block.
+ */
+export type ClaudeThinkingBlock = {
+    type: 'thinking';
+    thinking: string;
+    signature: string;
+};
+/**
+ * Redacted thinking content block.
+ */
+export type ClaudeRedactedThinkingBlock = {
+    type: 'redacted_thinking';
+    data: string;
+};
+/**
+ * Tool use content block.
+ */
+export type ClaudeToolUseBlock = {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+};
+/**
+ * Server-side tool use content block (e.g., web_search).
+ */
+export type ClaudeServerToolUseBlock = {
+    type: 'server_tool_use';
+    id: string;
+    name: 'web_search';
+    input: Record<string, unknown>;
+};
+/**
+ * Union of all content block types.
+ */
+export type ClaudeContentBlock = ClaudeTextBlock | ClaudeThinkingBlock | ClaudeRedactedThinkingBlock | ClaudeToolUseBlock | ClaudeServerToolUseBlock;
+/**
+ * Token usage information.
+ */
+export type ClaudeUsage = {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+};
+/**
+ * Claude Message response format compatible with the Anthropic SDK.
+ * This represents a complete assistant response from the Claude API.
+ */
+export type ClaudeMessage = {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    model: string;
+    content: ClaudeContentBlock[];
+    stop_reason: ClaudeStopReason | null;
+    stop_sequence?: string | null;
+    usage: ClaudeUsage;
+    /** Unmappable content preserved for lossless round-trips */
+    unsupported_content?: UnsupportedContent[];
+};
+/**
+ * Cache control for prompt caching.
+ */
+export type ClaudeCacheControl = {
+    type: 'ephemeral';
+};
+/**
+ * Text content block parameter for input.
+ */
+export type ClaudeTextBlockParam = {
+    type: 'text';
+    text: string;
+    cache_control?: ClaudeCacheControl | null;
+};
+/**
+ * Base64-encoded image source.
+ */
+export type ClaudeBase64ImageSource = {
+    type: 'base64';
+    media_type: 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp';
+    data: string;
+};
+/**
+ * URL-based image source.
+ */
+export type ClaudeURLImageSource = {
+    type: 'url';
+    url: string;
+};
+/**
+ * Image content block parameter for input.
+ */
+export type ClaudeImageBlockParam = {
+    type: 'image';
+    source: ClaudeBase64ImageSource | ClaudeURLImageSource;
+    cache_control?: ClaudeCacheControl | null;
+};
+/**
+ * Tool use content block parameter for input (when passing assistant's tool use back).
+ */
+export type ClaudeToolUseBlockParam = {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+    cache_control?: ClaudeCacheControl | null;
+};
+/**
+ * Tool result content block parameter for input.
+ */
+export type ClaudeToolResultBlockParam = {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | Array<ClaudeTextBlockParam | ClaudeImageBlockParam>;
+    is_error?: boolean;
+    cache_control?: ClaudeCacheControl | null;
+};
+/**
+ * Union of all input content block types.
+ */
+export type ClaudeContentBlockParam = ClaudeTextBlockParam | ClaudeImageBlockParam | ClaudeToolUseBlockParam | ClaudeToolResultBlockParam;
+/**
+ * Claude MessageParam input format compatible with the Anthropic SDK.
+ * This represents a message in a conversation for the Claude API.
+ */
+export type ClaudeMessageParam = {
+    role: 'user' | 'assistant';
+    content: string | Array<ClaudeContentBlockParam>;
+};
+/**
+ * Container for content that cannot be mapped to Claude's native format.
+ * Preserves information for round-trip conversions.
+ */
+export type UnsupportedContent = {
+    /** Original type from source format (e.g., "image_generation_call", "refusal") */
+    original_type: string;
+    /** Complete original data structure */
+    data: Record<string, unknown>;
+    /** Optional explanation of why this couldn't be mapped */
+    reason?: string;
+};
+//# sourceMappingURL=claude-message.d.ts.map

package/esm/api-shape-helpers/claude-message.d.ts.map

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

package/esm/api-shape-helpers/claude-message.js

@@ -0,0 +1,6 @@
+/*
+ * Types copied from @anthropic-ai/sdk for ClaudeMessage format.
+ * These types represent the Anthropic Claude API message response structure.
+ */
+export {};
+//# sourceMappingURL=claude-message.js.map

package/esm/api-shape-helpers/claude-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-message.js","sourceRoot":"","sources":["../../src/api-shape-helpers/claude-message.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/esm/index.d.ts

@@ -0,0 +1,22 @@
+export type { CallModelInput, CallModelInputWithState, ResolvedCallModelInput, } from './lib/async-params.js';
+export type { GetResponseOptions } from './lib/model-result.js';
+export type { StreamableOutputItem } from './lib/stream-transformers.js';
+export type { ContextInput } from './lib/tool-context.js';
+export type { ChatStreamEvent, ConversationState, ConversationStatus, HasApprovalTools, InferToolEvent, InferToolEventsUnion, InferToolInput, InferToolOutput, InferToolOutputsUnion, ManualTool, NextTurnParamsContext, NextTurnParamsFunctions, ParsedToolCall, PartialResponse, ResponseStreamEvent, ResponseStreamEvent as EnhancedResponseStreamEvent, StateAccessor, StepResult, StopCondition, StopWhen, Tool, ToolApprovalCheck, ToolCallOutputEvent, ToolExecutionResult, ToolExecutionResultUnion, ToolHasApproval, ToolPreliminaryResultEvent, ToolResultEvent, ToolStreamEvent, ToolWithExecute, ToolWithGenerator, TurnContext, TurnEndEvent, TurnStartEvent, TypedToolCall, TypedToolCallUnion, UnsentToolResult, Warning, } from './lib/tool-types.js';
+export { callModel } from './inner-loop/call-model.js';
+export { fromClaudeMessages, toClaudeMessage } from './lib/anthropic-compat.js';
+export { hasAsyncFunctions, resolveAsyncFunctions } from './lib/async-params.js';
+export { fromChatMessages, toChatMessage } from './lib/chat-compat.js';
+export { ClaudeContentBlockType, NonClaudeMessageRole } from './lib/claude-constants.js';
+export { isClaudeStyleMessages } from './lib/claude-type-guards.js';
+export { appendToMessages, createInitialState, createRejectedResult, createUnsentResult, generateConversationId, partitionToolCalls, toolRequiresApproval, updateState, } from './lib/conversation-state.js';
+export { ModelResult } from './lib/model-result.js';
+export { applyNextTurnParamsToRequest, buildNextTurnParamsContext, executeNextTurnParamsFunctions, } from './lib/next-turn-params.js';
+export { finishReasonIs, hasToolCall, isStopConditionMet, maxCost, maxTokensUsed, stepCountIs, } from './lib/stop-conditions.js';
+export { extractUnsupportedContent, getUnsupportedContentSummary, hasUnsupportedContent, } from './lib/stream-transformers.js';
+export { tool } from './lib/tool.js';
+export { buildToolExecuteContext, ToolContextStore } from './lib/tool-context.js';
+export { ToolEventBroadcaster } from './lib/tool-event-broadcaster.js';
+export { hasApprovalRequiredTools, hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolCallOutputEvent, isToolPreliminaryResultEvent, isToolResultEvent, isTurnEndEvent, isTurnStartEvent, ToolType, toolHasApprovalConfigured, } from './lib/tool-types.js';
+export { buildTurnContext, normalizeInputToArray } from './lib/turn-context.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,IAAI,2BAA2B,EAClD,aAAa,EACb,UAAU,EACV,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,GACR,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,GACZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/esm/index.js

@@ -0,0 +1,27 @@
+// Message format compatibility helpers
+// High-level model calling
+export { callModel } from './inner-loop/call-model.js';
+export { fromClaudeMessages, toClaudeMessage } from './lib/anthropic-compat.js';
+export { hasAsyncFunctions, resolveAsyncFunctions } from './lib/async-params.js';
+export { fromChatMessages, toChatMessage } from './lib/chat-compat.js';
+// Claude constants and type guards
+export { ClaudeContentBlockType, NonClaudeMessageRole } from './lib/claude-constants.js';
+export { isClaudeStyleMessages } from './lib/claude-type-guards.js';
+// Conversation state helpers
+export { appendToMessages, createInitialState, createRejectedResult, createUnsentResult, generateConversationId, partitionToolCalls, toolRequiresApproval, updateState, } from './lib/conversation-state.js';
+export { ModelResult } from './lib/model-result.js';
+// Next turn params helpers
+export { applyNextTurnParamsToRequest, buildNextTurnParamsContext, executeNextTurnParamsFunctions, } from './lib/next-turn-params.js';
+// Stop condition helpers
+export { finishReasonIs, hasToolCall, isStopConditionMet, maxCost, maxTokensUsed, stepCountIs, } from './lib/stop-conditions.js';
+export { extractUnsupportedContent, getUnsupportedContentSummary, hasUnsupportedContent, } from './lib/stream-transformers.js';
+// Tool creation helpers
+export { tool } from './lib/tool.js';
+// Tool context helpers
+export { buildToolExecuteContext, ToolContextStore } from './lib/tool-context.js';
+// Real-time tool event broadcasting
+export { ToolEventBroadcaster } from './lib/tool-event-broadcaster.js';
+export { hasApprovalRequiredTools, hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolCallOutputEvent, isToolPreliminaryResultEvent, isToolResultEvent, isTurnEndEvent, isTurnStartEvent, ToolType, toolHasApprovalConfigured, } from './lib/tool-types.js';
+// Turn context helpers
+export { buildTurnContext, normalizeInputToArray } from './lib/turn-context.js';
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAmDvC,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,mCAAmC;AACnC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,6BAA6B;AAC7B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,GACZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,2BAA2B;AAC3B,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,yBAAyB;AACzB,OAAO,EACL,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,wBAAwB;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,uBAAuB;AACvB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAClF,oCAAoC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,uBAAuB;AACvB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}