@yolk-sdk/agent 0.1.0-canary.102 → 0.1.0-canary.104

package/README.md

@@ -20,47 +20,47 @@ Published package metadata requires Node.js 22+.
 
 ## Subpaths
 
-| Subpath                                                  | Purpose                                                                                       |
-| -------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
-| `@yolk-sdk/agent/protocol`                               | Wire messages, events, content, usage, tool schemas                                           |
-| `@yolk-sdk/agent/loop`                                   | Stateless LLM/tool loop                                                                       |
-| `@yolk-sdk/agent/loop/testing`                           | Faux provider and tool executor test helpers                                                  |
-| `@yolk-sdk/agent/runtime`                                | Transcript or append-backed runtime orchestration                                             |
-| `@yolk-sdk/agent/client`                                 | HTTP/NDJSON transport, HITL resume, retry/error state helpers                                 |
-| `@yolk-sdk/agent/compaction`                             | Host-owned compaction budgets, checkpoints, formatting, retry                                 |
-| `@yolk-sdk/agent/classification`                         | Classifier model contract: typed questions, answers, usage, errors                            |
-| `@yolk-sdk/agent/tools`                                  | Tool registry, typed inputs, interactions, subagents/questions, durable tool ledger           |
-| `@yolk-sdk/agent/react`                                  | Headless React chat hook, reducer, selectors, and render model                                |
-| `@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/conformance`           | Synthetic OpenAI chat, Codex Responses, and Codex usage fixtures and conformance cases        |
-| `@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/vercel/ai-gateway-provider`   | Vercel AI Gateway Chat Completions provider factory                                           |
-| `@yolk-sdk/agent/providers/vercel/ai-gateway-classifier` | Vercel AI Gateway classifier (`POST /v1/evaluate`) layer                                      |
-| `@yolk-sdk/agent/providers/vercel/conformance`           | Verified Gateway chat fixtures, synthetic classifier fixtures, and conformance cases          |
-| `@yolk-sdk/agent/providers/opencode/go-provider`         | OpenCode Go Chat Completions, Messages, and Responses provider                                |
-| `@yolk-sdk/agent/providers/opencode/usage`               | OpenCode Go subscription-allowance snapshots                                                  |
-| `@yolk-sdk/agent/providers/opencode/conformance`         | Synthetic OpenCode Go (per protocol, commentary replay, usage) fixtures and conformance cases |
-| `@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/anthropic/conformance`        | Synthetic Anthropic Messages and Claude usage fixtures and conformance cases                  |
-| `@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/xai/usage`                    | Grok subscription-allowance snapshots                                                         |
-| `@yolk-sdk/agent/providers/xai/conformance`              | Synthetic Grok Responses and Grok usage fixtures and conformance cases                        |
-| `@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                                                                |
-| `@yolk-sdk/agent/voice/react`                            | Headless browser voice React hook                                                             |
+| Subpath                                                  | Purpose                                                                                                                      |
+| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `@yolk-sdk/agent/protocol`                               | Wire messages, events, content, usage, tool schemas                                                                          |
+| `@yolk-sdk/agent/loop`                                   | Stateless LLM/tool loop                                                                                                      |
+| `@yolk-sdk/agent/loop/testing`                           | Faux provider and tool executor test helpers                                                                                 |
+| `@yolk-sdk/agent/runtime`                                | Transcript or append-backed runtime orchestration                                                                            |
+| `@yolk-sdk/agent/client`                                 | HTTP/NDJSON transport, HITL resume, retry/error state helpers                                                                |
+| `@yolk-sdk/agent/compaction`                             | Host-owned compaction budgets, checkpoints, formatting, retry                                                                |
+| `@yolk-sdk/agent/classification`                         | Classifier model contract: typed questions, answers, usage, errors                                                           |
+| `@yolk-sdk/agent/tools`                                  | Tool registry, typed inputs, interactions, subagents/questions, durable tool ledger, staged tool plans, tool change previews |
+| `@yolk-sdk/agent/react`                                  | Headless React chat hook, reducer, selectors, and render model                                                               |
+| `@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/conformance`           | Synthetic OpenAI chat, Codex Responses, and Codex usage fixtures and conformance cases                                       |
+| `@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/vercel/ai-gateway-provider`   | Vercel AI Gateway Chat Completions provider factory                                                                          |
+| `@yolk-sdk/agent/providers/vercel/ai-gateway-classifier` | Vercel AI Gateway classifier (`POST /v1/evaluate`) layer                                                                     |
+| `@yolk-sdk/agent/providers/vercel/conformance`           | Verified Gateway chat fixtures, synthetic classifier fixtures, and conformance cases                                         |
+| `@yolk-sdk/agent/providers/opencode/go-provider`         | OpenCode Go Chat Completions, Messages, and Responses provider                                                               |
+| `@yolk-sdk/agent/providers/opencode/usage`               | OpenCode Go subscription-allowance snapshots                                                                                 |
+| `@yolk-sdk/agent/providers/opencode/conformance`         | Synthetic OpenCode Go (per protocol, commentary replay, usage) fixtures and conformance cases                                |
+| `@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/anthropic/conformance`        | Synthetic Anthropic Messages and Claude usage fixtures and conformance cases                                                 |
+| `@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/xai/usage`                    | Grok subscription-allowance snapshots                                                                                        |
+| `@yolk-sdk/agent/providers/xai/conformance`              | Synthetic Grok Responses and Grok usage fixtures and conformance cases                                                       |
+| `@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                                                                                               |
+| `@yolk-sdk/agent/voice/react`                            | Headless browser voice React hook                                                                                            |
 
 ## Imports
 
@@ -680,6 +680,7 @@ HITL is protocol-level, not UI-level:
   `submitToolApprovalResponse` / `submitQuestionResponse`, or using client stream helpers like
   `streamToolApprovalResponseEventStream`.
 - Denials become model-visible `ToolResult` messages with `isError = true`.
+- Give approval-gated tools a `changePreview` hook (`makeTool({ approval, changePreview })`) and pass `resolveTools(...).approvalPreviews` as `approvalPreviews` to loop/runtime configs: pending `ToolApprovalRequest`s then carry a tool-agnostic before → after `preview` (`ToolChangePreview`) or `previewError`. Previews are display only and never block the approval. See [ADR 0006](https://github.com/magoz/yolk-sdk/blob/main/docs/adr/0006-tool-change-previews.md).
 - Use `makeQuestionToolModule` to expose the package-owned `question` tool; answers resume as structured tool results and model-visible text with selected labels. The loop intercepts questions only when the tool is enabled in `tools`; omitted questions return an unavailable result without HITL or executor dispatch, even if a provider emits one.
 - Use `makeInputTool({ name, description, response, renderer })` for custom typed input. Apps own the response Effect schema and renderer; the SDK carries JSON data only. Pass `resolveTools(...).inputs` alongside `tools` to loop/runtime configs. The original `callParameters` and `response` schemas validate server-side, including refinements; display JSON Schema is not the validator. Invalid calls fail before prompting; invalid submissions remain pending for correction. The first valid submission or cancellation settles the request and cannot be overwritten by stale responses.
 - Resume custom inputs with `submitInputResponse`, `streamInputResponseEventStream`, or WebSocket `InputResponseInput`. Echo request/call IDs; do not reconstruct them. Input collection is not authorization: a draft composer never grants permission to send. Input tools cannot carry approval/background policy or execute directly.
@@ -866,6 +867,10 @@ not this marker. These child observations are separate from generic background t
 `prepareToolBatch` from `@yolk-sdk/agent/loop` exposes the same HITL preflight used by the loop.
 Durable orchestration must check `pendingRequests` before dispatching **any** tool, even calls
 listed in `callsToExecute`. Preserve synthetic results and original call ordering when committing.
+It fails with `ToolError` `unavailable` only when host storage read by an interaction call
+validator (for example a plan review's plan store) is unavailable; nothing runs, so fail the step
+and retry it. Admission (`validateInteractionSubmission`) answers `InteractionAdmissionError`
+`unavailable` for the same outage.
 
 Keep host-owned subagent execution wiring outside this package; pass only the package subagent contract across the boundary.
 
@@ -922,8 +927,8 @@ This package declares them; it does not run scripts.
 - `callableBy: 'all' | 'model' | 'codemode'` (default `all`) decides who may call a tool. For
   `codemode` only, `discovery: 'listed' | 'search'` (default `listed`) decides how scripts find it.
   Codemode-only tools never reach providers. Approval, input, interaction, activated background,
-  `question`, `subagent`, and nested-access tools never run from code mode; `resolveTools` rejects
-  `callableBy: 'codemode'` on them.
+  `question`, `subagent`, and nested-access tools never run from code mode (stageable approval tools
+  are only staged; see Staged tool plans); `resolveTools` rejects `callableBy: 'codemode'` on them.
 - `nestedToolAccess: true` gives a registration's `execute` a `nested` executor over the other
   code-mode-callable tools of the same resolution and host context. Nested calls run through the
   resolved execute path and fail closed with model-visible error results. Assign nested call ids as
@@ -955,6 +960,21 @@ keep their operations interruptible (the ledger's timeouts cannot cut uninterrup
 logs and metrics. Without the option behavior is unchanged. See
 [the tools README](https://github.com/magoz/yolk-sdk/blob/main/packages/agent/src/tools/README.md#durable-tool-ledger).
 
+## Staged tool plans
+
+A code mode script can stage calls of approval-gated tools marked `staging`
+(`makeTool({ approval, staging })`) instead of running them; a person reviews the saved plan once
+through `makePlanReviewTool` (`review_plan({ planId, planDigest })`, response `{ selectedKeys }`),
+and Yolk applies exactly the selected recorded calls, in staged order and at most once, through the
+normal execute path and ledger. Enable it with
+`resolveTools(modules, context, { interactionHost, plans: { store, planId? } })` and one review tool.
+Applied calls bypass `beforeNestedCall` and `ToolExecutor` decorators: wire your per-call authorizer
+as `makePlanReviewTool({ beforeCall })`. With a ledger, a redelivered review waits for an in-flight
+apply and returns its real outcome. `previewStoredToolPlan` pages each staged call's arguments
+with the tool's change preview (the same `changePreview` hook approvals use) for review screens;
+`ToolPlanOutcome` and `ToolPlanPreviewPage` are Effect Schemas. See
+[ADR 0005](https://github.com/magoz/yolk-sdk/blob/main/docs/adr/0005-staged-tool-plans.md).
+
 ## Tool failures
 
 Use `modelVisibleToolError(...)` for expected tool-domain failures the model can recover

package/dist/classification/errors.d.mts

@@ -1,5 +1,5 @@
-import * as Schema from "effect/Schema";
 import { ProviderErrorInfo } from "@yolk-sdk/agent/protocol";
+import * as Schema from "effect/Schema";
 
 //#region src/classification/errors.d.ts
 /**

package/dist/classification/errors.mjs

@@ -1,6 +1,6 @@
 import { ClassificationUsage } from "./schema.mjs";
-import * as Schema from "effect/Schema";
 import { ProviderErrorInfo } from "@yolk-sdk/agent/protocol";
+import * as Schema from "effect/Schema";
 //#region src/classification/errors.ts
 /**
 * Why an answer does not fit its question:

package/dist/client/transport.d.mts

@@ -1,7 +1,7 @@
 import { AgentTranscript } from "./state.mjs";
 import { Cause, Effect, Layer, Stream } from "effect";
-import * as Schema$1 from "effect/Schema";
 import { AgentEvent, AgentReasoningEffort, HitlResponse, InputResponse, InteractionResponse, QuestionResponse, ToolApprovalResponse } from "@yolk-sdk/agent/protocol";
+import * as Schema$1 from "effect/Schema";
 import { HttpClient } from "effect/http";
 
 //#region src/client/transport.d.ts

package/dist/client/transport.mjs

@@ -1,6 +1,6 @@
 import { Cause, Channel, Data, Effect, Exit, Match, Predicate, Pull, Queue, Ref, Result, Scope, Stream } from "effect";
-import * as Schema$1 from "effect/Schema";
 import { AgentEvent, AgentWebSocketServerMessage, InputResponseInput, InteractionResponseInput, QuestionResponseInput, ToolApprovalResponseInput, UserInput, isTerminalAgentEvent } from "@yolk-sdk/agent/protocol";
+import * as Schema$1 from "effect/Schema";
 import { FetchHttpClient, HttpClient, HttpClientRequest } from "effect/http";
 //#region src/client/transport.ts
 var AgentTransportError = class extends Schema$1.TaggedError()("AgentTransportError", {

package/dist/compaction/retry.d.mts

@@ -12,58 +12,58 @@ type ContextOverflowRetryCompactionResult = Data.TaggedEnum<{
   };
 }>;
 declare const ContextOverflowRetryCompactionResult: {
-  readonly Skipped: Data.TaggedEnum.ConstructorFrom<{
-    readonly _tag: "Skipped";
-    readonly messages: ReadonlyArray<AgentMessage>;
-  }, "_tag">;
   readonly Compacted: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Compacted";
     readonly messages: ReadonlyArray<AgentMessage>;
   }, "_tag">;
-  readonly $is: <Tag extends "Skipped" | "Compacted">(tag: Tag) => (u: unknown) => u is Extract<{
+  readonly Skipped: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Skipped";
     readonly messages: ReadonlyArray<AgentMessage>;
+  }, "_tag">;
+  readonly $is: <Tag extends "Compacted" | "Skipped">(tag: Tag) => (u: unknown) => u is Extract<{
+    readonly _tag: "Compacted";
+    readonly messages: ReadonlyArray<AgentMessage>;
   }, {
     readonly _tag: Tag;
   }> | Extract<{
-    readonly _tag: "Compacted";
+    readonly _tag: "Skipped";
     readonly messages: ReadonlyArray<AgentMessage>;
   }, {
     readonly _tag: Tag;
   }>;
   readonly $match: {
     <Cases extends {
-      readonly Skipped: (args: {
-        readonly _tag: "Skipped";
-        readonly messages: ReadonlyArray<AgentMessage>;
-      }) => any;
       readonly Compacted: (args: {
         readonly _tag: "Compacted";
         readonly messages: ReadonlyArray<AgentMessage>;
       }) => any;
+      readonly Skipped: (args: {
+        readonly _tag: "Skipped";
+        readonly messages: ReadonlyArray<AgentMessage>;
+      }) => any;
     }>(cases: Cases): (value: {
-      readonly _tag: "Skipped";
+      readonly _tag: "Compacted";
       readonly messages: ReadonlyArray<AgentMessage>;
     } | {
-      readonly _tag: "Compacted";
+      readonly _tag: "Skipped";
       readonly messages: ReadonlyArray<AgentMessage>;
-    }) => import("effect/Unify").Unify<ReturnType<Cases["Skipped" | "Compacted"]>>;
+    }) => import("effect/Unify").Unify<ReturnType<Cases["Compacted" | "Skipped"]>>;
     <Cases extends {
-      readonly Skipped: (args: {
-        readonly _tag: "Skipped";
-        readonly messages: ReadonlyArray<AgentMessage>;
-      }) => any;
       readonly Compacted: (args: {
         readonly _tag: "Compacted";
         readonly messages: ReadonlyArray<AgentMessage>;
       }) => any;
+      readonly Skipped: (args: {
+        readonly _tag: "Skipped";
+        readonly messages: ReadonlyArray<AgentMessage>;
+      }) => any;
     }>(value: {
-      readonly _tag: "Skipped";
+      readonly _tag: "Compacted";
       readonly messages: ReadonlyArray<AgentMessage>;
     } | {
-      readonly _tag: "Compacted";
+      readonly _tag: "Skipped";
       readonly messages: ReadonlyArray<AgentMessage>;
-    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Skipped" | "Compacted"]>>;
+    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Compacted" | "Skipped"]>>;
   };
 };
 type OverflowCompactionDecision = {
@@ -73,14 +73,14 @@ type OverflowCompactionDecision = {
   readonly _tag: 'Skipped';
 };
 declare const OverflowCompactionDecision: {
-  readonly Skipped: Data.TaggedEnum.ConstructorFrom<{
-    readonly _tag: "Skipped";
-  }, "_tag">;
   readonly Compacted: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Compacted";
     readonly messages: ReadonlyArray<AgentMessage>;
   }, "_tag">;
-  readonly $is: <Tag extends "Skipped" | "Compacted">(tag: Tag) => (u: unknown) => u is Extract<{
+  readonly Skipped: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Skipped";
+  }, "_tag">;
+  readonly $is: <Tag extends "Compacted" | "Skipped">(tag: Tag) => (u: unknown) => u is Extract<{
     readonly _tag: "Compacted";
     readonly messages: ReadonlyArray<AgentMessage>;
   }, {
@@ -92,23 +92,23 @@ declare const OverflowCompactionDecision: {
   }>;
   readonly $match: {
     <Cases extends {
-      readonly Skipped: (args: {
-        readonly _tag: "Skipped";
-      }) => any;
       readonly Compacted: (args: {
         readonly _tag: "Compacted";
         readonly messages: ReadonlyArray<AgentMessage>;
       }) => any;
-    }>(cases: Cases): (value: OverflowCompactionDecision) => import("effect/Unify").Unify<ReturnType<Cases["Skipped" | "Compacted"]>>;
-    <Cases extends {
       readonly Skipped: (args: {
         readonly _tag: "Skipped";
       }) => any;
+    }>(cases: Cases): (value: OverflowCompactionDecision) => import("effect/Unify").Unify<ReturnType<Cases["Compacted" | "Skipped"]>>;
+    <Cases extends {
       readonly Compacted: (args: {
         readonly _tag: "Compacted";
         readonly messages: ReadonlyArray<AgentMessage>;
       }) => any;
-    }>(value: OverflowCompactionDecision, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Skipped" | "Compacted"]>>;
+      readonly Skipped: (args: {
+        readonly _tag: "Skipped";
+      }) => any;
+    }>(value: OverflowCompactionDecision, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Compacted" | "Skipped"]>>;
   };
 };
 type ContextOverflowRetryCompactor = (messages: ReadonlyArray<AgentMessage>) => Effect.Effect<ContextOverflowRetryCompactionResult, unknown>;

package/dist/compaction/retry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.mts","names":[],"sources":["../../src/compaction/retry.ts"],"mappings":";;;;;KASY,oCAAA,GAAuC,IAAA,CAAK,UAAA;EACtD,SAAA;IAAA,SACW,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA;EAEnC,OAAA;IAAA,SACW,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA;AAAA;AAAA,cAIxB,oCAAA;EAAA;;uBAJU,aAAA,CAAc,YAAA;EAAA;EAAA;;uBAHd,aAAA,CAAc,YAAA;EAAA;EAAA;;uBAGd,aAAA,CAAc,YAAA;EAAA;IAAA;;;uBAHd,aAAA,CAAc,YAAA;EAAA;IAAA;;;;;;2BAGd,aAAA,CAAc,YAAA;MAAA;MAAA;;2BAHd,aAAA,CAAc,YAAA;MAAA;IAAA;;yBAGd,aAAA,CAAc,YAAA;IAAA;MAAA;yBAHd,aAAA,CAAc,YAAA;IAAA;;;;2BAGd,aAAA,CAAc,YAAA;MAAA;MAAA;;2BAHd,aAAA,CAAc,YAAA;MAAA;IAAA;;yBAGd,aAAA,CAAc,YAAA;IAAA;MAAA;yBAHd,aAAA,CAAc,YAAA;IAAA;;;KAUzB,0BAAA;EAAA,SAEG,IAAA;EAAA,SACA,QAAA,EAAU,aAAa,CAAC,YAAA;AAAA;EAAA,SAGxB,IAAA;AAAA;AAAA,cAGF,0BAAA;EAAA;;;;;uBANY,aAAA,CAAc,YAAA;EAAA;EAAA;;uBAAd,aAAA,CAAc,YAAA;EAAA;IAAA;;;;;;;;;;;;;2BAAd,aAAA,CAAc,YAAA;MAAA;IAAA;;;;;;;2BAAd,aAAA,CAAc,YAAA;MAAA;IAAA;;;KAQ3B,6BAAA,IACV,QAAA,EAAU,aAAA,CAAc,YAAA,MACrB,MAAA,CAAO,MAAA,CAAO,oCAAA;AAAA,KAEP,iCAAA;EAAA,SACD,QAAA;IAAA,SACE,MAAA,GAAS,OAAA,EAAS,UAAA,KAAe,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,gBAAA;EAAA;EAAA,SAE3D,WAAA,GAAc,GAAA,CAAI,GAAA,CAAI,aAAA,CAAc,YAAA;EAAA,SACpC,OAAA,EAAS,6BAAA;AAAA;AAAA,KAGf,uBAAA,GAA0B,oCAAA,GAAuC,0BAA0B;;cAGnF,6BAAA;AAAA,cAEA,gCAAA,GAAoC,OAAe;AAAA,cAGnD,gCAAA,GAAoC,OAAe;AAAA,cAGnD,wBAAA,GAA4B,KAAA;EAAA,SAC9B,OAAA;EAAA,SACA,aAAA;AAAA;AAAA,cAkBE,uBAAA,SAAiC,KAAA;EAAA,SACnC,OAAA,GACP,QAAA,EAAU,aAAA,CAAc,YAAA,MACrB,MAAA,CAAO,MAAA,CAAO,uBAAA,EAAyB,CAAA,EAAG,CAAA;EAAA,SACtC,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA,SACxB,OAAA;EAAA,SACA,aAAA;AAAA,MACP,MAAA,CAAO,MAAA,CAAO,0BAAA,EAA4B,CAAA,EAAG,CAAA;AAAA,cAuEpC,gCAAA,GAAoC,KAAA,EAAO,iCAAA,KAAiC,MAAA,CAAA,MAAA;EAAA"}
+{"version":3,"file":"retry.d.mts","names":[],"sources":["../../src/compaction/retry.ts"],"mappings":";;;;;KASY,oCAAA,GAAuC,IAAA,CAAK,UAAA;EACtD,SAAA;IAAA,SACW,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA;EAEnC,OAAA;IAAA,SACW,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA;AAAA;AAAA,cAIxB,oCAAA;EAAA;;uBAPU,aAAA,CAAc,YAAA;EAAA;EAAA;;uBAGd,aAAA,CAAc,YAAA;EAAA;EAAA;;uBAHd,aAAA,CAAc,YAAA;EAAA;IAAA;;;uBAGd,aAAA,CAAc,YAAA;EAAA;IAAA;;;;;;2BAHd,aAAA,CAAc,YAAA;MAAA;MAAA;;2BAGd,aAAA,CAAc,YAAA;MAAA;IAAA;;yBAHd,aAAA,CAAc,YAAA;IAAA;MAAA;yBAGd,aAAA,CAAc,YAAA;IAAA;;;;2BAHd,aAAA,CAAc,YAAA;MAAA;MAAA;;2BAGd,aAAA,CAAc,YAAA;MAAA;IAAA;;yBAHd,aAAA,CAAc,YAAA;IAAA;MAAA;yBAGd,aAAA,CAAc,YAAA;IAAA;;;KAOzB,0BAAA;EAAA,SAEG,IAAA;EAAA,SACA,QAAA,EAAU,aAAa,CAAC,YAAA;AAAA;EAAA,SAGxB,IAAA;AAAA;AAAA,cAGF,0BAAA;EAAA;;uBANY,aAAA,CAAc,YAAA;EAAA;EAAA;;;;;uBAAd,aAAA,CAAc,YAAA;EAAA;IAAA;;;;;;;;;;2BAAd,aAAA,CAAc,YAAA;MAAA;MAAA;;;;;;;2BAAd,aAAA,CAAc,YAAA;MAAA;MAAA;;;;;;KAQ3B,6BAAA,IACV,QAAA,EAAU,aAAA,CAAc,YAAA,MACrB,MAAA,CAAO,MAAA,CAAO,oCAAA;AAAA,KAEP,iCAAA;EAAA,SACD,QAAA;IAAA,SACE,MAAA,GAAS,OAAA,EAAS,UAAA,KAAe,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,gBAAA;EAAA;EAAA,SAE3D,WAAA,GAAc,GAAA,CAAI,GAAA,CAAI,aAAA,CAAc,YAAA;EAAA,SACpC,OAAA,EAAS,6BAAA;AAAA;AAAA,KAGf,uBAAA,GAA0B,oCAAA,GAAuC,0BAA0B;;cAGnF,6BAAA;AAAA,cAEA,gCAAA,GAAoC,OAAe;AAAA,cAGnD,gCAAA,GAAoC,OAAe;AAAA,cAGnD,wBAAA,GAA4B,KAAA;EAAA,SAC9B,OAAA;EAAA,SACA,aAAA;AAAA;AAAA,cAkBE,uBAAA,SAAiC,KAAA;EAAA,SACnC,OAAA,GACP,QAAA,EAAU,aAAA,CAAc,YAAA,MACrB,MAAA,CAAO,MAAA,CAAO,uBAAA,EAAyB,CAAA,EAAG,CAAA;EAAA,SACtC,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA,SACxB,OAAA;EAAA,SACA,aAAA;AAAA,MACP,MAAA,CAAO,MAAA,CAAO,0BAAA,EAA4B,CAAA,EAAG,CAAA;AAAA,cAuEpC,gCAAA,GAAoC,KAAA,EAAO,iCAAA,KAAiC,MAAA,CAAA,MAAA;EAAA"}

package/dist/compaction/window.d.mts

@@ -57,13 +57,6 @@ type CompletedCompactionResult = Extract<CompactionResult, {
   readonly _tag: 'Compacted';
 }>;
 declare const CompactionResult: {
-  readonly Skipped: Data.TaggedEnum.ConstructorFrom<{
-    readonly _tag: "Skipped";
-    readonly reason: CompactionSkipReason;
-    readonly messages: ReadonlyArray<AgentMessage>;
-    readonly events: ReadonlyArray<AgentEvent>;
-    readonly beforeTokens: number;
-  }, "_tag">;
   readonly Compacted: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Compacted";
     readonly strategy: string;
@@ -75,15 +68,14 @@ declare const CompactionResult: {
     readonly recentMessages: ReadonlyArray<AgentMessage>;
     readonly summaryMessage: AgentMessage;
   }, "_tag">;
-  readonly $is: <Tag extends "Skipped" | "Compacted">(tag: Tag) => (u: unknown) => u is Extract<{
+  readonly Skipped: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Skipped";
     readonly reason: CompactionSkipReason;
     readonly messages: ReadonlyArray<AgentMessage>;
     readonly events: ReadonlyArray<AgentEvent>;
     readonly beforeTokens: number;
-  }, {
-    readonly _tag: Tag;
-  }> | Extract<{
+  }, "_tag">;
+  readonly $is: <Tag extends "Compacted" | "Skipped">(tag: Tag) => (u: unknown) => u is Extract<{
     readonly _tag: "Compacted";
     readonly strategy: string;
     readonly messages: ReadonlyArray<AgentMessage>;
@@ -95,16 +87,17 @@ declare const CompactionResult: {
     readonly summaryMessage: AgentMessage;
   }, {
     readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "Skipped";
+    readonly reason: CompactionSkipReason;
+    readonly messages: ReadonlyArray<AgentMessage>;
+    readonly events: ReadonlyArray<AgentEvent>;
+    readonly beforeTokens: number;
+  }, {
+    readonly _tag: Tag;
   }>;
   readonly $match: {
     <Cases extends {
-      readonly Skipped: (args: {
-        readonly _tag: "Skipped";
-        readonly reason: CompactionSkipReason;
-        readonly messages: ReadonlyArray<AgentMessage>;
-        readonly events: ReadonlyArray<AgentEvent>;
-        readonly beforeTokens: number;
-      }) => any;
       readonly Compacted: (args: {
         readonly _tag: "Compacted";
         readonly strategy: string;
@@ -116,13 +109,14 @@ declare const CompactionResult: {
         readonly recentMessages: ReadonlyArray<AgentMessage>;
         readonly summaryMessage: AgentMessage;
       }) => any;
+      readonly Skipped: (args: {
+        readonly _tag: "Skipped";
+        readonly reason: CompactionSkipReason;
+        readonly messages: ReadonlyArray<AgentMessage>;
+        readonly events: ReadonlyArray<AgentEvent>;
+        readonly beforeTokens: number;
+      }) => any;
     }>(cases: Cases): (value: {
-      readonly _tag: "Skipped";
-      readonly reason: CompactionSkipReason;
-      readonly messages: ReadonlyArray<AgentMessage>;
-      readonly events: ReadonlyArray<AgentEvent>;
-      readonly beforeTokens: number;
-    } | {
       readonly _tag: "Compacted";
       readonly strategy: string;
       readonly messages: ReadonlyArray<AgentMessage>;
@@ -132,15 +126,14 @@ declare const CompactionResult: {
       readonly compactedMessages: ReadonlyArray<AgentMessage>;
       readonly recentMessages: ReadonlyArray<AgentMessage>;
       readonly summaryMessage: AgentMessage;
-    }) => import("effect/Unify").Unify<ReturnType<Cases["Skipped" | "Compacted"]>>;
+    } | {
+      readonly _tag: "Skipped";
+      readonly reason: CompactionSkipReason;
+      readonly messages: ReadonlyArray<AgentMessage>;
+      readonly events: ReadonlyArray<AgentEvent>;
+      readonly beforeTokens: number;
+    }) => import("effect/Unify").Unify<ReturnType<Cases["Compacted" | "Skipped"]>>;
     <Cases extends {
-      readonly Skipped: (args: {
-        readonly _tag: "Skipped";
-        readonly reason: CompactionSkipReason;
-        readonly messages: ReadonlyArray<AgentMessage>;
-        readonly events: ReadonlyArray<AgentEvent>;
-        readonly beforeTokens: number;
-      }) => any;
       readonly Compacted: (args: {
         readonly _tag: "Compacted";
         readonly strategy: string;
@@ -152,13 +145,14 @@ declare const CompactionResult: {
         readonly recentMessages: ReadonlyArray<AgentMessage>;
         readonly summaryMessage: AgentMessage;
       }) => any;
+      readonly Skipped: (args: {
+        readonly _tag: "Skipped";
+        readonly reason: CompactionSkipReason;
+        readonly messages: ReadonlyArray<AgentMessage>;
+        readonly events: ReadonlyArray<AgentEvent>;
+        readonly beforeTokens: number;
+      }) => any;
     }>(value: {
-      readonly _tag: "Skipped";
-      readonly reason: CompactionSkipReason;
-      readonly messages: ReadonlyArray<AgentMessage>;
-      readonly events: ReadonlyArray<AgentEvent>;
-      readonly beforeTokens: number;
-    } | {
       readonly _tag: "Compacted";
       readonly strategy: string;
       readonly messages: ReadonlyArray<AgentMessage>;
@@ -168,7 +162,13 @@ declare const CompactionResult: {
       readonly compactedMessages: ReadonlyArray<AgentMessage>;
       readonly recentMessages: ReadonlyArray<AgentMessage>;
       readonly summaryMessage: AgentMessage;
-    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Skipped" | "Compacted"]>>;
+    } | {
+      readonly _tag: "Skipped";
+      readonly reason: CompactionSkipReason;
+      readonly messages: ReadonlyArray<AgentMessage>;
+      readonly events: ReadonlyArray<AgentEvent>;
+      readonly beforeTokens: number;
+    }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Compacted" | "Skipped"]>>;
   };
 };
 type ApplyCompactionPlanOptions = {

package/dist/compaction/window.d.mts.map

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

package/dist/loop/error.d.mts

@@ -1,5 +1,5 @@
-import * as Schema from "effect/Schema";
 import { AgentError, ProviderErrorInfo } from "@yolk-sdk/agent/protocol";
+import * as Schema from "effect/Schema";
 
 //#region src/loop/error.d.ts
 declare const LLMResponseIssue: Schema.Literal<"missing_done">;

package/dist/loop/error.mjs

@@ -1,6 +1,6 @@
 import { Match } from "effect";
-import * as Schema$1 from "effect/Schema";
 import { AgentError, ProviderErrorInfo } from "@yolk-sdk/agent/protocol";
+import * as Schema$1 from "effect/Schema";
 //#region src/loop/error.ts
 const LLMResponseIssue = Schema$1.Literal("missing_done");
 var LLMError = class extends Schema$1.TaggedError()("LLMError", {

package/dist/loop/llm-event.d.mts

@@ -1,5 +1,5 @@
-import * as Schema from "effect/Schema";
 import { AgentUsage, ToolCall, ToolResult } from "@yolk-sdk/agent/protocol";
+import * as Schema from "effect/Schema";
 
 //#region src/loop/llm-event.d.ts
 declare const LLMTextDelta_base: Schema.Class<LLMTextDelta, Schema.TaggedStruct<"TextDelta", {

package/dist/loop/llm-event.mjs

@@ -1,5 +1,5 @@
-import * as Schema from "effect/Schema";
 import { AgentUsage, ToolCall, ToolResult } from "@yolk-sdk/agent/protocol";
+import * as Schema from "effect/Schema";
 //#region src/loop/llm-event.ts
 var LLMTextDelta = class extends Schema.TaggedClass()("TextDelta", { text: Schema.String }) {};
 var LLMReasoningDelta = class extends Schema.TaggedClass()("ReasoningDelta", { text: Schema.String }) {};

package/dist/loop/run.d.mts

@@ -4,7 +4,7 @@ import { LLMProvider } from "./services/llm-provider.mjs";
 import { LoopConfig } from "./services/loop-config.mjs";
 import { ToolExecutor } from "./services/tool-executor.mjs";
 import { Effect, Stream } from "effect";
-import { AgentEvent, AgentMessage, AgentModelCapabilities, AgentReasoningEffort, AgentUsage, HitlRequest, HitlResponse, InputToolHandler, InteractionHost, InteractionPreflight, InteractionReceipt, InteractionRef, ToolCall, ToolDef } from "@yolk-sdk/agent/protocol";
+import { AgentEvent, AgentMessage, AgentModelCapabilities, AgentReasoningEffort, AgentUsage, HitlRequest, HitlResponse, InputToolHandler, InteractionHost, InteractionPreflight, InteractionReceipt, InteractionRef, ToolApprovalPreviewer, ToolCall, ToolDef } from "@yolk-sdk/agent/protocol";
 
 //#region src/loop/run.d.ts
 type AgentLoopRunId = string;
@@ -19,6 +19,10 @@ type RunConfig = {
    */
   readonly interactions?: Readonly<Record<string, InteractionPreflight>>;
   readonly interactionHost?: InteractionHost;
+  /** Change previewers of approval-gated tools by tool name (from
+   * ResolvedToolSet.approvalPreviews): pending approval requests carry their preview.
+   */
+  readonly approvalPreviews?: Readonly<Record<string, ToolApprovalPreviewer>>;
   readonly model: string;
   readonly reasoningEffort?: AgentReasoningEffort;
   readonly capabilities?: AgentModelCapabilities;
@@ -33,6 +37,10 @@ type ToolBatchConfig = {
   readonly inputs?: Readonly<Record<string, InputToolHandler>>; /** Server-side interaction preflight by tool name (from ResolvedToolSet.interactions). */
   readonly interactions?: Readonly<Record<string, InteractionPreflight>>;
   readonly interactionHost?: InteractionHost;
+  /** Change previewers of approval-gated tools by tool name (from
+   * ResolvedToolSet.approvalPreviews).
+   */
+  readonly approvalPreviews?: Readonly<Record<string, ToolApprovalPreviewer>>;
   readonly model?: string;
   readonly createdMessages?: ReadonlyArray<AgentMessage>;
   readonly turn?: number;
@@ -63,7 +71,10 @@ type PreparedToolBatch = {
  * this at each preflight boundary and pass the result as interactionReceipts. Reads
  * do not accept/claim/settle. A storage error fails the batch closed. */
 declare const loadInteractionReceipts: (calls: ReadonlyArray<ToolCall>, host: InteractionHost | undefined) => Effect.Effect<ReadonlyMap<string, InteractionReceipt>, ToolError>;
-/** Preflight the entire batch before dispatching ANY call. Pending requests fence all execution. */
+/** Preflight the entire batch before dispatching ANY call. Pending requests fence all execution.
+ * Fails (`ToolError` `unavailable`) only when host storage an interaction call validator reads is
+ * unavailable: the batch fails closed, like `loadInteractionReceipts`, and nothing runs.
+ */
 declare const prepareToolBatch: (input: {
   readonly tools: ReadonlyArray<ToolDef>;
   readonly responses: ReadonlyArray<HitlResponse>;
@@ -71,7 +82,12 @@ declare const prepareToolBatch: (input: {
   readonly inputs?: Readonly<Record<string, InputToolHandler>>;
   readonly interactions?: Readonly<Record<string, InteractionPreflight>>;
   readonly interactionReceipts?: ReadonlyMap<string, InteractionReceipt>;
-}) => Effect.Effect<PreparedToolBatch>;
+  /** Change previewers by tool name (from ResolvedToolSet.approvalPreviews). Pending approval
+   * requests of these tools carry `preview` (or `previewError`); computed only while the request
+   * is pending, at most 8 at a time.
+   */
+  readonly approvalPreviews?: Readonly<Record<string, ToolApprovalPreviewer>>;
+}) => Effect.Effect<PreparedToolBatch, ToolError>;
 declare const runModelTurn: (config: ModelTurnConfig) => Stream.Stream<AgentEvent, AgentLoopError, ContextTransformer | LLMProvider | LoopConfig>;
 declare const runToolBatch: (config: ToolBatchConfig) => Stream.Stream<AgentEvent, AgentLoopError, LoopConfig | ToolExecutor>;
 declare const run: (config: RunConfig) => Stream.Stream<AgentEvent, AgentLoopError, ContextTransformer | LLMProvider | LoopConfig | ToolExecutor>;

package/dist/loop/run.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.mts","names":[],"sources":["../../src/loop/run.ts"],"mappings":";;;;;;;;;KAuFY,cAAA;AAAA,KAEA,SAAA;EAAA,SACD,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA,SACxB,YAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,OAAA;EAAA,SACrB,aAAA,GAAgB,aAAA,CAAc,YAAA,GANf;EAAA,SAQf,MAAA,GAAS,QAAA,CAAS,MAAA,SAAe,gBAAA;EANvB;;;EAAA,SAUV,YAAA,GAAe,QAAA,CAAS,MAAA,SAAe,oBAAA;EAAA,SACvC,eAAA,GAAkB,eAAA;EAAA,SAClB,KAAA;EAAA,SACA,eAAA,GAAkB,oBAAA;EAAA,SAClB,YAAA,GAAe,sBAAA;AAAA;AAAA,KAGd,eAAA,GAAkB,SAAS;EAAA,SAC5B,IAAI;AAAA;AAAA,KAGH,eAAA;EAAA,SACD,KAAA,EAAO,aAAA,CAAc,QAAA;EAAA,SACrB,KAAA,GAAQ,aAAA,CAAc,OAAA;EAAA,SACtB,aAAA,GAAgB,aAAA,CAAc,YAAA,GAVf;EAAA,SAYf,MAAA,GAAS,QAAA,CAAS,MAAA,SAAe,gBAAA,IAZI;EAAA,SAcrC,YAAA,GAAe,QAAA,CAAS,MAAA,SAAe,oBAAA;EAAA,SACvC,eAAA,GAAkB,eAAA;EAAA,SAClB,KAAA;EAAA,SACA,eAAA,GAAkB,aAAA,CAAc,YAAA;EAAA,SAChC,IAAA;EAAA,SACA,KAAA,GAAQ,UAAA;AAAA;AAAA,KAobd,wBAAA;EAAA,SACM,KAAA;EAAA,SACA,OAAA,EAAS,YAAY;AAAA;AAAA,KAG3B,eAAA;EAAA,SACM,KAAA;EAAA,SACA,IAAA,EAAM,QAAQ;AAAA;AAAA,KAyBb,iBAAA;EAAA,SACD,cAAA,EAAgB,aAAA,CAAc,eAAA;EAAA,SAC9B,cAAA,EAAgB,aAAA,CAAc,wBAAA;EAAA,SAC9B,YAAA,EAAc,aAAA,CAAc,UAAA;EAAA,SAC5B,MAAA,EAAQ,aAAA,CAAc,UAAA;EAAA,SACtB,eAAA,EAAiB,aAAA,CAAc,WAAA;EAAA,SAC/B,aAAA,EAAe,aAAA,CAAc,UAAA;EA9eX;;;;EAAA,SAmflB,mBAAA,EAAqB,WAAA,SAAoB,cAAA;AAAA;;;;cAiXvC,uBAAA,GACX,KAAA,EAAO,aAAA,CAAc,QAAA,GACrB,IAAA,EAAM,eAAA,iBACL,MAAA,CAAO,MAAA,CAAO,WAAA,SAAoB,kBAAA,GAAqB,SAAA;AA/1B1D;AAAA,cA+iCa,gBAAA,GAAoB,KAAA;EAAA,SACtB,KAAA,EAAO,aAAA,CAAc,OAAA;EAAA,SACrB,SAAA,EAAW,aAAA,CAAc,YAAA;EAAA,SACzB,KAAA,EAAO,aAAA,CAAc,QAAA;EAAA,SACrB,MAAA,GAAS,QAAA,CAAS,MAAA,SAAe,gBAAA;EAAA,SACjC,YAAA,GAAe,QAAA,CAAS,MAAA,SAAe,oBAAA;EAAA,SACvC,mBAAA,GAAsB,WAAA,SAAoB,kBAAA;AAAA,MACjD,MAAA,CAAO,MAAA,CAAO,iBAAA;AAAA,cA+iBL,YAAA,GACX,MAAA,EAAQ,eAAA,KACP,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,cAAA,EAAgB,kBAAA,GAAqB,WAAA,GAAc,UAAA;AAAA,cAuBnE,YAAA,GACX,MAAA,EAAQ,eAAA,KACP,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,cAAA,EAAgB,UAAA,GAAa,YAAA;AAAA,cAoD7C,GAAA,GACX,MAAA,EAAQ,SAAA,KACP,MAAA,CAAO,MAAA,CACR,UAAA,EACA,cAAA,EACA,kBAAA,GAAqB,WAAA,GAAc,UAAA,GAAa,YAAA"}
+{"version":3,"file":"run.d.mts","names":[],"sources":["../../src/loop/run.ts"],"mappings":"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"}