fascicle 0.17.2 → 0.17.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -201,6 +201,21 @@ type CapturePayload = {
201
201
  };
202
202
  type FinishReason = 'stop' | 'tool_calls' | 'length' | 'content_filter' | 'max_steps';
203
203
  type RetryFailureKind = 'rate_limit' | 'provider_5xx' | 'network' | 'timeout';
204
+ /**
205
+ * How the engine retries one model turn that failed on the provider's side.
206
+ *
207
+ * `max_attempts` counts the first try. Before the attempt after the nth
208
+ * failure the turn waits `initial_delay_ms * 2^(n-1)` plus up to one
209
+ * `initial_delay_ms` of jitter, capped at `max_delay_ms`, or the server's
210
+ * `Retry-After` when that is longer. `retry_on` names the failure kinds that
211
+ * retry at all.
212
+ *
213
+ * `DEFAULT_RETRY` makes 4 attempts from a 1 s base, so a failure that lasts
214
+ * waits 7 to 10 s in all before the turn throws. That covers a short blip.
215
+ * A provider that answers 503 for tens of seconds at a time wants more
216
+ * attempts or a longer base, and a call with its own `abort` budget is cut
217
+ * off mid-wait whatever the policy says.
218
+ */
204
219
  type RetryPolicy = {
205
220
  max_attempts: number;
206
221
  initial_delay_ms: number;
@@ -649,6 +664,10 @@ type GenerateOptions<t = string> = {
649
664
  abort?: AbortSignal;
650
665
  trajectory?: TrajectoryLogger;
651
666
  on_chunk?: (chunk: StreamChunk) => void | Promise<void>;
667
+ /**
668
+ * This call's retry policy, which replaces the engine's wholesale. See
669
+ * RetryPolicy for the default's window.
670
+ */
652
671
  retry?: RetryPolicy;
653
672
  tool_error_policy?: 'feed_back' | 'throw';
654
673
  schema_repair_attempts?: number;
@@ -847,6 +866,11 @@ type EngineDefaults = {
847
866
  readonly top_p?: number;
848
867
  readonly max_steps?: number;
849
868
  readonly turn_timeout_ms?: number;
869
+ /**
870
+ * The retry policy for every call that sets none, in place of
871
+ * `DEFAULT_RETRY`. See RetryPolicy for the default's window and when to
872
+ * override it.
873
+ */
850
874
  readonly retry_policy?: RetryPolicy;
851
875
  readonly tool_error_policy?: 'feed_back' | 'throw';
852
876
  readonly schema_repair_attempts?: number;
@@ -879,6 +903,7 @@ type EngineConfig = {
879
903
  */
880
904
  custom_providers?: Record<string, ProviderFactory>;
881
905
  pricing?: PricingTable;
906
+ /** The legacy spelling of `defaults.retry_policy`, which wins over it. */
882
907
  default_retry?: RetryPolicy;
883
908
  default_effort?: EffortLevel;
884
909
  default_max_steps?: number;
@@ -918,4 +943,4 @@ type Engine = {
918
943
  };
919
944
  //#endregion
920
945
  export { StepTiming as A, UsageTotals as B, ProviderConfigMap as C, RetryFailureKind as D, ResolvedModel as E, ToolCallRecord as F, NativeProviderAdapter as G, AiSdkProviderAdapter as H, ToolExecContext as I, ProviderFactory as J, ProviderAdapter as K, TruncatedTurnPolicy as L, Tool as M, ToolApprovalHandler as N, RetryPolicy as O, ToolApprovalRequest as P, ClaudeCliProviderReported as Q, TurnRequest as R, PricingTable as S, ProviderOptions as T, EffortTranslation as U, UserContentPart as V, ExternalAgentAdapter as W, RawProviderUsage as X, ProviderTransport as Y, default_normalize_usage as Z, Message as _, CacheSetting as a, PrepareStepResult as b, CostBreakdown as c, EngineConfig as d, EngineDefaults as f, GenerateTiming as g, GenerateResult as h, BedrockCredentials as i, StreamChunk as j, StepRecord as k, EffortLevel as l, GenerateOptions as m, AssistantContentPart as n, CaptureLevel as o, FinishReason as p, ProviderCapability as q, BedrockCredentialProvider as r, CapturePayload as s, AiSdkTelemetrySettings as t, Engine as u, PrepareStepContext as v, ProviderInit as w, Pricing as x, PrepareStepHook as y, TurnResult as z };
921
- //# sourceMappingURL=types-C7pO0jLq.d.ts.map
946
+ //# sourceMappingURL=types-C23S11Kk.d.ts.map
package/dist/viewer.js CHANGED
@@ -1,4 +1,4 @@
1
- import "./core-Dwir3pkb.js";
1
+ import "./core-Bfzt55Fl.js";
2
2
  import { l as parse_trajectory_event } from "./trajectory-DeURWIhj.js";
3
3
  import { open, stat } from "node:fs/promises";
4
4
  import { basename, dirname, extname, relative, resolve, sep } from "node:path";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fascicle",
3
- "version": "0.17.2",
3
+ "version": "0.17.4",
4
4
  "description": "Compose agents like plain values. A TypeScript toolkit that wires LLM calls, tools, and functions into typed steps over eight providers. No framework, no ambient state.",
5
5
  "keywords": [
6
6
  "agents",