effect-agent 0.1.0-beta.16 → 0.1.0-beta.161

package/dist/AgentPolicy-B4oH8TbG.d.mts

@@ -0,0 +1,112 @@
+import { n as ToolResultBounds } from "./ToolResult-BKdqWRff.mjs";
+import * as Schema from "effect/Schema";
+import * as Duration from "effect/Duration";
+declare namespace AgentPolicy_d_exports {
+  export { AgentPolicy, AgentPolicyInput, CompactionPolicy, CompactionPolicyInput };
+}
+declare const CompactionMode: Schema.Literals<readonly ["prune", "summarize", "prune-then-summarize"]>;
+/** Inputs normalized and validated by `CompactionPolicy.make`. */
+type CompactionPolicyInput = Readonly<{
+  /** Estimated tokens of recent history preserved verbatim across a compaction; defaults to `20_000`. */
+  readonly keepRecentTokens?: number;
+  /** Compaction strategy order; defaults to `"prune-then-summarize"`. */
+  readonly mode?: typeof CompactionMode.Type;
+}>;
+declare const CompactionPolicy_base: Schema.Class<CompactionPolicy, Schema.Struct<{
+  readonly keepRecentTokens: Schema.Int;
+  readonly mode: Schema.Literals<readonly ["prune", "summarize", "prune-then-summarize"]>;
+}>, {}>;
+/** How the engine reduces model context when `contextTokenLimit` is crossed. */
+declare class CompactionPolicy extends CompactionPolicy_base {
+  /** Normalize and validate compaction bounds, filling documented defaults. */
+  static make(input?: CompactionPolicyInput): CompactionPolicy;
+}
+/**
+ * Resolution when `maxTurns`, `maxToolCalls`, or `tokenBudget` is exhausted:
+ * `"final-answer"` gives the model one constrained opportunity to settle with
+ * output (the Run completes with `finishReason: "budget-exhausted"` and the
+ * exhausted-dimension marker), while `"fail"` fails the Run typed. Turn and
+ * Tool Call bounds resolve per RUN-018/RUN-019; the token dimension
+ * participates per RUN-025 with a one-shot bound (at most one grace call).
+ * Duration, cost, and repeated-failure bounds are hard rails regardless of
+ * this setting.
+ */
+declare const OnExhaustion: Schema.Literals<readonly ["final-answer", "fail"]>;
+declare const AgentPolicyFields: Schema.Struct<{
+  readonly maxTurns: Schema.Int;
+  readonly maxToolCalls: Schema.Int;
+  readonly maxDuration: Schema.refine<Duration.Duration, Schema.Duration>;
+  readonly toolConcurrency: Schema.Int;
+  readonly repeatedFailureLimit: Schema.Int;
+  readonly onExhaustion: Schema.Literals<readonly ["final-answer", "fail"]>;
+  readonly tokenBudget: Schema.optionalKey<Schema.Int>;
+  /** Tokens withheld from research calls so one final delivery call remains admissible. */
+  readonly completionReserveTokens: Schema.Int;
+  readonly costBudgetMicrousd: Schema.optionalKey<Schema.Int>;
+  /** Per-model-call live-context bound; crossing it triggers compaction rather than failure. */
+  readonly contextTokenLimit: Schema.optionalKey<Schema.Int>;
+  readonly toolResultBounds: typeof ToolResultBounds;
+  readonly runStatus: Schema.Literals<readonly ["appended", "off"]>;
+  /** Restart a disposable model call on joined input, at most twice per Run. Default off. */
+  readonly restartOnJoinedInput: Schema.optionalKey<Schema.Boolean>;
+  /**
+   * Retries per model call after a retryable `AiError` or a 429/5xx stream error part,
+   * before any content. Provider-defined Tools must be `Tool.Readonly`. Exponential
+   * backoff honors longer `retryAfter` delays and counts toward `maxDuration`. Default 0.
+   */
+  readonly modelRetries: Schema.optionalKey<Schema.Int>;
+  readonly compaction: typeof CompactionPolicy;
+}>;
+type AgentPolicyFields = typeof AgentPolicyFields.Type;
+/** Inputs normalized and validated by `AgentPolicy.make`. */
+type AgentPolicyInput = Readonly<Omit<AgentPolicyFields, "maxDuration" | "repeatedFailureLimit" | "onExhaustion" | "toolResultBounds" | "runStatus" | "compaction" | "completionReserveTokens"> & {
+  /** Finite, positive wall-clock duration accepted in any Effect Duration input form. */
+  readonly maxDuration: Duration.Input;
+  /** Non-negative repeated-failure bound; defaults to `3`. */
+  readonly repeatedFailureLimit?: number;
+  /** Turn/Tool-Call/token exhaustion resolution; defaults to `"final-answer"`. */
+  readonly onExhaustion?: typeof OnExhaustion.Type;
+  /** Byte bound for each encoded Tool result; defaults to `50 KiB`. */
+  readonly toolResultBounds?: ToolResultBounds;
+  /** Whether a derived run-status message is appended to each model call; defaults to `"off"` to preserve retained prompt cache boundaries. */
+  readonly runStatus?: AgentPolicyFields["runStatus"];
+  /** Tokens reserved for final delivery; defaults to 20% of tokenBudget, capped at 4,096. */
+  readonly completionReserveTokens?: number;
+  /** Compaction strategy applied when `contextTokenLimit` is crossed; defaults documented on `CompactionPolicy`. */
+  readonly compaction?: CompactionPolicy;
+}>;
+declare const AgentPolicy_base: Schema.Class<AgentPolicy, Schema.Struct<{
+  readonly maxTurns: Schema.Int;
+  readonly maxToolCalls: Schema.Int;
+  readonly maxDuration: Schema.refine<Duration.Duration, Schema.Duration>;
+  readonly toolConcurrency: Schema.Int;
+  readonly repeatedFailureLimit: Schema.Int;
+  readonly onExhaustion: Schema.Literals<readonly ["final-answer", "fail"]>;
+  readonly tokenBudget: Schema.optionalKey<Schema.Int>;
+  /** Tokens withheld from research calls so one final delivery call remains admissible. */
+  readonly completionReserveTokens: Schema.Int;
+  readonly costBudgetMicrousd: Schema.optionalKey<Schema.Int>;
+  /** Per-model-call live-context bound; crossing it triggers compaction rather than failure. */
+  readonly contextTokenLimit: Schema.optionalKey<Schema.Int>;
+  readonly toolResultBounds: typeof ToolResultBounds;
+  readonly runStatus: Schema.Literals<readonly ["appended", "off"]>;
+  /** Restart a disposable model call on joined input, at most twice per Run. Default off. */
+  readonly restartOnJoinedInput: Schema.optionalKey<Schema.Boolean>;
+  /**
+   * Retries per model call after a retryable `AiError` or a 429/5xx stream error part,
+   * before any content. Provider-defined Tools must be `Tool.Readonly`. Exponential
+   * backoff honors longer `retryAfter` delays and counts toward `maxDuration`. Default 0.
+   */
+  readonly modelRetries: Schema.optionalKey<Schema.Int>;
+  readonly compaction: typeof CompactionPolicy;
+}>, {}>;
+/** Schema class for finite agent run limits. */
+declare class AgentPolicy extends AgentPolicy_base {
+  /** Resolve an optional declaration against finite standalone or parent defaults. */
+  static resolve(input?: Partial<AgentPolicyInput>, parent?: AgentPolicy): AgentPolicy;
+  /** Normalize and validate finite policy bounds, throwing on invalid input. */
+  static make(input: AgentPolicyInput): AgentPolicy;
+}
+//#endregion
+export { CompactionPolicyInput as a, CompactionPolicy as i, AgentPolicyInput as n, AgentPolicy_d_exports as r, AgentPolicy as t };
+//# sourceMappingURL=AgentPolicy-B4oH8TbG.d.mts.map