@yolk-sdk/agent 0.1.0-canary.21 → 0.1.0-canary.23

package/dist/providers/openai/provider.mjs

@@ -1,5 +1,6 @@
 import { classifyProviderFailure, providerErrorInfo, providerFailureCause, providerFailureRetryable } from "../provider-error.mjs";
-import { AgentInputUsage, AgentOutputUsage, AgentUsage, ToolCall, assistantContent, assistantHostToolCalls, attachmentSourceDataUrl, attachmentSourceText, isTextDocumentMimeType, messageContextText, prependMessageContextToContent } from "@yolk-sdk/agent/protocol";
+import { validateProviderTranscript } from "../transcript.mjs";
+import { AgentInputUsage, AgentOutputUsage, AgentUsage, ToolCall, assistantContent, assistantHostToolCalls, attachmentSourceText, attachmentSourceUrl, isTextDocumentMimeType, messageContextText, prependMessageContextToContent } from "@yolk-sdk/agent/protocol";
 import { Config, Context, Effect, Layer, Option, Redacted, Stream } from "effect";
 import { FetchHttpClient, HttpClient, HttpClientRequest } from "effect/unstable/http";
 import * as Schema from "effect/Schema";
@@ -71,7 +72,7 @@ const contentPartToUserPart = (part) => {
 			type: "text",
 			text: part.text
 		});
-		case "Image": return Option.match(attachmentSourceDataUrl(part.source, part.mimeType), {
+		case "Image": return Option.match(attachmentSourceUrl(part.source, part.mimeType), {
 			onNone: () => Effect.fail(unsupportedContentError("Unresolved image source")),
 			onSome: (url) => Effect.succeed({
 				type: "image_url",
@@ -138,6 +139,7 @@ const toOpenAiTool = (tool) => ({
 	}
 });
 const toOpenAiRequestBody = (request, config) => Effect.gen(function* () {
+	yield* validateProviderTranscript(request.messages);
 	const messages = [{
 		role: "system",
 		content: request.systemPrompt

package/dist/providers/openai/provider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"provider.mjs","names":["LLMTextDelta"],"sources":["../../../src/providers/openai/provider.ts"],"sourcesContent":["import { Config, Context, Effect, Layer, Option, Redacted, Stream } from 'effect'\nimport {\n  FetchHttpClient,\n  HttpClient,\n  HttpClientRequest,\n  type HttpClientError,\n  type HttpClientResponse\n} from 'effect/unstable/http'\nimport * as Schema from 'effect/Schema'\nimport {\n  ToolCall,\n  AgentInputUsage,\n  AgentOutputUsage,\n  AgentUsage,\n  attachmentSourceDataUrl,\n  attachmentSourceText,\n  assistantContent,\n  assistantHostToolCalls,\n  isTextDocumentMimeType,\n  messageContextText,\n  prependMessageContextToContent,\n  type AgentMessage,\n  type Content,\n  type ContentPart,\n  type ToolDef\n} from '@yolk-sdk/agent/protocol'\nimport {\n  LLMError,\n  LLMDone,\n  LLMProvider,\n  LLMTextDelta,\n  LLMToolCall,\n  LLMUsage,\n  type LLMEvent,\n  type LLMRequest\n} from '@yolk-sdk/agent/loop'\nimport {\n  classifyProviderFailure,\n  providerErrorInfo,\n  providerFailureCause,\n  providerFailureRetryable\n} from '../provider-error.ts'\n\nexport type OpenAiProviderConfig = {\n  readonly chatCompletionsUrl?: string\n  readonly maxCompletionTokens?: number\n  readonly extraHeaders?: Readonly<Record<string, string>>\n  readonly apiKey: Redacted.Redacted<string>\n}\n\ntype OpenAiTextContentPart = {\n  readonly type: 'text'\n  readonly text: string\n}\n\ntype OpenAiImageContentPart = {\n  readonly type: 'image_url'\n  readonly image_url: {\n    readonly url: string\n  }\n}\n\ntype OpenAiUserContent = string | ReadonlyArray<OpenAiTextContentPart | OpenAiImageContentPart>\n\ntype OpenAiToolCall = {\n  readonly id: string\n  readonly type: 'function'\n  readonly function: {\n    readonly name: string\n    readonly arguments: string\n  }\n}\n\ntype OpenAiMessage =\n  | { readonly role: 'system'; readonly content: string }\n  | { readonly role: 'user'; readonly content: OpenAiUserContent }\n  | {\n      readonly role: 'assistant'\n      readonly content: string | null\n      readonly tool_calls?: ReadonlyArray<OpenAiToolCall>\n    }\n  | { readonly role: 'tool'; readonly tool_call_id: string; readonly content: string }\n\ntype OpenAiTool = {\n  readonly type: 'function'\n  readonly function: {\n    readonly name: string\n    readonly description: string\n    readonly parameters: unknown\n  }\n}\n\ntype OpenAiRequestBody = {\n  readonly model: string\n  readonly messages: ReadonlyArray<OpenAiMessage>\n  readonly max_completion_tokens: number\n  readonly tools?: ReadonlyArray<OpenAiTool>\n  readonly parallel_tool_calls?: true\n}\n\nclass OpenAiFunctionResponse extends Schema.Class<OpenAiFunctionResponse>('OpenAiFunctionResponse')(\n  {\n    name: Schema.String,\n    arguments: Schema.String\n  }\n) {}\n\nclass OpenAiToolCallResponse extends Schema.Class<OpenAiToolCallResponse>('OpenAiToolCallResponse')(\n  {\n    id: Schema.String,\n    type: Schema.Literals(['function']),\n    function: OpenAiFunctionResponse\n  }\n) {}\n\nclass OpenAiMessageResponse extends Schema.Class<OpenAiMessageResponse>('OpenAiMessageResponse')({\n  content: Schema.NullOr(Schema.String),\n  tool_calls: Schema.optional(Schema.Array(OpenAiToolCallResponse))\n}) {}\n\nclass OpenAiChoiceResponse extends Schema.Class<OpenAiChoiceResponse>('OpenAiChoiceResponse')({\n  message: OpenAiMessageResponse\n}) {}\n\nclass OpenAiPromptTokensDetails extends Schema.Class<OpenAiPromptTokensDetails>(\n  'OpenAiPromptTokensDetails'\n)({\n  cached_tokens: Schema.optional(Schema.Number)\n}) {}\n\nclass OpenAiCompletionTokensDetails extends Schema.Class<OpenAiCompletionTokensDetails>(\n  'OpenAiCompletionTokensDetails'\n)({\n  reasoning_tokens: Schema.optional(Schema.Number)\n}) {}\n\nclass OpenAiUsageResponse extends Schema.Class<OpenAiUsageResponse>('OpenAiUsageResponse')({\n  prompt_tokens: Schema.Number,\n  completion_tokens: Schema.Number,\n  prompt_tokens_details: Schema.optional(OpenAiPromptTokensDetails),\n  completion_tokens_details: Schema.optional(OpenAiCompletionTokensDetails)\n}) {}\n\nclass OpenAiChatCompletionResponse extends Schema.Class<OpenAiChatCompletionResponse>(\n  'OpenAiChatCompletionResponse'\n)({\n  choices: Schema.Array(OpenAiChoiceResponse),\n  usage: Schema.optional(OpenAiUsageResponse)\n}) {}\n\nclass OpenAiConfig extends Context.Service<OpenAiConfig, OpenAiProviderConfig>()(\n  '@app/OpenAiConfig'\n) {}\n\nconst OpenAiConfigLayer = Layer.effect(\n  OpenAiConfig,\n  Effect.gen(function* () {\n    const apiKey = yield* Config.redacted('OPENAI_API_KEY')\n    return { apiKey }\n  }).pipe(\n    Effect.mapError(\n      () =>\n        new LLMError({\n          cause: 'provider_error',\n          message: 'OPENAI_API_KEY not found',\n          retryable: false\n        })\n    )\n  )\n)\n\nconst unknownToMessage = (error: unknown) =>\n  error instanceof Error ? error.message : String(error)\n\nconst encodeJsonString = (value: unknown, message: string) =>\n  Schema.encodeUnknownEffect(Schema.UnknownFromJsonString)(value).pipe(\n    Effect.mapError(\n      error =>\n        new LLMError({\n          cause: 'provider_error',\n          message: `${message}: ${unknownToMessage(error)}`,\n          retryable: false\n        })\n    )\n  )\n\nconst decodeJsonString = (raw: string, message: string) =>\n  Schema.decodeUnknownEffect(Schema.UnknownFromJsonString)(raw).pipe(\n    Effect.mapError(\n      error =>\n        new LLMError({\n          cause: 'invalid_response',\n          message: `${message}: ${unknownToMessage(error)}`,\n          retryable: false\n        })\n    )\n  )\n\nconst unsupportedContentError = (contentType: string) =>\n  new LLMError({\n    cause: 'provider_error',\n    message: `${contentType} content is not supported by the OpenAI provider yet`,\n    retryable: false\n  })\n\nconst textDocumentToOpenAiPart = (part: Extract<ContentPart, { readonly _tag: 'Document' }>) =>\n  attachmentSourceText(part.source).pipe(\n    Effect.mapError(() => unsupportedContentError('Invalid document text')),\n    Effect.flatMap(\n      Option.match({\n        onNone: () => Effect.fail(unsupportedContentError('Unresolved document source')),\n        onSome: text => {\n          const block: OpenAiTextContentPart = {\n            type: 'text',\n            text: `Document: ${part.title ?? part.filename}\\n\\n${text}`\n          }\n\n          return Effect.succeed(block)\n        }\n      })\n    )\n  )\n\nconst contentPartToUserPart = (\n  part: ContentPart\n): Effect.Effect<OpenAiTextContentPart | OpenAiImageContentPart, LLMError> => {\n  switch (part._tag) {\n    case 'Text':\n      return Effect.succeed({ type: 'text', text: part.text })\n    case 'Image':\n      return Option.match(attachmentSourceDataUrl(part.source, part.mimeType), {\n        onNone: () => Effect.fail(unsupportedContentError('Unresolved image source')),\n        onSome: url => Effect.succeed({ type: 'image_url', image_url: { url } })\n      })\n    case 'Document':\n      return isTextDocumentMimeType(part.mimeType)\n        ? textDocumentToOpenAiPart(part)\n        : Effect.fail(unsupportedContentError('Document'))\n    case 'Audio':\n      return Effect.fail(unsupportedContentError('Audio'))\n  }\n}\n\nconst contentToUserContent = (content: Content): Effect.Effect<OpenAiUserContent, LLMError> =>\n  typeof content === 'string'\n    ? Effect.succeed(content)\n    : Effect.forEach(content, contentPartToUserPart)\n\nconst contentPartToText = (part: ContentPart, owner: string): Effect.Effect<string, LLMError> => {\n  switch (part._tag) {\n    case 'Text':\n      return Effect.succeed(part.text)\n    case 'Image':\n      return Effect.fail(unsupportedContentError(`${owner} image`))\n    case 'Document':\n      return Effect.fail(unsupportedContentError(`${owner} document`))\n    case 'Audio':\n      return Effect.fail(unsupportedContentError(`${owner} audio`))\n  }\n}\n\nconst contentToText = (content: Content, owner: string): Effect.Effect<string, LLMError> =>\n  typeof content === 'string'\n    ? Effect.succeed(content)\n    : Effect.forEach(content, part => contentPartToText(part, owner)).pipe(\n        Effect.map(textParts => textParts.join('\\n'))\n      )\n\nconst serializeToolArguments = (params: unknown) =>\n  encodeJsonString(params, 'Could not serialize OpenAI tool arguments')\n\nconst toolCallToOpenAiToolCall = (call: ToolCall): Effect.Effect<OpenAiToolCall, LLMError> =>\n  Effect.gen(function* () {\n    return {\n      id: call.id,\n      type: 'function',\n      function: {\n        name: call.name,\n        arguments: yield* serializeToolArguments(call.params)\n      }\n    }\n  })\n\nconst toOpenAiMessage = (message: AgentMessage): Effect.Effect<OpenAiMessage, LLMError> =>\n  Effect.gen(function* () {\n    switch (message._tag) {\n      case 'User':\n        return {\n          role: 'user',\n          content: yield* contentToUserContent(\n            prependMessageContextToContent(message.content, messageContextText(message))\n          )\n        }\n      case 'Assistant': {\n        const content = prependMessageContextToContent(\n          assistantContent(message),\n          messageContextText(message)\n        )\n        const toolCalls = yield* Effect.forEach(\n          assistantHostToolCalls(message),\n          toolCallToOpenAiToolCall\n        )\n\n        if (toolCalls.length > 0) {\n          return {\n            role: 'assistant',\n            content: yield* contentToText(content, 'Assistant'),\n            tool_calls: toolCalls\n          }\n        }\n\n        return {\n          role: 'assistant',\n          content: yield* contentToText(content, 'Assistant')\n        }\n      }\n      case 'ToolResult':\n        return {\n          role: 'tool',\n          tool_call_id: message.toolCallId,\n          content: yield* contentToText(\n            prependMessageContextToContent(message.content, messageContextText(message)),\n            'Tool result'\n          )\n        }\n    }\n  })\n\nconst toOpenAiTool = (tool: ToolDef): OpenAiTool => ({\n  type: 'function',\n  function: {\n    name: tool.name,\n    description: tool.description,\n    parameters: tool.parameters\n  }\n})\n\nexport const toOpenAiRequestBody = (\n  request: LLMRequest,\n  config?: { readonly maxCompletionTokens?: number }\n): Effect.Effect<OpenAiRequestBody, LLMError> =>\n  Effect.gen(function* () {\n    const systemMessage: OpenAiMessage = { role: 'system', content: request.systemPrompt }\n    const requestMessages = yield* Effect.forEach(request.messages, toOpenAiMessage)\n    const messages = [systemMessage, ...requestMessages]\n\n    const body = {\n      model: request.model,\n      messages,\n      max_completion_tokens: config?.maxCompletionTokens ?? 4096\n    }\n\n    if (request.tools.length === 0) {\n      return body\n    }\n\n    return {\n      ...body,\n      tools: request.tools.map(toOpenAiTool),\n      parallel_tool_calls: true\n    }\n  })\n\nconst parseToolArguments = (raw: string) =>\n  decodeJsonString(raw, 'Invalid OpenAI tool arguments JSON')\n\nconst toLlmEvents = (\n  message: OpenAiMessageResponse\n): Effect.Effect<ReadonlyArray<LLMEvent>, LLMError> =>\n  Effect.gen(function* () {\n    const content = message.content ?? ''\n    const textEvents = content.length > 0 ? [LLMTextDelta.make({ text: content })] : []\n    const toolCallEvents = yield* Effect.forEach(message.tool_calls ?? [], call =>\n      parseToolArguments(call.function.arguments).pipe(\n        Effect.map(params =>\n          LLMToolCall.make({\n            call: ToolCall.make({\n              id: call.id,\n              name: call.function.name,\n              params\n            })\n          })\n        )\n      )\n    )\n\n    if (toolCallEvents.length > 0) {\n      return [...textEvents, ...toolCallEvents, LLMDone.make({ stopReason: 'tool_use' })]\n    }\n\n    return [...textEvents, LLMDone.make({ stopReason: 'stop' })]\n  })\n\nconst toAgentUsage = (usage: OpenAiUsageResponse) =>\n  AgentUsage.make({\n    input: AgentInputUsage.make({\n      total: usage.prompt_tokens,\n      uncached: usage.prompt_tokens - (usage.prompt_tokens_details?.cached_tokens ?? 0),\n      cacheRead: usage.prompt_tokens_details?.cached_tokens\n    }),\n    output: AgentOutputUsage.make({\n      total: usage.completion_tokens,\n      reasoning: usage.completion_tokens_details?.reasoning_tokens,\n      text: usage.completion_tokens - (usage.completion_tokens_details?.reasoning_tokens ?? 0)\n    })\n  })\n\nconst toHttpClientLlmError =\n  (message: string, retryable: boolean) => (error: HttpClientError.HttpClientError) =>\n    new LLMError({\n      cause: 'provider_error',\n      message: `${message}: ${error.message}`,\n      retryable,\n      provider: providerErrorInfo({\n        provider: 'openai',\n        kind: retryable ? 'network' : 'unknown'\n      })\n    })\n\nconst parseOpenAiResponseJson = (\n  response: HttpClientResponse.HttpClientResponse\n): Effect.Effect<unknown, LLMError> =>\n  response.json.pipe(\n    Effect.mapError(\n      error =>\n        new LLMError({\n          cause: 'invalid_response',\n          message: `Could not parse OpenAI response JSON: ${error.message}`,\n          retryable: false\n        })\n    )\n  )\n\nconst sendOpenAiRequest = (\n  config: OpenAiProviderConfig,\n  request: LLMRequest,\n  client: HttpClient.HttpClient\n): Effect.Effect<ReadonlyArray<LLMEvent>, LLMError> =>\n  Effect.gen(function* () {\n    const body = yield* toOpenAiRequestBody(request, config)\n    const serializedBody = yield* encodeJsonString(body, 'Could not serialize OpenAI request')\n\n    const httpRequest = HttpClientRequest.post(config.chatCompletionsUrl ?? 'https://api.openai.com/v1/chat/completions').pipe(\n      HttpClientRequest.setHeaders({\n        accept: 'application/json',\n        authorization: `Bearer ${Redacted.value(config.apiKey)}`,\n        'content-type': 'application/json',\n        ...config.extraHeaders\n      }),\n      HttpClientRequest.bodyText(serializedBody, 'application/json')\n    )\n    const response = yield* client\n      .execute(httpRequest)\n      .pipe(Effect.mapError(toHttpClientLlmError('OpenAI request failed', true)))\n\n    if (response.status < 200 || response.status >= 300) {\n      const errorText = yield* response.text.pipe(\n        Effect.mapError(\n          error =>\n            new LLMError({\n              cause: 'provider_error',\n              message: `Could not read OpenAI error body: ${error.message}`,\n              retryable: false\n            })\n        )\n      )\n\n      const provider = classifyProviderFailure({\n        provider: 'openai',\n        status: response.status,\n        headers: response.headers,\n        body: errorText\n      })\n\n      return yield* Effect.fail(\n        new LLMError({\n          cause: providerFailureCause(provider.kind),\n          message: `OpenAI returned ${response.status}`,\n          retryable: providerFailureRetryable(provider.kind),\n          provider\n        })\n      )\n    }\n\n    const json = yield* parseOpenAiResponseJson(response)\n    const parsed = yield* Schema.decodeUnknownEffect(OpenAiChatCompletionResponse)(json).pipe(\n      Effect.mapError(\n        error =>\n          new LLMError({\n            cause: 'invalid_response',\n            message: `Invalid OpenAI response: ${unknownToMessage(error)}`,\n            retryable: false\n          })\n      )\n    )\n    const choice = parsed.choices[0]\n\n    if (choice === undefined) {\n      return yield* Effect.fail(\n        new LLMError({\n          cause: 'invalid_response',\n          message: 'OpenAI response contained no choices',\n          retryable: false\n        })\n      )\n    }\n\n    const events = yield* toLlmEvents(choice.message)\n\n    if (parsed.usage === undefined) {\n      return events\n    }\n\n    return [...events, LLMUsage.make({ usage: toAgentUsage(parsed.usage) })]\n  }).pipe(Effect.withSpan('OpenAiProvider.stream'))\n\nexport const makeOpenAiProviderLayer = (config: OpenAiProviderConfig) =>\n  Layer.effect(\n    LLMProvider,\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n\n      return LLMProvider.of({\n        stream: request =>\n          Stream.fromEffect(sendOpenAiRequest(config, request, client)).pipe(\n            Stream.flatMap(events => Stream.fromIterable(events))\n          )\n      })\n    })\n  )\n\nexport const OpenAiProviderLayer = Layer.effect(\n  LLMProvider,\n  Effect.gen(function* () {\n    const config = yield* OpenAiConfig\n    const client = yield* HttpClient.HttpClient\n\n    return LLMProvider.of({\n      stream: request =>\n        Stream.fromEffect(sendOpenAiRequest(config, request, client)).pipe(\n          Stream.flatMap(events => Stream.fromIterable(events))\n        )\n    })\n  })\n).pipe(Layer.provide(Layer.mergeAll(OpenAiConfigLayer, FetchHttpClient.layer)))\n"],"mappings":"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"}
+{"version":3,"file":"provider.mjs","names":["LLMTextDelta"],"sources":["../../../src/providers/openai/provider.ts"],"sourcesContent":["import { Config, Context, Effect, Layer, Option, Redacted, Stream } from 'effect'\nimport {\n  FetchHttpClient,\n  HttpClient,\n  HttpClientRequest,\n  type HttpClientError,\n  type HttpClientResponse\n} from 'effect/unstable/http'\nimport * as Schema from 'effect/Schema'\nimport {\n  ToolCall,\n  AgentInputUsage,\n  AgentOutputUsage,\n  AgentUsage,\n  attachmentSourceText,\n  attachmentSourceUrl,\n  assistantContent,\n  assistantHostToolCalls,\n  isTextDocumentMimeType,\n  messageContextText,\n  prependMessageContextToContent,\n  type AgentMessage,\n  type Content,\n  type ContentPart,\n  type ToolDef\n} from '@yolk-sdk/agent/protocol'\nimport {\n  LLMError,\n  LLMDone,\n  LLMProvider,\n  LLMTextDelta,\n  LLMToolCall,\n  LLMUsage,\n  type LLMEvent,\n  type LLMRequest\n} from '@yolk-sdk/agent/loop'\nimport {\n  classifyProviderFailure,\n  providerErrorInfo,\n  providerFailureCause,\n  providerFailureRetryable\n} from '../provider-error.ts'\nimport { validateProviderTranscript } from '../transcript.ts'\n\nexport type OpenAiProviderConfig = {\n  readonly chatCompletionsUrl?: string\n  readonly maxCompletionTokens?: number\n  readonly extraHeaders?: Readonly<Record<string, string>>\n  readonly apiKey: Redacted.Redacted<string>\n}\n\ntype OpenAiTextContentPart = {\n  readonly type: 'text'\n  readonly text: string\n}\n\ntype OpenAiImageContentPart = {\n  readonly type: 'image_url'\n  readonly image_url: {\n    readonly url: string\n  }\n}\n\ntype OpenAiUserContent = string | ReadonlyArray<OpenAiTextContentPart | OpenAiImageContentPart>\n\ntype OpenAiToolCall = {\n  readonly id: string\n  readonly type: 'function'\n  readonly function: {\n    readonly name: string\n    readonly arguments: string\n  }\n}\n\ntype OpenAiMessage =\n  | { readonly role: 'system'; readonly content: string }\n  | { readonly role: 'user'; readonly content: OpenAiUserContent }\n  | {\n      readonly role: 'assistant'\n      readonly content: string | null\n      readonly tool_calls?: ReadonlyArray<OpenAiToolCall>\n    }\n  | { readonly role: 'tool'; readonly tool_call_id: string; readonly content: string }\n\ntype OpenAiTool = {\n  readonly type: 'function'\n  readonly function: {\n    readonly name: string\n    readonly description: string\n    readonly parameters: unknown\n  }\n}\n\ntype OpenAiRequestBody = {\n  readonly model: string\n  readonly messages: ReadonlyArray<OpenAiMessage>\n  readonly max_completion_tokens: number\n  readonly tools?: ReadonlyArray<OpenAiTool>\n  readonly parallel_tool_calls?: true\n}\n\nclass OpenAiFunctionResponse extends Schema.Class<OpenAiFunctionResponse>('OpenAiFunctionResponse')(\n  {\n    name: Schema.String,\n    arguments: Schema.String\n  }\n) {}\n\nclass OpenAiToolCallResponse extends Schema.Class<OpenAiToolCallResponse>('OpenAiToolCallResponse')(\n  {\n    id: Schema.String,\n    type: Schema.Literals(['function']),\n    function: OpenAiFunctionResponse\n  }\n) {}\n\nclass OpenAiMessageResponse extends Schema.Class<OpenAiMessageResponse>('OpenAiMessageResponse')({\n  content: Schema.NullOr(Schema.String),\n  tool_calls: Schema.optional(Schema.Array(OpenAiToolCallResponse))\n}) {}\n\nclass OpenAiChoiceResponse extends Schema.Class<OpenAiChoiceResponse>('OpenAiChoiceResponse')({\n  message: OpenAiMessageResponse\n}) {}\n\nclass OpenAiPromptTokensDetails extends Schema.Class<OpenAiPromptTokensDetails>(\n  'OpenAiPromptTokensDetails'\n)({\n  cached_tokens: Schema.optional(Schema.Number)\n}) {}\n\nclass OpenAiCompletionTokensDetails extends Schema.Class<OpenAiCompletionTokensDetails>(\n  'OpenAiCompletionTokensDetails'\n)({\n  reasoning_tokens: Schema.optional(Schema.Number)\n}) {}\n\nclass OpenAiUsageResponse extends Schema.Class<OpenAiUsageResponse>('OpenAiUsageResponse')({\n  prompt_tokens: Schema.Number,\n  completion_tokens: Schema.Number,\n  prompt_tokens_details: Schema.optional(OpenAiPromptTokensDetails),\n  completion_tokens_details: Schema.optional(OpenAiCompletionTokensDetails)\n}) {}\n\nclass OpenAiChatCompletionResponse extends Schema.Class<OpenAiChatCompletionResponse>(\n  'OpenAiChatCompletionResponse'\n)({\n  choices: Schema.Array(OpenAiChoiceResponse),\n  usage: Schema.optional(OpenAiUsageResponse)\n}) {}\n\nclass OpenAiConfig extends Context.Service<OpenAiConfig, OpenAiProviderConfig>()(\n  '@app/OpenAiConfig'\n) {}\n\nconst OpenAiConfigLayer = Layer.effect(\n  OpenAiConfig,\n  Effect.gen(function* () {\n    const apiKey = yield* Config.redacted('OPENAI_API_KEY')\n    return { apiKey }\n  }).pipe(\n    Effect.mapError(\n      () =>\n        new LLMError({\n          cause: 'provider_error',\n          message: 'OPENAI_API_KEY not found',\n          retryable: false\n        })\n    )\n  )\n)\n\nconst unknownToMessage = (error: unknown) =>\n  error instanceof Error ? error.message : String(error)\n\nconst encodeJsonString = (value: unknown, message: string) =>\n  Schema.encodeUnknownEffect(Schema.UnknownFromJsonString)(value).pipe(\n    Effect.mapError(\n      error =>\n        new LLMError({\n          cause: 'provider_error',\n          message: `${message}: ${unknownToMessage(error)}`,\n          retryable: false\n        })\n    )\n  )\n\nconst decodeJsonString = (raw: string, message: string) =>\n  Schema.decodeUnknownEffect(Schema.UnknownFromJsonString)(raw).pipe(\n    Effect.mapError(\n      error =>\n        new LLMError({\n          cause: 'invalid_response',\n          message: `${message}: ${unknownToMessage(error)}`,\n          retryable: false\n        })\n    )\n  )\n\nconst unsupportedContentError = (contentType: string) =>\n  new LLMError({\n    cause: 'provider_error',\n    message: `${contentType} content is not supported by the OpenAI provider yet`,\n    retryable: false\n  })\n\nconst textDocumentToOpenAiPart = (part: Extract<ContentPart, { readonly _tag: 'Document' }>) =>\n  attachmentSourceText(part.source).pipe(\n    Effect.mapError(() => unsupportedContentError('Invalid document text')),\n    Effect.flatMap(\n      Option.match({\n        onNone: () => Effect.fail(unsupportedContentError('Unresolved document source')),\n        onSome: text => {\n          const block: OpenAiTextContentPart = {\n            type: 'text',\n            text: `Document: ${part.title ?? part.filename}\\n\\n${text}`\n          }\n\n          return Effect.succeed(block)\n        }\n      })\n    )\n  )\n\nconst contentPartToUserPart = (\n  part: ContentPart\n): Effect.Effect<OpenAiTextContentPart | OpenAiImageContentPart, LLMError> => {\n  switch (part._tag) {\n    case 'Text':\n      return Effect.succeed({ type: 'text', text: part.text })\n    case 'Image':\n      return Option.match(attachmentSourceUrl(part.source, part.mimeType), {\n        onNone: () => Effect.fail(unsupportedContentError('Unresolved image source')),\n        onSome: url => Effect.succeed({ type: 'image_url', image_url: { url } })\n      })\n    case 'Document':\n      return isTextDocumentMimeType(part.mimeType)\n        ? textDocumentToOpenAiPart(part)\n        : Effect.fail(unsupportedContentError('Document'))\n    case 'Audio':\n      return Effect.fail(unsupportedContentError('Audio'))\n  }\n}\n\nconst contentToUserContent = (content: Content): Effect.Effect<OpenAiUserContent, LLMError> =>\n  typeof content === 'string'\n    ? Effect.succeed(content)\n    : Effect.forEach(content, contentPartToUserPart)\n\nconst contentPartToText = (part: ContentPart, owner: string): Effect.Effect<string, LLMError> => {\n  switch (part._tag) {\n    case 'Text':\n      return Effect.succeed(part.text)\n    case 'Image':\n      return Effect.fail(unsupportedContentError(`${owner} image`))\n    case 'Document':\n      return Effect.fail(unsupportedContentError(`${owner} document`))\n    case 'Audio':\n      return Effect.fail(unsupportedContentError(`${owner} audio`))\n  }\n}\n\nconst contentToText = (content: Content, owner: string): Effect.Effect<string, LLMError> =>\n  typeof content === 'string'\n    ? Effect.succeed(content)\n    : Effect.forEach(content, part => contentPartToText(part, owner)).pipe(\n        Effect.map(textParts => textParts.join('\\n'))\n      )\n\nconst serializeToolArguments = (params: unknown) =>\n  encodeJsonString(params, 'Could not serialize OpenAI tool arguments')\n\nconst toolCallToOpenAiToolCall = (call: ToolCall): Effect.Effect<OpenAiToolCall, LLMError> =>\n  Effect.gen(function* () {\n    return {\n      id: call.id,\n      type: 'function',\n      function: {\n        name: call.name,\n        arguments: yield* serializeToolArguments(call.params)\n      }\n    }\n  })\n\nconst toOpenAiMessage = (message: AgentMessage): Effect.Effect<OpenAiMessage, LLMError> =>\n  Effect.gen(function* () {\n    switch (message._tag) {\n      case 'User':\n        return {\n          role: 'user',\n          content: yield* contentToUserContent(\n            prependMessageContextToContent(message.content, messageContextText(message))\n          )\n        }\n      case 'Assistant': {\n        const content = prependMessageContextToContent(\n          assistantContent(message),\n          messageContextText(message)\n        )\n        const toolCalls = yield* Effect.forEach(\n          assistantHostToolCalls(message),\n          toolCallToOpenAiToolCall\n        )\n\n        if (toolCalls.length > 0) {\n          return {\n            role: 'assistant',\n            content: yield* contentToText(content, 'Assistant'),\n            tool_calls: toolCalls\n          }\n        }\n\n        return {\n          role: 'assistant',\n          content: yield* contentToText(content, 'Assistant')\n        }\n      }\n      case 'ToolResult':\n        return {\n          role: 'tool',\n          tool_call_id: message.toolCallId,\n          content: yield* contentToText(\n            prependMessageContextToContent(message.content, messageContextText(message)),\n            'Tool result'\n          )\n        }\n    }\n  })\n\nconst toOpenAiTool = (tool: ToolDef): OpenAiTool => ({\n  type: 'function',\n  function: {\n    name: tool.name,\n    description: tool.description,\n    parameters: tool.parameters\n  }\n})\n\nexport const toOpenAiRequestBody = (\n  request: LLMRequest,\n  config?: { readonly maxCompletionTokens?: number }\n): Effect.Effect<OpenAiRequestBody, LLMError> =>\n  Effect.gen(function* () {\n    yield* validateProviderTranscript(request.messages)\n    const systemMessage: OpenAiMessage = { role: 'system', content: request.systemPrompt }\n    const requestMessages = yield* Effect.forEach(request.messages, toOpenAiMessage)\n    const messages = [systemMessage, ...requestMessages]\n\n    const body = {\n      model: request.model,\n      messages,\n      max_completion_tokens: config?.maxCompletionTokens ?? 4096\n    }\n\n    if (request.tools.length === 0) {\n      return body\n    }\n\n    return {\n      ...body,\n      tools: request.tools.map(toOpenAiTool),\n      parallel_tool_calls: true\n    }\n  })\n\nconst parseToolArguments = (raw: string) =>\n  decodeJsonString(raw, 'Invalid OpenAI tool arguments JSON')\n\nconst toLlmEvents = (\n  message: OpenAiMessageResponse\n): Effect.Effect<ReadonlyArray<LLMEvent>, LLMError> =>\n  Effect.gen(function* () {\n    const content = message.content ?? ''\n    const textEvents = content.length > 0 ? [LLMTextDelta.make({ text: content })] : []\n    const toolCallEvents = yield* Effect.forEach(message.tool_calls ?? [], call =>\n      parseToolArguments(call.function.arguments).pipe(\n        Effect.map(params =>\n          LLMToolCall.make({\n            call: ToolCall.make({\n              id: call.id,\n              name: call.function.name,\n              params\n            })\n          })\n        )\n      )\n    )\n\n    if (toolCallEvents.length > 0) {\n      return [...textEvents, ...toolCallEvents, LLMDone.make({ stopReason: 'tool_use' })]\n    }\n\n    return [...textEvents, LLMDone.make({ stopReason: 'stop' })]\n  })\n\nconst toAgentUsage = (usage: OpenAiUsageResponse) =>\n  AgentUsage.make({\n    input: AgentInputUsage.make({\n      total: usage.prompt_tokens,\n      uncached: usage.prompt_tokens - (usage.prompt_tokens_details?.cached_tokens ?? 0),\n      cacheRead: usage.prompt_tokens_details?.cached_tokens\n    }),\n    output: AgentOutputUsage.make({\n      total: usage.completion_tokens,\n      reasoning: usage.completion_tokens_details?.reasoning_tokens,\n      text: usage.completion_tokens - (usage.completion_tokens_details?.reasoning_tokens ?? 0)\n    })\n  })\n\nconst toHttpClientLlmError =\n  (message: string, retryable: boolean) => (error: HttpClientError.HttpClientError) =>\n    new LLMError({\n      cause: 'provider_error',\n      message: `${message}: ${error.message}`,\n      retryable,\n      provider: providerErrorInfo({\n        provider: 'openai',\n        kind: retryable ? 'network' : 'unknown'\n      })\n    })\n\nconst parseOpenAiResponseJson = (\n  response: HttpClientResponse.HttpClientResponse\n): Effect.Effect<unknown, LLMError> =>\n  response.json.pipe(\n    Effect.mapError(\n      error =>\n        new LLMError({\n          cause: 'invalid_response',\n          message: `Could not parse OpenAI response JSON: ${error.message}`,\n          retryable: false\n        })\n    )\n  )\n\nconst sendOpenAiRequest = (\n  config: OpenAiProviderConfig,\n  request: LLMRequest,\n  client: HttpClient.HttpClient\n): Effect.Effect<ReadonlyArray<LLMEvent>, LLMError> =>\n  Effect.gen(function* () {\n    const body = yield* toOpenAiRequestBody(request, config)\n    const serializedBody = yield* encodeJsonString(body, 'Could not serialize OpenAI request')\n\n    const httpRequest = HttpClientRequest.post(config.chatCompletionsUrl ?? 'https://api.openai.com/v1/chat/completions').pipe(\n      HttpClientRequest.setHeaders({\n        accept: 'application/json',\n        authorization: `Bearer ${Redacted.value(config.apiKey)}`,\n        'content-type': 'application/json',\n        ...config.extraHeaders\n      }),\n      HttpClientRequest.bodyText(serializedBody, 'application/json')\n    )\n    const response = yield* client\n      .execute(httpRequest)\n      .pipe(Effect.mapError(toHttpClientLlmError('OpenAI request failed', true)))\n\n    if (response.status < 200 || response.status >= 300) {\n      const errorText = yield* response.text.pipe(\n        Effect.mapError(\n          error =>\n            new LLMError({\n              cause: 'provider_error',\n              message: `Could not read OpenAI error body: ${error.message}`,\n              retryable: false\n            })\n        )\n      )\n\n      const provider = classifyProviderFailure({\n        provider: 'openai',\n        status: response.status,\n        headers: response.headers,\n        body: errorText\n      })\n\n      return yield* Effect.fail(\n        new LLMError({\n          cause: providerFailureCause(provider.kind),\n          message: `OpenAI returned ${response.status}`,\n          retryable: providerFailureRetryable(provider.kind),\n          provider\n        })\n      )\n    }\n\n    const json = yield* parseOpenAiResponseJson(response)\n    const parsed = yield* Schema.decodeUnknownEffect(OpenAiChatCompletionResponse)(json).pipe(\n      Effect.mapError(\n        error =>\n          new LLMError({\n            cause: 'invalid_response',\n            message: `Invalid OpenAI response: ${unknownToMessage(error)}`,\n            retryable: false\n          })\n      )\n    )\n    const choice = parsed.choices[0]\n\n    if (choice === undefined) {\n      return yield* Effect.fail(\n        new LLMError({\n          cause: 'invalid_response',\n          message: 'OpenAI response contained no choices',\n          retryable: false\n        })\n      )\n    }\n\n    const events = yield* toLlmEvents(choice.message)\n\n    if (parsed.usage === undefined) {\n      return events\n    }\n\n    return [...events, LLMUsage.make({ usage: toAgentUsage(parsed.usage) })]\n  }).pipe(Effect.withSpan('OpenAiProvider.stream'))\n\nexport const makeOpenAiProviderLayer = (config: OpenAiProviderConfig) =>\n  Layer.effect(\n    LLMProvider,\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n\n      return LLMProvider.of({\n        stream: request =>\n          Stream.fromEffect(sendOpenAiRequest(config, request, client)).pipe(\n            Stream.flatMap(events => Stream.fromIterable(events))\n          )\n      })\n    })\n  )\n\nexport const OpenAiProviderLayer = Layer.effect(\n  LLMProvider,\n  Effect.gen(function* () {\n    const config = yield* OpenAiConfig\n    const client = yield* HttpClient.HttpClient\n\n    return LLMProvider.of({\n      stream: request =>\n        Stream.fromEffect(sendOpenAiRequest(config, request, client)).pipe(\n          Stream.flatMap(events => Stream.fromIterable(events))\n        )\n    })\n  })\n).pipe(Layer.provide(Layer.mergeAll(OpenAiConfigLayer, FetchHttpClient.layer)))\n"],"mappings":"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"}

package/dist/providers/transcript.d.mts

@@ -0,0 +1,9 @@
+import { AgentMessage } from "@yolk-sdk/agent/protocol";
+import { Effect } from "effect";
+import { LLMError } from "@yolk-sdk/agent/loop";
+
+//#region src/providers/transcript.d.ts
+declare const validateProviderTranscript: (messages: ReadonlyArray<AgentMessage>) => Effect.Effect<void, LLMError>;
+//#endregion
+export { validateProviderTranscript };
+//# sourceMappingURL=transcript.d.mts.map

package/dist/providers/transcript.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.mts","names":[],"sources":["../../src/providers/transcript.ts"],"mappings":";;;;;cAOa,0BAAA,GACX,QAAA,EAAU,aAAA,CAAc,YAAA,MACvB,MAAA,CAAO,MAAA,OAAa,QAAA"}

package/dist/providers/transcript.mjs

@@ -0,0 +1,17 @@
+import { validateNoDanglingHostToolCalls } from "@yolk-sdk/agent/protocol";
+import { Effect } from "effect";
+import { LLMError } from "@yolk-sdk/agent/loop";
+//#region src/providers/transcript.ts
+const validateProviderTranscript = (messages) => {
+	const validation = validateNoDanglingHostToolCalls(messages);
+	if (validation._tag === "Valid") return Effect.void;
+	return Effect.fail(new LLMError({
+		cause: "validation_error",
+		message: validation.message,
+		retryable: false
+	}));
+};
+//#endregion
+export { validateProviderTranscript };
+
+//# sourceMappingURL=transcript.mjs.map

package/dist/providers/transcript.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.mjs","names":[],"sources":["../../src/providers/transcript.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport {\n  validateNoDanglingHostToolCalls,\n  type AgentMessage\n} from '@yolk-sdk/agent/protocol'\nimport { LLMError } from '@yolk-sdk/agent/loop'\n\nexport const validateProviderTranscript = (\n  messages: ReadonlyArray<AgentMessage>\n): Effect.Effect<void, LLMError> => {\n  const validation = validateNoDanglingHostToolCalls(messages)\n\n  if (validation._tag === 'Valid') {\n    return Effect.void\n  }\n\n  return Effect.fail(\n    new LLMError({\n      cause: 'validation_error',\n      message: validation.message,\n      retryable: false\n    })\n  )\n}\n"],"mappings":";;;;AAOA,MAAa,8BACX,aACkC;CAClC,MAAM,aAAa,gCAAgC,QAAQ;CAE3D,IAAI,WAAW,SAAS,SACtB,OAAO,OAAO;CAGhB,OAAO,OAAO,KACZ,IAAI,SAAS;EACX,OAAO;EACP,SAAS,WAAW;EACpB,WAAW;CACb,CAAC,CACH;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolk-sdk/agent",
-  "version": "0.1.0-canary.21",
+  "version": "0.1.0-canary.23",
   "description": "Protocol, loop, runtime, client, compaction, tools, React, providers, OAuth, skillset, and voice primitives for building Yolk agents.",
   "license": "MIT",
   "type": "module",

package/src/loop/run.ts

@@ -173,6 +173,52 @@ const subagentCompletedEvent = (input: {
       })
 }
 
+const toolCompletionEvents = (input: {
+  readonly call: ToolCall
+  readonly result: ToolResult
+  readonly model: string
+  readonly startedAtMs: number
+  readonly endedAtMs: number
+}): ReadonlyArray<AgentEvent> => {
+  const completed = subagentCompletedEvent(input)
+  const toolCompleted = ToolExecutionCompleted.make({
+    call: input.call,
+    result: input.result,
+    createdAtMs: input.endedAtMs
+  })
+
+  return completed === undefined ? [toolCompleted] : [toolCompleted, completed]
+}
+
+const toolErrorResult = (call: ToolCall, error: ToolError) =>
+  ToolResult.make({
+    toolCallId: call.id,
+    content: error.message,
+    isError: true
+  })
+
+const toolErrorEvents = (input: {
+  readonly call: ToolCall
+  readonly error: ToolError
+  readonly model: string
+  readonly startedAtMs: number
+  readonly endedAtMs: number
+}): ReadonlyArray<AgentEvent> => [
+  ToolExecutionError.make({
+    call: input.call,
+    message: input.error.message,
+    code: toolErrorCode(input.error),
+    createdAtMs: input.endedAtMs
+  }),
+  ...toolCompletionEvents({
+    call: input.call,
+    result: toolErrorResult(input.call, input.error),
+    model: input.model,
+    startedAtMs: input.startedAtMs,
+    endedAtMs: input.endedAtMs
+  })
+]
+
 const unsupportedInputError = (message: string) =>
   new LLMError({
     cause: 'validation_error',
@@ -400,22 +446,15 @@ const makeToolExecutionStream = (
             executor.execute(call).pipe(
               Effect.flatMap(result =>
                 Clock.currentTimeMillis.pipe(
-                  Effect.map(endedAtMs => {
-                    const completed = subagentCompletedEvent({
+                  Effect.map(endedAtMs =>
+                    toolCompletionEvents({
                       call,
                       result,
                       model,
                       startedAtMs,
                       endedAtMs
                     })
-                    const toolCompleted = ToolExecutionCompleted.make({
-                      call,
-                      result,
-                      createdAtMs: endedAtMs
-                    })
-
-                    return completed === undefined ? [toolCompleted] : [toolCompleted, completed]
-                  })
+                  )
                 )
               )
             )
@@ -424,16 +463,16 @@ const makeToolExecutionStream = (
             Stream.catchTag('ToolError', error =>
               Stream.fromEffect(Clock.currentTimeMillis).pipe(
                 Stream.flatMap(endedAtMs =>
-                  Stream.make(
-                    ToolExecutionError.make({
+                  Stream.fromIterable(
+                    toolErrorEvents({
                       call,
-                      message: error.message,
-                      code: toolErrorCode(error),
-                      createdAtMs: endedAtMs
+                      error,
+                      model,
+                      startedAtMs,
+                      endedAtMs
                     })
                   )
-                ),
-                Stream.concat(Stream.fail(error))
+                )
               )
             )
           )

package/src/protocol/content.ts

@@ -201,6 +201,17 @@ export const attachmentSourceDataUrl = (source: AttachmentSource, mimeType: stri
   }
 }
 
+export const attachmentSourceUrl = (source: AttachmentSource, mimeType: string) => {
+  switch (source._tag) {
+    case 'InlineBase64':
+      return Option.some(`data:${mimeType};base64,${source.data}`)
+    case 'Url':
+      return Option.some(source.url)
+    case 'Ref':
+      return Option.none<string>()
+  }
+}
+
 const normalizeMimeType = (mimeType: string) => mimeType.split(';', 1)[0]?.trim().toLowerCase() ?? ''
 
 const textDocumentMimeTypeByExtension: Readonly<Record<string, string>> = {

package/src/protocol/index.ts

@@ -11,6 +11,7 @@ export {
   attachmentSourceDataUrl,
   AttachmentSource,
   attachmentSourceText,
+  attachmentSourceUrl,
   type AttachmentContentPart,
   type AttachmentSourceResolver,
   attachmentSourcePreview,
@@ -96,8 +97,16 @@ export {
   assistantContent,
   assistantHostToolCalls,
   assistantReasoningText,
+  danglingHostToolCalls,
   messageContextText,
-  prependMessageContextToContent
+  prependMessageContextToContent,
+  repairDanglingHostToolCalls,
+  validateNoDanglingHostToolCalls
+} from './message.ts'
+export type {
+  DanglingHostToolCall,
+  RepairDanglingHostToolCallsOptions,
+  TranscriptInvariantValidation
 } from './message.ts'
 export { AgentReasoningEffort } from './reasoning.ts'
 export {

package/src/protocol/message.ts

@@ -87,6 +87,25 @@ export class ToolResultMessage extends Schema.TaggedClass<ToolResultMessage>()('
 export const AgentMessage = Schema.Union([UserMessage, AssistantAgentMessage, ToolResultMessage])
 export type AgentMessage = typeof AgentMessage.Type
 
+export type DanglingHostToolCall = {
+  readonly call: ToolCall
+  readonly assistantMessageIndex: number
+  readonly beforeMessageIndex?: number
+}
+
+export type TranscriptInvariantValidation =
+  | { readonly _tag: 'Valid' }
+  | {
+      readonly _tag: 'DanglingHostToolCalls'
+      readonly calls: ReadonlyArray<DanglingHostToolCall>
+      readonly message: string
+    }
+
+export type RepairDanglingHostToolCallsOptions = {
+  readonly content?: (call: ToolCall) => Content
+  readonly structuredContent?: (call: ToolCall) => unknown
+}
+
 export const assistantContent = (message: AssistantAgentMessage): Content => {
   const parts = message.parts.flatMap(part => (part._tag === 'Text' ? [part.content] : []))
   const first = parts[0]
@@ -108,6 +127,114 @@ export const assistantReasoningText = (message: AssistantAgentMessage) =>
 export const assistantHostToolCalls = (message: AssistantAgentMessage) =>
   message.parts.flatMap(part => (part._tag === 'HostToolCall' ? [part.call] : []))
 
+type PendingHostToolCall = {
+  readonly call: ToolCall
+  readonly assistantMessageIndex: number
+}
+
+const pendingHostToolCalls = (message: AgentMessage, messageIndex: number) =>
+  message._tag === 'Assistant'
+    ? assistantHostToolCalls(message).map(call => ({ call, assistantMessageIndex: messageIndex }))
+    : []
+
+const danglingHostToolCall = (
+  pending: PendingHostToolCall,
+  beforeMessageIndex: number | undefined
+): DanglingHostToolCall => ({
+  call: pending.call,
+  assistantMessageIndex: pending.assistantMessageIndex,
+  ...(beforeMessageIndex === undefined ? {} : { beforeMessageIndex })
+})
+
+const danglingHostToolCallSummary = (calls: ReadonlyArray<DanglingHostToolCall>) =>
+  calls.map(({ call }) => `${call.name} (${call.id})`).join(', ')
+
+const danglingHostToolResultContent = (call: ToolCall) =>
+  `Tool ${call.name} did not return a result before the transcript continued.`
+
+const danglingHostToolResultMessage = (
+  call: ToolCall,
+  options: RepairDanglingHostToolCallsOptions | undefined
+) => {
+  const structuredContent = options?.structuredContent?.(call)
+
+  return ToolResultMessage.make({
+    toolCallId: call.id,
+    content: options?.content?.(call) ?? danglingHostToolResultContent(call),
+    isError: true,
+    ...(structuredContent === undefined ? {} : { structuredContent })
+  })
+}
+
+export const danglingHostToolCalls = (
+  messages: ReadonlyArray<AgentMessage>
+): ReadonlyArray<DanglingHostToolCall> => {
+  const dangling: Array<DanglingHostToolCall> = []
+  let pending: ReadonlyArray<PendingHostToolCall> = []
+
+  for (const [messageIndex, message] of messages.entries()) {
+    if (message._tag !== 'ToolResult' && pending.length > 0) {
+      dangling.push(...pending.map(call => danglingHostToolCall(call, messageIndex)))
+      pending = []
+    }
+
+    pending = [...pending, ...pendingHostToolCalls(message, messageIndex)]
+
+    if (message._tag === 'ToolResult') {
+      pending = pending.filter(call => call.call.id !== message.toolCallId)
+    }
+  }
+
+  dangling.push(...pending.map(call => danglingHostToolCall(call, undefined)))
+
+  return dangling
+}
+
+export const validateNoDanglingHostToolCalls = (
+  messages: ReadonlyArray<AgentMessage>
+): TranscriptInvariantValidation => {
+  const dangling = danglingHostToolCalls(messages)
+
+  if (dangling.length === 0) {
+    return { _tag: 'Valid' }
+  }
+
+  return {
+    _tag: 'DanglingHostToolCalls',
+    calls: dangling,
+    message: `Transcript has host tool calls without tool results: ${danglingHostToolCallSummary(dangling)}`
+  }
+}
+
+export const repairDanglingHostToolCalls = (
+  messages: ReadonlyArray<AgentMessage>,
+  options?: RepairDanglingHostToolCallsOptions
+): ReadonlyArray<AgentMessage> => {
+  const repaired: Array<AgentMessage> = []
+  let pending: ReadonlyArray<ToolCall> = []
+
+  for (const message of messages) {
+    if (message._tag !== 'ToolResult' && pending.length > 0) {
+      repaired.push(...pending.map(call => danglingHostToolResultMessage(call, options)))
+      pending = []
+    }
+
+    repaired.push(message)
+
+    if (message._tag === 'Assistant') {
+      pending = [...pending, ...assistantHostToolCalls(message)]
+    }
+
+    if (message._tag === 'ToolResult') {
+      pending = pending.filter(call => call.id !== message.toolCallId)
+    }
+  }
+
+  repaired.push(...pending.map(call => danglingHostToolResultMessage(call, options)))
+
+  return repaired
+}
+
 const formatCreatedAtMs = (createdAtMs: number) =>
   Number.isFinite(createdAtMs) ? new Date(createdAtMs).toISOString() : String(createdAtMs)
 

package/src/providers/anthropic/claude-provider.ts

@@ -11,7 +11,6 @@ import {
   AgentOutputUsage,
   AgentUsage,
   ToolCall,
-  attachmentSourceBase64,
   attachmentSourceText,
   assistantContent,
   assistantHostToolCalls,
@@ -48,6 +47,7 @@ import {
   providerFailureCause,
   providerFailureRetryable
 } from '../provider-error.ts'
+import { validateProviderTranscript } from '../transcript.ts'
 
 export type AnthropicClaudeProviderConfig = {
   readonly token: OAuthAccessToken
@@ -65,20 +65,30 @@ type AnthropicSystemBlock = AnthropicTextBlock
 
 type AnthropicImageBlock = {
   readonly type: 'image'
-  readonly source: {
-    readonly type: 'base64'
-    readonly media_type: string
-    readonly data: string
-  }
+  readonly source:
+    | {
+        readonly type: 'base64'
+        readonly media_type: string
+        readonly data: string
+      }
+    | {
+        readonly type: 'url'
+        readonly url: string
+      }
 }
 
 type AnthropicDocumentBlock = {
   readonly type: 'document'
-  readonly source: {
-    readonly type: 'base64'
-    readonly media_type: 'application/pdf'
-    readonly data: string
-  }
+  readonly source:
+    | {
+        readonly type: 'base64'
+        readonly media_type: 'application/pdf'
+        readonly data: string
+      }
+    | {
+        readonly type: 'url'
+        readonly url: string
+      }
   readonly title?: string
 }
 
@@ -442,6 +452,60 @@ const unsupportedContentError = (contentType: string) =>
     retryable: false
   })
 
+const imageToAnthropicBlock = (
+  part: Extract<ContentPart, { readonly _tag: 'Image' }>
+): Effect.Effect<AnthropicImageBlock, LLMError> => {
+  switch (part.source._tag) {
+    case 'InlineBase64':
+      return Effect.succeed({
+        type: 'image',
+        source: {
+          type: 'base64',
+          media_type: part.mimeType,
+          data: part.source.data
+        }
+      })
+    case 'Url':
+      return Effect.succeed({
+        type: 'image',
+        source: {
+          type: 'url',
+          url: part.source.url
+        }
+      })
+    case 'Ref':
+      return Effect.fail(unsupportedContentError('Unresolved image source'))
+  }
+}
+
+const pdfDocumentToAnthropicBlock = (
+  part: Extract<ContentPart, { readonly _tag: 'Document' }>
+): Effect.Effect<AnthropicDocumentBlock, LLMError> => {
+  switch (part.source._tag) {
+    case 'InlineBase64':
+      return Effect.succeed({
+        type: 'document',
+        source: {
+          type: 'base64',
+          media_type: 'application/pdf',
+          data: part.source.data
+        },
+        title: part.title ?? part.filename
+      })
+    case 'Url':
+      return Effect.succeed({
+        type: 'document',
+        source: {
+          type: 'url',
+          url: part.source.url
+        },
+        title: part.title ?? part.filename
+      })
+    case 'Ref':
+      return Effect.fail(unsupportedContentError('Unresolved document source'))
+  }
+}
+
 const textDocumentToAnthropicBlock = (part: Extract<ContentPart, { readonly _tag: 'Document' }>) =>
   attachmentSourceText(part.source).pipe(
     Effect.mapError(() => unsupportedContentError('Invalid document text')),
@@ -465,33 +529,12 @@ const contentPartToUserBlock = (part: ContentPart): Effect.Effect<AnthropicUserB
     case 'Text':
       return Effect.succeed({ type: 'text', text: part.text })
     case 'Image':
-      return Option.match(attachmentSourceBase64(part.source), {
-        onNone: () => Effect.fail(unsupportedContentError('Unresolved image source')),
-        onSome: data => Effect.succeed({
-          type: 'image',
-          source: {
-            type: 'base64',
-            media_type: part.mimeType,
-            data
-          }
-        })
-      })
+      return imageToAnthropicBlock(part)
     case 'Document':
       return isTextDocumentMimeType(part.mimeType)
         ? textDocumentToAnthropicBlock(part)
         : part.mimeType === 'application/pdf'
-        ? Option.match(attachmentSourceBase64(part.source), {
-            onNone: () => Effect.fail(unsupportedContentError('Unresolved document source')),
-            onSome: data => Effect.succeed({
-              type: 'document',
-              source: {
-                type: 'base64',
-                media_type: 'application/pdf',
-                data
-              },
-              title: part.title ?? part.filename
-            })
-          })
+        ? pdfDocumentToAnthropicBlock(part)
         : Effect.fail(unsupportedContentError(`Document ${part.mimeType}`))
     case 'Audio':
       return Effect.fail(unsupportedContentError('Audio'))
@@ -802,6 +845,7 @@ export const toAnthropicClaudeRequestBody = (
   config?: { readonly maxTokens?: number; readonly stream?: boolean }
 ): Effect.Effect<AnthropicRequestBody, LLMError> =>
   Effect.gen(function* () {
+    yield* validateProviderTranscript(request.messages)
     const rawMessages = yield* Effect.forEach(request.messages, toAnthropicMessage)
     const billingSystemBlock = yield* makeAnthropicClaudeBillingSystemBlock(rawMessages)
     const messages = prependSystemPromptToFirstUserMessage(rawMessages, request.systemPrompt)