@yolk-sdk/agent 0.1.0-canary.57 → 0.1.0-canary.59

package/README.md

@@ -10,7 +10,7 @@ Root export is intentionally tiny. Import feature APIs from explicit subpaths.
 pnpm add @yolk-sdk/agent@canary effect
 ```
 
-Add `react` if you use `@yolk-sdk/agent/react`.
+Add `react` if you use `@yolk-sdk/agent/react` or `@yolk-sdk/agent/voice/react`.
 
 Canary APIs are unstable. Keep all `@yolk-sdk/*` packages on the same version.
 Published package metadata requires Node.js 22+.
@@ -30,13 +30,19 @@ Published package metadata requires Node.js 22+.
 | `@yolk-sdk/agent/oauth`                               | Provider-neutral OAuth token and broker contracts              |
 | `@yolk-sdk/agent/providers/openai`                    | OpenAI/Codex OAuth and broker helpers                          |
 | `@yolk-sdk/agent/providers/openai/codex`              | OpenAI Codex request and auth helpers                          |
+| `@yolk-sdk/agent/providers/openai/codex-usage`        | Codex subscription-allowance snapshots                         |
 | `@yolk-sdk/agent/providers/openai/codex-provider`     | Codex LLM provider factory                                     |
 | `@yolk-sdk/agent/providers/openai/provider`           | OpenAI-compatible LLM provider factory                         |
 | `@yolk-sdk/agent/providers/openai/realtime`           | OpenAI Realtime session config and event codecs                |
 | `@yolk-sdk/agent/providers/openai/speech`             | OpenAI text-to-speech and transcription adapters               |
 | `@yolk-sdk/agent/providers/anthropic`                 | Anthropic/Claude OAuth and broker helpers                      |
 | `@yolk-sdk/agent/providers/anthropic/claude`          | Claude request and auth helpers                                |
+| `@yolk-sdk/agent/providers/anthropic/usage`           | Claude subscription-allowance snapshots                        |
 | `@yolk-sdk/agent/providers/anthropic/claude-provider` | Claude LLM provider factory                                    |
+| `@yolk-sdk/agent/providers/xai`                       | Grok subscription OAuth and token broker helpers               |
+| `@yolk-sdk/agent/providers/xai/grok`                  | Grok subscription request and auth helpers                     |
+| `@yolk-sdk/agent/providers/xai/grok-provider`         | Grok subscription LLM provider factory                         |
+| `@yolk-sdk/agent/providers/subscription-usage`        | Shared allowance snapshot and safe error schemas               |
 | `@yolk-sdk/agent/skillset`                            | Portable skill and slash-command parsing/catalogs              |
 | `@yolk-sdk/agent/voice`                               | Voice protocol, controller, tool handler, projection, speech   |
 | `@yolk-sdk/agent/voice/browser`                       | Browser WebRTC voice transport                                 |
@@ -91,6 +97,18 @@ Test helpers live behind their own subpath:
 import { FauxProvider, Reply, TestToolExecutor } from '@yolk-sdk/agent/loop/testing'
 ```
 
+## Headless React chat
+
+`useAgentChat` exposes protocol messages, render-oriented chat messages, run/error/waiting state,
+and actions for submit, stop, edit, regenerate, delete, tool approval, and question responses. The
+package supplies no components, styling, auth, or route ownership, and React remains an optional
+peer used only by React subpaths.
+
+By default the hook streams HTTP/NDJSON through `@yolk-sdk/agent/client`. Pass an
+`AgentChatTransport` through the `transport` option to use another runtime. A custom transport
+receives the transcript, session/model options, HITL responses, and an `AbortSignal`, and returns an
+`AsyncIterable<AgentEvent>`; the host still owns endpoint auth and persistence.
+
 ## Quick start
 
 ```ts
@@ -137,12 +155,22 @@ limits or apply hidden fallbacks.
 | `makeOpenAiProviderLayer`          | `maxCompletionTokens` |
 | `makeOpenAiCodexProviderLayer`     | none                  |
 | `makeAnthropicClaudeProviderLayer` | `maxTokens`           |
-
-The public `toOpenAiRequestBody` and `toAnthropicClaudeRequestBody` helpers require the matching
-limit configuration. ChatGPT subscription Codex rejects vendor `max_output_tokens`, so
-`makeOpenAiCodexProviderLayer` and `toOpenAiCodexRequestBody` ignore the optional deprecated
-`maxOutputTokens` compatibility field. `OpenAiProviderLayer` reads both `OPENAI_API_KEY` and integer
-`OPENAI_MAX_COMPLETION_TOKENS` through Effect Config.
+| `makeXAiGrokProviderLayer`         | `maxOutputTokens`     |
+
+The public `toOpenAiRequestBody`, `toAnthropicClaudeRequestBody`, and `toXAiGrokRequestBody` helpers
+require the matching limit configuration. ChatGPT subscription Codex rejects vendor
+`max_output_tokens`, so `makeOpenAiCodexProviderLayer` and `toOpenAiCodexRequestBody` ignore the
+optional deprecated `maxOutputTokens` compatibility field. `OpenAiProviderLayer` reads both
+`OPENAI_API_KEY` and integer `OPENAI_MAX_COMPLETION_TOKENS` through Effect Config.
+
+Grok subscription access uses `https://cli-chat-proxy.grok.com/v1/responses`, not the xAI developer
+API-key endpoint. The adapter sends the required CLI-session and model-routing headers and rejects
+mismatched or expired access-token envelopes before HTTP. The package exports browser-PKCE and
+device-flow constants; hosts own the callback listener or device polling, token exchange/refresh,
+secure storage, and model discovery. Only set `responsesUrl` to a trusted proxy because it receives
+the OAuth bearer. xAI controls the public CLI OAuth client and private, unsupported proxy contract,
+so hosts should treat those surfaces as changeable and confirm that their use complies with xAI
+terms.
 
 Set optional `reasoningEffort` on `run` or `runRuntime`; provider adapters lower it to vendor
 configuration. Anthropic Claude forwards `low`, `medium`, `high`, and `xhigh` through
@@ -180,6 +208,37 @@ policy and emits protocol-visible retry/error state:
 Raw provider response bodies stay out of protocol/UI. Hosts own durable persistence and display of
 typed retry/error state.
 
+## Subscription allowance snapshots
+
+The Claude and Codex usage adapters read best-effort consumer subscription allowance percentages and
+reset windows. Claude currently normalizes its aggregate five-hour and seven-day windows; Codex
+normalizes its primary and secondary rate-limit windows. Additional provider-specific buckets are
+ignored. These private provider endpoints may change without notice. Pass a fresh
+host-owned `OAuthAccessToken` and provide an Effect `HttpClient`:
+
+```ts
+import { Effect } from 'effect'
+import { FetchHttpClient } from 'effect/unstable/http'
+import { fetchOpenAiCodexSubscriptionUsage } from '@yolk-sdk/agent/providers/openai/codex-usage'
+
+const snapshot = await fetchOpenAiCodexSubscriptionUsage(hostOAuthAccessToken).pipe(
+  Effect.provide(FetchHttpClient.layer),
+  Effect.runPromise
+)
+```
+
+Use `fetchAnthropicClaudeSubscriptionUsage` from
+`@yolk-sdk/agent/providers/anthropic/usage` for Claude. Provider adapters return an immutable Effect
+`Chunk` of semantic window ids, percentages, and optional reset/duration fields; hosts own labels,
+polling, persistence, stale-data
+policy, alert thresholds, billing interpretation, and UI. Configure `requestTimeoutMs` at the
+server integration boundary. Endpoint origins stay fixed, and `FetchHttpClient.layer` is configured
+for manual redirects. A custom `HttpClient` must not follow redirects for these credential-bearing
+requests.
+
+Subscription allowance snapshots are separate from protocol `AgentUsage`, which accounts for tokens
+used by model requests and nested model work.
+
 ## Usage accounting
 
 Provider `LLMUsage` events are additive deltas. Adapters normalize vendor counters before emitting;
@@ -242,7 +301,9 @@ inside one source fail validation. Hosts own file discovery, storage, enablement
 
 Build sources with `inlineBase64AttachmentSource`, `urlAttachmentSource`, or
 `refAttachmentSource`. Providers can pass through supported media URLs: OpenAI Chat supports image
-URLs; OpenAI Codex supports image and document URLs; Anthropic supports image and PDF URLs. Use
+URLs; OpenAI Codex supports image and document URLs; Anthropic supports image and PDF URLs. The Grok
+Responses lowerer can encode image URLs/data URLs, but hosts should enable image capability only for
+subscription models they have verified accept image input. Use
 inline base64 for simple apps, durable URLs for app-owned uploads, or persist `Ref` values and call
 `resolveContentAttachmentSources` at your storage boundary before provider execution. Host apps own
 upload, auth, retention, URL durability, and ref hydration policy.
@@ -330,7 +391,7 @@ replay.
 
 ## Parallel tool calls
 
-OpenAI and OpenAI Codex requests enable vendor parallel tool calls when tools are available. The
+OpenAI, OpenAI Codex, and Grok requests enable vendor parallel tool calls when tools are available. The
 Codex stream adapter preserves every sibling function call and suppresses final-response replays
 by call id. The loop executes calls emitted in the same model turn concurrently, bounded by the
 host-configured `LoopConfig.toolConcurrency`; dependent work waits for the next model turn.
@@ -405,10 +466,10 @@ handler, approval HITL, transcript projection, and one-shot TTS/STT contracts.
 
 - `useYolkVoice` (`@yolk-sdk/agent/voice/react`) owns browser session lifecycle, user drafts,
   and pending approvals; provider codecs come from `@yolk-sdk/agent/providers/openai/realtime`.
-- Tools execute server-side only: the controller forwards provider tool calls as
-  `VoiceSessionToolCallRequest` to your endpoint; `handleVoiceToolCall` applies
-  `ToolDef.approval` policy and never runs approval-gated tools without a matching approved
-  response.
+- Tools execute server-side only: the controller forwards the normalized
+  `VoiceSessionToolCallRequest` JSON envelope to your endpoint; `handleVoiceToolCall` returns a
+  JSON-compatible `VoiceToolCallOutcome` envelope, applies `ToolDef.approval` policy, and never runs
+  approval-gated tools without a matching approved response.
 - Approval-gated calls pause with `AwaitingInput`; approvals/denials resume through
   `submitHitlResponse`. Voice `question` is deferred in v1.
 - `projectVoiceEvent` turns voice events into protocol messages with no dangling host tool

package/dist/providers/anthropic/usage.d.mts

@@ -0,0 +1,15 @@
+import { ProviderSubscriptionUsageError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot } from "../subscription-usage.mjs";
+import { Effect } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { OAuthAccessToken } from "@yolk-sdk/agent/oauth";
+
+//#region src/providers/anthropic/usage.d.ts
+declare const anthropicClaudeSubscriptionUsageUrl = "https://api.anthropic.com/api/oauth/usage";
+type AnthropicClaudeSubscriptionUsageOptions = {
+  readonly requestTimeoutMs?: number;
+};
+declare const parseAnthropicClaudeSubscriptionUsage: (value: unknown, fetchedAt: string) => Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError>;
+declare const fetchAnthropicClaudeSubscriptionUsage: (token: OAuthAccessToken, options?: AnthropicClaudeSubscriptionUsageOptions) => Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageError, HttpClient.HttpClient>;
+//#endregion
+export { AnthropicClaudeSubscriptionUsageOptions, anthropicClaudeSubscriptionUsageUrl, fetchAnthropicClaudeSubscriptionUsage, parseAnthropicClaudeSubscriptionUsage };
+//# sourceMappingURL=usage.d.mts.map

package/dist/providers/anthropic/usage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.mts","names":[],"sources":["../../../src/providers/anthropic/usage.ts"],"mappings":";;;;;;cAqBa,mCAAA;AAAA,KAED,uCAAA;EAAA,SACD,gBAAgB;AAAA;AAAA,cAoBd,qCAAA,GACX,KAAA,WACA,SAAA,aACC,MAAA,CAAO,MAAA,CAAO,iCAAA,EAAmC,sCAAA;AAAA,cAuDvC,qCAAA,GACX,KAAA,EAAO,gBAAA,EACP,OAAA,GAAS,uCAAA,KACR,MAAA,CAAO,MAAA,CACR,iCAAA,EACA,8BAAA,EACA,UAAA,CAAW,UAAA"}

package/dist/providers/anthropic/usage.mjs

@@ -0,0 +1,73 @@
+import { ProviderSubscriptionUsageConfigurationError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageWindow } from "../subscription-usage.mjs";
+import { canonicalSubscriptionUsageInstant, executeProviderSubscriptionUsageRequest, readProviderSubscriptionUsageJson, validProviderSubscriptionUsageTimeout, validSubscriptionUsagePercent } from "../subscription-usage-internal.mjs";
+import { anthropicClaudeAuthorizationHeaders, anthropicClaudeProviderId } from "./claude.mjs";
+import { Chunk, Clock, Effect } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as Schema from "effect/Schema";
+//#region src/providers/anthropic/usage.ts
+const anthropicClaudeSubscriptionUsageUrl = "https://api.anthropic.com/api/oauth/usage";
+const NullableNumber = Schema.NullOr(Schema.Number);
+const NullableString = Schema.NullOr(Schema.String);
+var AnthropicClaudeSubscriptionUsageWindowWire = class extends Schema.Class("AnthropicClaudeSubscriptionUsageWindowWire")({
+	utilization: Schema.optional(NullableNumber),
+	resets_at: Schema.optional(NullableString)
+}) {};
+var AnthropicClaudeSubscriptionUsageWire = class extends Schema.Class("AnthropicClaudeSubscriptionUsageWire")({
+	five_hour: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire)),
+	seven_day: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire))
+}) {};
+const parseAnthropicClaudeSubscriptionUsage = (value, fetchedAt) => {
+	const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt);
+	if (canonicalFetchedAt === void 0) return Effect.fail(ProviderSubscriptionUsageResponseError.make({
+		provider: anthropicClaudeProviderId,
+		category: "invalid_response"
+	}));
+	return Schema.decodeUnknownEffect(AnthropicClaudeSubscriptionUsageWire)(value).pipe(Effect.map((decoded) => {
+		const windows = [];
+		const append = (wire, id) => {
+			if (!validSubscriptionUsagePercent(wire?.utilization)) return;
+			const resetValue = wire.resets_at === null ? void 0 : wire.resets_at;
+			const resetsAt = resetValue === void 0 ? void 0 : canonicalSubscriptionUsageInstant(resetValue);
+			windows.push(ProviderSubscriptionUsageWindow.make({
+				id,
+				usedPercent: wire.utilization,
+				...resetsAt === void 0 ? {} : { resetsAt }
+			}));
+		};
+		append(decoded.five_hour, "five-hour");
+		append(decoded.seven_day, "seven-day");
+		return ProviderSubscriptionUsageSnapshot.make({
+			provider: anthropicClaudeProviderId,
+			fetchedAt: canonicalFetchedAt,
+			windows: Chunk.fromIterable(windows)
+		});
+	}), Effect.mapError(() => ProviderSubscriptionUsageResponseError.make({
+		provider: anthropicClaudeProviderId,
+		category: "invalid_response"
+	})), Effect.withSpan("AnthropicClaudeSubscriptionUsage.parse"));
+};
+const fetchAnthropicClaudeSubscriptionUsage = (token, options = {}) => Effect.gen(function* () {
+	if (token.provider !== "anthropic-claude") return yield* Effect.fail(ProviderSubscriptionUsageConfigurationError.make({
+		provider: anthropicClaudeProviderId,
+		reason: "provider_mismatch"
+	}));
+	const requestTimeoutMs = options.requestTimeoutMs ?? 1e4;
+	if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) return yield* Effect.fail(ProviderSubscriptionUsageConfigurationError.make({
+		provider: anthropicClaudeProviderId,
+		reason: "invalid_request_timeout"
+	}));
+	return yield* parseAnthropicClaudeSubscriptionUsage(yield* readProviderSubscriptionUsageJson(anthropicClaudeProviderId, yield* executeProviderSubscriptionUsageRequest({
+		provider: anthropicClaudeProviderId,
+		client: yield* HttpClient.HttpClient,
+		request: HttpClientRequest.get(anthropicClaudeSubscriptionUsageUrl).pipe(HttpClientRequest.setHeaders({
+			accept: "application/json",
+			...anthropicClaudeAuthorizationHeaders(token),
+			"anthropic-beta": "oauth-2025-04-20"
+		})),
+		timeoutMs: requestTimeoutMs
+	})), new Date(yield* Clock.currentTimeMillis).toISOString());
+}).pipe(Effect.withSpan("AnthropicClaudeSubscriptionUsage.fetch"));
+//#endregion
+export { anthropicClaudeSubscriptionUsageUrl, fetchAnthropicClaudeSubscriptionUsage, parseAnthropicClaudeSubscriptionUsage };
+
+//# sourceMappingURL=usage.mjs.map

package/dist/providers/anthropic/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","names":[],"sources":["../../../src/providers/anthropic/usage.ts"],"sourcesContent":["import { Chunk, Clock, Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { HttpClient, HttpClientRequest } from 'effect/unstable/http'\nimport type { OAuthAccessToken } from '@yolk-sdk/agent/oauth'\nimport { anthropicClaudeAuthorizationHeaders, anthropicClaudeProviderId } from './claude.ts'\nimport {\n  canonicalSubscriptionUsageInstant,\n  defaultProviderSubscriptionUsageTimeoutMs,\n  executeProviderSubscriptionUsageRequest,\n  readProviderSubscriptionUsageJson,\n  validProviderSubscriptionUsageTimeout,\n  validSubscriptionUsagePercent\n} from '../subscription-usage-internal.ts'\nimport {\n  ProviderSubscriptionUsageConfigurationError,\n  type ProviderSubscriptionUsageError,\n  ProviderSubscriptionUsageResponseError,\n  ProviderSubscriptionUsageSnapshot,\n  ProviderSubscriptionUsageWindow\n} from '../subscription-usage.ts'\n\nexport const anthropicClaudeSubscriptionUsageUrl = 'https://api.anthropic.com/api/oauth/usage'\n\nexport type AnthropicClaudeSubscriptionUsageOptions = {\n  readonly requestTimeoutMs?: number\n}\n\nconst NullableNumber = Schema.NullOr(Schema.Number)\nconst NullableString = Schema.NullOr(Schema.String)\n\nclass AnthropicClaudeSubscriptionUsageWindowWire extends Schema.Class<AnthropicClaudeSubscriptionUsageWindowWire>(\n  'AnthropicClaudeSubscriptionUsageWindowWire'\n)({\n  utilization: Schema.optional(NullableNumber),\n  resets_at: Schema.optional(NullableString)\n}) {}\n\nclass AnthropicClaudeSubscriptionUsageWire extends Schema.Class<AnthropicClaudeSubscriptionUsageWire>(\n  'AnthropicClaudeSubscriptionUsageWire'\n)({\n  five_hour: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire)),\n  seven_day: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire))\n}) {}\n\nexport const parseAnthropicClaudeSubscriptionUsage = (\n  value: unknown,\n  fetchedAt: string\n): Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError> => {\n  const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt)\n\n  if (canonicalFetchedAt === undefined) {\n    return Effect.fail(\n      ProviderSubscriptionUsageResponseError.make({\n        provider: anthropicClaudeProviderId,\n        category: 'invalid_response'\n      })\n    )\n  }\n\n  return Schema.decodeUnknownEffect(AnthropicClaudeSubscriptionUsageWire)(value).pipe(\n    Effect.map(decoded => {\n      const windows: Array<ProviderSubscriptionUsageWindow> = []\n      const append = (\n        wire: AnthropicClaudeSubscriptionUsageWindowWire | null | undefined,\n        id: 'five-hour' | 'seven-day'\n      ) => {\n        if (!validSubscriptionUsagePercent(wire?.utilization)) {\n          return\n        }\n\n        const resetValue = wire.resets_at === null ? undefined : wire.resets_at\n        const resetsAt =\n          resetValue === undefined ? undefined : canonicalSubscriptionUsageInstant(resetValue)\n\n        windows.push(\n          ProviderSubscriptionUsageWindow.make({\n            id,\n            usedPercent: wire.utilization,\n            ...(resetsAt === undefined ? {} : { resetsAt })\n          })\n        )\n      }\n\n      append(decoded.five_hour, 'five-hour')\n      append(decoded.seven_day, 'seven-day')\n\n      return ProviderSubscriptionUsageSnapshot.make({\n        provider: anthropicClaudeProviderId,\n        fetchedAt: canonicalFetchedAt,\n        windows: Chunk.fromIterable(windows)\n      })\n    }),\n    Effect.mapError(() =>\n      ProviderSubscriptionUsageResponseError.make({\n        provider: anthropicClaudeProviderId,\n        category: 'invalid_response'\n      })\n    ),\n    Effect.withSpan('AnthropicClaudeSubscriptionUsage.parse')\n  )\n}\n\nexport const fetchAnthropicClaudeSubscriptionUsage = (\n  token: OAuthAccessToken,\n  options: AnthropicClaudeSubscriptionUsageOptions = {}\n): Effect.Effect<\n  ProviderSubscriptionUsageSnapshot,\n  ProviderSubscriptionUsageError,\n  HttpClient.HttpClient\n> =>\n  Effect.gen(function* () {\n    if (token.provider !== anthropicClaudeProviderId) {\n      return yield* Effect.fail(\n        ProviderSubscriptionUsageConfigurationError.make({\n          provider: anthropicClaudeProviderId,\n          reason: 'provider_mismatch'\n        })\n      )\n    }\n\n    const requestTimeoutMs = options.requestTimeoutMs ?? defaultProviderSubscriptionUsageTimeoutMs\n\n    if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) {\n      return yield* Effect.fail(\n        ProviderSubscriptionUsageConfigurationError.make({\n          provider: anthropicClaudeProviderId,\n          reason: 'invalid_request_timeout'\n        })\n      )\n    }\n\n    const client = yield* HttpClient.HttpClient\n    const request = HttpClientRequest.get(anthropicClaudeSubscriptionUsageUrl).pipe(\n      HttpClientRequest.setHeaders({\n        accept: 'application/json',\n        ...anthropicClaudeAuthorizationHeaders(token),\n        'anthropic-beta': 'oauth-2025-04-20'\n      })\n    )\n    const response = yield* executeProviderSubscriptionUsageRequest({\n      provider: anthropicClaudeProviderId,\n      client,\n      request,\n      timeoutMs: requestTimeoutMs\n    })\n    const json = yield* readProviderSubscriptionUsageJson(anthropicClaudeProviderId, response)\n    const fetchedAt = new Date(yield* Clock.currentTimeMillis).toISOString()\n\n    return yield* parseAnthropicClaudeSubscriptionUsage(json, fetchedAt)\n  }).pipe(Effect.withSpan('AnthropicClaudeSubscriptionUsage.fetch'))\n"],"mappings":";;;;;;;AAqBA,MAAa,sCAAsC;AAMnD,MAAM,iBAAiB,OAAO,OAAO,OAAO,MAAM;AAClD,MAAM,iBAAiB,OAAO,OAAO,OAAO,MAAM;AAElD,IAAM,6CAAN,cAAyD,OAAO,MAC9D,4CACF,EAAE;CACA,aAAa,OAAO,SAAS,cAAc;CAC3C,WAAW,OAAO,SAAS,cAAc;AAC3C,CAAC,EAAE,CAAC;AAEJ,IAAM,uCAAN,cAAmD,OAAO,MACxD,sCACF,EAAE;CACA,WAAW,OAAO,SAAS,OAAO,OAAO,0CAA0C,CAAC;CACpF,WAAW,OAAO,SAAS,OAAO,OAAO,0CAA0C,CAAC;AACtF,CAAC,EAAE,CAAC;AAEJ,MAAa,yCACX,OACA,cAC6F;CAC7F,MAAM,qBAAqB,kCAAkC,SAAS;CAEtE,IAAI,uBAAuB,KAAA,GACzB,OAAO,OAAO,KACZ,uCAAuC,KAAK;EAC1C,UAAU;EACV,UAAU;CACZ,CAAC,CACH;CAGF,OAAO,OAAO,oBAAoB,oCAAoC,EAAE,KAAK,EAAE,KAC7E,OAAO,KAAI,YAAW;EACpB,MAAM,UAAkD,CAAC;EACzD,MAAM,UACJ,MACA,OACG;GACH,IAAI,CAAC,8BAA8B,MAAM,WAAW,GAClD;GAGF,MAAM,aAAa,KAAK,cAAc,OAAO,KAAA,IAAY,KAAK;GAC9D,MAAM,WACJ,eAAe,KAAA,IAAY,KAAA,IAAY,kCAAkC,UAAU;GAErF,QAAQ,KACN,gCAAgC,KAAK;IACnC;IACA,aAAa,KAAK;IAClB,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS;GAC/C,CAAC,CACH;EACF;EAEA,OAAO,QAAQ,WAAW,WAAW;EACrC,OAAO,QAAQ,WAAW,WAAW;EAErC,OAAO,kCAAkC,KAAK;GAC5C,UAAU;GACV,WAAW;GACX,SAAS,MAAM,aAAa,OAAO;EACrC,CAAC;CACH,CAAC,GACD,OAAO,eACL,uCAAuC,KAAK;EAC1C,UAAU;EACV,UAAU;CACZ,CAAC,CACH,GACA,OAAO,SAAS,wCAAwC,CAC1D;AACF;AAEA,MAAa,yCACX,OACA,UAAmD,CAAC,MAMpD,OAAO,IAAI,aAAa;CACtB,IAAI,MAAM,aAAA,oBACR,OAAO,OAAO,OAAO,KACnB,4CAA4C,KAAK;EAC/C,UAAU;EACV,QAAQ;CACV,CAAC,CACH;CAGF,MAAM,mBAAmB,QAAQ,oBAAA;CAEjC,IAAI,CAAC,sCAAsC,gBAAgB,GACzD,OAAO,OAAO,OAAO,KACnB,4CAA4C,KAAK;EAC/C,UAAU;EACV,QAAQ;CACV,CAAC,CACH;CAoBF,OAAO,OAAO,sCAAsC,OAHhC,kCAAkC,2BAA2B,OANzD,wCAAwC;EAC9D,UAAU;EACV,QAAA,OAVoB,WAAW;EAW/B,SAVc,kBAAkB,IAAI,mCAAmC,EAAE,KACzE,kBAAkB,WAAW;GAC3B,QAAQ;GACR,GAAG,oCAAoC,KAAK;GAC5C,kBAAkB;EACpB,CAAC,CAKK;EACN,WAAW;CACb,CAAC,CACwF,GACvE,IAAI,KAAK,OAAO,MAAM,iBAAiB,EAAE,YAEO,CAAC;AACrE,CAAC,EAAE,KAAK,OAAO,SAAS,wCAAwC,CAAC"}

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

@@ -1,7 +1,7 @@
-import { Effect, Layer, Stream } from "effect";
+import { Effect } from "effect";
 import { AgentReasoningEffort } from "@yolk-sdk/agent/protocol";
-import { HttpClient, HttpClientResponse } from "effect/unstable/http";
-import { LLMError, LLMEvent, LLMProvider, LLMRequest } from "@yolk-sdk/agent/loop";
+import { HttpClientResponse } from "effect/unstable/http";
+import { LLMError, LLMRequest } from "@yolk-sdk/agent/loop";
 import { OAuthAccessToken } from "@yolk-sdk/agent/oauth";
 
 //#region src/providers/openai/codex-provider.d.ts
@@ -18,10 +18,6 @@ type OpenAiCodexProviderConfig = {
   readonly defaultReasoningEffort?: AgentReasoningEffort;
   readonly reasoningSummary?: OpenAiCodexReasoningSummary;
 };
-type OpenAiCodexMessageInput = {
-  readonly role: 'user' | 'assistant';
-  readonly content: string | ReadonlyArray<OpenAiCodexInputContentPart>;
-};
 type OpenAiCodexInputTextPart = {
   readonly type: 'input_text';
   readonly text: string;
@@ -39,7 +35,10 @@ type OpenAiCodexInputFilePart = {
   readonly file_url: string;
 };
 type OpenAiCodexInputContentPart = OpenAiCodexInputTextPart | OpenAiCodexInputImagePart | OpenAiCodexInputFilePart;
-type OpenAiCodexFunctionOutput = string | ReadonlyArray<OpenAiCodexInputContentPart>;
+type OpenAiCodexMessageInput = {
+  readonly role: 'user' | 'assistant';
+  readonly content: string | ReadonlyArray<OpenAiCodexInputContentPart>;
+};
 type OpenAiCodexFunctionCallInput = {
   readonly type: 'function_call';
   readonly call_id: string;
@@ -49,7 +48,7 @@ type OpenAiCodexFunctionCallInput = {
 type OpenAiCodexFunctionOutputInput = {
   readonly type: 'function_call_output';
   readonly call_id: string;
-  readonly output: OpenAiCodexFunctionOutput;
+  readonly output: string | ReadonlyArray<OpenAiCodexInputContentPart>;
 };
 type OpenAiCodexInputItem = OpenAiCodexMessageInput | OpenAiCodexFunctionCallInput | OpenAiCodexFunctionOutputInput;
 type OpenAiCodexTool = {
@@ -76,8 +75,8 @@ declare const toOpenAiCodexRequestBody: (request: LLMRequest, config?: {
   readonly defaultReasoningEffort?: AgentReasoningEffort;
   readonly reasoningSummary?: OpenAiCodexReasoningSummary;
 }) => Effect.Effect<OpenAiCodexRequestBody, LLMError>;
-declare const streamOpenAiCodexResponse: (response: HttpClientResponse.HttpClientResponse) => Stream.Stream<LLMEvent, LLMError>;
-declare const makeOpenAiCodexProviderLayer: (config: OpenAiCodexProviderConfig) => Layer.Layer<LLMProvider, never, HttpClient.HttpClient>;
+declare const streamOpenAiCodexResponse: (response: HttpClientResponse.HttpClientResponse) => import("effect/Stream").Stream<import("@yolk-sdk/agent/loop").LLMTextDelta | import("@yolk-sdk/agent/loop").LLMReasoningDelta | import("@yolk-sdk/agent/loop").LLMDone | import("@yolk-sdk/agent/loop").LLMToolCall | import("@yolk-sdk/agent/loop").LLMToolInputStart | import("@yolk-sdk/agent/loop").LLMToolInputDelta | import("@yolk-sdk/agent/loop").LLMProviderToolResult | import("@yolk-sdk/agent/loop").LLMUsage, LLMError, never>;
+declare const makeOpenAiCodexProviderLayer: (config: OpenAiCodexProviderConfig) => import("effect/Layer").Layer<import("@yolk-sdk/agent/loop").LLMProvider, never, import("effect/unstable/http/HttpClient").HttpClient>;
 //#endregion
 export { OpenAiCodexProviderConfig, OpenAiCodexReasoningSummary, makeOpenAiCodexProviderLayer, streamOpenAiCodexResponse, toOpenAiCodexRequestBody };
 //# sourceMappingURL=codex-provider.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"codex-provider.d.mts","names":[],"sources":["../../../src/providers/openai/codex-provider.ts"],"mappings":";;;;;;;KAiDY,2BAAA;AAAA,KAEA,yBAAA;EAAA,SACD,KAAA,EAAO,gBAAA;EAHqB;;;AAAA;EAAA,SAQ5B,eAAA;EAAA,SACA,YAAA;EAAA,SACA,YAAA,GAAe,QAAA,CAAS,MAAA;EAAA,SACxB,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,2BAAA;AAAA;AAAA,KAGzB,uBAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA,WAAkB,aAAa,CAAC,2BAAA;AAAA;AAAA,KAGtC,wBAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAI;AAAA;AAAA,KAGV,yBAAA;EAAA,SACM,IAAA;EAAA,SACA,SAAS;AAAA;AAAA,KAGf,wBAAA;EAAA,SAEU,IAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAGA,IAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGV,2BAAA,GACD,wBAAA,GACA,yBAAA,GACA,wBAAA;AAAA,KAEC,yBAAA,YAAqC,aAAa,CAAC,2BAAA;AAAA,KAEnD,4BAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGN,8BAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA,EAAQ,yBAAyB;AAAA;AAAA,KAGvC,oBAAA,GACD,uBAAA,GACA,4BAAA,GACA,8BAAA;AAAA,KAEC,eAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGN,sBAAA;EAAA,SACM,KAAA;EAAA,SACA,YAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,oBAAA;EAAA,SACrB,KAAA;EAAA,SACA,MAAA;EAAA,SACA,SAAA;IAAA,SACE,MAAA,EAAQ,oBAAA;IAAA,SACR,OAAA,EAAS,2BAAA;EAAA;EAAA,SAEX,KAAA,GAAQ,aAAA,CAAc,eAAA;EAAA,SACtB,mBAAA;AAAA;AAAA,cA2RE,wBAAA,GACX,OAAA,EAAS,UAAA,EACT,MAAA;EArU0B,kEAuUf,eAAA;EAAA,SACA,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,2BAAA;AAAA,MAE7B,MAAA,CAAO,MAAA,CAAO,sBAAA,EAAwB,QAAA;AAAA,cA2lB5B,yBAAA,GACX,QAAA,EAAU,kBAAA,CAAmB,kBAAA,KAC5B,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,QAAA;AAAA,cA0Fd,4BAAA,GAAgC,MAAA,EAAQ,yBAAA,KAAyB,KAAA,CAAA,KAAA,CAAA,WAAA,SAAA,UAAA,CAAA,UAAA"}
+{"version":3,"file":"codex-provider.d.mts","names":[],"sources":["../../../src/providers/openai/codex-provider.ts"],"mappings":";;;;;;;KAaY,2BAAA;AAAA,KAEA,yBAAA;EAAA,SACD,KAAA,EAAO,gBAAA;EAHqB;;;AAAA;EAAA,SAQ5B,eAAA;EAAA,SACA,YAAA;EAAA,SACA,YAAA,GAAe,QAAA,CAAS,MAAA;EAAA,SACxB,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,2BAAA;AAAA;AAAA,KAGzB,wBAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAI;AAAA;AAAA,KAGV,yBAAA;EAAA,SACM,IAAA;EAAA,SACA,SAAS;AAAA;AAAA,KAGf,wBAAA;EAAA,SAEU,IAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAGA,IAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGV,2BAAA,GACD,wBAAA,GACA,yBAAA,GACA,wBAAA;AAAA,KAEC,uBAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA,WAAkB,aAAa,CAAC,2BAAA;AAAA;AAAA,KAGtC,4BAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGN,8BAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA,WAAiB,aAAa,CAAC,2BAAA;AAAA;AAAA,KAGrC,oBAAA,GACD,uBAAA,GACA,4BAAA,GACA,8BAAA;AAAA,KAEC,eAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGN,sBAAA;EAAA,SACM,KAAA;EAAA,SACA,YAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,oBAAA;EAAA,SACrB,KAAA;EAAA,SACA,MAAA;EAAA,SACA,SAAA;IAAA,SACE,MAAA,EAAQ,oBAAA;IAAA,SACR,OAAA,EAAS,2BAAA;EAAA;EAAA,SAEX,KAAA,GAAQ,aAAA,CAAc,eAAA;EAAA,SACtB,mBAAA;AAAA;AAAA,cASE,wBAAA,GACX,OAAA,EAAS,UAAA,EACT,MAAA;oEAEW,eAAA;EAAA,SACA,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,2BAAA;AAAA,MAE7B,MAAA,CAAO,MAAA,CAAO,sBAAA,EAAwB,QAAA;AAAA,cAc5B,yBAAA,GAA6B,QAAA,EAAU,kBAAA,CAAmB,kBAAA,6BAAkB,MAAA,gCAAA,YAAA,kCAAA,iBAAA,kCAAA,OAAA,kCAAA,WAAA,kCAAA,iBAAA,kCAAA,iBAAA,kCAAA,qBAAA,kCAAA,QAAA,EAAA,QAAA;AAAA,cAG5E,4BAAA,GAAgC,MAAA,EAAQ,yBAAyB,4BAAA,KAAA,gCAAA,WAAA,mDAAA,UAAA"}