@yolk-sdk/agent 0.1.0-canary.111 → 0.1.0-canary.112

package/README.md

@@ -233,13 +233,19 @@ const GoLayer = makeOpenCodeGoProviderLayer({
 }).pipe(Layer.provide(FetchHttpClient.layer))
 ```
 
-The default base URL is `https://opencode.ai/zen/go/v1`. Chat streams SSE (the Go adapter sets
+The default base URL is `https://opencode.ai/inference/go/v1`. Chat streams SSE (the Go adapter sets
 `streaming: true`) with Bearer auth; Messages uses SSE and `x-api-key`; Responses uses SSE and Bearer
 auth. All normalize to `LLMEvent`s.
 Messages retains native tool names and system instructions, without Claude OAuth fingerprinting.
 Responses sends `max_output_tokens`, unlike Codex. Go requires a nonempty key and positive safe-integer
 limit at layer construction. `extraHeaders` cannot override required protocol headers, regardless of
 case. Only override `baseUrl` with a trusted proxy because it receives the credential.
+A chat parser rejection (for example a stream payload that is not JSON), a chat response that is not
+SSE, or a chat or Responses stream ending before its terminal event is retried once, before any
+event, under `<session>.reroute` so Go routes it to another upstream. The session is the request
+`cacheKey`, else the `x-opencode-session` extra header; without either the request is resent
+unchanged. Messages failures are not re-routed. Errors carrying provider metadata read
+`OpenCode Go <cause>`, with the failed check in `provider.providerCode`.
 
 Request `reasoningEffort` becomes chat `reasoning_effort`, Messages `output_config.effort` (omitting
 `minimal`), or Responses `reasoning.effort` with `summary: 'auto'`. `reasoningSummary` changes the

package/dist/client/state.d.mts

@@ -80,26 +80,6 @@ type AgentToolRun = {
   readonly result: ToolResult;
 };
 declare const AgentToolRun: {
-  readonly InputStreaming: Data.TaggedEnum.ConstructorFrom<{
-    readonly _tag: "InputStreaming";
-    readonly id: string;
-    readonly name?: string;
-    readonly input: string;
-  }, "_tag">;
-  readonly InputReady: Data.TaggedEnum.ConstructorFrom<{
-    readonly _tag: "InputReady";
-    readonly call: ToolCall;
-  }, "_tag">;
-  readonly ApprovalRequested: Data.TaggedEnum.ConstructorFrom<{
-    readonly _tag: "ApprovalRequested";
-    readonly call: ToolCall;
-    readonly request?: ToolApprovalRequest;
-  }, "_tag">;
-  readonly Denied: Data.TaggedEnum.ConstructorFrom<{
-    readonly _tag: "Denied";
-    readonly toolCallId: string;
-    readonly reason: string;
-  }, "_tag">;
   readonly QuestionRequested: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "QuestionRequested";
     readonly request: QuestionRequest;
@@ -142,6 +122,26 @@ declare const AgentToolRun: {
     readonly response: InteractionResponse;
     readonly request?: InteractionRequest;
   }, "_tag">;
+  readonly InputStreaming: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "InputStreaming";
+    readonly id: string;
+    readonly name?: string;
+    readonly input: string;
+  }, "_tag">;
+  readonly InputReady: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "InputReady";
+    readonly call: ToolCall;
+  }, "_tag">;
+  readonly ApprovalRequested: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "ApprovalRequested";
+    readonly call: ToolCall;
+    readonly request?: ToolApprovalRequest;
+  }, "_tag">;
+  readonly Denied: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Denied";
+    readonly toolCallId: string;
+    readonly reason: string;
+  }, "_tag">;
   readonly Executing: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Executing";
     readonly call: ToolCall;
@@ -173,7 +173,7 @@ declare const AgentToolRun: {
     readonly call: ToolCall;
     readonly result: ToolResult;
   }, "_tag">;
-  readonly $is: <Tag extends "InputStreaming" | "InputReady" | "ApprovalRequested" | "Denied" | "QuestionRequested" | "QuestionAnswered" | "QuestionCancelled" | "InputRequested" | "InputSubmitted" | "InputCancelled" | "InteractionRequested" | "InteractionSubmitted" | "InteractionCancelled" | "Executing" | "Completed" | "Accepted" | "Errored" | "ProviderCompleted">(tag: Tag) => (u: unknown) => u is Extract<{
+  readonly $is: <Tag extends "QuestionRequested" | "QuestionAnswered" | "QuestionCancelled" | "InputRequested" | "InputSubmitted" | "InputCancelled" | "InteractionRequested" | "InteractionSubmitted" | "InteractionCancelled" | "InputStreaming" | "InputReady" | "ApprovalRequested" | "Denied" | "Executing" | "Completed" | "Accepted" | "Errored" | "ProviderCompleted">(tag: Tag) => (u: unknown) => u is Extract<{
     readonly _tag: "InputStreaming";
     readonly id: string;
     readonly name?: string;
@@ -287,26 +287,6 @@ declare const AgentToolRun: {
   }>;
   readonly $match: {
     <Cases extends {
-      readonly InputStreaming: (args: {
-        readonly _tag: "InputStreaming";
-        readonly id: string;
-        readonly name?: string;
-        readonly input: string;
-      }) => any;
-      readonly InputReady: (args: {
-        readonly _tag: "InputReady";
-        readonly call: ToolCall;
-      }) => any;
-      readonly ApprovalRequested: (args: {
-        readonly _tag: "ApprovalRequested";
-        readonly call: ToolCall;
-        readonly request?: ToolApprovalRequest;
-      }) => any;
-      readonly Denied: (args: {
-        readonly _tag: "Denied";
-        readonly toolCallId: string;
-        readonly reason: string;
-      }) => any;
       readonly QuestionRequested: (args: {
         readonly _tag: "QuestionRequested";
         readonly request: QuestionRequest;
@@ -349,6 +329,26 @@ declare const AgentToolRun: {
         readonly response: InteractionResponse;
         readonly request?: InteractionRequest;
       }) => any;
+      readonly InputStreaming: (args: {
+        readonly _tag: "InputStreaming";
+        readonly id: string;
+        readonly name?: string;
+        readonly input: string;
+      }) => any;
+      readonly InputReady: (args: {
+        readonly _tag: "InputReady";
+        readonly call: ToolCall;
+      }) => any;
+      readonly ApprovalRequested: (args: {
+        readonly _tag: "ApprovalRequested";
+        readonly call: ToolCall;
+        readonly request?: ToolApprovalRequest;
+      }) => any;
+      readonly Denied: (args: {
+        readonly _tag: "Denied";
+        readonly toolCallId: string;
+        readonly reason: string;
+      }) => any;
       readonly Executing: (args: {
         readonly _tag: "Executing";
         readonly call: ToolCall;
@@ -380,28 +380,8 @@ declare const AgentToolRun: {
         readonly call: ToolCall;
         readonly result: ToolResult;
       }) => any;
-    }>(cases: Cases): (value: AgentToolRun) => import("effect/Unify").Unify<ReturnType<Cases["InputStreaming" | "InputReady" | "ApprovalRequested" | "Denied" | "QuestionRequested" | "QuestionAnswered" | "QuestionCancelled" | "InputRequested" | "InputSubmitted" | "InputCancelled" | "InteractionRequested" | "InteractionSubmitted" | "InteractionCancelled" | "Executing" | "Completed" | "Accepted" | "Errored" | "ProviderCompleted"]>>;
+    }>(cases: Cases): (value: AgentToolRun) => import("effect/Unify").Unify<ReturnType<Cases["QuestionRequested" | "QuestionAnswered" | "QuestionCancelled" | "InputRequested" | "InputSubmitted" | "InputCancelled" | "InteractionRequested" | "InteractionSubmitted" | "InteractionCancelled" | "InputStreaming" | "InputReady" | "ApprovalRequested" | "Denied" | "Executing" | "Completed" | "Accepted" | "Errored" | "ProviderCompleted"]>>;
     <Cases extends {
-      readonly InputStreaming: (args: {
-        readonly _tag: "InputStreaming";
-        readonly id: string;
-        readonly name?: string;
-        readonly input: string;
-      }) => any;
-      readonly InputReady: (args: {
-        readonly _tag: "InputReady";
-        readonly call: ToolCall;
-      }) => any;
-      readonly ApprovalRequested: (args: {
-        readonly _tag: "ApprovalRequested";
-        readonly call: ToolCall;
-        readonly request?: ToolApprovalRequest;
-      }) => any;
-      readonly Denied: (args: {
-        readonly _tag: "Denied";
-        readonly toolCallId: string;
-        readonly reason: string;
-      }) => any;
       readonly QuestionRequested: (args: {
         readonly _tag: "QuestionRequested";
         readonly request: QuestionRequest;
@@ -444,6 +424,26 @@ declare const AgentToolRun: {
         readonly response: InteractionResponse;
         readonly request?: InteractionRequest;
       }) => any;
+      readonly InputStreaming: (args: {
+        readonly _tag: "InputStreaming";
+        readonly id: string;
+        readonly name?: string;
+        readonly input: string;
+      }) => any;
+      readonly InputReady: (args: {
+        readonly _tag: "InputReady";
+        readonly call: ToolCall;
+      }) => any;
+      readonly ApprovalRequested: (args: {
+        readonly _tag: "ApprovalRequested";
+        readonly call: ToolCall;
+        readonly request?: ToolApprovalRequest;
+      }) => any;
+      readonly Denied: (args: {
+        readonly _tag: "Denied";
+        readonly toolCallId: string;
+        readonly reason: string;
+      }) => any;
       readonly Executing: (args: {
         readonly _tag: "Executing";
         readonly call: ToolCall;
@@ -475,7 +475,7 @@ declare const AgentToolRun: {
         readonly call: ToolCall;
         readonly result: ToolResult;
       }) => any;
-    }>(value: AgentToolRun, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["InputStreaming" | "InputReady" | "ApprovalRequested" | "Denied" | "QuestionRequested" | "QuestionAnswered" | "QuestionCancelled" | "InputRequested" | "InputSubmitted" | "InputCancelled" | "InteractionRequested" | "InteractionSubmitted" | "InteractionCancelled" | "Executing" | "Completed" | "Accepted" | "Errored" | "ProviderCompleted"]>>;
+    }>(value: AgentToolRun, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["QuestionRequested" | "QuestionAnswered" | "QuestionCancelled" | "InputRequested" | "InputSubmitted" | "InputCancelled" | "InteractionRequested" | "InteractionSubmitted" | "InteractionCancelled" | "InputStreaming" | "InputReady" | "ApprovalRequested" | "Denied" | "Executing" | "Completed" | "Accepted" | "Errored" | "ProviderCompleted"]>>;
   };
 };
 type AgentClientState = {

package/dist/client/state.d.mts.map

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

package/dist/providers/openai/provider.d.mts

@@ -120,8 +120,25 @@ type OpenAiRequestBodyConfig = {
   readonly providerName?: string;
 };
 declare const toOpenAiRequestBody: (request: LLMRequest, config: OpenAiRequestBodyConfig) => Effect.Effect<OpenAiRequestBody, LLMError>;
+/**
+ * `ProviderErrorInfo.providerCode` values (kind `invalid_response`) naming the check a Chat
+ * Completions response failed. Fixed literals that never carry upstream values, so hosts can log
+ * and persist them:
+ *
+ * - `invalid_stream_json`: an SSE `data:` payload is not JSON.
+ * - `invalid_stream_chunk`: a stream chunk does not match the `chat.completion.chunk` shape.
+ * - `invalid_reasoning`: reasoning content is neither a string nor null.
+ * - `invalid_tool_call`: a streamed tool call has no id or no name.
+ * - `invalid_tool_arguments`: tool call arguments are not JSON.
+ * - `invalid_usage`: the usage block lacks its token counts.
+ * - `invalid_response_json`: a JSON (non-streaming) response body is not JSON.
+ * - `invalid_response_body`: a JSON response does not match the `chat.completion` shape.
+ * - `missing_choices`: a JSON response has no choices.
+ */
+declare const openAiChatResponseIssues: readonly ["invalid_stream_json", "invalid_stream_chunk", "invalid_reasoning", "invalid_tool_call", "invalid_tool_arguments", "invalid_usage", "invalid_response_json", "invalid_response_body", "missing_choices"];
+type OpenAiChatResponseIssue = (typeof openAiChatResponseIssues)[number];
 declare const makeOpenAiProviderLayer: (config: OpenAiProviderConfig) => Layer.Layer<LLMProvider, never, HttpClient.HttpClient>;
 declare const OpenAiProviderLayer: Layer.Layer<LLMProvider, LLMError, never>;
 //#endregion
-export { OpenAiProviderConfig, OpenAiProviderLayer, OpenAiRequestExtras, makeOpenAiProviderLayer, toOpenAiRequestBody };
+export { OpenAiChatResponseIssue, OpenAiProviderConfig, OpenAiProviderLayer, OpenAiRequestExtras, makeOpenAiProviderLayer, openAiChatResponseIssues, toOpenAiRequestBody };
 //# sourceMappingURL=provider.d.mts.map

package/dist/providers/openai/provider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.mts","names":[],"sources":["../../../src/providers/openai/provider.ts"],"mappings":";;;;;;;KA+DK,sBAAA;EAAA,SACM,EAAA;EAAA,SACA,IAAI;AAAA;;KAIH,mBAAA;EAAA,UACA,GAAA,WAAc,QAAA,CAAO,IAAI;AAAA;AAAA,KAgJzB,oBAAA;EAAA,SACD,kBAAA;EAAA,SACA,mBAAA,UAlJC;EAAA,SAoJD,oBAAA;EAAA,SACA,YAAA,GAAe,QAAA,CAAS,MAAA;EArJE;AAAA;AAgJrC;;;EAhJqC,SA2J1B,SAAA,GAAY,mBAAA,EANG;EAAA,SAQf,qBAAA,4CAWmB;EAAA,SATnB,gBAAA;EAeiD;;;;EAAA,SAVjD,SAAA,YAlBA;EAAA,SAoBA,sBAAA,YAjBA;EAAA,SAmBA,gBAAA,GAAmB,sBAAA;EAAA,SACnB,MAAA,EAAQ,QAAA,CAAS,QAAA;EAdjB;;;;EAAA,SAmBA,eAAA,IAAmB,QAAA,aAAqB,QAAA,CAAS,MAAA;AAAA;AAAA,KAGvD,qBAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAI;AAAA;AAAA,KAGV,sBAAA;EAAA,SACM,IAAA;EAAA,SACA,SAAA;IAAA,SACE,GAAA;EAAA;AAAA;AAAA,KAIR,qBAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAA;IAAA,SACE,QAAA;IAAA,SACA,SAAA;EAAA;AAAA;AAAA,KAIR,iBAAA,YAED,aAAA,CAAc,qBAAA,GAAwB,sBAAA,GAAyB,qBAAA;AAAA,KAE9D,cAAA;EAAA,SACM,EAAA;EAAA,SACA,IAAA;EAAA,SACA,QAAA;IAAA,SACE,IAAA;IAAA,SACA,SAAA;EAAA;AAAA;AAAA,KAIR,aAAA;EAAA,SACU,IAAA;EAAA,SAAyB,OAAA;AAAA;EAAA,SACzB,IAAA;EAAA,SAAuB,OAAA,EAAS,iBAAA;AAAA;EAAA,SAEhC,IAAA;EAAA,SACA,OAAA;EAAA,SACA,UAAA,GAAa,aAAA,CAAc,cAAA;EAAA,SAC3B,iBAAA;AAAA;EAAA,SAEA,IAAA;EAAA,SAAuB,YAAA;EAAA,SAA+B,OAAA;AAAA;AAAA,KAEhE,UAAA;EAAA,SACM,IAAA;EAAA,SACA,QAAA;IAAA,SACE,IAAA;IAAA,SACA,WAAA;IAAA,SACA,UAAA,EAAY,QAAA,CAAO,IAAI;EAAA;AAAA;AAAA,KAI/B,iBAAA;EAAA,SACM,KAAA;EAAA,SACA,QAAA,EAAU,aAAA,CAAc,aAAA;EAAA,SACxB,qBAAA;EAAA,SACA,UAAA;EAAA,SACA,MAAA;EAAA,SACA,cAAA;IAAA,SACE,aAAA;EAAA;EAAA,SAEF,SAAA;IAAA,SACE,MAAA,EAAQ,oBAAA;EAAA;EAAA,SAEV,gBAAA,GAAmB,oBAAA;EAAA,SACnB,KAAA,GAAQ,aAAA,CAAc,UAAA;EAAA,SACtB,mBAAA;EAAA,SACA,WAAA;AAAA;AAAA,KAGN,aAAA,IAAiB,GAAA,aAAgB,MAAA,CAAO,MAAM,SAAS,QAAA;AAAA,KAEvD,uBAAA;EAAA,SACM,mBAAA;EAAA,SACA,oBAAA;EAAA,SACA,SAAA;EAAA,SACA,qBAAA;EAAA,SACA,gBAAA;EAAA,SACA,SAAA;EAAA,SACA,sBAAA;EAAA,SACA,aAAA,GAAgB,aAAa;EAAA,SAC7B,YAAA;AAAA;AAAA,cAioBE,mBAAA,GACX,OAAA,EAAS,UAAA,EACT,MAAA,EAAQ,uBAAA,KACP,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,QAAA;AAAA,cAm6BvB,uBAAA,GAA2B,MAAA,EAAQ,oBAAA,KAAoB,KAAA,CAAA,KAAA,CAAA,WAAA,SAAA,UAAA,CAAA,UAAA;AAAA,cAYvD,mBAAA,EAAmB,KAAA,CAAA,KAAA,CAAA,WAAA,EAAA,QAAA"}
+{"version":3,"file":"provider.d.mts","names":[],"sources":["../../../src/providers/openai/provider.ts"],"mappings":"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"}

package/dist/providers/openai/provider.mjs

@@ -203,7 +203,6 @@ const snapshotOpenAiRequestExtras = (extraBody, config, providerName) => {
 	}
 	return Effect.succeed(surviving);
 };
-const decodeJsonString = (raw, message) => Schema$1.decodeUnknownEffect(JsonFromJsonString)(raw).pipe(Effect.mapError(schemaErrorToLlmError("invalid_response", message)));
 const unsupportedContentError = (contentType, providerName) => new LLMError({
 	cause: "provider_error",
 	message: `${contentType} content is not supported by the ${providerName} provider yet`,
@@ -413,7 +412,12 @@ const toOpenAiRequestBody = (request, config) => Effect.gen(function* () {
 		...toolChoice
 	};
 });
-const parseToolArguments = (raw, providerName) => decodeJsonString(raw, `Invalid ${providerName} tool arguments JSON`);
+const parseToolArguments = (raw, providerIdentity, stream) => Schema$1.decodeUnknownEffect(JsonFromJsonString)(raw).pipe(Effect.mapError(chatSchemaIssueError({
+	providerIdentity,
+	issue: "invalid_tool_arguments",
+	message: `Invalid ${providerIdentity.name} tool arguments JSON`,
+	stream
+})));
 const toLlmEvents = (choice, providerIdentity, reasoningContent) => Effect.gen(function* () {
 	if (choice.finish_reason === "length" || choice.finish_reason === "content_filter") return yield* Effect.fail(new LLMError({
 		cause: "invalid_response",
@@ -426,11 +430,16 @@ const toLlmEvents = (choice, providerIdentity, reasoningContent) => Effect.gen(f
 		})
 	}));
 	const content = choice.message.content ?? "";
-	const reasoning = reasoningContent ? (yield* Schema$1.decodeUnknownEffect(Schema$1.NullOr(Schema$1.String))(choice.message.reasoning_content ?? choice.message.reasoning ?? null).pipe(Effect.mapError(schemaErrorToLlmError("invalid_response", `Invalid ${providerIdentity.name} reasoning content`)))) ?? "" : "";
+	const reasoning = reasoningContent ? (yield* Schema$1.decodeUnknownEffect(Schema$1.NullOr(Schema$1.String))(choice.message.reasoning_content ?? choice.message.reasoning ?? null).pipe(Effect.mapError(chatSchemaIssueError({
+		providerIdentity,
+		issue: "invalid_reasoning",
+		message: `Invalid ${providerIdentity.name} reasoning content`,
+		stream: void 0
+	})))) ?? "" : "";
 	const textEvents = [];
 	if (reasoning.length > 0) textEvents.push(LLMReasoningDelta$1.make({ text: reasoning }));
 	if (content.length > 0) textEvents.push(LLMTextDelta$1.make({ text: content }));
-	const toolCallEvents = yield* Effect.forEach(choice.message.tool_calls ?? [], (call) => parseToolArguments(call.function.arguments, providerIdentity.name).pipe(Effect.map((params) => LLMToolCall.make({ call: ToolCall.make({
+	const toolCallEvents = yield* Effect.forEach(choice.message.tool_calls ?? [], (call) => parseToolArguments(call.function.arguments, providerIdentity, void 0).pipe(Effect.map((params) => LLMToolCall.make({ call: ToolCall.make({
 		id: call.id,
 		name: call.function.name,
 		params
@@ -481,10 +490,56 @@ const chatSseBlockData = (block) => {
 		payload: data.length > 0 ? data : void 0
 	};
 };
-const invalidChatStreamEvent = (providerIdentity) => new LLMError({
+/**
+* `ProviderErrorInfo.providerCode` values (kind `invalid_response`) naming the check a Chat
+* Completions response failed. Fixed literals that never carry upstream values, so hosts can log
+* and persist them:
+*
+* - `invalid_stream_json`: an SSE `data:` payload is not JSON.
+* - `invalid_stream_chunk`: a stream chunk does not match the `chat.completion.chunk` shape.
+* - `invalid_reasoning`: reasoning content is neither a string nor null.
+* - `invalid_tool_call`: a streamed tool call has no id or no name.
+* - `invalid_tool_arguments`: tool call arguments are not JSON.
+* - `invalid_usage`: the usage block lacks its token counts.
+* - `invalid_response_json`: a JSON (non-streaming) response body is not JSON.
+* - `invalid_response_body`: a JSON response does not match the `chat.completion` shape.
+* - `missing_choices`: a JSON response has no choices.
+*/
+const openAiChatResponseIssues = [
+	"invalid_stream_json",
+	"invalid_stream_chunk",
+	"invalid_reasoning",
+	"invalid_tool_call",
+	"invalid_tool_arguments",
+	"invalid_usage",
+	"invalid_response_json",
+	"invalid_response_body",
+	"missing_choices"
+];
+const chatResponseIssueError = (input) => new LLMError({
 	cause: "invalid_response",
-	message: `Invalid ${providerIdentity.name} stream event`,
-	retryable: false
+	message: input.message,
+	retryable: false,
+	provider: input.stream === void 0 ? providerErrorInfo({
+		provider: input.providerIdentity.id,
+		kind: "invalid_response",
+		providerCode: input.issue
+	}) : providerErrorInfo({
+		provider: input.providerIdentity.id,
+		kind: "invalid_response",
+		providerCode: input.issue,
+		stream: input.stream
+	})
+});
+const chatSchemaIssueError = (input) => (error) => chatResponseIssueError({
+	...input,
+	message: `${input.message}: ${schemaErrorMessage(error)}`
+});
+const invalidChatStreamEvent = (context, issue, state) => chatResponseIssueError({
+	providerIdentity: context.providerIdentity,
+	issue,
+	message: `Invalid ${context.providerIdentity.name} stream event`,
+	stream: chatStreamDiagnostics(context.responseFormat, state)
 });
 const chatStreamError = (providerIdentity, raw) => Effect.gen(function* () {
 	const errorCode = yield* decodeOpenAiHttpErrorCode(raw);
@@ -511,20 +566,20 @@ const mergeChatToolCallDelta = (toolCalls, delta) => {
 	};
 	return [...toolCalls.filter((call) => call.index !== index), merged];
 };
-const decodeChatDeltaReasoning = (providerIdentity, reasoning) => Schema$1.decodeUnknownEffect(Schema$1.NullOr(Schema$1.String))(reasoning).pipe(Effect.map((value) => value ?? ""), Effect.mapError(() => invalidChatStreamEvent(providerIdentity)));
-const processChatStreamPayload = (providerIdentity, reasoningContent, state, payload) => Effect.gen(function* () {
-	const parsed = yield* Schema$1.decodeUnknownEffect(JsonFromJsonString)(payload).pipe(Effect.mapError(() => invalidChatStreamEvent(providerIdentity)));
+const decodeChatDeltaReasoning = (context, state, reasoning) => Schema$1.decodeUnknownEffect(Schema$1.NullOr(Schema$1.String))(reasoning).pipe(Effect.map((value) => value ?? ""), Effect.mapError(() => invalidChatStreamEvent(context, "invalid_reasoning", state)));
+const processChatStreamPayload = (context, state, payload) => Effect.gen(function* () {
+	const parsed = yield* Schema$1.decodeUnknownEffect(JsonFromJsonString)(payload).pipe(Effect.mapError(() => invalidChatStreamEvent(context, "invalid_stream_json", state)));
 	const envelope = isJsonRecord(parsed) ? jsonRecordField(parsed, "error") : void 0;
-	if (envelope !== void 0 && isJsonRecord(envelope)) return yield* chatStreamError(providerIdentity, payload);
-	const chunk = yield* Schema$1.decodeUnknownEffect(OpenAiChatStreamChunk)(parsed).pipe(Effect.mapError(() => invalidChatStreamEvent(providerIdentity)));
+	if (envelope !== void 0 && isJsonRecord(envelope)) return yield* chatStreamError(context.providerIdentity, payload);
+	const chunk = yield* Schema$1.decodeUnknownEffect(OpenAiChatStreamChunk)(parsed).pipe(Effect.mapError(() => invalidChatStreamEvent(context, "invalid_stream_chunk", state)));
 	const events = [];
 	let toolCalls = state.toolCalls;
 	let finishReason = state.finishReason;
 	let usage = state.usage;
 	for (const choice of chunk.choices ?? []) {
 		if (choice.delta?.content) events.push(LLMTextDelta$1.make({ text: choice.delta.content }));
-		if (reasoningContent && (choice.delta?.reasoning_content != null || choice.delta?.reasoning != null)) {
-			const reasoning = yield* decodeChatDeltaReasoning(providerIdentity, choice.delta.reasoning_content ?? choice.delta.reasoning ?? null);
+		if (context.reasoningContent && (choice.delta?.reasoning_content != null || choice.delta?.reasoning != null)) {
+			const reasoning = yield* decodeChatDeltaReasoning(context, state, choice.delta.reasoning_content ?? choice.delta.reasoning ?? null);
 			if (reasoning.length > 0) events.push(LLMReasoningDelta$1.make({ text: reasoning }));
 		}
 		for (const call of choice.delta?.tool_calls ?? []) toolCalls = mergeChatToolCallDelta(toolCalls, call);
@@ -544,7 +599,7 @@ const processChatStreamPayload = (providerIdentity, reasoningContent, state, pay
 		events
 	};
 });
-const processChatStreamBlock = (providerIdentity, reasoningContent, state, block) => Effect.gen(function* () {
+const processChatStreamBlock = (context, state, block) => Effect.gen(function* () {
 	if (state.streamClosed) return {
 		state,
 		events: []
@@ -559,7 +614,7 @@ const processChatStreamBlock = (providerIdentity, reasoningContent, state, block
 		state: current,
 		events: []
 	};
-	return yield* processChatStreamPayload(providerIdentity, reasoningContent, current, payload);
+	return yield* processChatStreamPayload(context, current, payload);
 });
 const chatStreamDiagnostics = (responseFormat, state) => ProviderStreamDiagnostics.make({
 	protocol: "chat-completions",
@@ -569,7 +624,7 @@ const chatStreamDiagnostics = (responseFormat, state) => ProviderStreamDiagnosti
 	outputStarted: state.outputStarted,
 	terminalSeen: state.hasTerminal
 });
-const processChatStreamText = (providerIdentity, reasoningContent, state, text) => Effect.gen(function* () {
+const processChatStreamText = (context, state, text) => Effect.gen(function* () {
 	const split = splitCompleteChatSseBlocks(`${state.buffer}${text}`);
 	let current = {
 		...state,
@@ -577,7 +632,7 @@ const processChatStreamText = (providerIdentity, reasoningContent, state, text)
 	};
 	const events = [];
 	for (const block of split.completeBlocks) {
-		const step = yield* processChatStreamBlock(providerIdentity, reasoningContent, current, block);
+		const step = yield* processChatStreamBlock(context, current, block);
 		current = step.state;
 		events.push(...step.events);
 	}
@@ -586,7 +641,8 @@ const processChatStreamText = (providerIdentity, reasoningContent, state, text)
 		events
 	};
 });
-const finalizeChatStreamState = (providerIdentity, responseFormat, state) => Effect.gen(function* () {
+const finalizeChatStreamState = (context, state) => Effect.gen(function* () {
+	const { providerIdentity, responseFormat } = context;
 	if (!state.hasTerminal) return yield* Effect.fail(new LLMError({
 		cause: "invalid_response",
 		message: `${providerIdentity.name} stream ended before a terminal chunk`,
@@ -625,12 +681,13 @@ const finalizeChatStreamState = (providerIdentity, responseFormat, state) => Eff
 	const toolCallEvents = yield* Effect.forEach(orderedCalls, (call) => {
 		const id = call.id;
 		const name = call.name;
-		if (id === void 0 || name === void 0) return Effect.fail(new LLMError({
-			cause: "invalid_response",
+		if (id === void 0 || name === void 0) return Effect.fail(chatResponseIssueError({
+			providerIdentity,
+			issue: "invalid_tool_call",
 			message: `Invalid ${providerIdentity.name} streamed tool call`,
-			retryable: false
+			stream: chatStreamDiagnostics(responseFormat, state)
 		}));
-		return parseToolArguments(call.arguments, providerIdentity.name).pipe(Effect.map((params) => LLMToolCall.make({ call: ToolCall.make({
+		return parseToolArguments(call.arguments, providerIdentity, chatStreamDiagnostics(responseFormat, state)).pipe(Effect.map((params) => LLMToolCall.make({ call: ToolCall.make({
 			id,
 			name,
 			params
@@ -639,7 +696,7 @@ const finalizeChatStreamState = (providerIdentity, responseFormat, state) => Eff
 	const events = [...toolCallEvents];
 	events.push(LLMDone.make({ stopReason: toolCallEvents.length > 0 ? "tool_use" : "stop" }));
 	if (state.usage !== void 0) {
-		const usage = yield* Schema$1.decodeUnknownEffect(OpenAiUsageResponse)(state.usage).pipe(Effect.mapError(() => invalidChatStreamEvent(providerIdentity)));
+		const usage = yield* Schema$1.decodeUnknownEffect(OpenAiUsageResponse)(state.usage).pipe(Effect.mapError(() => invalidChatStreamEvent(context, "invalid_usage", state)));
 		events.push(LLMUsage.make({ usage: toAgentUsage(usage) }));
 	}
 	return events;
@@ -675,15 +732,20 @@ const expectChatSseResponse = (providerIdentity, response) => {
 	}));
 };
 const streamOpenAiChatResponse = (providerIdentity, reasoningContent, responseFormat, response) => Stream.unwrap(Ref.make(initialOpenAiChatStreamState).pipe(Effect.map((stateRef) => {
+	const context = {
+		providerIdentity,
+		reasoningContent,
+		responseFormat
+	};
 	const chunks = response.stream.pipe(Stream.mapError(toHttpClientLlmError(providerIdentity, true)), Stream.tap((chunk) => Ref.update(stateRef, (state) => ({
 		...state,
 		receivedBytes: state.receivedBytes + chunk.byteLength
 	}))), Stream.decodeText, Stream.mapEffect((chunk) => Effect.gen(function* () {
-		const step = yield* processChatStreamText(providerIdentity, reasoningContent, yield* Ref.get(stateRef), chunk);
+		const step = yield* processChatStreamText(context, yield* Ref.get(stateRef), chunk);
 		yield* Ref.set(stateRef, step.state);
 		return step.events;
 	})), Stream.flatMap((events) => Stream.fromIterable(events)));
-	const finalEvents = Stream.fromEffect(Ref.get(stateRef).pipe(Effect.flatMap((state) => finalizeChatStreamState(providerIdentity, responseFormat, state)))).pipe(Stream.flatMap((events) => Stream.fromIterable(events)));
+	const finalEvents = Stream.fromEffect(Ref.get(stateRef).pipe(Effect.flatMap((state) => finalizeChatStreamState(context, state)))).pipe(Stream.flatMap((events) => Stream.fromIterable(events)));
 	return chunks.pipe(Stream.concat(finalEvents));
 })));
 const toHttpClientLlmError = (providerIdentity, retryable) => (error) => new LLMError({
@@ -695,13 +757,19 @@ const toHttpClientLlmError = (providerIdentity, retryable) => (error) => new LLM
 		kind: retryable ? "network" : "unknown"
 	})
 });
-const parseOpenAiResponseJson = (response, providerName) => Effect.gen(function* () {
-	const raw = yield* response.json.pipe(Effect.mapError((error) => new LLMError({
-		cause: "invalid_response",
-		message: `Could not parse ${providerName} response JSON: ${error.message}`,
-		retryable: false
+const parseOpenAiResponseJson = (response, providerIdentity) => Effect.gen(function* () {
+	const raw = yield* response.json.pipe(Effect.mapError((error) => chatResponseIssueError({
+		providerIdentity,
+		issue: "invalid_response_json",
+		message: `Could not parse ${providerIdentity.name} response JSON: ${error.message}`,
+		stream: void 0
+	})));
+	return yield* Schema$1.decodeUnknownEffect(Schema$1.Json)(raw).pipe(Effect.mapError(chatSchemaIssueError({
+		providerIdentity,
+		issue: "invalid_response_json",
+		message: `Could not parse ${providerIdentity.name} response JSON`,
+		stream: void 0
 	})));
-	return yield* Schema$1.decodeUnknownEffect(Schema$1.Json)(raw).pipe(Effect.mapError(schemaErrorToLlmError("invalid_response", `Could not parse ${providerName} response JSON`)));
 });
 const openAiRequestBodyFields = (config, providerIdentity, resolvePdfUrl) => {
 	const fields = {
@@ -772,13 +840,19 @@ const sendOpenAiRequestBody = (config, request, providerIdentity, client) => Eff
 });
 const sendOpenAiRequest = (config, request, client) => Effect.gen(function* () {
 	const providerIdentity = config.providerIdentity ?? defaultOpenAiProviderIdentity;
-	const json = yield* parseOpenAiResponseJson(yield* postOpenAiRequest(config, providerIdentity, yield* sendOpenAiRequestBody(config, request, providerIdentity, client), client, request.cacheKey), providerIdentity.name);
-	const parsed = yield* Schema$1.decodeUnknownEffect(OpenAiChatCompletionResponse)(json).pipe(Effect.mapError(schemaErrorToLlmError("invalid_response", `Invalid ${providerIdentity.name} response`)));
+	const json = yield* parseOpenAiResponseJson(yield* postOpenAiRequest(config, providerIdentity, yield* sendOpenAiRequestBody(config, request, providerIdentity, client), client, request.cacheKey), providerIdentity);
+	const parsed = yield* Schema$1.decodeUnknownEffect(OpenAiChatCompletionResponse)(json).pipe(Effect.mapError(chatSchemaIssueError({
+		providerIdentity,
+		issue: "invalid_response_body",
+		message: `Invalid ${providerIdentity.name} response`,
+		stream: void 0
+	})));
 	const choice = parsed.choices[0];
-	if (choice === void 0) return yield* Effect.fail(new LLMError({
-		cause: "invalid_response",
+	if (choice === void 0) return yield* Effect.fail(chatResponseIssueError({
+		providerIdentity,
+		issue: "missing_choices",
 		message: `${providerIdentity.name} response contained no choices`,
-		retryable: false
+		stream: void 0
 	}));
 	const events = yield* toLlmEvents(choice, providerIdentity, config.reasoningContent ?? false);
 	if (parsed.usage === void 0) return events;
@@ -801,6 +875,6 @@ const OpenAiProviderLayer = Layer.effect(LLMProvider, Effect.gen(function* () {
 	return LLMProvider.of({ stream: (request) => openAiProviderStream(config, request, client) });
 })).pipe(Layer.provide(Layer.mergeAll(OpenAiConfigLayer, FetchHttpClient.layer)));
 //#endregion
-export { OpenAiProviderLayer, makeOpenAiProviderLayer, toOpenAiRequestBody };
+export { OpenAiProviderLayer, makeOpenAiProviderLayer, openAiChatResponseIssues, toOpenAiRequestBody };
 
 //# sourceMappingURL=provider.mjs.map