@effect-agent/pr-review 0.0.1-beta.0 → 0.1.0-beta.8

package/dist/action.d.mts

@@ -1,4 +1,4 @@
-import { J as ReviewPublisher, K as PriorReviews, U as GitHubApiFailure, _n as ChangedFile, ct as ReviewMode, fn as PullRequestMetadata, mn as PullRequestSourceFailure, pn as PullRequestSource, pt as ReviewStateAuthenticator } from "./fan-out-Dy84-dIs.mjs";
+import { W as GitHubApiFailure, Y as ReviewPublisher, hn as PullRequestSourceFailure, lt as ReviewMode, mn as PullRequestSource, mt as ReviewStateAuthenticator, pn as PullRequestMetadata, q as PriorReviews, vn as ChangedFile } from "./fan-out-BBEATQwc.mjs";
 import { EffortPosition, InvalidEffortInput, ReviewProvider, ReviewRunOutcome, ReviewTargetUnresolved, RunReviewOptions } from "./index.mjs";
 import { Config, Effect, FileSystem, Schema } from "effect";
 import { BudgetExceeded } from "effect-agent";
@@ -148,7 +148,7 @@ declare const reviewActionProgram: Effect.Effect<{
   reason?: undefined;
   _tag: "Completed";
   outcome: ReviewRunOutcome;
-}, import("effect-agent").AgentApprovalDenied | import("effect-agent").AgentApprovalPending | import("effect-agent").AgentChildPending | import("effect-agent").AgentInputError | import("effect-agent").AgentOutputError | import("effect-agent").AgentPolicyError | import("effect/unstable/ai/AiError").AiError | import("effect-agent").BudgetAdapterError | BudgetExceeded | Config.ConfigError | GitHubApiFailure | GuidanceFileUnreadable | InvalidEffortInput | InvalidMaxDurationInput | import("effect-agent").ModelProtocolError | import("effect/PlatformError").PlatformError | PullRequestSourceFailure | ReviewGateFailed | ReviewTargetUnresolved | Schema.SchemaError, FileSystem.FileSystem>;
+}, import("effect-agent").AgentApprovalDenied | import("effect-agent").AgentApprovalPending | import("effect-agent").AgentChildPending | import("effect-agent").AgentInputError | import("effect-agent").AgentOutputError | import("effect-agent").AgentPolicyError | import("effect/unstable/ai/AiError").AiError | import("effect-agent").BudgetAdapterError | BudgetExceeded | Config.ConfigError | import("effect-agent").ContextOverflowError | GitHubApiFailure | GuidanceFileUnreadable | InvalidEffortInput | InvalidMaxDurationInput | import("effect-agent").ModelProtocolError | import("effect/PlatformError").PlatformError | PullRequestSourceFailure | ReviewGateFailed | ReviewTargetUnresolved | Schema.SchemaError, FileSystem.FileSystem>;
 /** Run the packaged action program on Node; the bundled action entrypoint. */
 declare const main: () => void;
 /** The packaged GitHub Actions surface. */
@@ -177,7 +177,7 @@ declare const PrReviewAction: {
     reason?: undefined;
     _tag: "Completed";
     outcome: ReviewRunOutcome;
-  }, import("effect-agent").AgentApprovalDenied | import("effect-agent").AgentApprovalPending | import("effect-agent").AgentChildPending | import("effect-agent").AgentInputError | import("effect-agent").AgentOutputError | import("effect-agent").AgentPolicyError | import("effect/unstable/ai/AiError").AiError | import("effect-agent").BudgetAdapterError | BudgetExceeded | Config.ConfigError | GitHubApiFailure | GuidanceFileUnreadable | InvalidEffortInput | InvalidMaxDurationInput | import("effect-agent").ModelProtocolError | import("effect/PlatformError").PlatformError | PullRequestSourceFailure | ReviewGateFailed | ReviewTargetUnresolved | Schema.SchemaError, FileSystem.FileSystem>;
+  }, import("effect-agent").AgentApprovalDenied | import("effect-agent").AgentApprovalPending | import("effect-agent").AgentChildPending | import("effect-agent").AgentInputError | import("effect-agent").AgentOutputError | import("effect-agent").AgentPolicyError | import("effect/unstable/ai/AiError").AiError | import("effect-agent").BudgetAdapterError | BudgetExceeded | Config.ConfigError | import("effect-agent").ContextOverflowError | GitHubApiFailure | GuidanceFileUnreadable | InvalidEffortInput | InvalidMaxDurationInput | import("effect-agent").ModelProtocolError | import("effect/PlatformError").PlatformError | PullRequestSourceFailure | ReviewGateFailed | ReviewTargetUnresolved | Schema.SchemaError, FileSystem.FileSystem>;
   readonly main: typeof main;
 };
 //#endregion

package/dist/action.mjs

@@ -1,5 +1,5 @@
-import { M as unavailableReviewStateAuthenticatorLayer, O as selectReviewRange, P as webCryptoReviewStateAuthenticatorLayer, an as normalizeRepoRelativePath, i as PriorReviews, k as selectedPullRequestSourceLayer, m as ReviewHeadComparison, nn as PullRequestSource, p as ReviewExecutionContext, y as ReviewStateAuthenticator } from "./github-bwQ2V-wb.mjs";
-import { A as InvalidEffortInput, M as parseEffortPosition, a as anthropicClientLayer, b as fanOutReviewBudgetLimits, c as makeOpenAiReviewModel, f as gitHubReviewLayers, h as PrReview, l as openAiClientLayer, m as resolveReviewTarget, n as DEFAULT_PROVIDER, o as describeReviewModel, p as readGitHubEvent, s as makeAnthropicReviewModel, x as reviewBudgetLimits } from "./providers-DyLJlpJQ.mjs";
+import { M as unavailableReviewStateAuthenticatorLayer, O as selectReviewRange, P as webCryptoReviewStateAuthenticatorLayer, i as PriorReviews, k as selectedPullRequestSourceLayer, m as ReviewHeadComparison, on as normalizeRepoRelativePath, p as ReviewExecutionContext, rn as PullRequestSource, y as ReviewStateAuthenticator } from "./github-BZNzmxao.mjs";
+import { A as InvalidEffortInput, M as parseEffortPosition, a as anthropicClientLayer, b as fanOutReviewBudgetLimits, c as makeOpenAiReviewModel, f as gitHubReviewLayers, h as PrReview, l as openAiClientLayer, m as resolveReviewTarget, n as DEFAULT_PROVIDER, o as describeReviewModel, p as readGitHubEvent, s as makeAnthropicReviewModel, x as reviewBudgetLimits } from "./providers-J6BKHyHe.mjs";
 import { Config, Console, Effect, FileSystem, Layer, Option, Redacted, Schema } from "effect";
 import { BudgetExceeded, UsageBudgetLimits } from "effect-agent";
 import { NodeRuntime, NodeServices } from "@effect/platform-node";

package/dist/cli.mjs

@@ -1,5 +1,5 @@
-import { s as fingerprintUnchanged } from "./github-bwQ2V-wb.mjs";
-import { A as InvalidEffortInput, M as parseEffortPosition, a as anthropicClientLayer, c as makeOpenAiReviewModel, f as gitHubReviewLayers, h as PrReview, l as openAiClientLayer, m as resolveReviewTarget, n as DEFAULT_PROVIDER, o as describeReviewModel, s as makeAnthropicReviewModel, t as DEFAULT_MODEL, w as ReviewPublicationPlan } from "./providers-DyLJlpJQ.mjs";
+import { s as fingerprintUnchanged } from "./github-BZNzmxao.mjs";
+import { A as InvalidEffortInput, M as parseEffortPosition, a as anthropicClientLayer, c as makeOpenAiReviewModel, f as gitHubReviewLayers, h as PrReview, l as openAiClientLayer, m as resolveReviewTarget, n as DEFAULT_PROVIDER, o as describeReviewModel, s as makeAnthropicReviewModel, t as DEFAULT_MODEL, w as ReviewPublicationPlan } from "./providers-J6BKHyHe.mjs";
 import { Console, Effect, Layer, Option, Schema } from "effect";
 import { BudgetExceeded } from "effect-agent";
 import { NodeRuntime, NodeServices } from "@effect/platform-node";

package/dist/{fan-out-Dy84-dIs.d.mts → fan-out-BBEATQwc.d.mts}

@@ -1,5 +1,5 @@
 import { Context, Effect, Layer, Option, Redacted, Schema } from "effect";
-import { AgentPolicy, AgentSpawner, IdGenerator, RunEvent, RunEventSink, RuntimeBinding, SubagentBudgetExhausted, SubagentDurability, SubagentDurabilityError, SubagentExecutionFailure, SubagentPolicy, SubagentPrestartDenied, SubagentProjectionFailure, ToolCallWaiting } from "effect-agent";
+import { AgentPolicy, RunEvent, RuntimeBinding, SubagentPolicy } from "effect-agent";
 import { Tool, Toolkit } from "effect/unstable/ai";
 import { HttpClient } from "effect/unstable/http";
 //#region src/internal/diff.d.ts
@@ -695,6 +695,11 @@ declare const rankAndDedupeFindings: (findings: ReadonlyArray<ReviewFinding>) =>
 declare const MAX_CHILD_FINDINGS = 8;
 /** One child returns at most this many non-anchored concerns. */
 declare const MAX_CHILD_CONCERNS = 3;
+/**
+ * One mandatory diff read plus one bounded context read for every path in a
+ * maximum-size unit. Keep the child and delegation reservation aligned.
+ */
+declare const MAX_FILE_REVIEW_TOOL_CALLS: number;
 declare const FileReviewToolkit: Toolkit.Toolkit<{
   readonly read_file: Tool.Tool<"read_file", {
     readonly parameters: typeof FileSliceQuery;
@@ -790,14 +795,6 @@ declare const mapFileReviewChildFailure: (failure: {
   readonly _tag: string;
   readonly message?: string;
 }) => FileReviewUnitFailed;
-/** Exactly the failure union `Subagent.define` declares for this delegation. */
-declare const FileReviewDelegationFailure: Schema.Union<readonly [typeof FileReviewUnitFailed, typeof SubagentPrestartDenied, typeof SubagentBudgetExhausted, typeof SubagentProjectionFailure, typeof SubagentExecutionFailure, typeof ToolCallWaiting, typeof SubagentDurabilityError]>;
-declare const DelegateFileReview: Tool.Tool<"delegate_file_review", {
-  readonly parameters: typeof FileReviewRequest;
-  readonly success: typeof FileReviewUnitResult;
-  readonly failure: Schema.Union<readonly [typeof FileReviewUnitFailed, typeof SubagentPrestartDenied, typeof SubagentBudgetExhausted, typeof SubagentProjectionFailure, typeof SubagentExecutionFailure, typeof ToolCallWaiting, typeof SubagentDurabilityError]>;
-  readonly failureMode: "return";
-}, AgentSpawner | IdGenerator | RunEventSink | SubagentDurability>;
 declare const ListReviewUnitsQuery_base: Schema.Class<ListReviewUnitsQuery, Schema.Struct<{
   /** Explicit constant keeps the zero-choice operation compatible with strict provider schemas. */
   readonly scope: Schema.Literal<"all">;
@@ -818,20 +815,6 @@ declare const FanOutCoordinatorToolkit: Toolkit.Toolkit<{
   }, PullRequestSource>;
 }>;
 declare const FanOutCoordinatorToolkitLayer: import("effect/Layer").Layer<Tool.Handler<"list_review_units">, never, never>;
-declare const FanOutReviewToolkit: Toolkit.Toolkit<{
-  readonly delegate_file_review: Tool.Tool<"delegate_file_review", {
-    readonly parameters: typeof FileReviewRequest;
-    readonly success: typeof FileReviewUnitResult;
-    readonly failure: Schema.Union<readonly [typeof FileReviewUnitFailed, typeof SubagentPrestartDenied, typeof SubagentBudgetExhausted, typeof SubagentProjectionFailure, typeof SubagentExecutionFailure, typeof ToolCallWaiting, typeof SubagentDurabilityError]>;
-    readonly failureMode: "return";
-  }, AgentSpawner | IdGenerator | RunEventSink | SubagentDurability>;
-  readonly list_review_units: Tool.Tool<"list_review_units", {
-    readonly parameters: typeof ListReviewUnitsQuery;
-    readonly success: typeof ReviewUnitPlan;
-    readonly failure: typeof PullRequestSourceFailure;
-    readonly failureMode: "error";
-  }, PullRequestSource>;
-}>;
 /**
  * Build the coordinator's instructions. The same consumer guidance the
  * children receive is injected between the mission framing and the procedure
@@ -870,20 +853,6 @@ declare const makeFileReviewerDefinition: (options?: FanOutInstructionOptions) =
 interface FanOutSuiteOptions extends FanOutInstructionOptions {
   readonly maxFindings?: number | undefined;
 }
-declare const makeFanOutReviewerDefinition: (options?: FanOutSuiteOptions) => import("effect-agent").Definition<typeof ReviewMission, typeof CodeReview, (mission: ReviewMission) => string, Toolkit.Toolkit<{
-  readonly delegate_file_review: Tool.Tool<"delegate_file_review", {
-    readonly parameters: typeof FileReviewRequest;
-    readonly success: typeof FileReviewUnitResult;
-    readonly failure: Schema.Union<readonly [typeof FileReviewUnitFailed, typeof SubagentPrestartDenied, typeof SubagentBudgetExhausted, typeof SubagentProjectionFailure, typeof SubagentExecutionFailure, typeof ToolCallWaiting, typeof SubagentDurabilityError]>;
-    readonly failureMode: "return";
-  }, AgentSpawner | IdGenerator | RunEventSink | SubagentDurability>;
-  readonly list_review_units: Tool.Tool<"list_review_units", {
-    readonly parameters: typeof ListReviewUnitsQuery;
-    readonly success: typeof ReviewUnitPlan;
-    readonly failure: typeof PullRequestSourceFailure;
-    readonly failureMode: "error";
-  }, PullRequestSource>;
-}>>;
 declare const makeFileReviewDelegation: (child: ReturnType<typeof makeFileReviewerDefinition>) => import("effect-agent").SubagentDelegation<"delegate_file_review", typeof FileReviewBrief, typeof FileReviewReport, (brief: FileReviewBrief) => string, {
   readonly read_file: Tool.Tool<"read_file", {
     readonly parameters: typeof FileSliceQuery;
@@ -897,7 +866,21 @@ declare const makeFileReviewDelegation: (child: ReturnType<typeof makeFileReview
     readonly failure: Schema.Union<readonly [typeof PullRequestSourceFailure, typeof ReviewInputViolation]>;
     readonly failureMode: "return";
   }, PullRequestSource>;
-}, typeof FileReviewRequest, typeof FileReviewUnitResult, typeof FileReviewUnitFailed, never, never>;
+}, typeof FileReviewRequest, typeof FileReviewUnitResult, typeof FileReviewUnitFailed, never, never, "return">;
+declare const makeFanOutReviewerDefinition: (options: FanOutSuiteOptions, delegation: ReturnType<typeof makeFileReviewDelegation>) => import("effect-agent").Definition<typeof ReviewMission, typeof CodeReview, (mission: ReviewMission) => string, Toolkit.Toolkit<{
+  readonly delegate_file_review: Tool.Tool<"delegate_file_review", {
+    readonly parameters: typeof FileReviewRequest;
+    readonly success: Schema.Union<readonly [typeof FileReviewUnitResult, import("effect-agent").SubagentContainedFailure<typeof FileReviewUnitFailed>]>;
+    readonly failure: import("effect-agent").SubagentReturnModeFailure;
+    readonly failureMode: "error";
+  }, import("effect-agent").AgentSpawner | import("effect-agent").IdGenerator | import("effect-agent").RunEventSink | import("effect-agent").SubagentDurability>;
+  readonly list_review_units: Tool.Tool<"list_review_units", {
+    readonly parameters: typeof ListReviewUnitsQuery;
+    readonly success: typeof ReviewUnitPlan;
+    readonly failure: typeof PullRequestSourceFailure;
+    readonly failureMode: "error";
+  }, PullRequestSource>;
+}>>;
 /** Build one coherent fan-out suite: child, coordinator, and delegation. */
 declare const makeFanOutReviewSuite: (options?: FanOutSuiteOptions) => FanOutReviewSuite;
 /** The default child Agent Definition. */
@@ -919,10 +902,10 @@ declare const FileReviewer: import("effect-agent").Definition<typeof FileReviewB
 declare const FanOutReviewer: import("effect-agent").Definition<typeof ReviewMission, typeof CodeReview, (mission: ReviewMission) => string, Toolkit.Toolkit<{
   readonly delegate_file_review: Tool.Tool<"delegate_file_review", {
     readonly parameters: typeof FileReviewRequest;
-    readonly success: typeof FileReviewUnitResult;
-    readonly failure: Schema.Union<readonly [typeof FileReviewUnitFailed, typeof SubagentPrestartDenied, typeof SubagentBudgetExhausted, typeof SubagentProjectionFailure, typeof SubagentExecutionFailure, typeof ToolCallWaiting, typeof SubagentDurabilityError]>;
-    readonly failureMode: "return";
-  }, AgentSpawner | IdGenerator | RunEventSink | SubagentDurability>;
+    readonly success: Schema.Union<readonly [typeof FileReviewUnitResult, import("effect-agent").SubagentContainedFailure<typeof FileReviewUnitFailed>]>;
+    readonly failure: import("effect-agent").SubagentReturnModeFailure;
+    readonly failureMode: "error";
+  }, import("effect-agent").AgentSpawner | import("effect-agent").IdGenerator | import("effect-agent").RunEventSink | import("effect-agent").SubagentDurability>;
   readonly list_review_units: Tool.Tool<"list_review_units", {
     readonly parameters: typeof ListReviewUnitsQuery;
     readonly success: typeof ReviewUnitPlan;
@@ -944,7 +927,35 @@ declare const fileReviewDelegation: import("effect-agent").SubagentDelegation<"d
     readonly failure: Schema.Union<readonly [typeof PullRequestSourceFailure, typeof ReviewInputViolation]>;
     readonly failureMode: "return";
   }, PullRequestSource>;
-}, typeof FileReviewRequest, typeof FileReviewUnitResult, typeof FileReviewUnitFailed, never, never>;
+}, typeof FileReviewRequest, typeof FileReviewUnitResult, typeof FileReviewUnitFailed, never, never, "return">;
+/** The default coordinator-facing delegation Tool (first-party contained mode). */
+declare const DelegateFileReview: Tool.Tool<"delegate_file_review", {
+  readonly parameters: typeof FileReviewRequest;
+  readonly success: Schema.Union<readonly [typeof FileReviewUnitResult, import("effect-agent").SubagentContainedFailure<typeof FileReviewUnitFailed>]>;
+  readonly failure: import("effect-agent").SubagentReturnModeFailure;
+  readonly failureMode: "error";
+}, import("effect-agent").AgentSpawner | import("effect-agent").IdGenerator | import("effect-agent").RunEventSink | import("effect-agent").SubagentDurability>;
+/** The default coordinator Toolkit. */
+declare const FanOutReviewToolkit: Toolkit.Toolkit<{
+  readonly delegate_file_review: Tool.Tool<"delegate_file_review", {
+    readonly parameters: typeof FileReviewRequest;
+    readonly success: Schema.Union<readonly [typeof FileReviewUnitResult, import("effect-agent").SubagentContainedFailure<typeof FileReviewUnitFailed>]>;
+    readonly failure: import("effect-agent").SubagentReturnModeFailure;
+    readonly failureMode: "error";
+  }, import("effect-agent").AgentSpawner | import("effect-agent").IdGenerator | import("effect-agent").RunEventSink | import("effect-agent").SubagentDurability>;
+  readonly list_review_units: Tool.Tool<"list_review_units", {
+    readonly parameters: typeof ListReviewUnitsQuery;
+    readonly success: typeof ReviewUnitPlan;
+    readonly failure: typeof PullRequestSourceFailure;
+    readonly failureMode: "error";
+  }, PullRequestSource>;
+}>;
+/**
+ * The contained failure family the delegation can surface as result data
+ * (SUB-033), derived from the delegation itself so the coverage decoder can
+ * never diverge from what the runtime actually contains.
+ */
+declare const FileReviewDelegationFailure: import("effect-agent").SubagentContainedFailure<typeof FileReviewUnitFailed>;
 /** Runtime wiring: one delegation plus one explicit child Binding. */
 declare const fanOutHandlersLayerFor: (delegation: ReturnType<typeof makeFileReviewDelegation>) => <Provider, ModelProvides, ModelRequires>(childBinding: RuntimeBinding<typeof FileReviewBrief, typeof FileReviewReport, ReturnType<typeof makeFileReviewerInstructions>, Toolkit.Tools<typeof FileReviewToolkit>, Provider, ModelProvides, ModelRequires>) => import("effect/Layer").Layer<Tool.Handler<"delegate_file_review">, never, import("effect-agent").SubagentLayerRequirements<typeof FileReviewBrief, typeof FileReviewReport, (brief: FileReviewBrief) => string, {
   readonly read_file: Tool.Tool<"read_file", {
@@ -982,5 +993,5 @@ declare const fanOutHandlersLayer: <Provider, ModelProvides, ModelRequires>(chil
   readonly message?: string;
 }, never>>;
 //#endregion
-export { ReviewCommentDraft as $, defaultReviewPolicy as $t, makeFanOutReviewInstructions as A, ChangedFilesView as At, UNIT_CHANGED_LINE_BUDGET as B, MAX_FINDINGS as Bt, defaultFileReviewerPolicy as C, parsePatch as Cn, selectedPullRequestSourceLayer as Ct, fileReviewDelegation as D, validateReviewState as Dt, fanOutReviewInstructions as E, unavailableReviewStateAuthenticatorLayer as Et, MAX_REVIEW_UNITS as F, FileSliceQuery as Ft, PriorReviewLookupFailure as G, ReviewFinding as Gt, rankAndDedupeFindings as H, ReadFile as Ht, MAX_UNIT_FILES as I, FindingSeverity as It, ReviewPublisher as J, ReviewMission as Jt, PriorReviews as K, ReviewGuidance as Kt, ReviewUnit as L, ListChangedFiles as Lt, makeFileReviewerInstructions as M, FileDiffQuery as Mt, mapFileReviewChildFailure as N, FileDiffView as Nt, fileReviewPolicy as O, webCryptoReviewStateAuthenticatorLayer as Ot, MAX_MERGED_FINDINGS as P, FileSlice as Pt, gitHubReviewPublisherLayer as Q, clampMaxFindings as Qt, ReviewUnitId as R, ListChangedFilesQuery as Rt, defaultFanOutPolicy as S, commentableLines as Sn, selectReviewRange as St, fanOutHandlersLayerFor as T, toStoredFinding as Tt, GitHubApiFailure as U, ReadFileDiff as Ut, planReviewUnits as V, PullRequestReviewer as Vt, GitHubReviewTarget as W, ReviewConcern as Wt, gitHubPriorReviewsLayer as X, ReviewToolkitLayer as Xt, fingerprintUnchanged as Y, ReviewToolkit as Yt, gitHubPullRequestSourceLayer as Z, ReviewVerdict as Zt, FileReviewer as _, ChangedFile as _n, StoredReviewFinding as _t, FanOutReviewSuite as a, reviewInstructions as an, MAX_REVIEW_STATE_MARKER_CHARS as at, MAX_CHILD_CONCERNS as b, PatchLine as bn, fromStoredConcern as bt, FanOutSuiteOptions as c, ReviewShape as cn, ReviewMode as ct, FileReviewReport as d, MAX_FILE_CHARS as dn, ReviewState as dt, listChangedFilesHandler as en, ReviewEvent as et, FileReviewRequest as f, PullRequestMetadata as fn, ReviewStateAuthenticationFailure as ft, FileReviewUnitResult as g, normalizeRepoRelativePath as gn, StoredReviewConcern as gt, FileReviewUnitFailed as h, ReviewInputViolation as hn, ReviewStateMarkerTooLarge as ht, FanOutInstructionOptions as i, resolveGuidance as in, GitCommitSha as it, makeFanOutReviewSuite as j, CodeReview as jt, fileReviewerInstructions as k, ChangedFileSummary as kt, FileReviewBrief as l, assessReviewCoverage as ln, ReviewScopeMode as lt, FileReviewToolkitLayer as m, PullRequestSourceFailure as mn, ReviewStateMarker as mt, FanOutCoordinatorToolkit as n, readFileDiffHandler as nn, anchorViolation as nt, FanOutReviewToolkit as o, FailedReviewUnit as on, ReviewExecutionContext as ot, FileReviewToolkit as p, PullRequestSource as pn, ReviewStateAuthenticator as pt, PublishedReview as q, ReviewInstructionOptions as qt, FanOutCoordinatorToolkitLayer as r, readFileHandler as rn, planPublication as rt, FanOutReviewer as s, ReviewCoverage as sn, ReviewHeadComparison as st, DelegateFileReview as t, makeReviewInstructions as tn, ReviewPublicationPlan as tt, FileReviewDelegationFailure as u, MAX_CHANGED_FILES as un, ReviewSelection as ut, ListReviewUnits as v, ChangedFileStatus as vn, buildProfileMission as vt, fanOutHandlersLayer as w, toStoredConcern as wt, MAX_CHILD_FINDINGS as x, annotatePatch as xn, fromStoredFinding as xt, ListReviewUnitsQuery as y, ChangedPath as yn, computeProfileFingerprint as yt, ReviewUnitPlan as z, MAX_CONCERNS as zt };
-//# sourceMappingURL=fan-out-Dy84-dIs.d.mts.map
+export { gitHubReviewPublisherLayer as $, clampMaxFindings as $t, fileReviewerInstructions as A, ChangedFileSummary as At, ReviewUnitPlan as B, MAX_CONCERNS as Bt, defaultFanOutPolicy as C, commentableLines as Cn, selectReviewRange as Ct, fanOutReviewInstructions as D, unavailableReviewStateAuthenticatorLayer as Dt, fanOutHandlersLayerFor as E, toStoredFinding as Et, MAX_MERGED_FINDINGS as F, FileSlice as Ft, GitHubReviewTarget as G, ReviewConcern as Gt, planReviewUnits as H, PullRequestReviewer as Ht, MAX_REVIEW_UNITS as I, FileSliceQuery as It, PublishedReview as J, ReviewInstructionOptions as Jt, PriorReviewLookupFailure as K, ReviewFinding as Kt, MAX_UNIT_FILES as L, FindingSeverity as Lt, makeFanOutReviewSuite as M, CodeReview as Mt, makeFileReviewerInstructions as N, FileDiffQuery as Nt, fileReviewDelegation as O, validateReviewState as Ot, mapFileReviewChildFailure as P, FileDiffView as Pt, gitHubPullRequestSourceLayer as Q, ReviewVerdict as Qt, ReviewUnit as R, ListChangedFiles as Rt, MAX_FILE_REVIEW_TOOL_CALLS as S, annotatePatch as Sn, fromStoredFinding as St, fanOutHandlersLayer as T, toStoredConcern as Tt, rankAndDedupeFindings as U, ReadFile as Ut, UNIT_CHANGED_LINE_BUDGET as V, MAX_FINDINGS as Vt, GitHubApiFailure as W, ReadFileDiff as Wt, fingerprintUnchanged as X, ReviewToolkit as Xt, ReviewPublisher as Y, ReviewMission as Yt, gitHubPriorReviewsLayer as Z, ReviewToolkitLayer as Zt, FileReviewer as _, normalizeRepoRelativePath as _n, StoredReviewConcern as _t, FanOutReviewSuite as a, resolveGuidance as an, GitCommitSha as at, MAX_CHILD_CONCERNS as b, ChangedPath as bn, computeProfileFingerprint as bt, FanOutSuiteOptions as c, ReviewCoverage as cn, ReviewHeadComparison as ct, FileReviewReport as d, MAX_CHANGED_FILES as dn, ReviewSelection as dt, defaultReviewPolicy as en, ReviewCommentDraft as et, FileReviewRequest as f, MAX_FILE_CHARS as fn, ReviewState as ft, FileReviewUnitResult as g, ReviewInputViolation as gn, ReviewStateMarkerTooLarge as gt, FileReviewUnitFailed as h, PullRequestSourceFailure as hn, ReviewStateMarker as ht, FanOutInstructionOptions as i, readFileHandler as in, planPublication as it, makeFanOutReviewInstructions as j, ChangedFilesView as jt, fileReviewPolicy as k, webCryptoReviewStateAuthenticatorLayer as kt, FileReviewBrief as l, ReviewShape as ln, ReviewMode as lt, FileReviewToolkitLayer as m, PullRequestSource as mn, ReviewStateAuthenticator as mt, FanOutCoordinatorToolkit as n, makeReviewInstructions as nn, ReviewPublicationPlan as nt, FanOutReviewToolkit as o, reviewInstructions as on, MAX_REVIEW_STATE_MARKER_CHARS as ot, FileReviewToolkit as p, PullRequestMetadata as pn, ReviewStateAuthenticationFailure as pt, PriorReviews as q, ReviewGuidance as qt, FanOutCoordinatorToolkitLayer as r, readFileDiffHandler as rn, anchorViolation as rt, FanOutReviewer as s, FailedReviewUnit as sn, ReviewExecutionContext as st, DelegateFileReview as t, listChangedFilesHandler as tn, ReviewEvent as tt, FileReviewDelegationFailure as u, assessReviewCoverage as un, ReviewScopeMode as ut, ListReviewUnits as v, ChangedFile as vn, StoredReviewFinding as vt, defaultFileReviewerPolicy as w, parsePatch as wn, selectedPullRequestSourceLayer as wt, MAX_CHILD_FINDINGS as x, PatchLine as xn, fromStoredConcern as xt, ListReviewUnitsQuery as y, ChangedFileStatus as yn, buildProfileMission as yt, ReviewUnitId as z, ListChangedFilesQuery as zt };
+//# sourceMappingURL=fan-out-BBEATQwc.d.mts.map

package/dist/{github-bwQ2V-wb.mjs → github-BZNzmxao.mjs}

@@ -1,5 +1,5 @@
 import { Context, Effect, Encoding, Layer, Option, Redacted, Result, Schema } from "effect";
-import { Agent, AgentPolicy, AgentSpawner, IdGenerator, RunEventSink, Subagent, SubagentBudgetExhausted, SubagentDurability, SubagentDurabilityError, SubagentExecutionFailure, SubagentPolicy, SubagentPrestartDenied, SubagentProjectionFailure, SubagentRuntime, ToolCallWaiting, ToolExecutionClass } from "effect-agent";
+import { Agent, AgentPolicy, Subagent, SubagentPolicy, SubagentRuntime, ToolExecutionClass } from "effect-agent";
 import { Tool, Toolkit } from "effect/unstable/ai";
 import { HttpClient, HttpClientRequest, HttpClientResponse } from "effect/unstable/http";
 //#region src/internal/diff.ts
@@ -414,7 +414,9 @@ const defaultReviewPolicy = AgentPolicy.make({
 	maxToolCalls: 24,
 	maxDuration: "8 minutes",
 	toolConcurrency: 2,
-	tokenBudget: 3e5
+	tokenBudget: 3e5,
+	contextTokenLimit: 15e4,
+	onExhaustion: "final-answer"
 });
 const PullRequestReviewer = Agent.define("pr-reviewer", {
 	input: ReviewMission,
@@ -549,6 +551,11 @@ const rankAndDedupeFindings = (findings) => {
 const MAX_CHILD_FINDINGS = 8;
 /** One child returns at most this many non-anchored concerns. */
 const MAX_CHILD_CONCERNS = 3;
+/**
+* One mandatory diff read plus one bounded context read for every path in a
+* maximum-size unit. Keep the child and delegation reservation aligned.
+*/
+const MAX_FILE_REVIEW_TOOL_CALLS = 24;
 const FileReviewToolkit = Toolkit.make(ReadFileDiff, ReadFile);
 const FileReviewToolkitLayer = FileReviewToolkit.toLayer({
 	read_file_diff: readFileDiffHandler,
@@ -589,10 +596,12 @@ const fileReviewerInstructions = makeFileReviewerInstructions();
 /** The default per-unit child execution bounds. */
 const defaultFileReviewerPolicy = AgentPolicy.make({
 	maxTurns: 8,
-	maxToolCalls: 16,
+	maxToolCalls: MAX_FILE_REVIEW_TOOL_CALLS,
 	maxDuration: "4 minutes",
 	toolConcurrency: 2,
-	tokenBudget: 2e5
+	tokenBudget: 2e5,
+	contextTokenLimit: 15e4,
+	onExhaustion: "fail"
 });
 /** The model-decoded delegation parameters: which unit to review. */
 var FileReviewRequest = class extends Schema.Class("@effect-agent/pr-review/FileReviewRequest")({
@@ -624,7 +633,7 @@ const fileReviewPolicy = SubagentPolicy.make({
 	maxChildren: 8,
 	maxConcurrency: 3,
 	maxTurns: 8,
-	maxToolCalls: 16,
+	maxToolCalls: MAX_FILE_REVIEW_TOOL_CALLS,
 	maxDuration: "4 minutes"
 });
 const delegationDescription = "Delegate the review of one planned unit to a bounded file-reviewer child and return its line-anchored findings. Call it exactly once per unit from list_review_units; never retry a failed unit.";
@@ -636,23 +645,6 @@ const mapFileReviewChildFailure = (failure) => FileReviewUnitFailed.make({
 	childErrorTag: failure._tag,
 	message: (failure.message ?? "").slice(0, 400)
 });
-/** Exactly the failure union `Subagent.define` declares for this delegation. */
-const FileReviewDelegationFailure = Schema.Union([
-	FileReviewUnitFailed,
-	SubagentPrestartDenied,
-	SubagentBudgetExhausted,
-	SubagentProjectionFailure,
-	SubagentExecutionFailure,
-	ToolCallWaiting,
-	SubagentDurabilityError
-]);
-const DelegateFileReview = Tool.make("delegate_file_review", {
-	description: delegationDescription,
-	parameters: FileReviewRequest,
-	success: FileReviewUnitResult,
-	failure: FileReviewDelegationFailure,
-	failureMode: "return"
-}).addDependency(AgentSpawner).addDependency(RunEventSink).addDependency(SubagentDurability).addDependency(IdGenerator).annotate(ToolExecutionClass, "readonly");
 var ListReviewUnitsQuery = class extends Schema.Class("@effect-agent/pr-review/ListReviewUnitsQuery")({ 
 /** Explicit constant keeps the zero-choice operation compatible with strict provider schemas. */
 scope: Schema.Literal("all") }) {};
@@ -669,7 +661,6 @@ const FanOutCoordinatorToolkitLayer = FanOutCoordinatorToolkit.toLayer({ list_re
 	const source = yield* PullRequestSource;
 	return planReviewUnits(yield* source.changedFiles, { totalChangedFiles: (yield* source.metadata).totalChangedFiles });
 }) });
-const FanOutReviewToolkit = Toolkit.make(ListReviewUnits, DelegateFileReview);
 /**
 * Build the coordinator's instructions. The same consumer guidance the
 * children receive is injected between the mission framing and the procedure
@@ -700,8 +691,10 @@ const defaultFanOutPolicy = AgentPolicy.make({
 	maxToolCalls: 9,
 	maxDuration: "15 minutes",
 	toolConcurrency: 3,
-	repeatedFailureLimit: 9,
-	tokenBudget: 3e5
+	repeatedFailureLimit: 3,
+	tokenBudget: 3e5,
+	contextTokenLimit: 15e4,
+	onExhaustion: "final-answer"
 });
 const makeFileReviewerDefinition = (options = {}) => Agent.define("pr-file-reviewer", {
 	input: FileReviewBrief,
@@ -715,25 +708,13 @@ const makeFileReviewerDefinition = (options = {}) => Agent.define("pr-file-revie
 		surface: "read-only"
 	}
 });
-const makeFanOutReviewerDefinition = (options = {}) => Agent.define("pr-fanout-reviewer", {
-	input: ReviewMission,
-	output: CodeReview,
-	instructions: makeFanOutReviewInstructions(options),
-	toolkit: FanOutReviewToolkit,
-	policy: defaultFanOutPolicy,
-	description: "Coordinate one pull-request review by fanning bounded per-unit file reviews out to delegated children and merging their findings into one structured review.",
-	metadata: {
-		deploymentClass: "E",
-		surface: "read-only",
-		delegation: "S1-attached"
-	}
-});
 const makeFileReviewDelegation = (child) => Subagent.define("delegate_file_review", {
 	description: delegationDescription,
 	target: child,
 	parameters: FileReviewRequest,
 	success: FileReviewUnitResult,
 	failure: FileReviewUnitFailed,
+	failureMode: "return",
 	prepareInput: (request) => Effect.succeed(FileReviewBrief.make({
 		unitId: request.unitId,
 		paths: request.paths,
@@ -746,13 +727,34 @@ const makeFileReviewDelegation = (child) => Subagent.define("delegate_file_revie
 	})),
 	policy: fileReviewPolicy
 });
+/**
+* The coordinator-facing delegation Tool: the delegation's own first-party
+* contained Tool plus the read-only execution class (the delegated child's
+* whole tool surface is read-only). Effect AI resolves handlers by Tool name,
+* so `SubagentRuntime.layer`'s handler serves this annotated copy unchanged.
+*/
+const delegationToolFor = (delegation) => delegation.tool.annotate(ToolExecutionClass, "readonly");
+const makeFanOutReviewerDefinition = (options, delegation) => Agent.define("pr-fanout-reviewer", {
+	input: ReviewMission,
+	output: CodeReview,
+	instructions: makeFanOutReviewInstructions(options),
+	toolkit: Toolkit.make(ListReviewUnits, delegationToolFor(delegation)),
+	policy: defaultFanOutPolicy,
+	description: "Coordinate one pull-request review by fanning bounded per-unit file reviews out to delegated children and merging their findings into one structured review.",
+	metadata: {
+		deploymentClass: "E",
+		surface: "read-only",
+		delegation: "S1-attached"
+	}
+});
 /** Build one coherent fan-out suite: child, coordinator, and delegation. */
 const makeFanOutReviewSuite = (options = {}) => {
 	const child = makeFileReviewerDefinition({ guidance: options.guidance });
+	const delegation = makeFileReviewDelegation(child);
 	return {
 		child,
-		parent: makeFanOutReviewerDefinition(options),
-		delegation: makeFileReviewDelegation(child)
+		parent: makeFanOutReviewerDefinition(options, delegation),
+		delegation
 	};
 };
 const defaultSuite = makeFanOutReviewSuite();
@@ -762,6 +764,16 @@ const FileReviewer = defaultSuite.child;
 const FanOutReviewer = defaultSuite.parent;
 /** The default delegation over the default child. */
 const fileReviewDelegation = defaultSuite.delegation;
+/** The default coordinator-facing delegation Tool (first-party contained mode). */
+const DelegateFileReview = delegationToolFor(fileReviewDelegation);
+/** The default coordinator Toolkit. */
+const FanOutReviewToolkit = FanOutReviewer.toolkit;
+/**
+* The contained failure family the delegation can surface as result data
+* (SUB-033), derived from the delegation itself so the coverage decoder can
+* never diverge from what the runtime actually contains.
+*/
+const FileReviewDelegationFailure = fileReviewDelegation.containedFailure;
 /** Runtime wiring: one delegation plus one explicit child Binding. */
 const fanOutHandlersLayerFor = (delegation) => (childBinding) => SubagentRuntime.layer(delegation, childBinding, { mapChildFailure: mapFileReviewChildFailure });
 /** Runtime wiring over the default delegation, mirroring the leaf example. */
@@ -1355,6 +1367,6 @@ const fingerprintUnchanged = (current) => Effect.gen(function* () {
 	return Option.isSome(latest) && latest.value === current;
 });
 //#endregion
-export { ListReviewUnits as $, MAX_CHANGED_FILES as $t, toStoredConcern as A, FileSliceQuery as At, FanOutCoordinatorToolkit as B, ReviewFinding as Bt, StoredReviewFinding as C, rankAndDedupeFindings as Ct, fromStoredFinding as D, FileDiffQuery as Dt, fromStoredConcern as E, CodeReview as Et, FINGERPRINT_MARKER_LENGTH as F, MAX_FINDINGS as Ft, FileReviewDelegationFailure as G, clampMaxFindings as Gt, FanOutReviewToolkit as H, ReviewToolkit as Ht, computeChangesetFingerprint as I, PullRequestReviewer as It, FileReviewToolkit as J, makeReviewInstructions as Jt, FileReviewReport as K, defaultReviewPolicy as Kt, extractFingerprint as L, ReadFile as Lt, unavailableReviewStateAuthenticatorLayer as M, ListChangedFiles as Mt, validateReviewState as N, ListChangedFilesQuery as Nt, selectReviewRange as O, FileDiffView as Ot, webCryptoReviewStateAuthenticatorLayer as P, MAX_CONCERNS as Pt, FileReviewer as Q, reviewInstructions as Qt, renderFingerprintMarker as R, ReadFileDiff as Rt, StoredReviewConcern as S, planReviewUnits as St, computeProfileFingerprint as T, ChangedFilesView as Tt, FanOutReviewer as U, ReviewToolkitLayer as Ut, FanOutCoordinatorToolkitLayer as V, ReviewMission as Vt, FileReviewBrief as W, ReviewVerdict as Wt, FileReviewUnitFailed as X, readFileHandler as Xt, FileReviewToolkitLayer as Y, readFileDiffHandler as Yt, FileReviewUnitResult as Z, resolveGuidance as Zt, ReviewState as _, MAX_UNIT_FILES as _t, PublishedReview as a, normalizeRepoRelativePath as an, fanOutHandlersLayer as at, ReviewStateMarker as b, ReviewUnitPlan as bt, gitHubPriorReviewsLayer as c, ChangedPath as cn, fileReviewDelegation as ct, GitCommitSha as d, parsePatch as dn, makeFanOutReviewInstructions as dt, MAX_FILE_CHARS as en, ListReviewUnitsQuery as et, MAX_REVIEW_STATE_MARKER_CHARS as f, makeFanOutReviewSuite as ft, ReviewScopeMode as g, MAX_REVIEW_UNITS as gt, ReviewMode as h, MAX_MERGED_FINDINGS as ht, PriorReviews as i, ReviewInputViolation as in, defaultFileReviewerPolicy as it, toStoredFinding as j, FindingSeverity as jt, selectedPullRequestSourceLayer as k, FileSlice as kt, gitHubPullRequestSourceLayer as l, annotatePatch as ln, fileReviewPolicy as lt, ReviewHeadComparison as m, mapFileReviewChildFailure as mt, GitHubReviewTarget as n, PullRequestSource as nn, MAX_CHILD_FINDINGS as nt, ReviewPublisher as o, ChangedFile as on, fanOutHandlersLayerFor as ot, ReviewExecutionContext as p, makeFileReviewerInstructions as pt, FileReviewRequest as q, listChangedFilesHandler as qt, PriorReviewLookupFailure as r, PullRequestSourceFailure as rn, defaultFanOutPolicy as rt, fingerprintUnchanged as s, ChangedFileStatus as sn, fanOutReviewInstructions as st, GitHubApiFailure as t, PullRequestMetadata as tn, MAX_CHILD_CONCERNS as tt, gitHubReviewPublisherLayer as u, commentableLines as un, fileReviewerInstructions as ut, ReviewStateAuthenticationFailure as v, ReviewUnit as vt, buildProfileMission as w, ChangedFileSummary as wt, ReviewStateMarkerTooLarge as x, UNIT_CHANGED_LINE_BUDGET as xt, ReviewStateAuthenticator as y, ReviewUnitId as yt, DelegateFileReview as z, ReviewConcern as zt };
+export { ListReviewUnits as $, reviewInstructions as $t, toStoredConcern as A, FileSlice as At, FanOutCoordinatorToolkit as B, ReviewConcern as Bt, StoredReviewFinding as C, planReviewUnits as Ct, fromStoredFinding as D, CodeReview as Dt, fromStoredConcern as E, ChangedFilesView as Et, FINGERPRINT_MARKER_LENGTH as F, MAX_CONCERNS as Ft, FileReviewDelegationFailure as G, ReviewVerdict as Gt, FanOutReviewToolkit as H, ReviewMission as Ht, computeChangesetFingerprint as I, MAX_FINDINGS as It, FileReviewToolkit as J, listChangedFilesHandler as Jt, FileReviewReport as K, clampMaxFindings as Kt, extractFingerprint as L, PullRequestReviewer as Lt, unavailableReviewStateAuthenticatorLayer as M, FindingSeverity as Mt, validateReviewState as N, ListChangedFiles as Nt, selectReviewRange as O, FileDiffQuery as Ot, webCryptoReviewStateAuthenticatorLayer as P, ListChangedFilesQuery as Pt, FileReviewer as Q, resolveGuidance as Qt, renderFingerprintMarker as R, ReadFile as Rt, StoredReviewConcern as S, UNIT_CHANGED_LINE_BUDGET as St, computeProfileFingerprint as T, ChangedFileSummary as Tt, FanOutReviewer as U, ReviewToolkit as Ut, FanOutCoordinatorToolkitLayer as V, ReviewFinding as Vt, FileReviewBrief as W, ReviewToolkitLayer as Wt, FileReviewUnitFailed as X, readFileDiffHandler as Xt, FileReviewToolkitLayer as Y, makeReviewInstructions as Yt, FileReviewUnitResult as Z, readFileHandler as Zt, ReviewState as _, MAX_REVIEW_UNITS as _t, PublishedReview as a, ReviewInputViolation as an, defaultFileReviewerPolicy as at, ReviewStateMarker as b, ReviewUnitId as bt, gitHubPriorReviewsLayer as c, ChangedFileStatus as cn, fanOutReviewInstructions as ct, GitCommitSha as d, commentableLines as dn, fileReviewerInstructions as dt, MAX_CHANGED_FILES as en, ListReviewUnitsQuery as et, MAX_REVIEW_STATE_MARKER_CHARS as f, parsePatch as fn, makeFanOutReviewInstructions as ft, ReviewScopeMode as g, MAX_MERGED_FINDINGS as gt, ReviewMode as h, mapFileReviewChildFailure as ht, PriorReviews as i, PullRequestSourceFailure as in, defaultFanOutPolicy as it, toStoredFinding as j, FileSliceQuery as jt, selectedPullRequestSourceLayer as k, FileDiffView as kt, gitHubPullRequestSourceLayer as l, ChangedPath as ln, fileReviewDelegation as lt, ReviewHeadComparison as m, makeFileReviewerInstructions as mt, GitHubReviewTarget as n, PullRequestMetadata as nn, MAX_CHILD_FINDINGS as nt, ReviewPublisher as o, normalizeRepoRelativePath as on, fanOutHandlersLayer as ot, ReviewExecutionContext as p, makeFanOutReviewSuite as pt, FileReviewRequest as q, defaultReviewPolicy as qt, PriorReviewLookupFailure as r, PullRequestSource as rn, MAX_FILE_REVIEW_TOOL_CALLS as rt, fingerprintUnchanged as s, ChangedFile as sn, fanOutHandlersLayerFor as st, GitHubApiFailure as t, MAX_FILE_CHARS as tn, MAX_CHILD_CONCERNS as tt, gitHubReviewPublisherLayer as u, annotatePatch as un, fileReviewPolicy as ut, ReviewStateAuthenticationFailure as v, MAX_UNIT_FILES as vt, buildProfileMission as w, rankAndDedupeFindings as wt, ReviewStateMarkerTooLarge as x, ReviewUnitPlan as xt, ReviewStateAuthenticator as y, ReviewUnit as yt, DelegateFileReview as z, ReadFileDiff as zt };
 
-//# sourceMappingURL=github-bwQ2V-wb.mjs.map
+//# sourceMappingURL=github-BZNzmxao.mjs.map