fascicle 0.6.3 → 0.8.10
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.
- package/CHANGELOG.md +128 -0
- package/README.md +36 -6
- package/dist/{tee-D_Qh_vfY.js → adapters-BS8cBOjL.js} +79 -7
- package/dist/adapters-BS8cBOjL.js.map +1 -0
- package/dist/adapters.d.ts +8 -8
- package/dist/adapters.js +1 -77
- package/dist/core-dRSAN1Q2.js +1846 -0
- package/dist/core-dRSAN1Q2.js.map +1 -0
- package/dist/index-CEj6hY9z.d.ts +856 -0
- package/dist/index-Cy7EUeiP.d.ts +430 -0
- package/dist/index.d.ts +36 -478
- package/dist/index.js +380 -2243
- package/dist/index.js.map +1 -1
- package/dist/mcp.d.ts +78 -0
- package/dist/mcp.js +315 -0
- package/dist/mcp.js.map +1 -0
- package/dist/static/viewer.html +1 -1
- package/package.json +65 -26
- package/dist/adapters.js.map +0 -1
- package/dist/index-BiuCs04Z.d.ts +0 -710
- package/dist/tee-D_Qh_vfY.js.map +0 -1
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
import { A as
|
|
1
|
+
import { A as fallback, B as describe, C as checkpoint, D as LoopResult, E as LoopGuardResult, F as parallel, G as Step, H as run, I as sequence, J as TrajectoryLogger, K as StepMetadata, L as DescribeOptions, M as pipe, N as map, O as loop, P as branch, R as FlowNode, S as suspend, T as LoopConfig, U as CheckpointStore, V as step, W as RunContext, Y as __json_default_export, _ as suspended_error, a as SpanStartEvent, b as stash, c as span_end_event_schema, d as STEP_KINDS, f as StepKind, g as resume_validation_error, h as describe_cycle_error, i as SpanEndEvent, j as retry, k as timeout, l as span_start_event_schema, m as aborted_error, n as EmitEvent, o as custom_event_schema, p as is_step_kind, q as TrajectoryEvent, r as ParsedTrajectoryEvent, s as emit_event_schema, t as CustomTrajectoryEvent, u as trajectory_event_schema, v as timeout_error, w as compose, x as use, y as scope, z as FlowValue } from "./index-CEj6hY9z.js";
|
|
2
|
+
import { A as RetryFailureKind, B as UserContentPart, C as GenerateResult, D as ProviderConfigMap, E as PricingTable, F as ToolApprovalHandler, I as ToolApprovalRequest, L as ToolCallRecord, M as StepRecord, N as StreamChunk, O as ProviderInit, P as Tool, R as ToolExecContext, S as GenerateOptions, T as Pricing, _ as EffortLevel, a as on_chunk_error, b as EngineDefaults, c as provider_error, d as schema_validation_error, f as tool_approval_denied_error, g as CostBreakdown, h as AssistantContentPart, i as model_required_error, j as RetryPolicy, k as ResolvedModel, l as provider_not_configured_error, m as create_engine, n as engine_config_error, o as provider_auth_error, p as tool_error, r as engine_disposed_error, s as provider_capability_error, t as claude_cli_error, u as rate_limit_error, v as Engine, w as Message, x as FinishReason, y as EngineConfig, z as UsageTotals } from "./index-Cy7EUeiP.js";
|
|
2
3
|
import { z } from "zod";
|
|
3
4
|
|
|
4
|
-
//#region
|
|
5
|
+
//#region src/composites/adversarial.d.ts
|
|
5
6
|
type AdversarialBuildInput<input, candidate> = {
|
|
6
7
|
readonly input: input;
|
|
7
8
|
readonly prior?: candidate;
|
|
@@ -24,7 +25,7 @@ type AdversarialConfig<input, candidate> = {
|
|
|
24
25
|
};
|
|
25
26
|
declare function adversarial<input, candidate>(config: AdversarialConfig<input, candidate>): Step<input, AdversarialResult<candidate>>;
|
|
26
27
|
//#endregion
|
|
27
|
-
//#region
|
|
28
|
+
//#region src/composites/consensus.d.ts
|
|
28
29
|
type ConsensusConfig<i, o> = {
|
|
29
30
|
readonly name?: string;
|
|
30
31
|
readonly members: Record<string, Step<i, o>>;
|
|
@@ -37,7 +38,7 @@ type ConsensusResult<o> = {
|
|
|
37
38
|
};
|
|
38
39
|
declare function consensus<i, o>(config: ConsensusConfig<i, o>): Step<i, ConsensusResult<o>>;
|
|
39
40
|
//#endregion
|
|
40
|
-
//#region
|
|
41
|
+
//#region src/composites/ensemble.d.ts
|
|
41
42
|
type EnsembleConfig<i, o> = {
|
|
42
43
|
readonly name?: string;
|
|
43
44
|
readonly members: Record<string, Step<i, o>>;
|
|
@@ -50,7 +51,7 @@ type EnsembleResult<o> = {
|
|
|
50
51
|
};
|
|
51
52
|
declare function ensemble<i, o>(config: EnsembleConfig<i, o>): Step<i, EnsembleResult<o>>;
|
|
52
53
|
//#endregion
|
|
53
|
-
//#region
|
|
54
|
+
//#region src/composites/ensemble_step.d.ts
|
|
54
55
|
type EnsembleStepConfig<i, o, ranked> = {
|
|
55
56
|
readonly name?: string;
|
|
56
57
|
readonly members: Record<string, Step<i, o>>;
|
|
@@ -66,7 +67,7 @@ type EnsembleStepResult<o, ranked> = {
|
|
|
66
67
|
};
|
|
67
68
|
declare function ensemble_step<i, o, ranked>(config: EnsembleStepConfig<i, o, ranked>): Step<i, EnsembleStepResult<o, ranked>>;
|
|
68
69
|
//#endregion
|
|
69
|
-
//#region
|
|
70
|
+
//#region src/composites/improve.d.ts
|
|
70
71
|
type Candidate<c> = {
|
|
71
72
|
readonly content: c;
|
|
72
73
|
readonly proposer_id: string;
|
|
@@ -123,7 +124,7 @@ type ImproveResult<c> = {
|
|
|
123
124
|
};
|
|
124
125
|
declare function improve<i, c>(config: ImproveConfig<i, c>): Step<i, ImproveResult<c>>;
|
|
125
126
|
//#endregion
|
|
126
|
-
//#region
|
|
127
|
+
//#region src/composites/learn.d.ts
|
|
127
128
|
type TrajectorySource = {
|
|
128
129
|
readonly kind: 'events';
|
|
129
130
|
readonly events: ReadonlyArray<TrajectoryEvent>;
|
|
@@ -160,7 +161,7 @@ type LearnResult<o> = {
|
|
|
160
161
|
};
|
|
161
162
|
declare function learn<i extends LearnInput, o>(config: LearnConfig<i, o>): Step<unknown, LearnResult<o>>;
|
|
162
163
|
//#endregion
|
|
163
|
-
//#region
|
|
164
|
+
//#region src/composites/tournament.d.ts
|
|
164
165
|
type BracketRecord = {
|
|
165
166
|
readonly round: number;
|
|
166
167
|
readonly a_id: string;
|
|
@@ -178,7 +179,7 @@ type TournamentResult<o> = {
|
|
|
178
179
|
};
|
|
179
180
|
declare function tournament<i, o>(config: TournamentConfig<i, o>): Step<i, TournamentResult<o>>;
|
|
180
181
|
//#endregion
|
|
181
|
-
//#region
|
|
182
|
+
//#region src/composites/bench.d.ts
|
|
182
183
|
type Score = {
|
|
183
184
|
readonly score: number;
|
|
184
185
|
readonly reason?: string;
|
|
@@ -229,7 +230,7 @@ type BenchOptions = {
|
|
|
229
230
|
declare function bench<I, O, S = Score>(flow: Step<I, O>, cases: ReadonlyArray<BenchCase<I>>, judges: Record<string, Judge<I, O, S>>, options?: BenchOptions): Promise<BenchReport<I, O, S>>;
|
|
230
231
|
declare function normalize_score(raw: unknown): Score | undefined;
|
|
231
232
|
//#endregion
|
|
232
|
-
//#region
|
|
233
|
+
//#region src/composites/judges.d.ts
|
|
233
234
|
declare function judge_equals<O>(): Judge<unknown, O>;
|
|
234
235
|
type JudgeWithFn<I, O> = (args: JudgeArgs<I, O>) => number | Score | undefined | Promise<number | Score | undefined>;
|
|
235
236
|
declare function judge_with<I, O>(fn: JudgeWithFn<I, O>): Judge<I, O>;
|
|
@@ -243,7 +244,7 @@ type JudgeLlmConfig = {
|
|
|
243
244
|
};
|
|
244
245
|
declare function judge_llm<I, O>(config: JudgeLlmConfig): Judge<I, O>;
|
|
245
246
|
//#endregion
|
|
246
|
-
//#region
|
|
247
|
+
//#region src/composites/regression.d.ts
|
|
247
248
|
type RegressionDelta = {
|
|
248
249
|
readonly metric: string;
|
|
249
250
|
readonly baseline: number;
|
|
@@ -272,449 +273,7 @@ declare function regression_compare(current: BenchReport, baseline: BenchReport,
|
|
|
272
273
|
declare function read_baseline(path: string): Promise<BenchReport>;
|
|
273
274
|
declare function write_baseline(path: string, report: BenchReport): Promise<void>;
|
|
274
275
|
//#endregion
|
|
275
|
-
//#region
|
|
276
|
-
declare const version$1 = "0.6.3";
|
|
277
|
-
//#endregion
|
|
278
|
-
//#region packages/engine/src/providers/claude_cli/types.d.ts
|
|
279
|
-
/**
|
|
280
|
-
* Public types for the claude_cli subprocess provider (spec §5.1, §5.3, §5.4).
|
|
281
|
-
*
|
|
282
|
-
* Value fields are snake_case; exported type aliases are PascalCase. These
|
|
283
|
-
* types are re-exported from packages/engine/src/index.ts so callers can
|
|
284
|
-
* narrow provider-scoped options and provider_reported values at their use
|
|
285
|
-
* site.
|
|
286
|
-
*/
|
|
287
|
-
type AuthMode = 'auto' | 'oauth' | 'api_key';
|
|
288
|
-
type SandboxProviderConfig = {
|
|
289
|
-
readonly kind: 'bwrap';
|
|
290
|
-
readonly network_allowlist?: ReadonlyArray<string>;
|
|
291
|
-
readonly additional_write_paths?: ReadonlyArray<string>;
|
|
292
|
-
} | {
|
|
293
|
-
readonly kind: 'greywall';
|
|
294
|
-
readonly network_allowlist?: ReadonlyArray<string>;
|
|
295
|
-
readonly additional_write_paths?: ReadonlyArray<string>;
|
|
296
|
-
/**
|
|
297
|
-
* greywall 0.3+ takes filesystem/network policy from a JSON settings
|
|
298
|
-
* file. By default the adapter writes a temp settings file derived
|
|
299
|
-
* from `network_allowlist`/`additional_write_paths`. Set to forward
|
|
300
|
-
* a caller-managed settings file directly via `--settings` instead.
|
|
301
|
-
* The temp-file path is then skipped entirely.
|
|
302
|
-
*/
|
|
303
|
-
readonly settings_path?: string;
|
|
304
|
-
};
|
|
305
|
-
type ClaudeCliProviderConfig = {
|
|
306
|
-
readonly binary?: string;
|
|
307
|
-
readonly auth_mode?: AuthMode;
|
|
308
|
-
readonly api_key?: string;
|
|
309
|
-
/**
|
|
310
|
-
* The subprocess env seeds the standard process-env keys
|
|
311
|
-
* (PATH/HOME/SHELL/USER/LOGNAME/LANG/TMPDIR) by default under every
|
|
312
|
-
* auth mode so the spawn target (sandbox wrapper or the claude binary)
|
|
313
|
-
* can be resolved on PATH. Under `auth_mode: 'oauth'` the *full*
|
|
314
|
-
* `process.env` is inherited so the CLI can reach the logged-in OAuth
|
|
315
|
-
* session. Set to `false` to opt out and start from an empty env.
|
|
316
|
-
*/
|
|
317
|
-
readonly inherit_env?: boolean;
|
|
318
|
-
readonly default_cwd?: string;
|
|
319
|
-
readonly startup_timeout_ms?: number;
|
|
320
|
-
readonly stall_timeout_ms?: number;
|
|
321
|
-
readonly setting_sources?: ReadonlyArray<'user' | 'project' | 'local'>;
|
|
322
|
-
readonly plugin_dirs?: ReadonlyArray<string>;
|
|
323
|
-
readonly sandbox?: SandboxProviderConfig;
|
|
324
|
-
readonly skip_probe?: boolean;
|
|
325
|
-
};
|
|
326
|
-
//#endregion
|
|
327
|
-
//#region packages/engine/src/types.d.ts
|
|
328
|
-
type EffortLevel = 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
|
|
329
|
-
type FinishReason = 'stop' | 'tool_calls' | 'length' | 'content_filter' | 'aborted' | 'max_steps';
|
|
330
|
-
type RetryFailureKind = 'rate_limit' | 'provider_5xx' | 'network' | 'timeout';
|
|
331
|
-
type RetryPolicy = {
|
|
332
|
-
max_attempts: number;
|
|
333
|
-
initial_delay_ms: number;
|
|
334
|
-
max_delay_ms: number;
|
|
335
|
-
retry_on: ReadonlyArray<RetryFailureKind>;
|
|
336
|
-
};
|
|
337
|
-
type AliasTarget = {
|
|
338
|
-
provider: string;
|
|
339
|
-
model_id: string;
|
|
340
|
-
defaults?: {
|
|
341
|
-
temperature?: number;
|
|
342
|
-
max_tokens?: number;
|
|
343
|
-
effort?: EffortLevel;
|
|
344
|
-
};
|
|
345
|
-
};
|
|
346
|
-
type AliasTable = Readonly<Record<string, AliasTarget>>;
|
|
347
|
-
/**
|
|
348
|
-
* Family catalog: family name -> provider name -> the latest model id to send
|
|
349
|
-
* to that provider for the family. See `MODEL_FAMILIES` in aliases.ts.
|
|
350
|
-
*/
|
|
351
|
-
type FamilyCatalog = Readonly<Record<string, Readonly<Record<string, string>>>>;
|
|
352
|
-
type Pricing = {
|
|
353
|
-
input_per_million: number;
|
|
354
|
-
output_per_million: number;
|
|
355
|
-
cached_input_per_million?: number;
|
|
356
|
-
cache_write_per_million?: number;
|
|
357
|
-
reasoning_per_million?: number;
|
|
358
|
-
};
|
|
359
|
-
type PricingTable = Readonly<Record<string, Pricing>>;
|
|
360
|
-
type UsageTotals = {
|
|
361
|
-
input_tokens: number;
|
|
362
|
-
output_tokens: number;
|
|
363
|
-
reasoning_tokens?: number;
|
|
364
|
-
cached_input_tokens?: number;
|
|
365
|
-
cache_write_tokens?: number;
|
|
366
|
-
};
|
|
367
|
-
type CostBreakdown = {
|
|
368
|
-
total_usd: number;
|
|
369
|
-
input_usd: number;
|
|
370
|
-
output_usd: number;
|
|
371
|
-
cached_input_usd?: number;
|
|
372
|
-
cache_write_usd?: number;
|
|
373
|
-
reasoning_usd?: number;
|
|
374
|
-
currency: 'USD';
|
|
375
|
-
is_estimate: true;
|
|
376
|
-
};
|
|
377
|
-
type ToolCallRecord = {
|
|
378
|
-
id: string;
|
|
379
|
-
name: string;
|
|
380
|
-
input: unknown;
|
|
381
|
-
output?: unknown;
|
|
382
|
-
error?: {
|
|
383
|
-
message: string;
|
|
384
|
-
stack?: string;
|
|
385
|
-
};
|
|
386
|
-
duration_ms: number;
|
|
387
|
-
started_at: number;
|
|
388
|
-
};
|
|
389
|
-
type StepRecord = {
|
|
390
|
-
index: number;
|
|
391
|
-
text: string;
|
|
392
|
-
tool_calls: ToolCallRecord[];
|
|
393
|
-
usage: UsageTotals;
|
|
394
|
-
cost?: CostBreakdown;
|
|
395
|
-
finish_reason: FinishReason;
|
|
396
|
-
};
|
|
397
|
-
type UserContentPart = {
|
|
398
|
-
type: 'text';
|
|
399
|
-
text: string;
|
|
400
|
-
} | {
|
|
401
|
-
type: 'image';
|
|
402
|
-
image: Uint8Array | string;
|
|
403
|
-
media_type?: string;
|
|
404
|
-
};
|
|
405
|
-
type AssistantContentPart = {
|
|
406
|
-
type: 'text';
|
|
407
|
-
text: string;
|
|
408
|
-
} | {
|
|
409
|
-
type: 'tool_call';
|
|
410
|
-
id: string;
|
|
411
|
-
name: string;
|
|
412
|
-
input: unknown;
|
|
413
|
-
};
|
|
414
|
-
type Message = {
|
|
415
|
-
role: 'system';
|
|
416
|
-
content: string;
|
|
417
|
-
} | {
|
|
418
|
-
role: 'user';
|
|
419
|
-
content: string | UserContentPart[];
|
|
420
|
-
} | {
|
|
421
|
-
role: 'assistant';
|
|
422
|
-
content: string | AssistantContentPart[];
|
|
423
|
-
} | {
|
|
424
|
-
role: 'tool';
|
|
425
|
-
tool_call_id: string;
|
|
426
|
-
name: string;
|
|
427
|
-
content: string;
|
|
428
|
-
};
|
|
429
|
-
type ToolExecContext = {
|
|
430
|
-
abort: AbortSignal;
|
|
431
|
-
trajectory?: TrajectoryLogger;
|
|
432
|
-
tool_call_id: string;
|
|
433
|
-
step_index: number;
|
|
434
|
-
};
|
|
435
|
-
type Tool<i = unknown, o = unknown> = {
|
|
436
|
-
name: string;
|
|
437
|
-
description: string;
|
|
438
|
-
input_schema: z.ZodType<i>;
|
|
439
|
-
execute: (input: i, ctx: ToolExecContext) => Promise<o> | o;
|
|
440
|
-
needs_approval?: boolean | ((input: i) => boolean | Promise<boolean>);
|
|
441
|
-
};
|
|
442
|
-
type ToolApprovalRequest = {
|
|
443
|
-
tool_name: string;
|
|
444
|
-
input: unknown;
|
|
445
|
-
step_index: number;
|
|
446
|
-
abort: AbortSignal;
|
|
447
|
-
};
|
|
448
|
-
type ToolApprovalHandler = (request: ToolApprovalRequest) => boolean | Promise<boolean>;
|
|
449
|
-
type StreamChunk = {
|
|
450
|
-
kind: 'text';
|
|
451
|
-
text: string;
|
|
452
|
-
step_index: number;
|
|
453
|
-
} | {
|
|
454
|
-
kind: 'reasoning';
|
|
455
|
-
text: string;
|
|
456
|
-
step_index: number;
|
|
457
|
-
} | {
|
|
458
|
-
kind: 'tool_call_start';
|
|
459
|
-
id: string;
|
|
460
|
-
name: string;
|
|
461
|
-
step_index: number;
|
|
462
|
-
} | {
|
|
463
|
-
kind: 'tool_call_input_delta';
|
|
464
|
-
id: string;
|
|
465
|
-
delta: string;
|
|
466
|
-
step_index: number;
|
|
467
|
-
} | {
|
|
468
|
-
kind: 'tool_call_end';
|
|
469
|
-
id: string;
|
|
470
|
-
input: unknown;
|
|
471
|
-
step_index: number;
|
|
472
|
-
} | {
|
|
473
|
-
kind: 'tool_result';
|
|
474
|
-
id: string;
|
|
475
|
-
output?: unknown;
|
|
476
|
-
error?: {
|
|
477
|
-
message: string;
|
|
478
|
-
};
|
|
479
|
-
step_index: number;
|
|
480
|
-
} | {
|
|
481
|
-
kind: 'step_finish';
|
|
482
|
-
step_index: number;
|
|
483
|
-
finish_reason: FinishReason;
|
|
484
|
-
usage: UsageTotals;
|
|
485
|
-
} | {
|
|
486
|
-
kind: 'finish';
|
|
487
|
-
finish_reason: FinishReason;
|
|
488
|
-
usage: UsageTotals;
|
|
489
|
-
};
|
|
490
|
-
type GenerateOptions<t = string> = {
|
|
491
|
-
model?: string;
|
|
492
|
-
provider?: string;
|
|
493
|
-
prompt: string | Message[];
|
|
494
|
-
system?: string;
|
|
495
|
-
schema?: z.ZodType<t>;
|
|
496
|
-
tools?: Tool[];
|
|
497
|
-
effort?: EffortLevel;
|
|
498
|
-
temperature?: number;
|
|
499
|
-
max_tokens?: number;
|
|
500
|
-
top_p?: number;
|
|
501
|
-
max_steps?: number;
|
|
502
|
-
abort?: AbortSignal;
|
|
503
|
-
trajectory?: TrajectoryLogger;
|
|
504
|
-
on_chunk?: (chunk: StreamChunk) => void | Promise<void>;
|
|
505
|
-
retry?: RetryPolicy;
|
|
506
|
-
tool_error_policy?: 'feed_back' | 'throw';
|
|
507
|
-
schema_repair_attempts?: number;
|
|
508
|
-
on_tool_approval?: ToolApprovalHandler;
|
|
509
|
-
provider_options?: Record<string, unknown>;
|
|
510
|
-
};
|
|
511
|
-
type GenerateResult<t = string> = {
|
|
512
|
-
content: t;
|
|
513
|
-
tool_calls: ToolCallRecord[];
|
|
514
|
-
steps: StepRecord[];
|
|
515
|
-
usage: UsageTotals;
|
|
516
|
-
cost?: CostBreakdown;
|
|
517
|
-
finish_reason: FinishReason;
|
|
518
|
-
model_resolved: {
|
|
519
|
-
provider: string;
|
|
520
|
-
model_id: string;
|
|
521
|
-
};
|
|
522
|
-
provider_reported?: Record<string, unknown>;
|
|
523
|
-
};
|
|
524
|
-
type ProviderInit = {
|
|
525
|
-
api_key?: string;
|
|
526
|
-
base_url?: string;
|
|
527
|
-
[k: string]: unknown;
|
|
528
|
-
};
|
|
529
|
-
type ProviderConfigMap = {
|
|
530
|
-
anthropic?: {
|
|
531
|
-
api_key: string;
|
|
532
|
-
base_url?: string;
|
|
533
|
-
};
|
|
534
|
-
openai?: {
|
|
535
|
-
api_key: string;
|
|
536
|
-
base_url?: string;
|
|
537
|
-
organization?: string;
|
|
538
|
-
};
|
|
539
|
-
google?: {
|
|
540
|
-
api_key: string;
|
|
541
|
-
base_url?: string;
|
|
542
|
-
};
|
|
543
|
-
ollama?: {
|
|
544
|
-
base_url: string;
|
|
545
|
-
};
|
|
546
|
-
lmstudio?: {
|
|
547
|
-
base_url: string;
|
|
548
|
-
};
|
|
549
|
-
openrouter?: {
|
|
550
|
-
api_key: string;
|
|
551
|
-
base_url?: string;
|
|
552
|
-
http_referer?: string;
|
|
553
|
-
x_title?: string;
|
|
554
|
-
};
|
|
555
|
-
claude_cli?: ClaudeCliProviderConfig;
|
|
556
|
-
[custom: string]: ProviderInit | undefined;
|
|
557
|
-
};
|
|
558
|
-
/**
|
|
559
|
-
* Call-level defaults applied by the engine before dispatching to a provider.
|
|
560
|
-
*
|
|
561
|
-
* Per-call options from `generate(opts)` win over defaults using these rules:
|
|
562
|
-
*
|
|
563
|
-
* | Field | Rule |
|
|
564
|
-
* | --------------------------------------------------------------------- | ----------------------------------------- |
|
|
565
|
-
* | `model` | per-call wins; else default; else `sonnet` |
|
|
566
|
-
* | `provider` | per-call wins; else default; else sole configured provider; else `anthropic` |
|
|
567
|
-
* | `system`, `effort`, `max_steps`, `tool_error_policy`, `schema_repair_attempts` | per-call wins (nullish coalesce) |
|
|
568
|
-
* | `retry_policy` | per-call replaces wholesale |
|
|
569
|
-
* | `provider_options` | two-level: per-provider-key shallow merge |
|
|
570
|
-
* | `prompt`, `tools`, `schema`, `abort`, `trajectory`, `on_chunk` | not defaultable; always call-supplied |
|
|
571
|
-
*/
|
|
572
|
-
type EngineDefaults = {
|
|
573
|
-
readonly model?: string;
|
|
574
|
-
readonly provider?: string;
|
|
575
|
-
readonly system?: string;
|
|
576
|
-
readonly effort?: EffortLevel;
|
|
577
|
-
readonly max_steps?: number;
|
|
578
|
-
readonly retry_policy?: RetryPolicy;
|
|
579
|
-
readonly tool_error_policy?: 'feed_back' | 'throw';
|
|
580
|
-
readonly schema_repair_attempts?: number;
|
|
581
|
-
readonly provider_options?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
|
|
582
|
-
};
|
|
583
|
-
type EngineConfig = {
|
|
584
|
-
providers: ProviderConfigMap;
|
|
585
|
-
aliases?: AliasTable;
|
|
586
|
-
families?: FamilyCatalog;
|
|
587
|
-
pricing?: PricingTable;
|
|
588
|
-
default_retry?: RetryPolicy;
|
|
589
|
-
default_effort?: EffortLevel;
|
|
590
|
-
default_max_steps?: number;
|
|
591
|
-
defaults?: EngineDefaults;
|
|
592
|
-
};
|
|
593
|
-
type Engine = {
|
|
594
|
-
generate: <t = string>(opts: GenerateOptions<t>) => Promise<GenerateResult<t>>;
|
|
595
|
-
register_alias: (alias: string, target: AliasTarget) => void;
|
|
596
|
-
unregister_alias: (alias: string) => void;
|
|
597
|
-
resolve_alias: (alias: string) => AliasTarget;
|
|
598
|
-
list_aliases: () => AliasTable;
|
|
599
|
-
register_price: (provider: string, model_id: string, pricing: Pricing) => void;
|
|
600
|
-
resolve_price: (provider: string, model_id: string) => Pricing | undefined;
|
|
601
|
-
list_prices: () => PricingTable;
|
|
602
|
-
dispose: () => Promise<void>;
|
|
603
|
-
};
|
|
604
|
-
//#endregion
|
|
605
|
-
//#region packages/engine/src/create_engine.d.ts
|
|
606
|
-
declare function create_engine(config: EngineConfig): Engine;
|
|
607
|
-
//#endregion
|
|
608
|
-
//#region packages/engine/src/errors.d.ts
|
|
609
|
-
declare class rate_limit_error extends Error {
|
|
610
|
-
readonly kind: "rate_limit_error";
|
|
611
|
-
readonly retry_after_ms?: number;
|
|
612
|
-
readonly attempts: number;
|
|
613
|
-
readonly status?: number;
|
|
614
|
-
constructor(message: string, metadata?: {
|
|
615
|
-
retry_after_ms?: number;
|
|
616
|
-
attempts?: number;
|
|
617
|
-
status?: number;
|
|
618
|
-
});
|
|
619
|
-
}
|
|
620
|
-
declare class provider_error extends Error {
|
|
621
|
-
readonly kind: "provider_error";
|
|
622
|
-
readonly status?: number;
|
|
623
|
-
readonly body?: string;
|
|
624
|
-
readonly cause_kind?: 'provider_5xx' | 'network' | 'unknown';
|
|
625
|
-
constructor(message: string, metadata?: {
|
|
626
|
-
status?: number;
|
|
627
|
-
body?: string;
|
|
628
|
-
cause_kind?: 'provider_5xx' | 'network' | 'unknown';
|
|
629
|
-
});
|
|
630
|
-
}
|
|
631
|
-
declare class schema_validation_error extends Error {
|
|
632
|
-
readonly kind: "schema_validation_error";
|
|
633
|
-
readonly zod_error: unknown;
|
|
634
|
-
readonly raw_text: string;
|
|
635
|
-
constructor(message: string, zod_error: unknown, raw_text: string);
|
|
636
|
-
}
|
|
637
|
-
declare class tool_error extends Error {
|
|
638
|
-
readonly kind: "tool_error";
|
|
639
|
-
readonly tool_name: string;
|
|
640
|
-
readonly tool_call_id: string;
|
|
641
|
-
readonly cause: unknown;
|
|
642
|
-
constructor(message: string, metadata: {
|
|
643
|
-
tool_name: string;
|
|
644
|
-
tool_call_id: string;
|
|
645
|
-
cause: unknown;
|
|
646
|
-
});
|
|
647
|
-
}
|
|
648
|
-
declare class tool_approval_denied_error extends Error {
|
|
649
|
-
readonly kind: "tool_approval_denied_error";
|
|
650
|
-
readonly tool_name: string;
|
|
651
|
-
readonly step_index: number;
|
|
652
|
-
readonly tool_call_id: string;
|
|
653
|
-
constructor(message: string, metadata: {
|
|
654
|
-
tool_name: string;
|
|
655
|
-
step_index: number;
|
|
656
|
-
tool_call_id: string;
|
|
657
|
-
});
|
|
658
|
-
}
|
|
659
|
-
declare class model_not_found_error extends Error {
|
|
660
|
-
readonly kind: "model_not_found_error";
|
|
661
|
-
readonly model: string;
|
|
662
|
-
readonly registered: ReadonlyArray<string>;
|
|
663
|
-
constructor(model: string, registered: ReadonlyArray<string>);
|
|
664
|
-
}
|
|
665
|
-
declare class model_family_unavailable_error extends Error {
|
|
666
|
-
readonly kind: "model_family_unavailable_error";
|
|
667
|
-
readonly family: string;
|
|
668
|
-
readonly provider: string;
|
|
669
|
-
readonly available_providers: ReadonlyArray<string>;
|
|
670
|
-
constructor(family: string, provider: string, available_providers: ReadonlyArray<string>);
|
|
671
|
-
}
|
|
672
|
-
declare class provider_not_configured_error extends Error {
|
|
673
|
-
readonly kind: "provider_not_configured_error";
|
|
674
|
-
readonly provider: string;
|
|
675
|
-
constructor(provider: string);
|
|
676
|
-
}
|
|
677
|
-
declare class engine_config_error extends Error {
|
|
678
|
-
readonly kind: "engine_config_error";
|
|
679
|
-
readonly provider?: string;
|
|
680
|
-
constructor(message: string, provider?: string);
|
|
681
|
-
}
|
|
682
|
-
declare class on_chunk_error extends Error {
|
|
683
|
-
readonly kind: "on_chunk_error";
|
|
684
|
-
readonly cause: unknown;
|
|
685
|
-
constructor(message: string, cause: unknown);
|
|
686
|
-
}
|
|
687
|
-
declare class provider_capability_error extends Error {
|
|
688
|
-
readonly kind: "provider_capability_error";
|
|
689
|
-
readonly provider: string;
|
|
690
|
-
readonly capability: string;
|
|
691
|
-
constructor(provider: string, capability: string, detail?: string);
|
|
692
|
-
}
|
|
693
|
-
declare class engine_disposed_error extends Error {
|
|
694
|
-
readonly kind: "engine_disposed_error";
|
|
695
|
-
constructor(message?: string);
|
|
696
|
-
}
|
|
697
|
-
type ClaudeCliErrorReason = 'binary_not_found' | 'auth_missing' | 'auth_expired' | 'api_key_missing' | 'startup_timeout' | 'stall_timeout' | 'no_result_event' | 'result_error' | 'subprocess_exit' | 'sandbox_unavailable' | 'engine_disposed' | 'parse_error';
|
|
698
|
-
declare class claude_cli_error extends Error {
|
|
699
|
-
readonly kind: "claude_cli_error";
|
|
700
|
-
readonly reason: ClaudeCliErrorReason;
|
|
701
|
-
readonly status?: number;
|
|
702
|
-
readonly stderr_snippet?: string;
|
|
703
|
-
constructor(reason: ClaudeCliErrorReason, message: string, metadata?: {
|
|
704
|
-
status?: number;
|
|
705
|
-
stderr_snippet?: string;
|
|
706
|
-
});
|
|
707
|
-
}
|
|
708
|
-
declare class provider_auth_error extends Error {
|
|
709
|
-
readonly kind: "provider_auth_error";
|
|
710
|
-
readonly provider: string;
|
|
711
|
-
readonly refresh_command?: string;
|
|
712
|
-
constructor(provider: string, message: string, metadata?: {
|
|
713
|
-
refresh_command?: string;
|
|
714
|
-
});
|
|
715
|
-
}
|
|
716
|
-
//#endregion
|
|
717
|
-
//#region packages/fascicle/src/model_call.d.ts
|
|
276
|
+
//#region src/model_call.d.ts
|
|
718
277
|
type ModelCallInput = string | ReadonlyArray<Message>;
|
|
719
278
|
type ModelCallConfig<T = string> = {
|
|
720
279
|
readonly engine: Engine;
|
|
@@ -743,33 +302,16 @@ type ModelCallConfig<T = string> = {
|
|
|
743
302
|
};
|
|
744
303
|
declare function model_call<T = string>(cfg: ModelCallConfig<T>): Step<ModelCallInput, GenerateResult<T>>;
|
|
745
304
|
//#endregion
|
|
746
|
-
//#region
|
|
305
|
+
//#region src/forward_standard_env.d.ts
|
|
747
306
|
declare function forward_standard_env(): Record<string, string>;
|
|
748
307
|
//#endregion
|
|
749
|
-
//#region
|
|
750
|
-
/**
|
|
751
|
-
* fascicle-viewer CLI.
|
|
752
|
-
*
|
|
753
|
-
* fascicle-viewer <path> # tail a JSONL file (primary)
|
|
754
|
-
* fascicle-viewer --listen # accept HTTP push only
|
|
755
|
-
* fascicle-viewer <path> --listen # both producers feed the same broadcaster
|
|
756
|
-
*
|
|
757
|
-
* Flags: --port <n> --host <h> --buffer <n> --no-open --help
|
|
758
|
-
*
|
|
759
|
-
* Defaults bind 127.0.0.1:4242 and open the user's default browser. SIGINT
|
|
760
|
-
* shuts everything down cleanly. The CLI body is exposed as `run_viewer_cli`
|
|
761
|
-
* so the umbrella's bin shim can drive it from a bundled `dist/index.js`.
|
|
762
|
-
*/
|
|
763
|
-
declare function run_viewer_cli(argv: readonly string[]): Promise<void>;
|
|
764
|
-
//#endregion
|
|
765
|
-
//#region packages/viewer/src/index.d.ts
|
|
308
|
+
//#region src/viewer/start_viewer.d.ts
|
|
766
309
|
/**
|
|
767
|
-
*
|
|
310
|
+
* `start_viewer` programmatic embed implementation.
|
|
768
311
|
*
|
|
769
|
-
*
|
|
770
|
-
*
|
|
771
|
-
*
|
|
772
|
-
* never reaches into the engine, composites, or any provider.
|
|
312
|
+
* Spin up the server, optionally start tailing a JSONL file, and return a
|
|
313
|
+
* handle that can stop both. `start_viewer` only depends on core's wire-format
|
|
314
|
+
* schema; it never reaches into the engine, composites, or any provider.
|
|
773
315
|
*/
|
|
774
316
|
type StartViewerOptions = {
|
|
775
317
|
readonly path?: string;
|
|
@@ -788,5 +330,21 @@ type ViewerHandle = {
|
|
|
788
330
|
};
|
|
789
331
|
declare function start_viewer(options?: StartViewerOptions): Promise<ViewerHandle>;
|
|
790
332
|
//#endregion
|
|
791
|
-
|
|
333
|
+
//#region src/viewer/cli.d.ts
|
|
334
|
+
/**
|
|
335
|
+
* fascicle-viewer CLI.
|
|
336
|
+
*
|
|
337
|
+
* fascicle-viewer <path> # tail a JSONL file (primary)
|
|
338
|
+
* fascicle-viewer --listen # accept HTTP push only
|
|
339
|
+
* fascicle-viewer <path> --listen # both producers feed the same broadcaster
|
|
340
|
+
*
|
|
341
|
+
* Flags: --port <n> --host <h> --buffer <n> --no-open --help
|
|
342
|
+
*
|
|
343
|
+
* Defaults bind 127.0.0.1:4242 and open the user's default browser. SIGINT
|
|
344
|
+
* shuts everything down cleanly. The CLI body is exposed as `run_viewer_cli`
|
|
345
|
+
* so the umbrella's bin shim can drive it from a bundled `dist/index.js`.
|
|
346
|
+
*/
|
|
347
|
+
declare function run_viewer_cli(argv: readonly string[]): Promise<void>;
|
|
348
|
+
//#endregion
|
|
349
|
+
export { type AdversarialBuildInput, type AdversarialConfig, type AdversarialCritiqueResult, type AdversarialResult, type AssistantContentPart, type BenchCase, type BenchOptions, type BenchReport, type BenchSummary, type BracketRecord, type Candidate, type CaseResult, CheckpointStore, type ConsensusConfig, type ConsensusResult, type CostBreakdown, CustomTrajectoryEvent, DescribeOptions, type EffortLevel, EmitEvent, type Engine, type EngineConfig, type EngineDefaults, type EnsembleConfig, type EnsembleResult, type EnsembleStepConfig, type EnsembleStepResult, type FinishReason, FlowNode, FlowValue, type GenerateOptions, type GenerateResult, type HistoryEntry, type ImproveBudget, type ImproveConfig, type ImproveResult, type ImproveRoundInput, type Improvement, type Judge, type JudgeArgs, type JudgeLlmConfig, type JudgeWithFn, type LearnConfig, type LearnInput, type LearnResult, type Lesson, LoopConfig, LoopGuardResult, LoopResult, type Message, type ModelCallConfig, type ModelCallInput, ParsedTrajectoryEvent, type PerCaseDelta, type Pricing, type PricingTable, type ProviderConfigMap, type ProviderInit, type RegressionCompareOptions, type RegressionDelta, type RegressionReport, type ResolvedModel, type RetryFailureKind, type RetryPolicy, RunContext, STEP_KINDS, type Score, type ScoredCandidate, SpanEndEvent, SpanStartEvent, type StartViewerOptions, Step, StepKind, StepMetadata, type StepRecord, type StreamChunk, type Tool, type ToolApprovalHandler, type ToolApprovalRequest, type ToolCallRecord, type ToolExecContext, type TournamentConfig, type TournamentResult, TrajectoryEvent, TrajectoryLogger, type TrajectorySource, type UsageTotals, type UserContentPart, type ViewerHandle, aborted_error, adversarial, bench, branch, checkpoint, claude_cli_error, compose, consensus, create_engine, custom_event_schema, describe, describe_cycle_error, emit_event_schema, engine_config_error, engine_disposed_error, ensemble, ensemble_step, fallback, __json_default_export as flow_schema, forward_standard_env, improve, is_step_kind, judge_equals, judge_llm, judge_with, learn, loop, map, model_call, model_required_error, normalize_score, on_chunk_error, parallel, pipe, provider_auth_error, provider_capability_error, provider_error, provider_not_configured_error, rate_limit_error, read_baseline, regression_compare, resume_validation_error, retry, run, run_viewer_cli, schema_validation_error, scope, sequence, span_end_event_schema, span_start_event_schema, start_viewer, stash, step, suspend, suspended_error, timeout, timeout_error, tool_approval_denied_error, tool_error, tournament, trajectory_event_schema, use, write_baseline };
|
|
792
350
|
//# sourceMappingURL=index.d.ts.map
|