@acentric/llm 0.0.0-stage → 0.1.0

package/dist/formats/anthropic.d.ts

@@ -0,0 +1,152 @@
+import type { Json } from '@acentric/types';
+/** A prompt-cache breakpoint on a block, tool or system text. */
+export type AnthropicCacheControl = {
+    readonly type: 'ephemeral';
+    /** `5m`, the default, or `1h`, which costs twice the input price to write. */
+    readonly ttl?: '5m' | '1h';
+};
+/** A block typed loosely: only the fields the readers use are named, and the rest pass through. */
+export type AnthropicBlock<T extends string, Fields = unknown> = {
+    readonly type: T;
+    readonly [key: string]: Json;
+} & Fields;
+export type AnthropicTextBlock = {
+    readonly type: 'text';
+    readonly text: string;
+    /** Where the text comes from, with documents or search results that allow citations. */
+    readonly citations?: readonly Json[] | null;
+};
+/**
+ * The model's reasoning. `thinking` is a summary, or empty when `display` is
+ * `omitted`, the default on Claude 5 models; the reasoning itself travels in
+ * the `signature`, which is checked every time it is sent back. Send it back
+ * unchanged.
+ */
+export type AnthropicThinkingBlock = {
+    readonly type: 'thinking';
+    readonly thinking: string;
+    readonly signature: string;
+};
+/** Reasoning the safety systems flagged, encrypted. Send it back unchanged. */
+export type AnthropicRedactedThinkingBlock = {
+    readonly type: 'redacted_thinking';
+    readonly data: string;
+};
+/** Who made a call: `direct`, or code execution for programmatic tool calling. */
+export type AnthropicCaller = {
+    readonly type: string;
+    readonly [key: string]: Json;
+};
+/** A call to one of the caller's tools, answered with a `tool_result`. */
+export type AnthropicToolUseBlock = {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    /** The arguments, parsed. */
+    readonly input: Json;
+    readonly caller?: AnthropicCaller;
+    /** Set on a member of an Anthropic toolset; its result must name the toolset. */
+    readonly toolset_name?: string;
+};
+/** A call to a server tool: web search, web fetch, code execution, tool search. */
+export type AnthropicServerToolUseBlock = AnthropicBlock<'server_tool_use', {
+    readonly id: string;
+    readonly name: string;
+    readonly input: Json;
+}>;
+/** A server tool's result, in the same message. Some hold encrypted content: send them back unchanged. */
+export type AnthropicServerToolResultBlock = AnthropicBlock<'web_search_tool_result' | 'web_fetch_tool_result' | 'code_execution_tool_result' | 'bash_code_execution_tool_result' | 'text_editor_code_execution_tool_result' | 'tool_search_tool_result', {
+    readonly tool_use_id: string;
+}>;
+/** A call to a remote MCP server, and its result. */
+export type AnthropicMcpToolUseBlock = AnthropicBlock<'mcp_tool_use', {
+    readonly id: string;
+}>;
+export type AnthropicMcpToolResultBlock = AnthropicBlock<'mcp_tool_result', {
+    readonly tool_use_id: string;
+}>;
+/** Earlier context, summarized. Send it back unchanged. */
+export type AnthropicCompactionBlock = AnthropicBlock<'compaction'>;
+/** A file uploaded to the code execution container. */
+export type AnthropicContainerUploadBlock = AnthropicBlock<'container_upload', {
+    readonly file_id: string;
+}>;
+export type AnthropicOutputBlock = AnthropicTextBlock | AnthropicThinkingBlock | AnthropicRedactedThinkingBlock | AnthropicToolUseBlock | AnthropicServerToolUseBlock | AnthropicServerToolResultBlock | AnthropicMcpToolUseBlock | AnthropicMcpToolResultBlock | AnthropicCompactionBlock | AnthropicContainerUploadBlock;
+export type AnthropicMediaSource = {
+    readonly type: 'base64';
+    readonly media_type: string;
+    readonly data: string;
+} | {
+    readonly type: 'url';
+    readonly url: string;
+} | {
+    readonly type: 'file';
+    readonly file_id: string;
+} | {
+    readonly type: 'text';
+    readonly media_type: 'text/plain';
+    readonly data: string;
+} | {
+    readonly type: 'content';
+    readonly content: Json;
+};
+export type AnthropicImageBlock = AnthropicBlock<'image', {
+    readonly source: AnthropicMediaSource;
+}>;
+export type AnthropicDocumentBlock = AnthropicBlock<'document', {
+    readonly source: AnthropicMediaSource;
+}>;
+/** A search result the model may cite. */
+export type AnthropicSearchResultBlock = AnthropicBlock<'search_result', {
+    readonly source: string;
+    readonly title: string;
+    readonly content: readonly Json[];
+}>;
+export type AnthropicToolResultBlock = AnthropicBlock<'tool_result', {
+    readonly tool_use_id: string;
+    readonly is_error?: boolean;
+}>;
+/** A block a `native` message may carry. */
+export type AnthropicInputBlock = AnthropicBlock<'text', {
+    readonly text: string;
+}> | AnthropicImageBlock | AnthropicDocumentBlock | AnthropicSearchResultBlock | AnthropicToolResultBlock | AnthropicContainerUploadBlock;
+/** Why generation stopped. */
+export type AnthropicStopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | 'pause_turn' | 'refusal' | 'model_context_window_exceeded' | 'compaction' | (string & {});
+/** Token usage as the format reports it. */
+export type AnthropicUsage = {
+    /** Uncached input only. */
+    readonly input_tokens: number;
+    readonly cache_creation_input_tokens?: number | null;
+    readonly cache_read_input_tokens?: number | null;
+    /** Cache writes by time to live. */
+    readonly cache_creation?: {
+        readonly ephemeral_5m_input_tokens?: number;
+        readonly ephemeral_1h_input_tokens?: number;
+    } | null;
+    /** Output tokens, thinking included. */
+    readonly output_tokens: number;
+    readonly output_tokens_details?: {
+        readonly thinking_tokens?: number;
+    } | null;
+    readonly server_tool_use?: {
+        readonly [tool: string]: number;
+    } | null;
+    /** The tier that served the request: `standard`, `priority` or `batch`. */
+    readonly service_tier?: string | null;
+    /** Where inference ran: `global`, or `us` at 1.1 times the price. */
+    readonly inference_geo?: string | null;
+    /** `standard` or `fast`. */
+    readonly speed?: string | null;
+    /** The whole bill per sampling iteration, each with its own model. */
+    readonly iterations?: readonly AnthropicUsageIteration[] | null;
+};
+export type AnthropicUsageIteration = {
+    readonly type: 'message' | 'compaction' | 'advisor_message' | 'fallback_message' | (string & {});
+    readonly model?: string | null;
+    readonly input_tokens?: number;
+    readonly output_tokens?: number;
+    readonly cache_creation_input_tokens?: number | null;
+    readonly cache_read_input_tokens?: number | null;
+    readonly cache_creation?: AnthropicUsage['cache_creation'];
+};
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/formats/anthropic.d.ts.map

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

package/dist/formats/anthropic.js

@@ -0,0 +1,7 @@
+// The Anthropic Messages format (`POST /v1/messages`): the content blocks the
+// client writes and reads.
+//
+// Blocks are typed for what the client and the readers interpret. Anthropic
+// adds block types and fields often, and those pass through as they are.
+export {};
+//# sourceMappingURL=anthropic.js.map

package/dist/formats/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/formats/anthropic.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2BAA2B;AAC3B,EAAE;AACF,4EAA4E;AAC5E,yEAAyE"}

package/dist/formats/responses.d.ts

@@ -0,0 +1,179 @@
+import type { Json } from '@acentric/types';
+/** An explicit prompt-cache breakpoint on a content part. */
+export type ResponsesCacheBreakpoint = {
+    readonly mode: 'explicit';
+};
+export type ResponsesInputText = {
+    readonly type: 'input_text';
+    readonly text: string;
+    readonly prompt_cache_breakpoint?: ResponsesCacheBreakpoint;
+};
+export type ResponsesInputImage = {
+    readonly type: 'input_image';
+    /** A URL or a `data:` URL. */
+    readonly image_url?: string;
+    readonly file_id?: string;
+    readonly detail?: 'auto' | 'low' | 'high' | 'original';
+    readonly prompt_cache_breakpoint?: ResponsesCacheBreakpoint;
+};
+export type ResponsesInputFile = {
+    readonly type: 'input_file';
+    readonly file_id?: string;
+    readonly file_url?: string;
+    /** The file's bytes, as a `data:` URL. */
+    readonly file_data?: string;
+    readonly filename?: string;
+    readonly detail?: 'auto' | 'low' | 'high';
+    readonly prompt_cache_breakpoint?: ResponsesCacheBreakpoint;
+};
+export type ResponsesInputContent = ResponsesInputText | ResponsesInputImage | ResponsesInputFile;
+/** A user, system or developer message in the input. */
+export type ResponsesInputMessage = {
+    readonly type: 'message';
+    readonly role: 'user' | 'system' | 'developer';
+    readonly content: readonly ResponsesInputContent[];
+};
+export type ResponsesAnnotation = {
+    readonly type: 'url_citation';
+    readonly url: string;
+    readonly title: string;
+    readonly start_index: number;
+    readonly end_index: number;
+} | {
+    readonly type: 'file_citation';
+    readonly file_id: string;
+    readonly filename: string;
+    readonly index: number;
+} | {
+    readonly type: 'container_file_citation';
+    readonly container_id: string;
+    readonly file_id: string;
+    readonly filename: string;
+    readonly start_index: number;
+    readonly end_index: number;
+} | {
+    readonly type: 'file_path';
+    readonly file_id: string;
+    readonly index: number;
+};
+export type ResponsesOutputText = {
+    readonly type: 'output_text';
+    readonly text: string;
+    readonly annotations: readonly ResponsesAnnotation[];
+    readonly logprobs?: readonly Json[];
+};
+export type ResponsesRefusal = {
+    readonly type: 'refusal';
+    readonly refusal: string;
+};
+/** An assistant message in the output. */
+export type ResponsesOutputMessage = {
+    readonly type: 'message';
+    readonly id: string;
+    readonly role: 'assistant';
+    readonly status: 'in_progress' | 'completed' | 'incomplete';
+    /** `commentary` is a progress update, not the answer. Keep it when sending back. */
+    readonly phase?: 'commentary' | 'final_answer' | null;
+    readonly content: readonly (ResponsesOutputText | ResponsesRefusal)[];
+};
+export type ResponsesReasoning = {
+    readonly type: 'reasoning';
+    readonly id: string;
+    readonly summary: readonly {
+        readonly type: 'summary_text';
+        readonly text: string;
+    }[];
+    readonly content?: readonly {
+        readonly type: 'reasoning_text';
+        readonly text: string;
+    }[];
+    /** Opaque: send it back unchanged. */
+    readonly encrypted_content?: string | null;
+    readonly status?: 'in_progress' | 'completed' | 'incomplete';
+};
+/** Who made a call, such as `{ type: "program", caller_id }` for programmatic tool calling. */
+export type ResponsesCaller = {
+    readonly type: string;
+    readonly [key: string]: Json;
+};
+export type ResponsesFunctionCall = {
+    readonly type: 'function_call';
+    readonly id?: string;
+    /** The ID a result answers; `id` is only the item's. */
+    readonly call_id: string;
+    readonly name: string;
+    /** A JSON string, as the model wrote it. */
+    readonly arguments: string;
+    readonly namespace?: string;
+    readonly caller?: ResponsesCaller;
+    readonly async?: boolean;
+    readonly status?: 'in_progress' | 'completed' | 'incomplete';
+};
+export type ResponsesCustomToolCall = {
+    readonly type: 'custom_tool_call';
+    readonly id?: string;
+    readonly call_id: string;
+    readonly name: string;
+    readonly input: string;
+    readonly namespace?: string;
+    readonly caller?: ResponsesCaller;
+    readonly async?: boolean;
+};
+export type ResponsesFunctionCallOutput = {
+    readonly type: 'function_call_output';
+    readonly call_id: string;
+    readonly output: string | readonly ResponsesInputContent[];
+    readonly id?: string;
+    readonly name?: string;
+    readonly namespace?: string;
+    readonly caller?: ResponsesCaller;
+    readonly status?: 'in_progress' | 'completed' | 'incomplete';
+};
+export type ResponsesCustomToolCallOutput = {
+    readonly type: 'custom_tool_call_output';
+    readonly call_id: string;
+    readonly output: string | readonly ResponsesInputContent[];
+    readonly id?: string;
+    readonly caller?: ResponsesCaller;
+};
+/** Earlier context, compacted. Opaque: send it back unchanged. */
+export type ResponsesCompaction = {
+    readonly type: 'compaction';
+    readonly id?: string;
+    readonly encrypted_content: string;
+};
+/** An item the provider stored, by ID. */
+export type ResponsesItemReference = {
+    readonly type: 'item_reference';
+    readonly id: string;
+};
+/** Output items every Responses provider shares. */
+export type ResponsesOutputItem = ResponsesOutputMessage | ResponsesReasoning | ResponsesFunctionCall | ResponsesCustomToolCall | ResponsesCompaction;
+/** Input items every Responses provider shares, besides output items sent back. */
+export type ResponsesInputItem = ResponsesInputMessage | ResponsesFunctionCallOutput | ResponsesCustomToolCallOutput | ResponsesItemReference | ResponsesOutputItem;
+/**
+ * An item a provider adds to the format, typed loosely: only the fields the
+ * readers use are named, and the rest pass through.
+ */
+export type ResponsesItem<T extends string, Fields = unknown> = {
+    readonly type: T;
+    readonly id?: string;
+    readonly [key: string]: Json;
+} & Fields;
+/** Token usage as the format reports it. */
+export type ResponsesUsage = {
+    /** Every input token, cached or not. */
+    readonly input_tokens: number;
+    readonly input_tokens_details?: {
+        readonly cached_tokens?: number;
+        readonly cache_write_tokens?: number;
+    } | null;
+    /** Output tokens, reasoning included. */
+    readonly output_tokens: number;
+    readonly output_tokens_details?: {
+        readonly reasoning_tokens?: number;
+    } | null;
+    readonly total_tokens?: number;
+};
+export type ResponsesStatus = 'completed' | 'incomplete' | 'failed' | 'cancelled' | 'queued' | 'in_progress';
+//# sourceMappingURL=responses.d.ts.map

package/dist/formats/responses.d.ts.map

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

package/dist/formats/responses.js

@@ -0,0 +1,9 @@
+// The Responses format: OpenAI's Responses API and the Open Responses
+// specification other providers implement, here Fireworks. These are the
+// shapes every Responses provider shares; each provider adds its own items in
+// providers/.
+//
+// Items are typed for what the client and the readers interpret. Providers add
+// fields and item types often, and those pass through as they are.
+export {};
+//# sourceMappingURL=responses.js.map

package/dist/formats/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/formats/responses.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,yEAAyE;AACzE,8EAA8E;AAC9E,cAAc;AACd,EAAE;AACF,+EAA+E;AAC/E,mEAAmE"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export type * from './content.js';
+export type * from './fields.js';
+export type * from './messages.js';
+export type * from './providers.js';
+export type * from './request.js';
+export type * from './response.js';
+export type * from './tool-calls.js';
+export type * from './tools.js';
+export type * from './usage.js';
+export type * from './formats/anthropic.js';
+export type * from './formats/responses.js';
+export type * from './providers/anthropic.js';
+export type * from './providers/fireworks.js';
+export type * from './providers/openai.js';
+export { convert } from './convert/index.js';
+export type { Conversion, ConversionChange, ConvertOptions, ConvertTarget, } from './convert/index.js';
+export { estimateCost } from './cost.js';
+export type { CostOptions } from './cost.js';
+export { isLlmFailure, LLM_FAILURE_KINDS, LlmError, llmFailure } from './failure.js';
+export type { LlmErrorOptions, LlmFailure, LlmFailureKind } from './failure.js';
+export { outputText, pendingToolCalls, reasoningSummary, refusals, requestMessages, toolCalls, toolResult, } from './read.js';
+export type { TextOptions, ToolResultOptions } from './read.js';
+export type * from './model.js';
+export { findModel, MODELS } from './models.js';
+export { GATEWAY_SECRETS, llmSecrets, PROVIDER_SECRETS } from './secrets.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,uBAAuB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,SAAS,EACT,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAChE,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// The pure half of @acentric/llm: what an agent's step, effects and view may
+// import. Nothing here uses fetch, timers, the clock or randomness, so it
+// bundles into agent.js. The calls themselves are in @acentric/llm/client,
+// for handlers.
+export { convert } from './convert/index.js';
+export { estimateCost } from './cost.js';
+export { isLlmFailure, LLM_FAILURE_KINDS, LlmError, llmFailure } from './failure.js';
+export { outputText, pendingToolCalls, reasoningSummary, refusals, requestMessages, toolCalls, toolResult, } from './read.js';
+export { findModel, MODELS } from './models.js';
+export { GATEWAY_SECRETS, llmSecrets, PROVIDER_SECRETS } from './secrets.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,gBAAgB;AAiBhB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,SAAS,EACT,UAAU,GACX,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,6 @@
+import type { Json, JsonObject } from '@acentric/types';
+/** Whether a value is a Json object. `Array.isArray` alone does not narrow a readonly array out. */
+export declare function isObject(value: Json | undefined): value is JsonObject;
+/** Whether a value is a Json array. */
+export declare function isArray(value: Json | undefined): value is readonly Json[];
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAExD,oGAAoG;AACpG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,UAAU,CAErE;AAED,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,IAAI,EAAE,CAEzE"}

package/dist/json.js

@@ -0,0 +1,10 @@
+// Reading Json whose shape is not known in advance, such as a provider's items.
+/** Whether a value is a Json object. `Array.isArray` alone does not narrow a readonly array out. */
+export function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Whether a value is a Json array. */
+export function isArray(value) {
+    return Array.isArray(value);
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAIhF,oGAAoG;AACpG,MAAM,UAAU,QAAQ,CAAC,KAAuB;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,OAAO,CAAC,KAAuB;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,82 @@
+import type { Json } from '@acentric/types';
+import type { ContentPart, TextPart } from './content.js';
+import type { Metadata, ProviderFields } from './fields.js';
+import type { ApiOf, NativeInputItem, NativeOutputItem, Provider } from './providers.js';
+import type { ToolType } from './tools.js';
+type MessageBase = {
+    /** For an assistant message, the provider's response ID. Otherwise the application's. */
+    readonly id?: string;
+    /** Milliseconds since the Unix epoch. */
+    readonly timestamp?: number;
+    /** The application's own attributes. Never sent to a provider. */
+    readonly metadata?: Metadata;
+};
+export type UserMessage = MessageBase & {
+    readonly role: 'user';
+    readonly content: readonly ContentPart[];
+};
+/**
+ * An instruction in the middle of the conversation. The request's
+ * `instructions` are the top-level ones. A provider with no such messages
+ * refuses a request that has one.
+ */
+export type SystemMessage = MessageBase & {
+    readonly role: 'system';
+    readonly content: readonly TextPart[];
+};
+/**
+ * The provider's output, as it is, for sending back: reasoning, signatures and
+ * compaction items included. Read it with `outputText`, `toolCalls` and the
+ * other readers. Sending it back is safe to the same provider, format and model.
+ */
+export type AssistantMessage<P extends Provider = Provider> = P extends Provider ? MessageBase & {
+    readonly role: 'assistant';
+    readonly provider: P;
+    readonly api: ApiOf<P>;
+    /** The model ID the request asked for. */
+    readonly model: string;
+    readonly content: readonly NativeOutputItem<P>[];
+} : never;
+/** The result of a tool call the caller ran. */
+export type ToolResultMessage = MessageBase & {
+    readonly role: 'tool_result';
+    readonly toolCallId: string;
+    readonly toolName: string;
+    /** The type of the tool that was called. Defaults to `function`. */
+    readonly toolType?: ToolType;
+    readonly content: readonly ContentPart[];
+    /**
+     * The tool failed. Sent only where the provider has a field for it, so
+     * `content` must say what failed either way.
+     */
+    readonly isError?: boolean;
+    /**
+     * Merged into the provider's result item, for fields it requires on results,
+     * such as OpenAI's `caller`. `toolResult(call, content)` copies them from the call.
+     */
+    readonly providerOptions?: ProviderFields;
+};
+/**
+ * Input only provider `P` takes, sent as it is: a compaction trigger, the
+ * output of a computer-use call, an approval.
+ */
+export type NativeMessage<P extends Provider = Provider> = P extends Provider ? MessageBase & {
+    readonly role: 'native';
+    readonly provider: P;
+    readonly api: ApiOf<P>;
+    readonly content: readonly NativeInputItem<P>[];
+} : never;
+/** The application's own entry in a conversation. Never sent to a provider. */
+export type CustomMessage = MessageBase & {
+    readonly role: 'custom';
+    /** Says how the application reads `data`. */
+    readonly tag: string;
+    readonly data: Json;
+};
+/** A message a request to provider `P` sends. */
+export type RequestMessage<P extends Provider = Provider> = UserMessage | SystemMessage | ToolResultMessage | AssistantMessage<P> | NativeMessage<P>;
+/** Any message in a conversation, the application's own included. */
+export type Message<P extends Provider = Provider> = RequestMessage<P> | CustomMessage;
+export type Role = Message['role'];
+export {};
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

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

package/dist/messages.js

@@ -0,0 +1,4 @@
+// A conversation's messages. Assistant messages are the provider's own output,
+// kept as it is and sent back unchanged; everything else is shared.
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,oEAAoE"}

package/dist/model.d.ts

@@ -0,0 +1,36 @@
+import type { KnownModelId, Provider } from './providers.js';
+export type Modality = 'text' | 'image' | 'file';
+/** US dollars per million tokens. */
+export type ModelCost = {
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead?: number;
+    /** Writing to the cache, for the provider's default time to live. */
+    readonly cacheWrite?: number;
+    /** Writing to the cache for an hour, where a provider prices it apart (Anthropic). */
+    readonly cacheWrite1h?: number;
+};
+export type ModelPricing = {
+    readonly base: ModelCost;
+    /**
+     * Prices for the whole request once its prompt is over a number of tokens,
+     * in ascending order.
+     */
+    readonly tiers?: readonly {
+        readonly aboveInputTokens: number;
+        readonly cost: ModelCost;
+    }[];
+};
+/** One model. */
+export type ModelInfo<P extends Provider = Provider> = P extends Provider ? {
+    readonly provider: P;
+    readonly id: KnownModelId<P>;
+    readonly name: string;
+    /** The most tokens it reads, prompt and output together. */
+    readonly contextWindow?: number;
+    /** The most tokens it writes in one reply. */
+    readonly maxOutputTokens?: number;
+    readonly input?: readonly Modality[];
+    readonly pricing?: ModelPricing;
+} : never;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjD,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CAC7F,CAAC;AAEF,iBAAiB;AACjB,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,SAAS,QAAQ,GACrE;IACE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC,GACD,KAAK,CAAC"}

package/dist/model.js

@@ -0,0 +1,4 @@
+// What is known about a model: its limits, what it takes as input and its
+// prices, in US dollars per million tokens.
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,4CAA4C"}

package/dist/models.d.ts

@@ -0,0 +1,9 @@
+import type { ModelInfo } from './model.js';
+import type { Provider } from './providers.js';
+/** Every model, by provider. */
+export declare const MODELS: {
+    readonly [P in Provider]: readonly ModelInfo<P>[];
+};
+/** The model, or undefined for one not listed, which still works. */
+export declare function findModel<P extends Provider>(provider: P, id: string): ModelInfo<P> | undefined;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,gCAAgC;AAChC,eAAO,MAAM,MAAM,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,QAAQ,GAAG,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE;CAIvE,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAI/F"}

package/dist/models.js

@@ -0,0 +1,19 @@
+// What is known about each model: its limits, what it takes as input and its
+// prices. A model need not be here to be used; one that is gets cost
+// estimates, and a step can read its context window.
+import { ANTHROPIC_MODELS } from './catalog/anthropic.js';
+import { FIREWORKS_MODELS } from './catalog/fireworks.js';
+import { OPENAI_MODELS } from './catalog/openai.js';
+/** Every model, by provider. */
+export const MODELS = {
+    anthropic: ANTHROPIC_MODELS,
+    openai: OPENAI_MODELS,
+    fireworks: FIREWORKS_MODELS,
+};
+/** The model, or undefined for one not listed, which still works. */
+export function findModel(provider, id) {
+    const models = MODELS[provider];
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion
+    return models.find((model) => model.id === id);
+}
+//# sourceMappingURL=models.js.map