fascicle 0.17.4 → 0.17.5

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.
@@ -184,11 +184,13 @@ var provider_auth_error = class extends Error {
184
184
  kind = "provider_auth_error";
185
185
  provider;
186
186
  refresh_command;
187
+ cause;
187
188
  constructor(provider, message, metadata = {}) {
188
189
  super(message);
189
190
  this.name = "provider_auth_error";
190
191
  this.provider = provider;
191
192
  this.refresh_command = metadata.refresh_command;
193
+ this.cause = metadata.cause;
192
194
  }
193
195
  };
194
196
  /**
@@ -283,6 +285,40 @@ function normalize_local_usage(raw) {
283
285
  return base;
284
286
  }
285
287
  /**
288
+ * The error for a provider config that's missing a value the provider can't
289
+ * run without. It names the key to pass to create_engine and where the value
290
+ * usually comes from, an environment variable or a local server's address.
291
+ * It says "pass" because the engine never reads the environment itself.
292
+ */
293
+ function missing_config_error(provider, key, usual) {
294
+ return new engine_config_error(`${provider} provider requires a non-empty ${key}: pass providers.${provider}.${key} to create_engine, usually ${usual}`, provider);
295
+ }
296
+ /** The built-in providers that send no credentials of their own. */
297
+ const KEYLESS_PROVIDERS = /* @__PURE__ */ new Set(["ollama", "lmstudio"]);
298
+ /**
299
+ * Whether `base_url` puts a user name or password before its host, with a
300
+ * scheme or without one, as `http://user:pass@host` and `user@host:11434`
301
+ * do. Only the authority counts, the part before the first `/`, `?`, or `#`,
302
+ * so an `@` in a path or a query isn't one.
303
+ */
304
+ function has_userinfo(base_url) {
305
+ const scheme_end = base_url.indexOf("://");
306
+ const rest = scheme_end === -1 ? base_url : base_url.slice(scheme_end + 3);
307
+ const authority_end = rest.search(/[/?#]/);
308
+ return (authority_end === -1 ? rest : rest.slice(0, authority_end)).includes("@");
309
+ }
310
+ /**
311
+ * Throw `engine_config_error` for a built-in provider whose `base_url` holds
312
+ * a user name or password. Node's fetch refuses to send a request to such a
313
+ * URL, and its error repeats the whole URL, credentials included, so the
314
+ * engine refuses it as it's built, without repeating the URL.
315
+ */
316
+ function refuse_credentials_in_base_url(provider, init) {
317
+ const base_url = init.base_url;
318
+ if (typeof base_url !== "string" || !has_userinfo(base_url)) return;
319
+ throw new engine_config_error(`${provider} provider's base_url holds a user name or password, which fetch refuses to send: take them out of base_url, ${KEYLESS_PROVIDERS.has(provider) ? `since the ${provider} provider sends no credentials` : `and pass the key as providers.${provider}.api_key`}`, provider);
320
+ }
321
+ /**
286
322
  * Build the standard missing-peer error: names the package and the install
287
323
  * command so a missing peer is diagnosable from the message alone. Shared so
288
324
  * every optional-peer failure reads identically, whether the failing
@@ -360,13 +396,64 @@ function extract_error_message(body) {
360
396
  if (message !== void 0) return message;
361
397
  return body.length > 300 ? `${body.slice(0, 300)}...` : body;
362
398
  }
399
+ const LOCAL_PROVIDERS = /* @__PURE__ */ new Set(["ollama", "lmstudio"]);
400
+ /** The model name in Ollama's `model 'x' not found` reply, either quote. */
401
+ const OLLAMA_MISSING_MODEL = /model ['"]([^'"]+)['"] not found/;
402
+ /**
403
+ * `detail` without the one period a provider's sentence ends on, so that an
404
+ * action can follow it after a colon. A `...` truncation tail keeps its dots.
405
+ */
406
+ function strip_trailing_period(detail) {
407
+ return detail.replace(/(?<!\.)\.$/, "");
408
+ }
409
+ /**
410
+ * What to do about a 404: pull the model, when Ollama names one it doesn't
411
+ * have, and otherwise check the model id and where `base_url` points, since
412
+ * a path the provider doesn't serve answers 404 too.
413
+ */
414
+ function not_found_action(provider, detail) {
415
+ const missing = provider === "ollama" ? OLLAMA_MISSING_MODEL.exec(detail)?.[1] : void 0;
416
+ if (missing !== void 0) return `run ollama pull ${missing}`;
417
+ return `check the model id against the ${provider} model list, and that base_url points at the ${provider} API`;
418
+ }
419
+ /**
420
+ * What a caller does about a non-retryable status, or '' for a status whose
421
+ * fix only the provider's own text can say, such as a 400 or a 422. The
422
+ * ollama and lmstudio providers send no credentials, so a 401 from either
423
+ * comes from something in front of the server.
424
+ */
425
+ function status_action(provider, status, detail) {
426
+ if (status === 401) return LOCAL_PROVIDERS.has(provider) ? `the ${provider} provider sends no credentials, so check that base_url reaches the server without a proxy that asks for them` : `check providers.${provider}.api_key`;
427
+ if (status === 403) return "the credentials lack access to this model or endpoint";
428
+ if (status === 404) return not_found_action(provider, detail);
429
+ return "";
430
+ }
431
+ /**
432
+ * The error a status that won't be retried becomes, on either transport: a
433
+ * 401 is a provider_auth_error, and any other status a provider_error that
434
+ * carries it and the body. The message leads with the provider and the
435
+ * status, then the provider's own text, then what to do when the status says
436
+ * it. The native transport's response_error and the engine's ai_sdk
437
+ * classifier both build theirs here, so a wrong key or a wrong model id reads
438
+ * the same whichever transport the call took, and `cause` holds the SDK's
439
+ * error on the ai_sdk one.
440
+ */
441
+ function non_retryable_status_error(provider, status, detail, metadata = {}) {
442
+ const action = status_action(provider, status, detail);
443
+ const tail = action === "" ? detail : `${strip_trailing_period(detail)}: ${action}`;
444
+ if (status === 401) return new provider_auth_error(provider, `${provider} authentication failed (401): ${tail}`, { cause: metadata.cause });
445
+ return new provider_error(`${provider} API error ${status}: ${tail}`, {
446
+ status,
447
+ ...metadata
448
+ });
449
+ }
363
450
  /**
364
- * Map a non-2xx response to what the engine's retry stack expects: 401
365
- * becomes a typed provider_auth_error, 429/5xx keep `status`, `body`, and
366
- * `responseHeaders` so classify_provider_error marks them retryable
367
- * (rate_limit honoring retry-after, provider_5xx) and the exhausted error
368
- * still has the body, and any other 4xx is a permanent provider_error that
369
- * surfaces as-is.
451
+ * Map a non-2xx response to what the engine's retry stack expects: 429/5xx
452
+ * keep `status`, `body`, and `responseHeaders` so classify_provider_error
453
+ * marks them retryable (rate_limit honoring retry-after, provider_5xx) and
454
+ * the exhausted error still has the body, and any other status is the
455
+ * permanent error that non_retryable_status_error builds, which surfaces
456
+ * as-is.
370
457
  */
371
458
  async function response_error(response, provider) {
372
459
  let body = "";
@@ -375,7 +462,6 @@ async function response_error(response, provider) {
375
462
  } catch {}
376
463
  const detail = extract_error_message(body);
377
464
  const status = response.status;
378
- if (status === 401) return new provider_auth_error(provider, `${provider} authentication failed (401): ${detail}`);
379
465
  if (status === 429 || status >= 500) {
380
466
  const retry_after = response.headers.get("retry-after");
381
467
  return Object.assign(/* @__PURE__ */ new Error(`${provider} API error ${status}: ${detail}`), {
@@ -383,10 +469,7 @@ async function response_error(response, provider) {
383
469
  body
384
470
  }, retry_after !== null ? { responseHeaders: { "retry-after": retry_after } } : {});
385
471
  }
386
- return new provider_error(`${provider} API error ${status}: ${detail}`, {
387
- status,
388
- body
389
- });
472
+ return non_retryable_status_error(provider, status, detail, { body });
390
473
  }
391
474
  /**
392
475
  * A transport failure in the `kind: 'network'` shape that the shared
@@ -398,13 +481,70 @@ function network_failure(message) {
398
481
  return Object.assign(new Error(message), { kind: "network" });
399
482
  }
400
483
  /**
484
+ * The `code` that `value` carries, such as `ECONNREFUSED`, when it's an
485
+ * object whose `code` is a string.
486
+ */
487
+ function error_code(value) {
488
+ if (value === null || typeof value !== "object") return void 0;
489
+ const code = Reflect.get(value, "code");
490
+ return typeof code === "string" ? code : void 0;
491
+ }
492
+ /**
493
+ * A transport failure's own message, followed by the system error code that
494
+ * the error or its `cause` carries when the message doesn't already name it,
495
+ * as in `fetch failed (ECONNREFUSED)`. Undici's `fetch failed` alone doesn't
496
+ * say whether the host refused, timed out, or doesn't resolve. A failure with
497
+ * no message, such as the `AggregateError` that Node raises when every
498
+ * address of a host refuses, is named by its code alone.
499
+ */
500
+ function network_detail(err) {
501
+ const message = err instanceof Error ? err.message : String(err);
502
+ const cause = err !== null && typeof err === "object" ? Reflect.get(err, "cause") : void 0;
503
+ const code = error_code(err) ?? error_code(cause);
504
+ if (message.length === 0) return code ?? "(no detail)";
505
+ return code === void 0 || message.includes(code) ? message : `${message} (${code})`;
506
+ }
507
+ /**
508
+ * `url` as its origin and path, without the credentials, query, or fragment
509
+ * that can carry a key, so that a message that names it is safe to log. A
510
+ * string that doesn't parse is named only as not being a URL.
511
+ */
512
+ function log_safe_url(url) {
513
+ try {
514
+ const parsed = new URL(url);
515
+ return `${parsed.origin}${parsed.pathname}`;
516
+ } catch {
517
+ return "a base_url that is not a valid URL";
518
+ }
519
+ }
520
+ /**
521
+ * The message for a request that never reached the provider: the URL it was
522
+ * sent to (see log_safe_url), what failed, and what to check, with the
523
+ * command that starts the server for Ollama, the one provider that's usually
524
+ * a daemon on the same machine. A failure whose own text repeats the URL,
525
+ * as undici's does for one that it can't parse or that holds credentials,
526
+ * gets the same log-safe URL in its place.
527
+ */
528
+ function unreachable_message(provider, url, detail) {
529
+ const safe = log_safe_url(url);
530
+ return `${provider} could not be reached at ${safe}: ${url.length > 0 ? detail.replaceAll(url, safe) : detail}: check base_url, and that the server is running${provider === "ollama" ? " (ollama serve)" : ""}`;
531
+ }
532
+ /**
533
+ * The message for a connection that dropped after the response began, which
534
+ * names no URL, since the request reached the server.
535
+ */
536
+ function dropped_message(provider, detail) {
537
+ return `${provider} connection dropped while reading the response: ${detail}`;
538
+ }
539
+ /**
401
540
  * A user abort surfaces as the fetch/reader AbortError; retry_turn converts
402
541
  * it via its own signal check, so it is rethrown untouched. Everything else
403
- * is a transport failure wrapped as a network_failure.
542
+ * is a transport failure wrapped as a network_failure, whose message `message`
543
+ * builds from the failure's network_detail.
404
544
  */
405
- function rethrow_network_failure(err, abort, provider) {
545
+ function rethrow_network_failure(err, abort, message) {
406
546
  if (abort.aborted) throw err;
407
- throw network_failure(`${provider} native: network failure: ${err instanceof Error ? err.message : String(err)}`);
547
+ throw network_failure(message(network_detail(err)));
408
548
  }
409
549
  /**
410
550
  * The response's media type, lowercased and without its parameters, or ''
@@ -424,7 +564,7 @@ async function read_json_body(response, abort, provider) {
424
564
  try {
425
565
  text = await response.text();
426
566
  } catch (err) {
427
- rethrow_network_failure(err, abort, provider);
567
+ rethrow_network_failure(err, abort, (detail) => dropped_message(provider, detail));
428
568
  }
429
569
  try {
430
570
  return JSON.parse(text);
@@ -433,6 +573,15 @@ async function read_json_body(response, abort, provider) {
433
573
  }
434
574
  }
435
575
  /**
576
+ * The error for a response that isn't the provider's protocol: what was
577
+ * wrong with it, then what to check, since a body of the wrong shape most
578
+ * often comes from a `base_url` that points somewhere else. `also` names the
579
+ * other fix when there is one.
580
+ */
581
+ function protocol_error(provider, what, also) {
582
+ return new provider_error(`${provider} native: ${what}: check that base_url points at the ${provider} API${also === void 0 ? "" : `, or ${also}`}`);
583
+ }
584
+ /**
436
585
  * Run one native turn over HTTP: POST the dialect's body, map a non-2xx to
437
586
  * the retry stack's shapes, and hand the response to the dialect's stream or
438
587
  * JSON consumer. A streamed request whose reply doesn't arrive as the
@@ -462,7 +611,7 @@ async function invoke_http_turn(req, provider, request, consume) {
462
611
  signal: req.abort
463
612
  });
464
613
  } catch (err) {
465
- rethrow_network_failure(err, req.abort, provider);
614
+ rethrow_network_failure(err, req.abort, (detail) => unreachable_message(provider, request.url, detail));
466
615
  }
467
616
  if (!response.ok) throw await response_error(response, provider);
468
617
  if (req.stream && media_type(response) === consume.stream_media_type) return consume.stream(response);
@@ -487,7 +636,7 @@ async function consume_framed_stream(response, req, provider, framing, create_ag
487
636
  try {
488
637
  step = await reader.read();
489
638
  } catch (err) {
490
- rethrow_network_failure(err, req.abort, provider);
639
+ rethrow_network_failure(err, req.abort, (detail) => dropped_message(provider, detail));
491
640
  }
492
641
  return step.done ? void 0 : step.value;
493
642
  };
@@ -658,6 +807,6 @@ function is_leading_system(m) {
658
807
  return m?.role === "system";
659
808
  }
660
809
  //#endregion
661
- export { schema_validation_error as A, on_chunk_error as C, provider_not_configured_error as D, provider_error as E, tool_error as M, turn_timeout_error as N, provider_required_error as O, model_required_error as S, provider_capability_error as T, translate_effort_to_sdk_reasoning as _, invoke_http_turn as a, engine_disposed_error as b, network_failure as c, split_assistant_parts as d, default_normalize_usage as f, resolve_transport as g, normalize_local_usage as h, error_body_message as i, tool_approval_denied_error as j, rate_limit_error as k, parse_tool_call_arguments as l, missing_peer_error as m, consume_framed_stream as n, is_own_reasoning as o, load_optional_peer as p, create_line_splitter as r, map_messages_by_role as s, split_leading_system_run as t, read_dialect_init as u, claude_cli_error as v, provider_auth_error as w, incomplete_generation_error as x, engine_config_error as y };
810
+ export { provider_auth_error as A, translate_effort_to_sdk_reasoning as C, incomplete_generation_error as D, engine_disposed_error as E, rate_limit_error as F, schema_validation_error as I, tool_approval_denied_error as L, provider_error as M, provider_not_configured_error as N, model_required_error as O, provider_required_error as P, tool_error as R, resolve_transport as S, engine_config_error as T, load_optional_peer as _, invoke_http_turn as a, normalize_local_usage as b, network_detail as c, parse_tool_call_arguments as d, protocol_error as f, default_normalize_usage as g, unreachable_message as h, error_body_message as i, provider_capability_error as j, on_chunk_error as k, network_failure as l, split_assistant_parts as m, consume_framed_stream as n, is_own_reasoning as o, read_dialect_init as p, create_line_splitter as r, map_messages_by_role as s, split_leading_system_run as t, non_retryable_status_error as u, missing_config_error as v, claude_cli_error as w, refuse_credentials_in_base_url as x, missing_peer_error as y, turn_timeout_error as z };
662
811
 
663
- //# sourceMappingURL=leading_system-C23TJ9OQ.js.map
812
+ //# sourceMappingURL=leading_system-CHSYz0h9.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"leading_system-CHSYz0h9.js","names":[],"sources":["../src/engine/errors.ts","../src/engine/providers/types.ts","../src/engine/providers/native_shared.ts","../src/engine/leading_system.ts"],"sourcesContent":["/**\n * Typed errors for the AI engine layer.\n *\n * This is the only source file in the engine module permitted to use the\n * `class` keyword. `Error` is a built-in and `instanceof` branching is how\n * the retry helper and composition-layer composers distinguish failure modes.\n * Every other engine file stays class-free.\n *\n * `aborted_error` is defined in the core module and re-exported here so that\n * `instanceof aborted_error` is true regardless of which layer surfaced it.\n * This is the one value-level import from core permitted in engine source;\n * see the ignores in `rules/no-core-value-import-in-engine.yml`.\n *\n * Every class declares an optional `path`: the chain of step ids the error\n * crossed while bubbling through the core runner's dispatch. The runner\n * attaches it via Reflect.set (`prepend_path` in core's runner.ts), so the\n * `declare` modifier types what arrives without emitting a field;\n * construction never sets it.\n */\n\nimport type { SchemaIssue } from '#schema'\nimport type { FinishReason } from './types.js'\n\nexport { aborted_error } from '#core'\n\nexport class rate_limit_error extends Error {\n readonly kind = 'rate_limit_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly retry_after_ms: number | undefined;\n readonly attempts: number;\n readonly status: number | undefined;\n override readonly cause: unknown;\n constructor(\n message: string,\n metadata: { retry_after_ms?: number; attempts?: number; status?: number; cause?: unknown } = {},\n ) {\n super(message)\n this.name = 'rate_limit_error'\n this.retry_after_ms = metadata.retry_after_ms\n this.attempts = metadata.attempts ?? 0\n this.status = metadata.status\n this.cause = metadata.cause\n }\n}\n\nexport class provider_error extends Error {\n readonly kind = 'provider_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly status: number | undefined;\n readonly body: string | undefined;\n readonly cause_kind: 'provider_5xx' | 'network' | 'unknown' | undefined;\n readonly attempts: number | undefined;\n override readonly cause: unknown;\n constructor(\n message: string,\n metadata: {\n status?: number\n body?: string | undefined\n cause_kind?: 'provider_5xx' | 'network' | 'unknown'\n attempts?: number\n cause?: unknown\n } = {},\n ) {\n super(message)\n this.name = 'provider_error'\n this.status = metadata.status\n this.body = metadata.body\n this.cause_kind = metadata.cause_kind\n this.attempts = metadata.attempts\n this.cause = metadata.cause\n }\n}\n\n/**\n * Turn-timeout expiry. Thrown by the engine-owned retry_turn wrapper when a\n * single invoke_turn exceeds `turn_timeout_ms` before any chunk reached a\n * consumer.\n * Its `kind` is the RetryFailureKind wire value `'timeout'` (not the class\n * name) on purpose: that is the discriminant classify_retryable /\n * classify_provider_error already key on, so the shared classifier treats an\n * expiry as retryable without any timeout-specific branch. An expiry after a\n * chunk has reached an on_chunk consumer never reaches here; retry_turn\n * converts it to a non-retryable stream interruption first.\n */\nexport class turn_timeout_error extends Error {\n readonly kind = 'timeout' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly timeout_ms: number;\n readonly step_index: number | undefined;\n constructor(timeout_ms: number, step_index?: number) {\n super(`turn exceeded turn_timeout_ms budget of ${timeout_ms}ms`)\n this.name = 'turn_timeout_error'\n this.timeout_ms = timeout_ms\n this.step_index = step_index\n }\n}\n\nexport class schema_validation_error extends Error {\n readonly kind = 'schema_validation_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly schema_issues: ReadonlyArray<SchemaIssue>;\n readonly raw_text: string;\n constructor(message: string, schema_issues: ReadonlyArray<SchemaIssue>, raw_text: string) {\n super(message)\n this.name = 'schema_validation_error'\n this.schema_issues = schema_issues\n this.raw_text = raw_text\n }\n}\n\nexport class tool_error extends Error {\n readonly kind = 'tool_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly tool_name: string;\n readonly tool_call_id: string;\n override readonly cause: unknown;\n constructor(\n message: string,\n metadata: { tool_name: string; tool_call_id: string; cause: unknown },\n ) {\n super(message)\n this.name = 'tool_error'\n this.tool_name = metadata.tool_name\n this.tool_call_id = metadata.tool_call_id\n this.cause = metadata.cause\n }\n}\n\nexport class tool_approval_denied_error extends Error {\n readonly kind = 'tool_approval_denied_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly tool_name: string;\n readonly step_index: number;\n readonly tool_call_id: string;\n constructor(\n message: string,\n metadata: { tool_name: string; step_index: number; tool_call_id: string },\n ) {\n super(message)\n this.name = 'tool_approval_denied_error'\n this.tool_name = metadata.tool_name\n this.step_index = metadata.step_index\n this.tool_call_id = metadata.tool_call_id\n }\n}\n\nexport class model_required_error extends Error {\n readonly kind = 'model_required_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n constructor(\n message = 'no model specified: pass `model` to generate() or set `defaults.model` on the engine',\n ) {\n super(message)\n this.name = 'model_required_error'\n }\n}\n\n/**\n * A generate call named a provider the engine has no adapter for. Carries the\n * configured names, and the message repeats them, so a typo is visible from\n * the message alone rather than needing the engine config alongside it.\n */\nexport class provider_not_configured_error extends Error {\n readonly kind = 'provider_not_configured_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly provider: string;\n readonly configured: ReadonlyArray<string>;\n constructor(provider: string, configured: ReadonlyArray<string> = []) {\n const state = configured.length > 0 ? configured.join(', ') : 'none'\n super(\n `provider '${provider}' is not configured on this engine: pass it to create_engine({ providers }) (configured: ${state})`,\n )\n this.name = 'provider_not_configured_error'\n this.provider = provider\n this.configured = configured\n }\n}\n\n/**\n * No provider could be resolved for a generate call: several providers are\n * configured, the call named none, and no `defaults.provider` is set. Carries\n * the configured provider names so the message tells the caller exactly what\n * the engine can route to.\n */\nexport class provider_required_error extends Error {\n readonly kind = 'provider_required_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly configured: ReadonlyArray<string>;\n constructor(configured: ReadonlyArray<string>) {\n super(\n `no provider specified: pass \\`provider\\` to generate() or set \\`defaults.provider\\` (configured: ${configured.join(', ')})`,\n )\n this.name = 'provider_required_error'\n this.configured = configured\n }\n}\n\nexport class engine_config_error extends Error {\n readonly kind = 'engine_config_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly provider: string | undefined;\n constructor(message: string, provider?: string) {\n super(message)\n this.name = 'engine_config_error'\n this.provider = provider\n }\n}\n\nexport class on_chunk_error extends Error {\n readonly kind = 'on_chunk_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n override readonly cause: unknown;\n constructor(message: string, cause: unknown) {\n super(message)\n this.name = 'on_chunk_error'\n this.cause = cause\n }\n}\n\nexport class provider_capability_error extends Error {\n readonly kind = 'provider_capability_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly provider: string;\n readonly capability: string;\n constructor(provider: string, capability: string, detail?: string) {\n const suffix = detail !== undefined ? `: ${detail}` : ''\n super(`provider '${provider}' does not support '${capability}'${suffix}`)\n this.name = 'provider_capability_error'\n this.provider = provider\n this.capability = capability\n }\n}\n\nexport class engine_disposed_error extends Error {\n readonly kind = 'engine_disposed_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n constructor(message = 'engine has been disposed: build a new one with create_engine()') {\n super(message)\n this.name = 'engine_disposed_error'\n }\n}\n\nexport type ClaudeCliErrorReason =\n | 'binary_not_found'\n | 'startup_timeout'\n | 'stall_timeout'\n | 'no_result_event'\n | 'result_error'\n | 'subprocess_exit'\n | 'sandbox_unavailable'\n\nexport class claude_cli_error extends Error {\n readonly kind = 'claude_cli_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly reason: ClaudeCliErrorReason;\n readonly status: number | undefined;\n readonly stderr_snippet: string | undefined;\n constructor(\n reason: ClaudeCliErrorReason,\n message: string,\n metadata: { status?: number; stderr_snippet?: string } = {},\n ) {\n super(message)\n this.name = 'claude_cli_error'\n this.reason = reason\n this.status = metadata.status\n this.stderr_snippet = metadata.stderr_snippet\n }\n}\n\nexport class provider_auth_error extends Error {\n readonly kind = 'provider_auth_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly provider: string;\n readonly refresh_command: string | undefined;\n override readonly cause: unknown;\n constructor(\n provider: string,\n message: string,\n metadata: { refresh_command?: string; cause?: unknown } = {},\n ) {\n super(message)\n this.name = 'provider_auth_error'\n this.provider = provider\n this.refresh_command = metadata.refresh_command\n this.cause = metadata.cause\n }\n}\n\n/**\n * A generate call that set a schema finished for a reason other than 'stop'\n * (content_filter, length, max_steps, tool_calls), so no schema-validated\n * value exists and validation was never attempted. Carries the raw model text\n * and the last provider-reported payload, so a guardrail trace or other\n * block detail stays reachable from the catch. Distinct from\n * schema_validation_error, which covers a response that completed normally\n * and then failed validation after its repair attempts ran out.\n */\nexport class incomplete_generation_error extends Error {\n readonly kind = 'incomplete_generation_error' as const;\n declare readonly path?: ReadonlyArray<string>;\n readonly finish_reason: FinishReason;\n readonly raw_text: string;\n readonly provider_reported: Record<string, unknown> | undefined;\n constructor(\n finish_reason: FinishReason,\n raw_text: string,\n provider_reported?: Record<string, unknown>,\n ) {\n super(\n `generation finished with '${finish_reason}' before a schema-validated response was produced`,\n )\n this.name = 'incomplete_generation_error'\n this.finish_reason = finish_reason\n this.raw_text = raw_text\n this.provider_reported = provider_reported\n }\n}\n","/**\n * Shared provider-adapter shape.\n *\n * Each file under src/engine/providers/ exports a factory that accepts a\n * ProviderInit shape and returns a ProviderAdapter. Factories are\n * synchronous; build_model is async so SDK loading is deferred until a model\n * is actually needed. A missing peer dependency surfaces on the first\n * build_model call as a plain Error naming the peer and its install command\n * (see missing_peer_error).\n *\n * Only the ai_sdk transport module (providers/ai_sdk/invoke.ts) may import\n * from `ai` or invoke generateText/streamText. ai_sdk adapters build the\n * provider model and translate parameters; they do not orchestrate the call.\n */\n\nimport type {\n CacheSetting,\n ResolvedModel,\n EffortLevel,\n GenerateOptions,\n GenerateResult,\n ProviderInit,\n TurnRequest,\n TurnResult,\n UsageTotals,\n} from '../types.js'\nimport { engine_config_error } from '../errors.js'\n\n/**\n * Which backend a provider factory returns: 'ai_sdk' wraps the Vercel AI SDK\n * provider package, 'native' talks to the provider's HTTP API directly. The\n * provider name stays the same across transports so pricing keys and usage\n * fields carry over; only the wire implementation changes.\n */\nexport type ProviderTransport = 'ai_sdk' | 'native'\n\n/**\n * Read the `transport` selector off a provider init. Defaults to 'ai_sdk';\n * anything but the two known backends throws at construction so a typo\n * fails loud instead of silently running the default.\n */\nexport function resolve_transport(\n init: ProviderInit,\n provider: string,\n): ProviderTransport {\n const raw = init['transport']\n if (raw === undefined || raw === 'ai_sdk') return 'ai_sdk'\n if (raw === 'native') return 'native'\n throw new engine_config_error(\n `${provider} provider: transport must be 'ai_sdk' or 'native', got ${JSON.stringify(raw)}`,\n provider,\n )\n}\n\nexport type EffortTranslation = {\n // Outer keys are provider names, inner records hold per-provider settings,\n // matching the two-level shape merge_provider_options expects.\n provider_options: Record<string, Record<string, unknown>>\n effort_ignored: boolean\n // A level for the AI SDK's own `reasoning` call option, which the provider\n // package maps per model. Left out, the SDK uses the provider's default.\n reasoning?: Exclude<EffortLevel, 'none'>\n}\n\n/**\n * Hand effort to the AI SDK's `reasoning` option and build no provider\n * options of its own, so the provider package maps each level per model from\n * the capability table it keeps (adaptive thinking or a budget for Claude,\n * `thinkingLevel` or a budget for Gemini, `reasoningEffort` for OpenAI).\n * `none` sends neither, which is the SDK's provider default. The anthropic,\n * bedrock, google, and openai ai_sdk adapters all translate this way.\n */\nexport function translate_effort_to_sdk_reasoning(effort: EffortLevel): EffortTranslation {\n if (effort === 'none') return { provider_options: {}, effort_ignored: false }\n return { provider_options: {}, effort_ignored: false, reasoning: effort }\n}\n\nexport type ProviderCapability =\n | 'text'\n | 'tools'\n | 'schema'\n | 'streaming'\n | 'image_input'\n | 'reasoning'\n // Provider performs native constrained decoding (the AI SDK responseFormat /\n // Output.object path), as opposed to the prompt-for-JSON-then-extract path.\n // Distinct from 'schema': every provider can satisfy a schema via repair, but\n // only some constrain the decode to it.\n | 'structured_output'\n\n/**\n * How an adapter caches prompts, which decides what a call's `cache` setting\n * does on it. `'with_tools'` caches for five minutes by default on a call\n * with tools, `'opt_in'` caches only when the call or the engine asks, and\n * `'automatic'` marks a provider that caches on its own, so an explicit\n * setting is ignored. An adapter that declares nothing requests no caching.\n */\ntype PromptCacheDeclaration = 'with_tools' | 'opt_in' | 'automatic'\n\nexport type RawProviderUsage = {\n input_tokens?: number\n output_tokens?: number\n reasoning_tokens?: number\n cached_input_tokens?: number\n cache_write_tokens?: number\n // The Vercel AI SDK also surfaces details via *Details containers; adapters\n // accept the flattened shape above for testability.\n input_token_details?: {\n cached_tokens?: number\n cache_creation_input_tokens?: number\n }\n output_token_details?: {\n reasoning_tokens?: number\n }\n [k: string]: unknown\n}\n\nexport type AiSdkProviderAdapter = {\n readonly kind: 'ai_sdk'\n readonly name: string\n // The key the adapter's package writes providerMetadata under, which is\n // the only key a reasoning part may carry to be sent back. Defaults\n // to `name`; a custom adapter over a built-in package (@ai-sdk/anthropic on\n // Vertex, say) can't take the built-in name, so it sets the package's key.\n readonly metadata_key?: string\n readonly build_model: (model_id: string) => Promise<unknown>\n readonly translate_effort: (effort: EffortLevel) => EffortTranslation\n /**\n * Map the SDK's usage to UsageTotals. The engine also hands it the step's\n * `providerMetadata`, for a split that the SDK's usage object leaves out.\n */\n readonly normalize_usage: (raw: RawProviderUsage | undefined, provider_metadata?: unknown) => UsageTotals\n readonly supports: (capability: ProviderCapability) => boolean\n readonly prompt_cache?: PromptCacheDeclaration\n /**\n * Turn the call's resolved cache setting into call-level provider options,\n * given the caller's own (engine defaults merged with the call's). The\n * engine merges the result beneath the caller's options, where effort's\n * translation goes. An adapter that declares `'with_tools'` or `'opt_in'`\n * without this hook asks for no cache, as one that declares nothing.\n */\n readonly translate_cache?: (\n cache: CacheSetting,\n provider_options: Readonly<Record<string, unknown>> | undefined,\n ) => Record<string, Record<string, unknown>>\n}\n\n/**\n * Raw-HTTP transport: implements a single turn against a provider's own\n * API with zero `ai` / `@ai-sdk/*` in its module graph. generate.ts wraps\n * invoke_turn in retry + classification + abort, so a native adapter owns only\n * request/response mapping (and streaming via TurnRequest.dispatch_chunk); it\n * MUST NOT implement its own retry. classify_error optionally overrides the\n * shared classifier; dispose is optional (keep-alive agents, connection pools).\n */\nexport type NativeProviderAdapter = {\n readonly kind: 'native'\n readonly name: string\n readonly invoke_turn: (req: TurnRequest) => Promise<TurnResult>\n readonly supports: (capability: ProviderCapability) => boolean\n readonly prompt_cache?: PromptCacheDeclaration\n readonly dispose?: () => Promise<void>\n readonly classify_error?: (err: unknown) => unknown\n}\n\nexport type ExternalAgentAdapter = {\n readonly kind: 'external'\n readonly name: string\n readonly generate: <t>(\n opts: GenerateOptions<t>,\n resolved: ResolvedModel,\n ) => Promise<GenerateResult<t>>\n readonly dispose: () => Promise<void>\n readonly supports: (capability: ProviderCapability) => boolean\n}\n\nexport type ProviderAdapter =\n | AiSdkProviderAdapter\n | NativeProviderAdapter\n | ExternalAgentAdapter\n\nexport type ProviderFactory = (init: ProviderInit) => ProviderAdapter\n\n/**\n * Map raw provider usage to UsageTotals, the mapper most adapters share.\n *\n * Missing usage zeroes the totals. Optional fields (reasoning and cache\n * tokens) are set only when the raw payload carries them, reading the\n * flattened field first and the AI SDK's *_details container second.\n */\nexport function default_normalize_usage(\n raw: RawProviderUsage | undefined,\n): UsageTotals {\n if (raw === undefined) return { input_tokens: 0, output_tokens: 0 }\n const input_tokens = typeof raw.input_tokens === 'number' ? raw.input_tokens : 0\n const output_tokens = typeof raw.output_tokens === 'number' ? raw.output_tokens : 0\n const totals: UsageTotals = { input_tokens, output_tokens }\n if (typeof raw.reasoning_tokens === 'number') totals.reasoning_tokens = raw.reasoning_tokens\n else if (typeof raw.output_token_details?.reasoning_tokens === 'number') {\n totals.reasoning_tokens = raw.output_token_details.reasoning_tokens\n }\n if (typeof raw.cached_input_tokens === 'number') totals.cached_input_tokens = raw.cached_input_tokens\n else if (typeof raw.input_token_details?.cached_tokens === 'number') {\n totals.cached_input_tokens = raw.input_token_details.cached_tokens\n }\n if (typeof raw.cache_write_tokens === 'number') totals.cache_write_tokens = raw.cache_write_tokens\n else if (typeof raw.input_token_details?.cache_creation_input_tokens === 'number') {\n totals.cache_write_tokens = raw.input_token_details.cache_creation_input_tokens\n }\n return totals\n}\n\n/**\n * Usage mapper for local backends (Ollama, LM Studio) whose servers never\n * report cache or reasoning tokens: default-normalize, then strip those\n * fields so a stray *_details container cannot invent them.\n */\nexport function normalize_local_usage(raw: RawProviderUsage | undefined): UsageTotals {\n const base = default_normalize_usage(raw)\n delete base.cached_input_tokens\n delete base.cache_write_tokens\n delete base.cache_write_1h_tokens\n delete base.reasoning_tokens\n return base\n}\n\n/**\n * The error for a provider config that's missing a value the provider can't\n * run without. It names the key to pass to create_engine and where the value\n * usually comes from, an environment variable or a local server's address.\n * It says \"pass\" because the engine never reads the environment itself.\n */\nexport function missing_config_error(\n provider: string,\n key: string,\n usual: string,\n): engine_config_error {\n return new engine_config_error(\n `${provider} provider requires a non-empty ${key}: pass providers.${provider}.${key} to create_engine, usually ${usual}`,\n provider,\n )\n}\n\n/** The built-in providers that send no credentials of their own. */\nconst KEYLESS_PROVIDERS: ReadonlySet<string> = new Set(['ollama', 'lmstudio'])\n\n/**\n * Whether `base_url` puts a user name or password before its host, with a\n * scheme or without one, as `http://user:pass@host` and `user@host:11434`\n * do. Only the authority counts, the part before the first `/`, `?`, or `#`,\n * so an `@` in a path or a query isn't one.\n */\nfunction has_userinfo(base_url: string): boolean {\n const scheme_end = base_url.indexOf('://')\n const rest = scheme_end === -1 ? base_url : base_url.slice(scheme_end + 3)\n const authority_end = rest.search(/[/?#]/)\n const authority = authority_end === -1 ? rest : rest.slice(0, authority_end)\n return authority.includes('@')\n}\n\n/**\n * Throw `engine_config_error` for a built-in provider whose `base_url` holds\n * a user name or password. Node's fetch refuses to send a request to such a\n * URL, and its error repeats the whole URL, credentials included, so the\n * engine refuses it as it's built, without repeating the URL.\n */\nexport function refuse_credentials_in_base_url(provider: string, init: ProviderInit): void {\n const base_url: unknown = init.base_url\n if (typeof base_url !== 'string' || !has_userinfo(base_url)) return\n const fix = KEYLESS_PROVIDERS.has(provider)\n ? `since the ${provider} provider sends no credentials`\n : `and pass the key as providers.${provider}.api_key`\n throw new engine_config_error(\n `${provider} provider's base_url holds a user name or password, which fetch refuses to send: take them out of base_url, ${fix}`,\n provider,\n )\n}\n\n/**\n * Build the standard missing-peer error: names the package and the install\n * command so a missing peer is diagnosable from the message alone. Shared so\n * every optional-peer failure reads identically, whether the failing\n * `import()` names the peer directly (load_optional_peer below) or a local\n * module that reaches the peer through its own static import (the ai_sdk\n * turn seam in generate.ts, whose dynamic import must stay written in\n * generate.ts for its relative specifier to resolve correctly).\n */\nexport function missing_peer_error(peer_name: string, cause: unknown): Error {\n const detail = cause instanceof Error ? cause.message : JSON.stringify(cause)\n const message =\n `missing peer dependency '${peer_name}'. Install it with your package manager, e.g., \\`pnpm add ${peer_name}\\` or \\`npm install ${peer_name}\\`. Cause: ${detail}`\n return new Error(message, { cause })\n}\n\n/**\n * Dynamically import an optional peer dependency, rethrowing an import\n * failure via missing_peer_error so a missing peer is diagnosable from the\n * message alone.\n */\nexport async function load_optional_peer<t>(\n specifier: string,\n): Promise<t> {\n let mod: unknown\n try {\n mod = await import(specifier)\n } catch (err: unknown) {\n throw missing_peer_error(specifier, err)\n }\n // eslint-disable-next-line typescript-eslint/no-unsafe-type-assertion\n return mod as t\n}\n","/**\n * Shared plumbing for the native (raw-HTTP) provider adapters.\n *\n * Everything here is wire-neutral: how a turn travels HTTP (POST, non-2xx\n * mapping, stream-vs-JSON dispatch), how streamed bytes become framed\n * payloads, and the engine-message folds the 1:1 wires share. Each adapter\n * keeps what is genuinely its own dialect (request bodies, response parsers,\n * stream aggregators) and delegates the rest here, so the three adapters\n * cannot drift apart on retry classification or stream draining. This module\n * imports nothing from `ai` or `@ai-sdk/*` and nothing from the adapters, so\n * every adapter can import it cycle-free.\n */\n\nimport type {\n AssistantContentPart,\n Message,\n ProviderInit,\n StreamChunk,\n TurnRequest,\n TurnResult,\n UserContentPart,\n} from '../types.js'\nimport { provider_auth_error, provider_error } from '../errors.js'\n\n/**\n * `value` when it is a non-empty string, or undefined.\n */\nfunction non_empty_string(value: unknown): string | undefined {\n return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n\n/**\n * The message under a JSON error envelope's `error` key, or else its\n * top-level `message`, or undefined when the shape carries none worth\n * surfacing.\n */\nfunction error_field_message(parsed: unknown): string | undefined {\n if (parsed === null || typeof parsed !== 'object') return undefined\n const error: unknown = Reflect.get(parsed, 'error')\n if (typeof error === 'string' && error.length > 0) return error\n if (error !== null && typeof error === 'object') {\n const message = non_empty_string(Reflect.get(error, 'message'))\n if (message !== undefined) return message\n }\n return non_empty_string(Reflect.get(parsed, 'message'))\n}\n\n/**\n * The message a non-2xx JSON body carries, or undefined when the body isn't\n * JSON or carries none. The wires share one envelope family: Anthropic sends\n * `{ type: 'error', error: { message } }`, OpenAI-style wires send\n * `{ error: { message } }`, Ollama sends `{ error: \"message\" }` (with the\n * nested shape appearing behind proxies), and Bedrock sends `{ message }`, so\n * one parser accepts a string or a `{ message }` object under `error`, and\n * then a top-level `message`. The engine's classifier reads an AI SDK error's\n * `responseBody` through it too.\n */\nexport function error_body_message(body: string): string | undefined {\n let parsed: unknown\n try {\n parsed = JSON.parse(body)\n } catch {\n // Not JSON, so it carries no message.\n }\n return error_field_message(parsed)\n}\n\n/**\n * Pull a human-readable message out of a non-2xx body: the one its JSON\n * carries (see error_body_message), or else the raw body, truncated to 300\n * chars.\n */\nfunction extract_error_message(body: string): string {\n if (body.length === 0) return '(empty body)'\n const message = error_body_message(body)\n if (message !== undefined) return message\n return body.length > 300 ? `${body.slice(0, 300)}...` : body\n}\n\nconst LOCAL_PROVIDERS: ReadonlySet<string> = new Set(['ollama', 'lmstudio'])\n\n/** The model name in Ollama's `model 'x' not found` reply, either quote. */\nconst OLLAMA_MISSING_MODEL = /model ['\"]([^'\"]+)['\"] not found/\n\n/**\n * `detail` without the one period a provider's sentence ends on, so that an\n * action can follow it after a colon. A `...` truncation tail keeps its dots.\n */\nfunction strip_trailing_period(detail: string): string {\n return detail.replace(/(?<!\\.)\\.$/, '')\n}\n\n/**\n * What to do about a 404: pull the model, when Ollama names one it doesn't\n * have, and otherwise check the model id and where `base_url` points, since\n * a path the provider doesn't serve answers 404 too.\n */\nfunction not_found_action(provider: string, detail: string): string {\n const missing = provider === 'ollama' ? OLLAMA_MISSING_MODEL.exec(detail)?.[1] : undefined\n if (missing !== undefined) return `run ollama pull ${missing}`\n return `check the model id against the ${provider} model list, and that base_url points at the ${provider} API`\n}\n\n/**\n * What a caller does about a non-retryable status, or '' for a status whose\n * fix only the provider's own text can say, such as a 400 or a 422. The\n * ollama and lmstudio providers send no credentials, so a 401 from either\n * comes from something in front of the server.\n */\nfunction status_action(provider: string, status: number, detail: string): string {\n if (status === 401) {\n return LOCAL_PROVIDERS.has(provider)\n ? `the ${provider} provider sends no credentials, so check that base_url reaches the server without a proxy that asks for them`\n : `check providers.${provider}.api_key`\n }\n if (status === 403) return 'the credentials lack access to this model or endpoint'\n if (status === 404) return not_found_action(provider, detail)\n return ''\n}\n\n/**\n * The error a status that won't be retried becomes, on either transport: a\n * 401 is a provider_auth_error, and any other status a provider_error that\n * carries it and the body. The message leads with the provider and the\n * status, then the provider's own text, then what to do when the status says\n * it. The native transport's response_error and the engine's ai_sdk\n * classifier both build theirs here, so a wrong key or a wrong model id reads\n * the same whichever transport the call took, and `cause` holds the SDK's\n * error on the ai_sdk one.\n */\nexport function non_retryable_status_error(\n provider: string,\n status: number,\n detail: string,\n metadata: { body?: string | undefined; cause?: unknown } = {},\n): provider_auth_error | provider_error {\n const action = status_action(provider, status, detail)\n const tail = action === '' ? detail : `${strip_trailing_period(detail)}: ${action}`\n if (status === 401) {\n return new provider_auth_error(provider, `${provider} authentication failed (401): ${tail}`, {\n cause: metadata.cause,\n })\n }\n return new provider_error(`${provider} API error ${status}: ${tail}`, { status, ...metadata })\n}\n\n/**\n * Map a non-2xx response to what the engine's retry stack expects: 429/5xx\n * keep `status`, `body`, and `responseHeaders` so classify_provider_error\n * marks them retryable (rate_limit honoring retry-after, provider_5xx) and\n * the exhausted error still has the body, and any other status is the\n * permanent error that non_retryable_status_error builds, which surfaces\n * as-is.\n */\nasync function response_error(response: Response, provider: string): Promise<Error> {\n let body = ''\n try {\n body = await response.text()\n } catch {\n // Body is best-effort detail; classification needs only the status.\n }\n const detail = extract_error_message(body)\n const status = response.status\n if (status === 429 || status >= 500) {\n const retry_after = response.headers.get('retry-after')\n return Object.assign(\n new Error(`${provider} API error ${status}: ${detail}`),\n { status, body },\n retry_after !== null ? { responseHeaders: { 'retry-after': retry_after } } : {},\n )\n }\n return non_retryable_status_error(provider, status, detail, { body })\n}\n\n/**\n * A transport failure in the `kind: 'network'` shape that the shared\n * classify_provider_error marks retryable. A stream that ends before its\n * closing event throws it too, since a cut-off stream is a dropped\n * connection, so the engine retries it whenever nothing consumed its chunks.\n */\nexport function network_failure(message: string): Error {\n return Object.assign(new Error(message), { kind: 'network' })\n}\n\n/**\n * The `code` that `value` carries, such as `ECONNREFUSED`, when it's an\n * object whose `code` is a string.\n */\nfunction error_code(value: unknown): string | undefined {\n if (value === null || typeof value !== 'object') return undefined\n const code: unknown = Reflect.get(value, 'code')\n return typeof code === 'string' ? code : undefined\n}\n\n/**\n * A transport failure's own message, followed by the system error code that\n * the error or its `cause` carries when the message doesn't already name it,\n * as in `fetch failed (ECONNREFUSED)`. Undici's `fetch failed` alone doesn't\n * say whether the host refused, timed out, or doesn't resolve. A failure with\n * no message, such as the `AggregateError` that Node raises when every\n * address of a host refuses, is named by its code alone.\n */\nexport function network_detail(err: unknown): string {\n const message = err instanceof Error ? err.message : String(err)\n const cause: unknown = err !== null && typeof err === 'object' ? Reflect.get(err, 'cause') : undefined\n const code = error_code(err) ?? error_code(cause)\n if (message.length === 0) return code ?? '(no detail)'\n return code === undefined || message.includes(code) ? message : `${message} (${code})`\n}\n\n/**\n * `url` as its origin and path, without the credentials, query, or fragment\n * that can carry a key, so that a message that names it is safe to log. A\n * string that doesn't parse is named only as not being a URL.\n */\nfunction log_safe_url(url: string): string {\n try {\n const parsed = new URL(url)\n return `${parsed.origin}${parsed.pathname}`\n } catch {\n return 'a base_url that is not a valid URL'\n }\n}\n\n/**\n * The message for a request that never reached the provider: the URL it was\n * sent to (see log_safe_url), what failed, and what to check, with the\n * command that starts the server for Ollama, the one provider that's usually\n * a daemon on the same machine. A failure whose own text repeats the URL,\n * as undici's does for one that it can't parse or that holds credentials,\n * gets the same log-safe URL in its place.\n */\nexport function unreachable_message(provider: string, url: string, detail: string): string {\n const safe = log_safe_url(url)\n const scrubbed = url.length > 0 ? detail.replaceAll(url, safe) : detail\n const start = provider === 'ollama' ? ' (ollama serve)' : ''\n return `${provider} could not be reached at ${safe}: ${scrubbed}: check base_url, and that the server is running${start}`\n}\n\n/**\n * The message for a connection that dropped after the response began, which\n * names no URL, since the request reached the server.\n */\nfunction dropped_message(provider: string, detail: string): string {\n return `${provider} connection dropped while reading the response: ${detail}`\n}\n\n/**\n * A user abort surfaces as the fetch/reader AbortError; retry_turn converts\n * it via its own signal check, so it is rethrown untouched. Everything else\n * is a transport failure wrapped as a network_failure, whose message `message`\n * builds from the failure's network_detail.\n */\nfunction rethrow_network_failure(\n err: unknown,\n abort: AbortSignal,\n message: (detail: string) => string,\n): never {\n if (abort.aborted) throw err\n throw network_failure(message(network_detail(err)))\n}\n\n/**\n * The response's media type, lowercased and without its parameters, or ''\n * when it names none.\n */\nfunction media_type(response: Response): string {\n const header = response.headers.get('content-type') ?? ''\n return (header.split(';')[0] ?? '').trim().toLowerCase()\n}\n\n/**\n * Read a non-stream response body and parse it as JSON. A read that fails\n * partway is a transport failure, wrapped as network the way a failed stream\n * read is; a body that arrives whole but does not parse is a permanent\n * provider_error naming what came back.\n */\nasync function read_json_body(\n response: Response,\n abort: AbortSignal,\n provider: string,\n): Promise<unknown> {\n let text: string\n try {\n text = await response.text()\n } catch (err: unknown) {\n rethrow_network_failure(err, abort, (detail) => dropped_message(provider, detail))\n }\n try {\n return JSON.parse(text)\n } catch {\n throw new provider_error(\n `${provider} native: response body is not valid JSON: check that base_url points at the ${provider} API (body: ${extract_error_message(text)})`,\n )\n }\n}\n\n/**\n * The error for a response that isn't the provider's protocol: what was\n * wrong with it, then what to check, since a body of the wrong shape most\n * often comes from a `base_url` that points somewhere else. `also` names the\n * other fix when there is one.\n */\nexport function protocol_error(provider: string, what: string, also?: string): provider_error {\n const other = also === undefined ? '' : `, or ${also}`\n return new provider_error(\n `${provider} native: ${what}: check that base_url points at the ${provider} API${other}`,\n )\n}\n\n/**\n * Run one native turn over HTTP: POST the dialect's body, map a non-2xx to\n * the retry stack's shapes, and hand the response to the dialect's stream or\n * JSON consumer. A streamed request whose reply doesn't arrive as the\n * dialect's stream media type (`text/event-stream`, or NDJSON for Ollama) is\n * read as a whole JSON body, so a server that answers with JSON still works,\n * and a page that isn't JSON fails with the `base_url` hint rather than as a\n * cut-off stream. `build_body` runs before the network try/catch, so a mapper\n * that rejects the request (e.g., a provider_capability_error for a part the\n * wire cannot carry) propagates unchanged instead of being retried as a\n * network failure. `req.on_wire`, when the call captures the wire, sees the\n * URL and the body object just before the body is serialized, and never a\n * header.\n */\nexport async function invoke_http_turn(\n req: TurnRequest,\n provider: string,\n request: {\n url: string\n headers: Record<string, string>\n build_body: () => Record<string, unknown>\n },\n consume: {\n stream: (response: Response) => Promise<TurnResult>\n parse: (payload: unknown) => TurnResult\n /** The media type that a streamed reply arrives as. */\n stream_media_type: string\n },\n): Promise<TurnResult> {\n const built = request.build_body()\n req.on_wire?.({ url: request.url, body: built })\n const body = JSON.stringify(built)\n let response: Response\n try {\n response = await fetch(request.url, {\n method: 'POST',\n headers: request.headers,\n body,\n signal: req.abort,\n })\n } catch (err: unknown) {\n rethrow_network_failure(err, req.abort, (detail) => unreachable_message(provider, request.url, detail))\n }\n if (!response.ok) throw await response_error(response, provider)\n if (req.stream && media_type(response) === consume.stream_media_type) {\n return consume.stream(response)\n }\n return consume.parse(await read_json_body(response, req.abort, provider))\n}\n\n/**\n * Drain a streaming response: decode bytes, reassemble framed payloads (SSE\n * events or NDJSON lines), and feed them to the dialect's aggregator, which\n * dispatches chunks through req.dispatch_chunk as they arrive. Transport\n * failures mid-read wrap as network errors; aggregator throws (malformed\n * frames, mid-stream error events, a rejecting on_chunk) pass through\n * untouched, with the reader cancelled so the connection is released.\n */\nexport async function consume_framed_stream(\n response: Response,\n req: TurnRequest,\n provider: string,\n framing: { push: (text: string) => string[]; flush: () => string[] },\n create_aggregator: (dispatch: (chunk: StreamChunk) => Promise<void>) => {\n handle: (data: string) => Promise<void>\n complete: () => TurnResult\n },\n): Promise<TurnResult> {\n const body = response.body\n if (body === null) {\n throw new provider_error(`${provider} native: streaming response has no body`)\n }\n const aggregator = create_aggregator(req.dispatch_chunk ?? (async (): Promise<void> => {}))\n const reader = body.getReader()\n const text_decoder = new TextDecoder()\n\n const next_bytes = async (): Promise<Uint8Array | undefined> => {\n let step: Awaited<ReturnType<typeof reader.read>>\n try {\n step = await reader.read()\n } catch (err: unknown) {\n rethrow_network_failure(err, req.abort, (detail) => dropped_message(provider, detail))\n }\n return step.done ? undefined : step.value\n }\n\n // Sequential awaits are the contract here: chunk order is an engine\n // invariant and each frame mutates aggregator state, so no parallelism.\n try {\n while (true) {\n const bytes = await next_bytes()\n if (bytes === undefined) break\n for (const data of framing.push(text_decoder.decode(bytes, { stream: true }))) {\n await aggregator.handle(data)\n }\n }\n } finally {\n // Frees the connection when an error exits the loop early; a no-op on a\n // fully drained stream.\n void reader.cancel().catch(() => {})\n }\n const tail = [...framing.push(text_decoder.decode()), ...framing.flush()]\n for (const data of tail) {\n await aggregator.handle(data)\n }\n return aggregator.complete()\n}\n\n/**\n * Incremental newline framing shared by the SSE and NDJSON decoders: buffer\n * decoded text across arbitrary chunk boundaries, hand each completed line\n * (CR trimmed) to `handle_line`, and on flush hand over an unterminated tail\n * line, then `on_flush` for state a decoder holds across lines (an SSE event\n * never closed by a blank line).\n */\nexport function create_line_splitter(\n handle_line: (line: string, out: string[]) => void,\n on_flush?: (out: string[]) => void,\n): { push: (text: string) => string[]; flush: () => string[] } {\n let buffer = ''\n\n const take_line = (raw: string, out: string[]): void => {\n handle_line(raw.endsWith('\\r') ? raw.slice(0, -1) : raw, out)\n }\n\n return {\n push(text: string): string[] {\n buffer += text\n const out: string[] = []\n let newline = buffer.indexOf('\\n')\n while (newline >= 0) {\n take_line(buffer.slice(0, newline), out)\n buffer = buffer.slice(newline + 1)\n newline = buffer.indexOf('\\n')\n }\n return out\n },\n flush(): string[] {\n const out: string[] = []\n if (buffer.length > 0) take_line(buffer, out)\n buffer = ''\n on_flush?.(out)\n return out\n },\n }\n}\n\n/**\n * Decode a tool call's wire `arguments` string into the engine's input value:\n * non-empty JSON parses (bad JSON is a provider_error naming the tool), and\n * an absent or empty value means `{}`, the shape some servers send for\n * no-argument calls. The Ollama wire's structured-object arguments are its\n * caller's business before this runs.\n */\nexport function parse_tool_call_arguments(\n raw_args: unknown,\n provider: string,\n tool_name: string,\n): unknown {\n if (typeof raw_args === 'string' && raw_args.length > 0) {\n try {\n return JSON.parse(raw_args)\n } catch {\n throw new provider_error(\n `${provider} native: tool_calls arguments for ${tool_name} is not valid JSON`,\n )\n }\n }\n return {}\n}\n\n/**\n * Fold engine messages into a wire's message array by role. Serves the wires\n * whose messages map 1:1 in place (chat/completions, Ollama's /api/chat); the\n * Messages API's system-hoisting and role-merging rules live in its own\n * mapper instead.\n */\nexport function map_messages_by_role<m>(\n messages: ReadonlyArray<Message>,\n wire: {\n system: (content: string) => m\n user: (content: string | UserContentPart[]) => m\n assistant: (content: string | AssistantContentPart[]) => m\n tool: (message: Extract<Message, { role: 'tool' }>) => m\n },\n): m[] {\n const out: m[] = []\n for (const message of messages) {\n switch (message.role) {\n case 'system':\n out.push(wire.system(message.content))\n break\n case 'user':\n out.push(wire.user(message.content))\n break\n case 'assistant':\n out.push(wire.assistant(message.content))\n break\n case 'tool':\n out.push(wire.tool(message))\n break\n }\n }\n return out\n}\n\ntype ReasoningPart = Extract<AssistantContentPart, { type: 'reasoning' }>\n\n/**\n * Whether a reasoning part is one this provider may send back: only a part\n * carrying data under the provider's own key goes. A part keyed for another\n * vendor stays behind, so a `fallback` never hands one vendor's signature to\n * another, and so does a part with no data, whose text alone is what a\n * signing wire refuses.\n */\nexport function is_own_reasoning(part: ReasoningPart, key: string): boolean {\n return part.provider_options?.[key] !== undefined\n}\n\n/**\n * Partition assistant content parts into the text runs, tool calls, and\n * reasoning the wire mappers serialize separately. `reasoning` holds only\n * the parts `provider` may send back, in order (see is_own_reasoning). An\n * opaque part belongs to the provider that sent it, and these formats carry\n * no such block, so it is skipped.\n */\nexport function split_assistant_parts(\n parts: ReadonlyArray<AssistantContentPart>,\n provider: string,\n): {\n texts: string[]\n tool_parts: Array<Extract<AssistantContentPart, { type: 'tool_call' }>>\n reasoning: ReasoningPart[]\n} {\n const texts: string[] = []\n const tool_parts: Array<Extract<AssistantContentPart, { type: 'tool_call' }>> = []\n const reasoning: ReasoningPart[] = []\n for (const part of parts) {\n if (part.type === 'text') texts.push(part.text)\n else if (part.type === 'tool_call') tool_parts.push(part)\n else if (part.type === 'reasoning' && is_own_reasoning(part, provider)) reasoning.push(part)\n }\n return { texts, tool_parts, reasoning }\n}\n\n/**\n * Read the api_key and base_url every OpenAI-compatible dialect starts from:\n * a missing or non-string api_key becomes '' (the core's empty-key guard owns\n * the throw), and an absent base_url falls back to the dialect's default.\n */\nexport function read_dialect_init(\n init: ProviderInit,\n default_base_url: string,\n): { api_key: string; base_url: string } {\n return {\n api_key: typeof init.api_key === 'string' ? init.api_key : '',\n base_url:\n typeof init.base_url === 'string' && init.base_url.length > 0\n ? init.base_url\n : default_base_url,\n }\n}\n","/**\n * Collapse a leading run of system messages into a single joined string,\n * returning the remaining messages.\n *\n * Both message paths hoist a leading system run out of their list the same way:\n * the engine-Message side (generate.ts split_leading_system_messages) hands the\n * run to a native adapter's TurnRequest.system, and the AI SDK side\n * (providers/ai_sdk/invoke.ts split_leading_system) hands it to the SDK's\n * top-level `instructions` option. Same guard, same '\\n\\n' join, and the same\n * \"return the list untouched when hoisting would leave `messages` empty\" rule,\n * since provider APIs reject an empty messages array. They differ only in the\n * element type and how a system message's text is read, so each caller supplies\n * `system_text`; the traversal and its guards live here once.\n */\nexport function split_leading_system_run<T extends { readonly role: string }>(\n messages: ReadonlyArray<T>,\n system_text: (message: Extract<T, { role: 'system' }>) => string,\n): { system?: string; messages: T[] } {\n let run_end = 0\n const system_parts: string[] = []\n while (run_end < messages.length) {\n const m = messages[run_end]\n if (!is_leading_system(m)) break\n system_parts.push(system_text(m))\n run_end += 1\n }\n const rest = messages.slice(run_end)\n if (system_parts.length === 0 || rest.length === 0) {\n return { messages: [...messages] }\n }\n return { system: system_parts.join('\\n\\n'), messages: rest }\n}\n\n/**\n * Narrow a possibly undefined message to the system member of its union.\n *\n * A cast-free type guard so `split_leading_system_run` can hand the narrowed\n * message straight to `system_text` without a `T`-eroding assertion; the\n * optional chain covers the out-of-bounds `undefined` the index access yields.\n */\nfunction is_leading_system<T extends { readonly role: string }>(\n m: T | undefined,\n): m is Extract<T, { role: 'system' }> {\n // Stryker disable next-line OptionalChaining: within the loop guard run_end < messages.length, m is always an in-bounds (defined) message, so m.role and m?.role read identically.\n return m?.role === 'system'\n}\n"],"mappings":"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"}
package/dist/testing.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { C as validate_schema, S as format_schema_issues, j as aborted_error } from "./core-Bfzt55Fl.js";
2
- import { n as to_json_schema, t as create_engine } from "./engine-CbVdzplI.js";
3
- import { A as schema_validation_error } from "./leading_system-C23TJ9OQ.js";
2
+ import { n as to_json_schema, t as create_engine } from "./engine-BTijBDlY.js";
3
+ import { I as schema_validation_error } from "./leading_system-CHSYz0h9.js";
4
4
  //#region src/testing/assert_prefix_stable.ts
5
5
  const ONE_AT_A_TIME = "the check reads calls that ran one at a time, so a parallel flow takes one double per branch";
6
6
  /** A tool list as its names, in order, the way a message prints it. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fascicle",
3
- "version": "0.17.4",
3
+ "version": "0.17.5",
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",