fascicle 0.14.0 → 0.15.0

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.
@@ -220,6 +220,25 @@ function resolve_transport(init, provider) {
220
220
  throw new engine_config_error(`${provider} provider: transport must be 'ai_sdk' or 'native', got ${JSON.stringify(raw)}`, provider);
221
221
  }
222
222
  /**
223
+ * Hand effort to the AI SDK's `reasoning` option and build no provider
224
+ * options of its own, so the provider package maps each level per model from
225
+ * the capability table it keeps (adaptive thinking or a budget for Claude,
226
+ * `thinkingLevel` or a budget for Gemini, `reasoningEffort` for OpenAI).
227
+ * `none` sends neither, which is the SDK's provider default. The anthropic,
228
+ * bedrock, google, and openai ai_sdk adapters all translate this way.
229
+ */
230
+ function translate_effort_to_sdk_reasoning(effort) {
231
+ if (effort === "none") return {
232
+ provider_options: {},
233
+ effort_ignored: false
234
+ };
235
+ return {
236
+ provider_options: {},
237
+ effort_ignored: false,
238
+ reasoning: effort
239
+ };
240
+ }
241
+ /**
223
242
  * Map raw provider usage to UsageTotals, the mapper most adapters share.
224
243
  *
225
244
  * Missing usage zeroes the totals. Optional fields (reasoning and cache
@@ -283,6 +302,241 @@ async function load_optional_peer(specifier) {
283
302
  return mod;
284
303
  }
285
304
  //#endregion
305
+ //#region src/engine/providers/native_shared.ts
306
+ /**
307
+ * The message under a JSON error envelope's `error` key, or undefined when
308
+ * the shape carries none worth surfacing.
309
+ */
310
+ function error_field_message(parsed) {
311
+ if (parsed === null || typeof parsed !== "object") return void 0;
312
+ const error = Reflect.get(parsed, "error");
313
+ if (typeof error === "string" && error.length > 0) return error;
314
+ if (error === null || typeof error !== "object") return void 0;
315
+ const message = Reflect.get(error, "message");
316
+ return typeof message === "string" && message.length > 0 ? message : void 0;
317
+ }
318
+ /**
319
+ * Pull a human-readable message out of a non-2xx body. The native wires share
320
+ * one envelope family: Anthropic sends `{ type: 'error', error: { message } }`,
321
+ * OpenAI-style wires send `{ error: { message } }`, and Ollama sends
322
+ * `{ error: "message" }` (with the nested shape appearing behind proxies), so
323
+ * one parser accepts a string or a `{ message }` object under `error` and
324
+ * falls back to the raw body, truncated to 300 chars.
325
+ */
326
+ function extract_error_message(body) {
327
+ if (body.length === 0) return "(empty body)";
328
+ let message;
329
+ try {
330
+ message = error_field_message(JSON.parse(body));
331
+ } catch {}
332
+ if (message !== void 0) return message;
333
+ return body.length > 300 ? `${body.slice(0, 300)}...` : body;
334
+ }
335
+ /**
336
+ * Map a non-2xx response to what the engine's retry stack expects: 401
337
+ * becomes a typed provider_auth_error, 429/5xx keep `status` +
338
+ * `responseHeaders` so classify_provider_error marks them retryable
339
+ * (rate_limit honoring retry-after, provider_5xx), and any other 4xx is a
340
+ * permanent provider_error that surfaces as-is.
341
+ */
342
+ async function response_error(response, provider) {
343
+ let body = "";
344
+ try {
345
+ body = await response.text();
346
+ } catch {}
347
+ const detail = extract_error_message(body);
348
+ const status = response.status;
349
+ if (status === 401) return new provider_auth_error(provider, `${provider} authentication failed (401): ${detail}`);
350
+ if (status === 429 || status >= 500) {
351
+ const retry_after = response.headers.get("retry-after");
352
+ return Object.assign(/* @__PURE__ */ new Error(`${provider} API error ${status}: ${detail}`), { status }, retry_after !== null ? { responseHeaders: { "retry-after": retry_after } } : {});
353
+ }
354
+ return new provider_error(`${provider} API error ${status}: ${detail}`, {
355
+ status,
356
+ body
357
+ });
358
+ }
359
+ /**
360
+ * A user abort surfaces as the fetch/reader AbortError; retry_turn converts
361
+ * it via its own signal check, so it is rethrown untouched. Everything else
362
+ * is a transport failure wrapped in the `kind: 'network'` shape the shared
363
+ * classify_provider_error marks retryable.
364
+ */
365
+ function rethrow_network_failure(err, abort, provider) {
366
+ if (abort.aborted) throw err;
367
+ const detail = err instanceof Error ? err.message : String(err);
368
+ throw Object.assign(/* @__PURE__ */ new Error(`${provider} native: network failure: ${detail}`), { kind: "network" });
369
+ }
370
+ /**
371
+ * Run one native turn over HTTP: POST the dialect's body, map a non-2xx to
372
+ * the retry stack's shapes, and hand the response to the dialect's stream or
373
+ * JSON consumer. `build_body` is called inside the network try/catch on
374
+ * purpose, so a mapper that throws surfaces as a retryable network failure
375
+ * rather than escaping the turn unclassified.
376
+ */
377
+ async function invoke_http_turn(req, provider, request, consume) {
378
+ let response;
379
+ try {
380
+ response = await fetch(request.url, {
381
+ method: "POST",
382
+ headers: request.headers,
383
+ body: JSON.stringify(request.build_body()),
384
+ signal: req.abort
385
+ });
386
+ } catch (err) {
387
+ rethrow_network_failure(err, req.abort, provider);
388
+ }
389
+ if (!response.ok) throw await response_error(response, provider);
390
+ if (req.stream) return consume.stream(response);
391
+ const payload = await response.json();
392
+ return consume.parse(payload);
393
+ }
394
+ /**
395
+ * Drain a streaming response: decode bytes, reassemble framed payloads (SSE
396
+ * events or NDJSON lines), and feed them to the dialect's aggregator, which
397
+ * dispatches chunks through req.dispatch_chunk as they arrive. Transport
398
+ * failures mid-read wrap as network errors; aggregator throws (malformed
399
+ * frames, mid-stream error events, a rejecting on_chunk) pass through
400
+ * untouched, with the reader cancelled so the connection is released.
401
+ */
402
+ async function consume_framed_stream(response, req, provider, framing, create_aggregator) {
403
+ const body = response.body;
404
+ if (body === null) throw new provider_error(`${provider} native: streaming response has no body`);
405
+ const aggregator = create_aggregator(req.dispatch_chunk ?? (async () => {}));
406
+ const reader = body.getReader();
407
+ const text_decoder = new TextDecoder();
408
+ const next_bytes = async () => {
409
+ let step;
410
+ try {
411
+ step = await reader.read();
412
+ } catch (err) {
413
+ rethrow_network_failure(err, req.abort, provider);
414
+ }
415
+ return step.done ? void 0 : step.value;
416
+ };
417
+ try {
418
+ while (true) {
419
+ const bytes = await next_bytes();
420
+ if (bytes === void 0) break;
421
+ for (const data of framing.push(text_decoder.decode(bytes, { stream: true }))) await aggregator.handle(data);
422
+ }
423
+ } finally {
424
+ reader.cancel().catch(() => {});
425
+ }
426
+ const tail = [...framing.push(text_decoder.decode()), ...framing.flush()];
427
+ for (const data of tail) await aggregator.handle(data);
428
+ return aggregator.complete();
429
+ }
430
+ /**
431
+ * Incremental newline framing shared by the SSE and NDJSON decoders: buffer
432
+ * decoded text across arbitrary chunk boundaries, hand each completed line
433
+ * (CR trimmed) to `handle_line`, and on flush hand over an unterminated tail
434
+ * line, then `on_flush` for state a decoder holds across lines (an SSE event
435
+ * never closed by a blank line).
436
+ */
437
+ function create_line_splitter(handle_line, on_flush) {
438
+ let buffer = "";
439
+ const take_line = (raw, out) => {
440
+ handle_line(raw.endsWith("\r") ? raw.slice(0, -1) : raw, out);
441
+ };
442
+ return {
443
+ push(text) {
444
+ buffer += text;
445
+ const out = [];
446
+ let newline = buffer.indexOf("\n");
447
+ while (newline >= 0) {
448
+ take_line(buffer.slice(0, newline), out);
449
+ buffer = buffer.slice(newline + 1);
450
+ newline = buffer.indexOf("\n");
451
+ }
452
+ return out;
453
+ },
454
+ flush() {
455
+ const out = [];
456
+ if (buffer.length > 0) take_line(buffer, out);
457
+ buffer = "";
458
+ on_flush?.(out);
459
+ return out;
460
+ }
461
+ };
462
+ }
463
+ /**
464
+ * Decode a tool call's wire `arguments` string into the engine's input value:
465
+ * non-empty JSON parses (bad JSON is a provider_error naming the tool), and
466
+ * an absent or empty value means `{}`, the shape some servers send for
467
+ * no-argument calls. The Ollama wire's structured-object arguments are its
468
+ * caller's business before this runs.
469
+ */
470
+ function parse_tool_call_arguments(raw_args, provider, tool_name) {
471
+ if (typeof raw_args === "string" && raw_args.length > 0) try {
472
+ return JSON.parse(raw_args);
473
+ } catch {
474
+ throw new provider_error(`${provider} native: tool_calls arguments for ${tool_name} is not valid JSON`);
475
+ }
476
+ return {};
477
+ }
478
+ /**
479
+ * Fold engine messages into a wire's message array by role. Serves the wires
480
+ * whose messages map 1:1 in place (chat/completions, Ollama's /api/chat); the
481
+ * Messages API's system-hoisting and role-merging rules live in its own
482
+ * mapper instead.
483
+ */
484
+ function map_messages_by_role(messages, wire) {
485
+ const out = [];
486
+ for (const message of messages) switch (message.role) {
487
+ case "system":
488
+ out.push(wire.system(message.content));
489
+ break;
490
+ case "user":
491
+ out.push(wire.user(message.content));
492
+ break;
493
+ case "assistant":
494
+ out.push(wire.assistant(message.content));
495
+ break;
496
+ case "tool": out.push(wire.tool(message));
497
+ }
498
+ return out;
499
+ }
500
+ /**
501
+ * Whether a reasoning part is one this provider may send back: only a part
502
+ * carrying data under the provider's own key goes. A part keyed for another
503
+ * vendor stays behind, so a `fallback` never hands one vendor's signature to
504
+ * another, and so does a part with no data, whose text alone is what a
505
+ * signing wire refuses.
506
+ */
507
+ function is_own_reasoning(part, key) {
508
+ return part.provider_options?.[key] !== void 0;
509
+ }
510
+ /**
511
+ * Partition assistant content parts into the text runs, tool calls, and
512
+ * reasoning the wire mappers serialize separately. `reasoning` holds only
513
+ * the parts `provider` may send back, in order (see is_own_reasoning).
514
+ */
515
+ function split_assistant_parts(parts, provider) {
516
+ const texts = [];
517
+ const tool_parts = [];
518
+ const reasoning = [];
519
+ for (const part of parts) if (part.type === "text") texts.push(part.text);
520
+ else if (part.type === "tool_call") tool_parts.push(part);
521
+ else if (is_own_reasoning(part, provider)) reasoning.push(part);
522
+ return {
523
+ texts,
524
+ tool_parts,
525
+ reasoning
526
+ };
527
+ }
528
+ /**
529
+ * Read the api_key and base_url every OpenAI-compatible dialect starts from:
530
+ * a missing or non-string api_key becomes '' (the core's empty-key guard owns
531
+ * the throw), and an absent base_url falls back to the dialect's default.
532
+ */
533
+ function read_dialect_init(init, default_base_url) {
534
+ return {
535
+ api_key: typeof init.api_key === "string" ? init.api_key : "",
536
+ base_url: typeof init.base_url === "string" && init.base_url.length > 0 ? init.base_url : default_base_url
537
+ };
538
+ }
539
+ //#endregion
286
540
  //#region src/engine/leading_system.ts
287
541
  /**
288
542
  * Collapse a leading run of system messages into a single joined string,
@@ -325,6 +579,6 @@ function is_leading_system(m) {
325
579
  return m?.role === "system";
326
580
  }
327
581
  //#endregion
328
- export { turn_timeout_error as S, provider_required_error as _, normalize_local_usage as a, tool_approval_denied_error as b, engine_config_error as c, model_required_error as d, on_chunk_error as f, provider_not_configured_error as g, provider_error as h, missing_peer_error as i, engine_disposed_error as l, provider_capability_error as m, default_normalize_usage as n, resolve_transport as o, provider_auth_error as p, load_optional_peer as r, claude_cli_error as s, split_leading_system_run as t, incomplete_generation_error as u, rate_limit_error as v, tool_error as x, schema_validation_error as y };
582
+ export { tool_error as A, provider_capability_error as C, rate_limit_error as D, provider_required_error as E, schema_validation_error as O, provider_auth_error as S, provider_not_configured_error as T, engine_config_error as _, is_own_reasoning as a, model_required_error as b, read_dialect_init as c, load_optional_peer as d, missing_peer_error as f, claude_cli_error as g, translate_effort_to_sdk_reasoning as h, invoke_http_turn as i, turn_timeout_error as j, tool_approval_denied_error as k, split_assistant_parts as l, resolve_transport as m, consume_framed_stream as n, map_messages_by_role as o, normalize_local_usage as p, create_line_splitter as r, parse_tool_call_arguments as s, split_leading_system_run as t, default_normalize_usage as u, engine_disposed_error as v, provider_error as w, on_chunk_error as x, incomplete_generation_error as y };
329
583
 
330
- //# sourceMappingURL=leading_system-BQe_405V.js.map
584
+ //# sourceMappingURL=leading_system-DfJLqpGi.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"leading_system-DfJLqpGi.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 constructor(\n message: string,\n metadata: { retry_after_ms?: number; attempts?: number; status?: number } = {},\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 }\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 constructor(\n message: string,\n metadata: {\n status?: number\n body?: string\n cause_kind?: 'provider_5xx' | 'network' | '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 }\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 streamed.\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. A mid-stream\n * expiry never reaches here; retry_turn converts it to a non-retryable\n * 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 | 'auth_missing'\n | 'auth_expired'\n | 'api_key_missing'\n | 'startup_timeout'\n | 'stall_timeout'\n | 'no_result_event'\n | 'result_error'\n | 'subprocess_exit'\n | 'sandbox_unavailable'\n | 'engine_disposed'\n | 'parse_error'\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 constructor(\n provider: string,\n message: string,\n metadata: { refresh_command?: string } = {},\n ) {\n super(message)\n this.name = 'provider_auth_error'\n this.provider = provider\n this.refresh_command = metadata.refresh_command\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. Missing peer dependencies surface as engine_config_error\n * on first build_model call with a clear message naming the missing peer.\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 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\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 // Vercel AI SDK v6 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 (D26). 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 readonly normalize_usage: (raw: RawProviderUsage | undefined) => UsageTotals\n readonly supports: (capability: ProviderCapability) => boolean\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 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.reasoning_tokens\n return base\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 * The message under a JSON error envelope's `error` key, or undefined when\n * the shape carries none worth surfacing.\n */\nfunction error_field_message(parsed: unknown): string | undefined {\n // Stryker disable next-line ConditionalExpression,LogicalOperator: the\n // caller's try/catch already funnels every non-object parse to the raw\n // snippet, so this guard only narrows unknown -> object for Reflect.get;\n // forcing it either way throws-and-catches to the same fallback (equivalent).\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 // Stryker disable next-line ConditionalExpression,LogicalOperator: same as\n // above -- a non-object error still reaches the raw-snippet fallback via the\n // catch or the message-not-a-string check, so both boundaries are equivalent.\n if (error === null || typeof error !== 'object') return undefined\n const message: unknown = Reflect.get(error, 'message')\n return typeof message === 'string' && message.length > 0 ? message : undefined\n}\n\n/**\n * Pull a human-readable message out of a non-2xx body. The native wires share\n * one envelope family: Anthropic sends `{ type: 'error', error: { message } }`,\n * OpenAI-style wires send `{ error: { message } }`, and Ollama sends\n * `{ error: \"message\" }` (with the nested shape appearing behind proxies), so\n * one parser accepts a string or a `{ message }` object under `error` and\n * falls back to the raw body, truncated to 300 chars.\n */\nfunction extract_error_message(body: string): string {\n if (body.length === 0) return '(empty body)'\n let message: string | undefined\n try {\n message = error_field_message(JSON.parse(body))\n } catch {\n // Not JSON; fall through to the raw snippet.\n }\n if (message !== undefined) return message\n return body.length > 300 ? `${body.slice(0, 300)}...` : body\n}\n\n/**\n * Map a non-2xx response to what the engine's retry stack expects: 401\n * becomes a typed provider_auth_error, 429/5xx keep `status` +\n * `responseHeaders` so classify_provider_error marks them retryable\n * (rate_limit honoring retry-after, provider_5xx), and any other 4xx is a\n * permanent provider_error that surfaces 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 === 401) {\n return new provider_auth_error(\n provider,\n `${provider} authentication failed (401): ${detail}`,\n )\n }\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 },\n retry_after !== null ? { responseHeaders: { 'retry-after': retry_after } } : {},\n )\n }\n return new provider_error(`${provider} API error ${status}: ${detail}`, { status, body })\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 in the `kind: 'network'` shape the shared\n * classify_provider_error marks retryable.\n */\nfunction rethrow_network_failure(err: unknown, abort: AbortSignal, provider: string): never {\n if (abort.aborted) throw err\n const detail = err instanceof Error ? err.message : String(err)\n throw Object.assign(new Error(`${provider} native: network failure: ${detail}`), {\n kind: 'network',\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. `build_body` is called inside the network try/catch on\n * purpose, so a mapper that throws surfaces as a retryable network failure\n * rather than escaping the turn unclassified.\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 },\n): Promise<TurnResult> {\n let response: Response\n try {\n response = await fetch(request.url, {\n method: 'POST',\n headers: request.headers,\n body: JSON.stringify(request.build_body()),\n signal: req.abort,\n })\n } catch (err: unknown) {\n rethrow_network_failure(err, req.abort, provider)\n }\n if (!response.ok) throw await response_error(response, provider)\n if (req.stream) return consume.stream(response)\n const payload: unknown = await response.json()\n return consume.parse(payload)\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, provider)\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).\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 (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/mcp.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { c as Step, h as TrajectoryLogger } from "./types-CPqLZOEr.js";
2
2
  import { r as ToolSchema } from "./types-BK0UW28o.js";
3
- import { E as Tool } from "./types-C_Rmcgck.js";
3
+ import { D as Tool } from "./types-De-TVQxS.js";
4
4
  import { Client } from "@modelcontextprotocol/sdk/client/index.js";
5
5
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
6
6
  import { z } from "zod";
@@ -63,7 +63,7 @@ type McpClientHandle = {
63
63
  export declare function mcp_client(config: McpClientConfig, options?: McpClientOptions): Promise<McpClientHandle>;
64
64
  //#endregion
65
65
  //#region src/mcp/serve.d.ts
66
- type ServeFlowOptions<i, o> = {
66
+ type ServeFlowConfig<i, o> = {
67
67
  server: McpServer;
68
68
  flow: Step<i, o>;
69
69
  name: string;
@@ -90,7 +90,7 @@ type ServeFlowOptions<i, o> = {
90
90
  * into a `CallToolResult`. A thrown flow becomes an `isError` result rather
91
91
  * than a JSON-RPC protocol error.
92
92
  */
93
- export declare function serve_flow<i, o>(options: ServeFlowOptions<i, o>): void;
93
+ export declare function serve_flow<i, o>(config: ServeFlowConfig<i, o>): void;
94
94
  //#endregion
95
95
  //#region src/mcp/errors.d.ts
96
96
  /**
@@ -112,5 +112,5 @@ export declare class mcp_error extends Error {
112
112
  });
113
113
  }
114
114
  //#endregion
115
- export type { McpClientConfig, McpClientHandle, McpClientOptions, McpExistingClientConfig, McpStdioConfig, McpStreamableHttpConfig, ServeFlowOptions };
115
+ export type { McpClientConfig, McpClientHandle, McpClientOptions, McpExistingClientConfig, McpStdioConfig, McpStreamableHttpConfig, ServeFlowConfig };
116
116
  //# sourceMappingURL=mcp.d.ts.map
package/dist/mcp.js CHANGED
@@ -1,5 +1,6 @@
1
1
  import { E as run } from "./core-CDrz0NM1.js";
2
- import { n as as_record, r as is_record, t as json_schema_to_standard } from "./json_schema_to_standard-r21kW2LI.js";
2
+ import { n as is_record, t as as_record } from "./records-1HU7mWXf.js";
3
+ import { t as json_schema_to_standard } from "./json_schema_to_standard-BTWD0J6p.js";
3
4
  //#region src/mcp/errors.ts
4
5
  /**
5
6
  * Typed errors for the MCP adapter.
@@ -230,8 +231,8 @@ function to_fascicle_tool(client, advertised, options) {
230
231
  * into a `CallToolResult`. A thrown flow becomes an `isError` result rather
231
232
  * than a JSON-RPC protocol error.
232
233
  */
233
- function serve_flow(options) {
234
- const { server, flow, name, description, input_schema, trajectory, to_result } = options;
234
+ function serve_flow(config) {
235
+ const { server, flow, name, description, input_schema, trajectory, to_result } = config;
235
236
  server.registerTool(name, {
236
237
  description,
237
238
  inputSchema: input_schema
package/dist/mcp.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.js","names":[],"sources":["../src/mcp/errors.ts","../src/mcp/result_mapping.ts","../src/mcp/sdk_loader.ts","../src/mcp/client.ts","../src/mcp/serve.ts"],"sourcesContent":["/**\n * Typed errors for the MCP adapter.\n *\n * Listed alongside src/core/errors.ts and src/engine/errors.ts in the\n * `no-class` rule ignores: `instanceof` branching is how callers distinguish a\n * missing optional peer from a tool-level failure surfaced over the wire.\n */\n\nexport class mcp_sdk_missing_error extends Error {\n readonly kind = 'mcp_sdk_missing_error' as const;\n constructor(\n message = '@modelcontextprotocol/sdk is required for fascicle/mcp; install it: pnpm add @modelcontextprotocol/sdk',\n ) {\n super(message)\n this.name = 'mcp_sdk_missing_error'\n }\n}\n\nexport class mcp_error extends Error {\n readonly kind = 'mcp_error' as const;\n readonly tool_name: string | undefined;\n constructor(message: string, metadata: { tool_name?: string } = {}) {\n super(message)\n this.name = 'mcp_error'\n this.tool_name = metadata.tool_name\n }\n}\n","/**\n * Mapping between MCP `CallToolResult` payloads and Fascicle tool values, in\n * both directions: inbound results from `mcp_client` tools, outbound results\n * for `serve_flow`.\n */\n\nimport { as_record, is_record } from '#schema'\nimport { mcp_error } from './errors.js'\n\nexport type McpToolResult = {\n content: Array<{ type: 'text'; text: string }>\n structuredContent?: Record<string, unknown>\n}\n\n/**\n * Converts a remote tool's `CallToolResult` into the value a Fascicle\n * `Tool.execute` returns.\n *\n * `isError: true` marks a tool-level failure, so it throws `mcp_error` rather\n * than returning, letting the tool loop's error policy feed it back to the\n * model. `structuredContent` is preferred over joined text parts when present;\n * with neither, the raw `content` (or `null`) is returned.\n */\nexport function call_result_to_output(result: unknown, tool_name?: string): unknown {\n const record = as_record(result) ?? {}\n\n if (record['isError'] === true) {\n const detail = join_text(record['content']) ?? 'MCP tool returned an error'\n throw new mcp_error(detail, tool_name !== undefined ? { tool_name } : {})\n }\n\n if (is_record(record['structuredContent'])) return record['structuredContent']\n\n const text = join_text(record['content'])\n if (text !== undefined) return text\n\n return record['content'] ?? null\n}\n\n/**\n * Converts a Fascicle flow's output into a `CallToolResult` for `serve_flow`.\n *\n * A `to_result` override takes precedence over the default mapping. By\n * default, objects are emitted as both a JSON text part (every MCP host can\n * read text) and `structuredContent` (typed hosts get the object); everything\n * else becomes a single text part.\n */\nexport function output_to_call_result<o>(\n output: o,\n to_result?: (output: o) => { text: string; structured?: Record<string, unknown> },\n): McpToolResult {\n if (to_result !== undefined) {\n const shaped = to_result(output)\n return build_result(shaped.text, shaped.structured)\n }\n if (typeof output === 'string') return build_result(output)\n if (is_record(output)) return build_result(stringify(output), output)\n if (Array.isArray(output)) return build_result(stringify(output))\n return build_result(String(output))\n}\n\n/**\n * Assembles a `CallToolResult` with one text part and, when given, structured\n * content.\n */\nfunction build_result(text: string, structured?: Record<string, unknown>): McpToolResult {\n return structured !== undefined\n ? { content: [{ type: 'text', text }], structuredContent: structured }\n : { content: [{ type: 'text', text }] }\n}\n\n/**\n * Joins the `text` parts of an MCP content array with newlines, skipping\n * non-text parts; `undefined` when there is nothing to join.\n */\nfunction join_text(content: unknown): string | undefined {\n if (!Array.isArray(content)) return undefined\n const parts: string[] = []\n for (const part of content) {\n if (is_record(part) && part['type'] === 'text' && typeof part['text'] === 'string') {\n parts.push(part['text'])\n }\n }\n return parts.length > 0 ? parts.join('\\n') : undefined\n}\n\n/**\n * `JSON.stringify` that falls back to `String` instead of throwing on\n * unserializable values (circular references, BigInt).\n */\nfunction stringify(value: unknown): string {\n try {\n return JSON.stringify(value)\n } catch {\n return String(value)\n }\n}\n","/**\n * Lazy loader for the optional `@modelcontextprotocol/sdk` peer.\n *\n * `mcp_client` needs SDK values (the Client and transport constructors), so it\n * imports them dynamically rather than statically: a consumer can import\n * `fascicle/mcp` without the SDK installed and only pays the cost when they\n * actually connect. A missing peer surfaces as a typed `mcp_sdk_missing_error`\n * with install guidance, mirroring the engine's `load_optional_peer`.\n *\n * `serve_flow` is not covered here: it operates on a caller-constructed\n * `McpServer`, so it needs only a type-only import and no runtime SDK load.\n */\n\nimport { mcp_sdk_missing_error } from './errors.js'\n\nexport type McpClientSdk = Awaited<ReturnType<typeof load_client_sdk>>\n\n/**\n * Dynamically imports the `@modelcontextprotocol/sdk` client modules,\n * throwing a typed `mcp_sdk_missing_error` when the optional peer is not\n * installed.\n */\nexport async function load_client_sdk() {\n try {\n const [client_mod, stdio_mod, http_mod] = await Promise.all([\n import('@modelcontextprotocol/sdk/client/index.js'),\n import('@modelcontextprotocol/sdk/client/stdio.js'),\n import('@modelcontextprotocol/sdk/client/streamableHttp.js'),\n ])\n return {\n Client: client_mod.Client,\n StdioClientTransport: stdio_mod.StdioClientTransport,\n StreamableHTTPClientTransport: http_mod.StreamableHTTPClientTransport,\n }\n } catch (err: unknown) {\n const detail = err instanceof Error ? err.message : String(err)\n throw new mcp_sdk_missing_error(\n `@modelcontextprotocol/sdk is required for fascicle/mcp; install it: pnpm add @modelcontextprotocol/sdk (cause: ${detail})`,\n )\n }\n}\n","/**\n * Inbound MCP: connect to an external MCP server and surface its tools as plain\n * Fascicle `Tool[]`.\n */\n\nimport type { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js'\nimport type { Tool, ToolExecContext } from '#engine'\nimport { is_record, json_schema_to_standard } from '#schema'\nimport { mcp_error } from './errors.js'\nimport { call_result_to_output } from './result_mapping.js'\nimport { load_client_sdk, type McpClientSdk } from './sdk_loader.js'\n\nconst DEFAULT_CLIENT_INFO = { name: 'fascicle', version: '0.0.0' }\n\nexport type McpStdioConfig = {\n transport: 'stdio'\n command: string\n args?: string[]\n env?: Record<string, string>\n cwd?: string\n}\n\nexport type McpStreamableHttpConfig = {\n transport: 'http'\n url: string\n headers?: Record<string, string>\n}\n\n// Escape hatch: hand in an already-connected Client (a transport the adapter\n// does not build, a test harness, a shared connection). Its lifecycle stays\n// with the caller, so the returned `close` is a no-op for this variant.\nexport type McpExistingClientConfig = {\n transport: 'client'\n client: Client\n}\n\nexport type McpClientConfig =\n | McpStdioConfig\n | McpStreamableHttpConfig\n | McpExistingClientConfig\n\nexport type McpClientOptions = {\n // Identity sent in the MCP handshake; defaults to Fascicle.\n client_info?: { name: string; version: string }\n // When set, only tools whose name is listed are surfaced.\n include?: ReadonlyArray<string>\n // Supplies a description for tools that advertise none.\n default_description?: (tool_name: string) => string\n}\n\nexport type McpClientHandle = {\n readonly tools: ReadonlyArray<Tool>\n readonly close: () => Promise<void>\n}\n\n/**\n * Connects to an MCP server and surfaces its advertised tools as Fascicle\n * `Tool[]`, plus a `close` handle for the connection.\n *\n * Owns the connection lifecycle (config in, `{ tools, close }` out) so callers\n * do not have to import SDK transport classes themselves. Each advertised MCP\n * tool becomes an ordinary `Tool`: its JSON Schema is wrapped as a `ToolSchema`\n * the loop validates against and the provider receives back unchanged, and\n * `execute` forwards to `callTool`, propagating the run's abort signal. For the\n * `client` transport variant the caller keeps ownership of the connection, so\n * `close` is a no-op.\n */\nexport async function mcp_client(\n config: McpClientConfig,\n options: McpClientOptions = {},\n): Promise<McpClientHandle> {\n const owns_client = config.transport !== 'client'\n const client = await connect_client(config, options)\n\n const include = options.include !== undefined ? new Set(options.include) : undefined\n const listed = await client.listTools()\n const tools: Tool[] = []\n for (const advertised of listed.tools) {\n if (include !== undefined && !include.has(advertised.name)) continue\n tools.push(to_fascicle_tool(client, advertised, options))\n }\n\n return {\n tools,\n close: async () => {\n if (owns_client) await client.close()\n },\n }\n}\n\n/**\n * Returns the caller's already-connected client as-is, or lazily loads the\n * SDK and connects a fresh client over the configured transport.\n */\nasync function connect_client(\n config: McpClientConfig,\n options: McpClientOptions,\n): Promise<Client> {\n if (config.transport === 'client') return config.client\n const sdk = await load_client_sdk()\n const client = new sdk.Client(options.client_info ?? DEFAULT_CLIENT_INFO)\n await client.connect(build_transport(sdk, config))\n return client\n}\n\n/**\n * Constructs the SDK transport matching the config: a spawned child process\n * for `stdio`, a Streamable HTTP connection for `http`.\n */\nfunction build_transport(\n sdk: McpClientSdk,\n config: McpStdioConfig | McpStreamableHttpConfig,\n): Transport {\n if (config.transport === 'stdio') {\n return new sdk.StdioClientTransport({\n command: config.command,\n ...(config.args !== undefined ? { args: config.args } : {}),\n ...(config.env !== undefined ? { env: config.env } : {}),\n ...(config.cwd !== undefined ? { cwd: config.cwd } : {}),\n })\n }\n const opts = config.headers !== undefined ? { requestInit: { headers: config.headers } } : {}\n // The SDK declares this class `implements Transport`, but its `onmessage`\n // overload is narrower than the interface's, which only strict mode flags.\n // eslint-disable-next-line typescript-eslint/no-unsafe-type-assertion\n return new sdk.StreamableHTTPClientTransport(new URL(config.url), opts) as Transport\n}\n\n/**\n * Wraps one advertised MCP tool as a Fascicle `Tool` whose `execute` forwards\n * to `callTool` on the shared client.\n *\n * An already-aborted signal short-circuits before the wire call; otherwise the\n * signal is passed through so cancelling the run cancels the remote call.\n */\nfunction to_fascicle_tool(\n client: Client,\n advertised: { name: string; description?: string | undefined; inputSchema: unknown },\n options: McpClientOptions,\n): Tool {\n const name = advertised.name\n const description =\n advertised.description ?? options.default_description?.(name) ?? `MCP tool ${name}`\n return {\n name,\n description,\n input_schema: json_schema_to_standard(advertised.inputSchema),\n execute: async (input: unknown, ctx: ToolExecContext) => {\n if (ctx.abort.aborted) {\n throw ctx.abort.reason instanceof Error\n ? ctx.abort.reason\n : new mcp_error(`MCP tool ${name} aborted before invocation`, { tool_name: name })\n }\n const result = await client.callTool(\n { name, arguments: is_record(input) ? input : undefined },\n undefined,\n { signal: ctx.abort },\n )\n return call_result_to_output(result, name)\n },\n }\n}\n","/**\n * Outbound MCP: expose a composed Fascicle flow as an MCP tool.\n *\n * `serve_flow` registers onto a caller-constructed `McpServer` (the caller owns\n * the transport, identity, and lifecycle, and can host many flows on one\n * server), so it needs only a type-only SDK import. The registered handler\n * drives the existing `run`, threading the per-request abort signal so an MCP\n * client cancellation aborts the in-flight flow, and maps the result into a\n * `CallToolResult`. A thrown flow becomes an `isError` result rather than a\n * JSON-RPC protocol error.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { z } from 'zod'\nimport { run } from '#core'\nimport type { Step, TrajectoryLogger } from '#core'\nimport { output_to_call_result } from './result_mapping.js'\n\nexport type ServeFlowOptions<i, o> = {\n server: McpServer\n flow: Step<i, o>\n name: string\n description: string\n /**\n * Stays zod rather than joining the rest of the surface on `ToolSchema`.\n * `McpServer.registerTool` types `inputSchema` as a zod schema and offers no\n * JSON Schema entry point, and the SDK carries zod as a hard runtime\n * dependency, so a `serve_flow` caller already has zod resolved. Widening\n * this to a neutral schema would typecheck and then fail inside the SDK.\n */\n input_schema: z.ZodType<i>\n trajectory?: TrajectoryLogger\n // Overrides the default value-to-CallToolResult mapping.\n to_result?: (output: o) => { text: string; structured?: Record<string, unknown> }\n}\n\n/**\n * Registers a Fascicle flow as a tool on a caller-owned MCP server.\n *\n * Drives the flow with `run`, threading the per-request abort signal so an\n * MCP client cancellation aborts the in-flight flow, and maps the result\n * into a `CallToolResult`. A thrown flow becomes an `isError` result rather\n * than a JSON-RPC protocol error.\n */\nexport function serve_flow<i, o>(options: ServeFlowOptions<i, o>): void {\n const { server, flow, name, description, input_schema, trajectory, to_result } = options\n server.registerTool(\n name,\n { description, inputSchema: input_schema },\n async (input: i, extra) => {\n try {\n const output = await run(flow, input, {\n install_signal_handlers: false,\n abort: extra.signal,\n ...(trajectory !== undefined ? { trajectory } : {}),\n })\n return output_to_call_result(output, to_result)\n } catch (err: unknown) {\n return {\n isError: true,\n content: [{ type: 'text', text: err instanceof Error ? err.message : String(err) }],\n }\n }\n },\n )\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"mcp.js","names":[],"sources":["../src/mcp/errors.ts","../src/mcp/result_mapping.ts","../src/mcp/sdk_loader.ts","../src/mcp/client.ts","../src/mcp/serve.ts"],"sourcesContent":["/**\n * Typed errors for the MCP adapter.\n *\n * Listed alongside src/core/errors.ts and src/engine/errors.ts in the\n * `no-class` rule ignores: `instanceof` branching is how callers distinguish a\n * missing optional peer from a tool-level failure surfaced over the wire.\n */\n\nexport class mcp_sdk_missing_error extends Error {\n readonly kind = 'mcp_sdk_missing_error' as const;\n constructor(\n message = '@modelcontextprotocol/sdk is required for fascicle/mcp; install it: pnpm add @modelcontextprotocol/sdk',\n ) {\n super(message)\n this.name = 'mcp_sdk_missing_error'\n }\n}\n\nexport class mcp_error extends Error {\n readonly kind = 'mcp_error' as const;\n readonly tool_name: string | undefined;\n constructor(message: string, metadata: { tool_name?: string } = {}) {\n super(message)\n this.name = 'mcp_error'\n this.tool_name = metadata.tool_name\n }\n}\n","/**\n * Mapping between MCP `CallToolResult` payloads and Fascicle tool values, in\n * both directions: inbound results from `mcp_client` tools, outbound results\n * for `serve_flow`.\n */\n\nimport { as_record, is_record } from '#schema'\nimport { mcp_error } from './errors.js'\n\nexport type McpToolResult = {\n content: Array<{ type: 'text'; text: string }>\n structuredContent?: Record<string, unknown>\n}\n\n/**\n * Converts a remote tool's `CallToolResult` into the value a Fascicle\n * `Tool.execute` returns.\n *\n * `isError: true` marks a tool-level failure, so it throws `mcp_error` rather\n * than returning, letting the tool loop's error policy feed it back to the\n * model. `structuredContent` is preferred over joined text parts when present;\n * with neither, the raw `content` (or `null`) is returned.\n */\nexport function call_result_to_output(result: unknown, tool_name?: string): unknown {\n const record = as_record(result) ?? {}\n\n if (record['isError'] === true) {\n const detail = join_text(record['content']) ?? 'MCP tool returned an error'\n throw new mcp_error(detail, tool_name !== undefined ? { tool_name } : {})\n }\n\n if (is_record(record['structuredContent'])) return record['structuredContent']\n\n const text = join_text(record['content'])\n if (text !== undefined) return text\n\n return record['content'] ?? null\n}\n\n/**\n * Converts a Fascicle flow's output into a `CallToolResult` for `serve_flow`.\n *\n * A `to_result` override takes precedence over the default mapping. By\n * default, objects are emitted as both a JSON text part (every MCP host can\n * read text) and `structuredContent` (typed hosts get the object); everything\n * else becomes a single text part.\n */\nexport function output_to_call_result<o>(\n output: o,\n to_result?: (output: o) => { text: string; structured?: Record<string, unknown> },\n): McpToolResult {\n if (to_result !== undefined) {\n const shaped = to_result(output)\n return build_result(shaped.text, shaped.structured)\n }\n if (typeof output === 'string') return build_result(output)\n if (is_record(output)) return build_result(stringify(output), output)\n if (Array.isArray(output)) return build_result(stringify(output))\n return build_result(String(output))\n}\n\n/**\n * Assembles a `CallToolResult` with one text part and, when given, structured\n * content.\n */\nfunction build_result(text: string, structured?: Record<string, unknown>): McpToolResult {\n return structured !== undefined\n ? { content: [{ type: 'text', text }], structuredContent: structured }\n : { content: [{ type: 'text', text }] }\n}\n\n/**\n * Joins the `text` parts of an MCP content array with newlines, skipping\n * non-text parts; `undefined` when there is nothing to join.\n */\nfunction join_text(content: unknown): string | undefined {\n if (!Array.isArray(content)) return undefined\n const parts: string[] = []\n for (const part of content) {\n if (is_record(part) && part['type'] === 'text' && typeof part['text'] === 'string') {\n parts.push(part['text'])\n }\n }\n return parts.length > 0 ? parts.join('\\n') : undefined\n}\n\n/**\n * `JSON.stringify` that falls back to `String` instead of throwing on\n * unserializable values (circular references, BigInt).\n */\nfunction stringify(value: unknown): string {\n try {\n return JSON.stringify(value)\n } catch {\n return String(value)\n }\n}\n","/**\n * Lazy loader for the optional `@modelcontextprotocol/sdk` peer.\n *\n * `mcp_client` needs SDK values (the Client and transport constructors), so it\n * imports them dynamically rather than statically: a consumer can import\n * `fascicle/mcp` without the SDK installed and only pays the cost when they\n * actually connect. A missing peer surfaces as a typed `mcp_sdk_missing_error`\n * with install guidance, mirroring the engine's `load_optional_peer`.\n *\n * `serve_flow` is not covered here: it operates on a caller-constructed\n * `McpServer`, so it needs only a type-only import and no runtime SDK load.\n */\n\nimport { mcp_sdk_missing_error } from './errors.js'\n\nexport type McpClientSdk = Awaited<ReturnType<typeof load_client_sdk>>\n\n/**\n * Dynamically imports the `@modelcontextprotocol/sdk` client modules,\n * throwing a typed `mcp_sdk_missing_error` when the optional peer is not\n * installed.\n */\nexport async function load_client_sdk() {\n try {\n const [client_mod, stdio_mod, http_mod] = await Promise.all([\n import('@modelcontextprotocol/sdk/client/index.js'),\n import('@modelcontextprotocol/sdk/client/stdio.js'),\n import('@modelcontextprotocol/sdk/client/streamableHttp.js'),\n ])\n return {\n Client: client_mod.Client,\n StdioClientTransport: stdio_mod.StdioClientTransport,\n StreamableHTTPClientTransport: http_mod.StreamableHTTPClientTransport,\n }\n } catch (err: unknown) {\n const detail = err instanceof Error ? err.message : String(err)\n throw new mcp_sdk_missing_error(\n `@modelcontextprotocol/sdk is required for fascicle/mcp; install it: pnpm add @modelcontextprotocol/sdk (cause: ${detail})`,\n )\n }\n}\n","/**\n * Inbound MCP: connect to an external MCP server and surface its tools as plain\n * Fascicle `Tool[]`.\n */\n\nimport type { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js'\nimport type { Tool, ToolExecContext } from '#engine'\nimport { is_record, json_schema_to_standard } from '#schema'\nimport { mcp_error } from './errors.js'\nimport { call_result_to_output } from './result_mapping.js'\nimport { load_client_sdk, type McpClientSdk } from './sdk_loader.js'\n\nconst DEFAULT_CLIENT_INFO = { name: 'fascicle', version: '0.0.0' }\n\nexport type McpStdioConfig = {\n transport: 'stdio'\n command: string\n args?: string[]\n env?: Record<string, string>\n cwd?: string\n}\n\nexport type McpStreamableHttpConfig = {\n transport: 'http'\n url: string\n headers?: Record<string, string>\n}\n\n// Escape hatch: hand in an already-connected Client (a transport the adapter\n// does not build, a test harness, a shared connection). Its lifecycle stays\n// with the caller, so the returned `close` is a no-op for this variant.\nexport type McpExistingClientConfig = {\n transport: 'client'\n client: Client\n}\n\nexport type McpClientConfig =\n | McpStdioConfig\n | McpStreamableHttpConfig\n | McpExistingClientConfig\n\nexport type McpClientOptions = {\n // Identity sent in the MCP handshake; defaults to Fascicle.\n client_info?: { name: string; version: string }\n // When set, only tools whose name is listed are surfaced.\n include?: ReadonlyArray<string>\n // Supplies a description for tools that advertise none.\n default_description?: (tool_name: string) => string\n}\n\nexport type McpClientHandle = {\n readonly tools: ReadonlyArray<Tool>\n readonly close: () => Promise<void>\n}\n\n/**\n * Connects to an MCP server and surfaces its advertised tools as Fascicle\n * `Tool[]`, plus a `close` handle for the connection.\n *\n * Owns the connection lifecycle (config in, `{ tools, close }` out) so callers\n * do not have to import SDK transport classes themselves. Each advertised MCP\n * tool becomes an ordinary `Tool`: its JSON Schema is wrapped as a `ToolSchema`\n * the loop validates against and the provider receives back unchanged, and\n * `execute` forwards to `callTool`, propagating the run's abort signal. For the\n * `client` transport variant the caller keeps ownership of the connection, so\n * `close` is a no-op.\n */\nexport async function mcp_client(\n config: McpClientConfig,\n options: McpClientOptions = {},\n): Promise<McpClientHandle> {\n const owns_client = config.transport !== 'client'\n const client = await connect_client(config, options)\n\n const include = options.include !== undefined ? new Set(options.include) : undefined\n const listed = await client.listTools()\n const tools: Tool[] = []\n for (const advertised of listed.tools) {\n if (include !== undefined && !include.has(advertised.name)) continue\n tools.push(to_fascicle_tool(client, advertised, options))\n }\n\n return {\n tools,\n close: async () => {\n if (owns_client) await client.close()\n },\n }\n}\n\n/**\n * Returns the caller's already-connected client as-is, or lazily loads the\n * SDK and connects a fresh client over the configured transport.\n */\nasync function connect_client(\n config: McpClientConfig,\n options: McpClientOptions,\n): Promise<Client> {\n if (config.transport === 'client') return config.client\n const sdk = await load_client_sdk()\n const client = new sdk.Client(options.client_info ?? DEFAULT_CLIENT_INFO)\n await client.connect(build_transport(sdk, config))\n return client\n}\n\n/**\n * Constructs the SDK transport matching the config: a spawned child process\n * for `stdio`, a Streamable HTTP connection for `http`.\n */\nfunction build_transport(\n sdk: McpClientSdk,\n config: McpStdioConfig | McpStreamableHttpConfig,\n): Transport {\n if (config.transport === 'stdio') {\n return new sdk.StdioClientTransport({\n command: config.command,\n ...(config.args !== undefined ? { args: config.args } : {}),\n ...(config.env !== undefined ? { env: config.env } : {}),\n ...(config.cwd !== undefined ? { cwd: config.cwd } : {}),\n })\n }\n const opts = config.headers !== undefined ? { requestInit: { headers: config.headers } } : {}\n // The SDK declares this class `implements Transport`, but its `onmessage`\n // overload is narrower than the interface's, which only strict mode flags.\n // eslint-disable-next-line typescript-eslint/no-unsafe-type-assertion\n return new sdk.StreamableHTTPClientTransport(new URL(config.url), opts) as Transport\n}\n\n/**\n * Wraps one advertised MCP tool as a Fascicle `Tool` whose `execute` forwards\n * to `callTool` on the shared client.\n *\n * An already-aborted signal short-circuits before the wire call; otherwise the\n * signal is passed through so cancelling the run cancels the remote call.\n */\nfunction to_fascicle_tool(\n client: Client,\n advertised: { name: string; description?: string | undefined; inputSchema: unknown },\n options: McpClientOptions,\n): Tool {\n const name = advertised.name\n const description =\n advertised.description ?? options.default_description?.(name) ?? `MCP tool ${name}`\n return {\n name,\n description,\n input_schema: json_schema_to_standard(advertised.inputSchema),\n execute: async (input: unknown, ctx: ToolExecContext) => {\n if (ctx.abort.aborted) {\n throw ctx.abort.reason instanceof Error\n ? ctx.abort.reason\n : new mcp_error(`MCP tool ${name} aborted before invocation`, { tool_name: name })\n }\n const result = await client.callTool(\n { name, arguments: is_record(input) ? input : undefined },\n undefined,\n { signal: ctx.abort },\n )\n return call_result_to_output(result, name)\n },\n }\n}\n","/**\n * Outbound MCP: expose a composed Fascicle flow as an MCP tool.\n *\n * `serve_flow` registers onto a caller-constructed `McpServer` (the caller owns\n * the transport, identity, and lifecycle, and can host many flows on one\n * server), so it needs only a type-only SDK import. The registered handler\n * drives the existing `run`, threading the per-request abort signal so an MCP\n * client cancellation aborts the in-flight flow, and maps the result into a\n * `CallToolResult`. A thrown flow becomes an `isError` result rather than a\n * JSON-RPC protocol error.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { z } from 'zod'\nimport { run } from '#core'\nimport type { Step, TrajectoryLogger } from '#core'\nimport { output_to_call_result } from './result_mapping.js'\n\nexport type ServeFlowConfig<i, o> = {\n server: McpServer\n flow: Step<i, o>\n name: string\n description: string\n /**\n * Stays zod rather than joining the rest of the surface on `ToolSchema`.\n * `McpServer.registerTool` types `inputSchema` as a zod schema and offers no\n * JSON Schema entry point, and the SDK carries zod as a hard runtime\n * dependency, so a `serve_flow` caller already has zod resolved. Widening\n * this to a neutral schema would typecheck and then fail inside the SDK.\n */\n input_schema: z.ZodType<i>\n trajectory?: TrajectoryLogger\n // Overrides the default value-to-CallToolResult mapping.\n to_result?: (output: o) => { text: string; structured?: Record<string, unknown> }\n}\n\n/**\n * Registers a Fascicle flow as a tool on a caller-owned MCP server.\n *\n * Drives the flow with `run`, threading the per-request abort signal so an\n * MCP client cancellation aborts the in-flight flow, and maps the result\n * into a `CallToolResult`. A thrown flow becomes an `isError` result rather\n * than a JSON-RPC protocol error.\n */\nexport function serve_flow<i, o>(config: ServeFlowConfig<i, o>): void {\n const { server, flow, name, description, input_schema, trajectory, to_result } = config\n server.registerTool(\n name,\n { description, inputSchema: input_schema },\n async (input: i, extra) => {\n try {\n const output = await run(flow, input, {\n install_signal_handlers: false,\n abort: extra.signal,\n ...(trajectory !== undefined ? { trajectory } : {}),\n })\n return output_to_call_result(output, to_result)\n } catch (err: unknown) {\n return {\n isError: true,\n content: [{ type: 'text', text: err instanceof Error ? err.message : String(err) }],\n }\n }\n },\n )\n}\n"],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ //#region src/schema/records.ts
2
+ /**
3
+ * Small shared guards for reading untyped JSON. They live beside the JSON
4
+ * Schema bridge that needs them and are exported, so MCP's client and result
5
+ * mapping read payloads through the same copy rather than carrying their own.
6
+ */
7
+ /**
8
+ * Narrows a value to a plain object: non-null, `typeof` object, not an array.
9
+ */
10
+ function is_record(value) {
11
+ return typeof value === "object" && value !== null && !Array.isArray(value);
12
+ }
13
+ /**
14
+ * Returns the value when it is a plain object, otherwise `undefined`.
15
+ */
16
+ function as_record(value) {
17
+ return is_record(value) ? value : void 0;
18
+ }
19
+ //#endregion
20
+ export { is_record as n, as_record as t };
21
+
22
+ //# sourceMappingURL=records-1HU7mWXf.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"records-1HU7mWXf.js","names":[],"sources":["../src/schema/records.ts"],"sourcesContent":["/**\n * Small shared guards for reading untyped JSON. They live beside the JSON\n * Schema bridge that needs them and are exported, so MCP's client and result\n * mapping read payloads through the same copy rather than carrying their own.\n */\n\n/**\n * Narrows a value to a plain object: non-null, `typeof` object, not an array.\n */\nexport function is_record(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/**\n * Returns the value when it is a plain object, otherwise `undefined`.\n */\nexport function as_record(value: unknown): Record<string, unknown> | undefined {\n return is_record(value) ? value : undefined\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,UAAU,OAAkD;CAC1E,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;AAKA,SAAgB,UAAU,OAAqD;CAC7E,OAAO,UAAU,KAAK,IAAI,QAAQ,KAAA;AACpC"}
@@ -1,4 +1,5 @@
1
- import { n as as_record, t as json_schema_to_standard } from "./json_schema_to_standard-r21kW2LI.js";
1
+ import { t as as_record } from "./records-1HU7mWXf.js";
2
+ import { t as json_schema_to_standard } from "./json_schema_to_standard-BTWD0J6p.js";
2
3
  import { open, readdir, readlink, realpath, stat } from "node:fs/promises";
3
4
  import { basename, dirname, extname, isAbsolute, join, matchesGlob, relative, resolve, sep } from "node:path";
4
5
  import { Worker } from "node:worker_threads";
@@ -296,15 +297,30 @@ async function matching_files(session, request, ignored, abort) {
296
297
  return found.map((relative) => shown_path(session, join(base.path, relative))).toSorted();
297
298
  }
298
299
  /**
300
+ * The files as the model reads them, one to a line, and past `limit` the
301
+ * first `limit` of them with a note giving the total. The walk has already
302
+ * found every match to sort them, so the total costs nothing to count.
303
+ */
304
+ function listing(files, limit) {
305
+ if (files.length <= limit) return files.join("\n");
306
+ const note = `[the first ${limit} of ${files.length} files; narrow pattern or path to see the rest]`;
307
+ return [
308
+ ...files.slice(0, limit),
309
+ "",
310
+ note
311
+ ].join("\n");
312
+ }
313
+ /**
299
314
  * The `list_files` tool for one session: the files under a directory in
300
- * its workspace that match a glob, skipping the `ignore` names.
315
+ * its workspace that match a glob, skipping the `ignore` names, at most
316
+ * `limit` per call.
301
317
  */
302
- function list_files_tool(session, ignore) {
318
+ function list_files_tool(session, ignore, limit) {
303
319
  const ignored = new Set(ignore);
304
320
  return {
305
321
  name: "list_files",
306
322
  description: [
307
- "List the files in the workspace that match a glob pattern, one per line; a path under the workspace root is shown relative to it.",
323
+ `List the files in the workspace that match a glob pattern, one per line and at most ${limit} per call; a path under the workspace root is shown relative to it.`,
308
324
  `The pattern matches under path (default: the workspace root) and defaults to ${ALL_FILES$1}.`,
309
325
  "As in a shell, * and ** skip names that start with a dot, so name the dot to list hidden files (.github/**/*).",
310
326
  ...ignore.length === 0 ? [] : [`Skips ${ignore.join(", ")}.`]
@@ -326,7 +342,7 @@ function list_files_tool(session, ignore) {
326
342
  execute: async (input, ctx) => {
327
343
  const request = list_request(input);
328
344
  const files = await matching_files(session, request, ignored, ctx.abort);
329
- return files.length === 0 ? `no files match ${request.pattern} under ${request.path}` : files.join("\n");
345
+ return files.length === 0 ? `no files match ${request.pattern} under ${request.path}` : listing(files, limit);
330
346
  }
331
347
  };
332
348
  }
@@ -560,4 +576,4 @@ function search_tool(session, ignore, budget_ms) {
560
576
  //#endregion
561
577
  export { read_file_tool as a, resolve_roots as c, is_binary as i, shown_path as l, search_tool as n, contain as o, list_files_tool as r, error_code as s, search_files as t };
562
578
 
563
- //# sourceMappingURL=search-CqH5hmuF.js.map
579
+ //# sourceMappingURL=search-CA_OqFeW.js.map