fascicle 0.10.3 → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +25 -0
- package/dist/{adapters-CJnu1687.js → adapters-hmnJOOgf.js} +30 -64
- package/dist/adapters-hmnJOOgf.js.map +1 -0
- package/dist/adapters.js +1 -1
- package/dist/agents.js +51 -29
- package/dist/agents.js.map +1 -1
- package/dist/{core-DkuJqLwd.js → core-DgH4mDbK.js} +205 -114
- package/dist/core-DgH4mDbK.js.map +1 -0
- package/dist/index.d.ts +17 -23
- package/dist/index.js +2352 -1641
- package/dist/index.js.map +1 -1
- package/dist/{invoke-D9pxbZcu.js → invoke-BjrbCBSV.js} +101 -66
- package/dist/invoke-BjrbCBSV.js.map +1 -0
- package/dist/{types-kO1JoGNZ.js → leading_system-CpkjHoCQ.js} +57 -3
- package/dist/leading_system-CpkjHoCQ.js.map +1 -0
- package/dist/mcp.js +1 -1
- package/dist/stdio.js +2 -2
- package/package.json +1 -1
- package/dist/adapters-CJnu1687.js.map +0 -1
- package/dist/core-DkuJqLwd.js.map +0 -1
- package/dist/invoke-D9pxbZcu.js.map +0 -1
- package/dist/types-kO1JoGNZ.js.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { A as aborted_error } from "./core-
|
|
2
|
-
import { n as load_optional_peer, t as
|
|
1
|
+
import { A as aborted_error } from "./core-DgH4mDbK.js";
|
|
2
|
+
import { n as default_normalize_usage, r as load_optional_peer, t as split_leading_system_run } from "./leading_system-CpkjHoCQ.js";
|
|
3
3
|
import { NoObjectGeneratedError, Output, generateText, isStepCount, streamText, tool } from "ai";
|
|
4
4
|
//#region src/engine/providers/ai_sdk/telemetry.ts
|
|
5
5
|
/**
|
|
@@ -47,6 +47,56 @@ function map_finish_reason(raw) {
|
|
|
47
47
|
}
|
|
48
48
|
}
|
|
49
49
|
/**
|
|
50
|
+
* Read a numeric field off an object by key, or undefined when it is absent or
|
|
51
|
+
* not a number. The single typeof guard behind every usage-field read below.
|
|
52
|
+
*/
|
|
53
|
+
function read_number(source, key) {
|
|
54
|
+
const value = Reflect.get(source, key);
|
|
55
|
+
return typeof value === "number" ? value : void 0;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Read the AI SDK's nested `inputTokenDetails` (cache read/write counts) onto
|
|
59
|
+
* `raw`. Present-but-empty details still seed `input_token_details` so the
|
|
60
|
+
* "the SDK reported details" signal survives even when both counts are absent.
|
|
61
|
+
*/
|
|
62
|
+
function read_input_details(usage, raw) {
|
|
63
|
+
const details = Reflect.get(usage, "inputTokenDetails");
|
|
64
|
+
if (details === null || typeof details !== "object") return;
|
|
65
|
+
raw.input_token_details = {};
|
|
66
|
+
const cache_read = read_number(details, "cacheReadTokens");
|
|
67
|
+
if (cache_read !== void 0) raw.input_token_details.cached_tokens = cache_read;
|
|
68
|
+
const cache_write = read_number(details, "cacheWriteTokens");
|
|
69
|
+
if (cache_write !== void 0) raw.input_token_details.cache_creation_input_tokens = cache_write;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Read the AI SDK's nested `outputTokenDetails` (reasoning-token count) onto
|
|
73
|
+
* `raw`, seeding `output_token_details` whenever the details object is present.
|
|
74
|
+
*/
|
|
75
|
+
function read_output_details(usage, raw) {
|
|
76
|
+
const details = Reflect.get(usage, "outputTokenDetails");
|
|
77
|
+
if (details === null || typeof details !== "object") return;
|
|
78
|
+
raw.output_token_details = {};
|
|
79
|
+
const reasoning = read_number(details, "reasoningTokens");
|
|
80
|
+
if (reasoning !== void 0) raw.output_token_details.reasoning_tokens = reasoning;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Read the flattened snake_case usage fields some provider mocks return
|
|
84
|
+
* directly. The `input_tokens`/`output_tokens` flats are fallbacks: they fill
|
|
85
|
+
* in only when the camelCase read did not already set the same total.
|
|
86
|
+
*/
|
|
87
|
+
function read_flat_usage(usage, raw) {
|
|
88
|
+
const cached = read_number(usage, "cached_input_tokens");
|
|
89
|
+
if (cached !== void 0) raw.cached_input_tokens = cached;
|
|
90
|
+
const cache_write = read_number(usage, "cache_write_tokens");
|
|
91
|
+
if (cache_write !== void 0) raw.cache_write_tokens = cache_write;
|
|
92
|
+
const reasoning = read_number(usage, "reasoning_tokens");
|
|
93
|
+
if (reasoning !== void 0) raw.reasoning_tokens = reasoning;
|
|
94
|
+
const input_flat = read_number(usage, "input_tokens");
|
|
95
|
+
if (raw.input_tokens === void 0 && input_flat !== void 0) raw.input_tokens = input_flat;
|
|
96
|
+
const output_flat = read_number(usage, "output_tokens");
|
|
97
|
+
if (raw.output_tokens === void 0 && output_flat !== void 0) raw.output_tokens = output_flat;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
50
100
|
* Extract the usage fields `default_normalize_usage` understands from an AI
|
|
51
101
|
* SDK usage object, tolerating both the SDK's camelCase shape and the
|
|
52
102
|
* flattened snake_case fields some provider mocks return directly.
|
|
@@ -54,34 +104,13 @@ function map_finish_reason(raw) {
|
|
|
54
104
|
function to_raw_provider_usage(usage) {
|
|
55
105
|
if (usage === null || typeof usage !== "object") return {};
|
|
56
106
|
const raw = {};
|
|
57
|
-
const input_tokens =
|
|
58
|
-
if (
|
|
59
|
-
const output_tokens =
|
|
60
|
-
if (
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
const cache_write = Reflect.get(input_details, "cacheWriteTokens");
|
|
65
|
-
raw.input_token_details = {};
|
|
66
|
-
if (typeof cache_read === "number") raw.input_token_details.cached_tokens = cache_read;
|
|
67
|
-
if (typeof cache_write === "number") raw.input_token_details.cache_creation_input_tokens = cache_write;
|
|
68
|
-
}
|
|
69
|
-
const output_details = Reflect.get(usage, "outputTokenDetails");
|
|
70
|
-
if (output_details !== null && typeof output_details === "object") {
|
|
71
|
-
const reasoning = Reflect.get(output_details, "reasoningTokens");
|
|
72
|
-
raw.output_token_details = {};
|
|
73
|
-
if (typeof reasoning === "number") raw.output_token_details.reasoning_tokens = reasoning;
|
|
74
|
-
}
|
|
75
|
-
const cached_flat = Reflect.get(usage, "cached_input_tokens");
|
|
76
|
-
if (typeof cached_flat === "number") raw.cached_input_tokens = cached_flat;
|
|
77
|
-
const cache_write_flat = Reflect.get(usage, "cache_write_tokens");
|
|
78
|
-
if (typeof cache_write_flat === "number") raw.cache_write_tokens = cache_write_flat;
|
|
79
|
-
const reasoning_flat = Reflect.get(usage, "reasoning_tokens");
|
|
80
|
-
if (typeof reasoning_flat === "number") raw.reasoning_tokens = reasoning_flat;
|
|
81
|
-
const input_flat = Reflect.get(usage, "input_tokens");
|
|
82
|
-
if (raw.input_tokens === void 0 && typeof input_flat === "number") raw.input_tokens = input_flat;
|
|
83
|
-
const output_flat = Reflect.get(usage, "output_tokens");
|
|
84
|
-
if (raw.output_tokens === void 0 && typeof output_flat === "number") raw.output_tokens = output_flat;
|
|
107
|
+
const input_tokens = read_number(usage, "inputTokens");
|
|
108
|
+
if (input_tokens !== void 0) raw.input_tokens = input_tokens;
|
|
109
|
+
const output_tokens = read_number(usage, "outputTokens");
|
|
110
|
+
if (output_tokens !== void 0) raw.output_tokens = output_tokens;
|
|
111
|
+
read_input_details(usage, raw);
|
|
112
|
+
read_output_details(usage, raw);
|
|
113
|
+
read_flat_usage(usage, raw);
|
|
85
114
|
return raw;
|
|
86
115
|
}
|
|
87
116
|
/**
|
|
@@ -202,20 +231,7 @@ function to_sdk_messages(messages) {
|
|
|
202
231
|
* `messages` empty, since the SDK rejects an empty messages array.
|
|
203
232
|
*/
|
|
204
233
|
function split_leading_system(messages) {
|
|
205
|
-
|
|
206
|
-
const system_parts = [];
|
|
207
|
-
while (run_end < messages.length) {
|
|
208
|
-
const m = messages[run_end];
|
|
209
|
-
if (m?.role !== "system") break;
|
|
210
|
-
system_parts.push(m.content);
|
|
211
|
-
run_end += 1;
|
|
212
|
-
}
|
|
213
|
-
const rest = messages.slice(run_end);
|
|
214
|
-
if (system_parts.length === 0 || rest.length === 0) return { messages: [...messages] };
|
|
215
|
-
return {
|
|
216
|
-
system: system_parts.join("\n\n"),
|
|
217
|
-
messages: rest
|
|
218
|
-
};
|
|
234
|
+
return split_leading_system_run(messages, (m) => m.content);
|
|
219
235
|
}
|
|
220
236
|
/**
|
|
221
237
|
* Map fascicle's Tool[] to the AI SDK's ToolSet.
|
|
@@ -283,33 +299,52 @@ function default_usage_from_sdk(usage) {
|
|
|
283
299
|
return default_normalize_usage(to_raw_provider_usage(usage));
|
|
284
300
|
}
|
|
285
301
|
/**
|
|
302
|
+
* Fold one stream part's accumulated state into `acc`: text deltas append,
|
|
303
|
+
* tool-call parts push a RawToolCall, and the finish-step overwrites finish
|
|
304
|
+
* reason, usage, and provider_reported. The finish-step's providerMetadata is
|
|
305
|
+
* the same value generateText returns on its result, which is what keeps a
|
|
306
|
+
* streamed run's provider_reported identical to a plain run's. Parts with no
|
|
307
|
+
* accumulated state (error, abort, stream framing) are the caller's to handle.
|
|
308
|
+
*/
|
|
309
|
+
function accumulate_stream_part(part, acc) {
|
|
310
|
+
if (part.type === "text-delta") {
|
|
311
|
+
acc.text += part.text;
|
|
312
|
+
return;
|
|
313
|
+
}
|
|
314
|
+
if (part.type === "tool-call") {
|
|
315
|
+
acc.tool_calls.push({
|
|
316
|
+
id: part.toolCallId,
|
|
317
|
+
name: part.toolName,
|
|
318
|
+
input: part.input
|
|
319
|
+
});
|
|
320
|
+
return;
|
|
321
|
+
}
|
|
322
|
+
if (part.type === "finish-step") {
|
|
323
|
+
acc.finish_reason = map_finish_reason(part.finishReason);
|
|
324
|
+
acc.raw_usage = to_raw_provider_usage(part.usage);
|
|
325
|
+
acc.provider_reported = to_provider_reported(part.providerMetadata);
|
|
326
|
+
}
|
|
327
|
+
}
|
|
328
|
+
/**
|
|
286
329
|
* Run one streamText call, dispatching StreamChunks as parts arrive and
|
|
287
330
|
* accumulating them into a TurnResult once the stream completes.
|
|
288
331
|
*/
|
|
289
332
|
async function collect_stream(params, step_index, dispatcher, on_first_chunk, internal_controller, adapter) {
|
|
290
333
|
const stream_result = streamText(params);
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
334
|
+
const acc = {
|
|
335
|
+
text: "",
|
|
336
|
+
tool_calls: [],
|
|
337
|
+
finish_reason: "stop",
|
|
338
|
+
raw_usage: {},
|
|
339
|
+
provider_reported: void 0
|
|
340
|
+
};
|
|
296
341
|
let first = true;
|
|
297
342
|
for await (const part of stream_result.stream) {
|
|
298
343
|
if (first) {
|
|
299
344
|
first = false;
|
|
300
345
|
on_first_chunk();
|
|
301
346
|
}
|
|
302
|
-
|
|
303
|
-
if (part.type === "tool-call") tool_calls.push({
|
|
304
|
-
id: part.toolCallId,
|
|
305
|
-
name: part.toolName,
|
|
306
|
-
input: part.input
|
|
307
|
-
});
|
|
308
|
-
if (part.type === "finish-step") {
|
|
309
|
-
finish_reason = map_finish_reason(part.finishReason);
|
|
310
|
-
raw_usage = to_raw_provider_usage(part.usage);
|
|
311
|
-
provider_reported = to_provider_reported(part.providerMetadata);
|
|
312
|
-
}
|
|
347
|
+
accumulate_stream_part(part, acc);
|
|
313
348
|
if (part.type === "error") throw part.error;
|
|
314
349
|
if (part.type === "abort") throw new aborted_error("aborted", { step_index });
|
|
315
350
|
const chunk = map_stream_part_to_chunk(part, step_index);
|
|
@@ -322,11 +357,11 @@ async function collect_stream(params, step_index, dispatcher, on_first_chunk, in
|
|
|
322
357
|
}
|
|
323
358
|
}
|
|
324
359
|
return {
|
|
325
|
-
text,
|
|
326
|
-
tool_calls,
|
|
327
|
-
finish_reason,
|
|
328
|
-
usage: adapter.normalize_usage(raw_usage),
|
|
329
|
-
...provider_reported !== void 0 ? { provider_reported } : {}
|
|
360
|
+
text: acc.text,
|
|
361
|
+
tool_calls: acc.tool_calls,
|
|
362
|
+
finish_reason: acc.finish_reason,
|
|
363
|
+
usage: adapter.normalize_usage(acc.raw_usage),
|
|
364
|
+
...acc.provider_reported !== void 0 ? { provider_reported: acc.provider_reported } : {}
|
|
330
365
|
};
|
|
331
366
|
}
|
|
332
367
|
/**
|
|
@@ -448,4 +483,4 @@ function create_ai_sdk_turn(cfg) {
|
|
|
448
483
|
//#endregion
|
|
449
484
|
export { create_ai_sdk_turn, default_usage_from_sdk, map_finish_reason, map_stream_part_to_chunk, split_leading_system, to_provider_reported, to_raw_provider_usage, to_sdk_messages, to_sdk_tools };
|
|
450
485
|
|
|
451
|
-
//# sourceMappingURL=invoke-
|
|
486
|
+
//# sourceMappingURL=invoke-BjrbCBSV.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"invoke-BjrbCBSV.js","names":["ai_tool"],"sources":["../src/engine/providers/ai_sdk/telemetry.ts","../src/engine/providers/ai_sdk/invoke.ts"],"sourcesContent":["/**\n * AI SDK telemetry wiring, confined to the ai_sdk transport.\n *\n * `@ai-sdk/otel` is adopted strictly below the turn seam: it instruments one\n * turn inside this module, never the loop. The peer is loaded lazily and only\n * when telemetry is explicitly enabled, so the disabled default (every call\n * that does not opt in) pulls in nothing.\n *\n * This is the ONLY place `@ai-sdk/otel` is referenced. generate.ts and\n * create_engine.ts thread a plain `AiSdkTelemetrySettings` value through the\n * seam and stay SDK-agnostic; loop-level, transport-neutral tracing is the\n * separate `fascicle/otel` bridge.\n */\n\nimport type { AiSdkTelemetrySettings } from '../../types.js'\nimport { load_optional_peer } from '../types.js'\n\ntype OpenTelemetryCtor = new (options?: { tracer?: unknown }) => unknown\n\ntype AiSdkOtelModule = {\n readonly OpenTelemetry: OpenTelemetryCtor\n}\n\n/**\n * The subset of the AI SDK's telemetry option shape this module produces, using\n * the SDK's own (camelCase) keys. Cast onto `experimental_telemetry` at the\n * call site.\n */\nexport type AiSdkTelemetryPassthrough = {\n isEnabled: true\n integrations: unknown[]\n functionId?: string\n recordInputs?: boolean\n recordOutputs?: boolean\n metadata?: Readonly<Record<string, string | number | boolean>>\n}\n\n/**\n * Build the AI SDK's `experimental_telemetry` option from engine settings,\n * loading the `@ai-sdk/otel` peer only when telemetry is enabled.\n */\nexport async function build_ai_sdk_telemetry(\n settings: AiSdkTelemetrySettings | undefined,\n): Promise<AiSdkTelemetryPassthrough | undefined> {\n if (!settings?.enabled) return undefined\n const mod = await load_optional_peer<AiSdkOtelModule>('@ai-sdk/otel')\n const integration = new mod.OpenTelemetry(\n settings.tracer !== undefined ? { tracer: settings.tracer } : {},\n )\n const out: AiSdkTelemetryPassthrough = { isEnabled: true, integrations: [integration] }\n if (settings.function_id !== undefined) out.functionId = settings.function_id\n if (settings.record_inputs !== undefined) out.recordInputs = settings.record_inputs\n if (settings.record_outputs !== undefined) out.recordOutputs = settings.record_outputs\n if (settings.metadata !== undefined) out.metadata = settings.metadata\n return out\n}\n","/**\n * The ai_sdk transport: the engine's only Vercel AI SDK call site.\n *\n * Only this module imports from `ai` or invokes generateText / streamText.\n * generate.ts drives this transport through create_ai_sdk_turn and stays\n * SDK-agnostic; run_tool_loop sees the same neutral TurnResult a native\n * adapter produces. Enforced by rules/no-ai-import-outside-ai-sdk-provider.yml.\n *\n * Retry stays out of this module on purpose: generate.ts wraps the turn\n * returned here in the engine-owned retry_turn, exactly as it wraps a native\n * adapter's invoke_turn. This module owns request/response mapping only.\n */\n\nimport {\n generateText,\n NoObjectGeneratedError,\n Output,\n isStepCount,\n streamText,\n tool as ai_tool,\n type LanguageModel,\n type ModelMessage,\n type TextStreamPart,\n type ToolSet,\n} from 'ai'\nimport type { ToolSchema } from '#schema'\nimport type {\n AiSdkTelemetrySettings,\n FinishReason,\n Message,\n StreamChunk,\n Tool,\n TurnResult,\n UsageTotals,\n} from '../../types.js'\nimport { aborted_error } from '../../errors.js'\nimport { split_leading_system_run } from '../../leading_system.js'\nimport type { ChunkDispatcher } from '../../streaming.js'\nimport type { RawToolCall } from '../../tool_loop.js'\nimport {\n default_normalize_usage,\n type AiSdkProviderAdapter,\n type RawProviderUsage,\n} from '../types.js'\nimport { build_ai_sdk_telemetry, type AiSdkTelemetryPassthrough } from './telemetry.js'\n\n/**\n * Map the AI SDK's finish reason string to the engine's FinishReason.\n */\nexport function map_finish_reason(raw: string | undefined): FinishReason {\n switch (raw) {\n case 'stop':\n return 'stop'\n case 'length':\n return 'length'\n case 'content-filter':\n case 'content_filter':\n return 'content_filter'\n case 'tool-calls':\n case 'tool_calls':\n return 'tool_calls'\n default:\n return 'stop'\n }\n}\n\n/**\n * Read a numeric field off an object by key, or undefined when it is absent or\n * not a number. The single typeof guard behind every usage-field read below.\n */\nfunction read_number(source: object, key: string): number | undefined {\n const value = Reflect.get(source, key)\n return typeof value === 'number' ? value : undefined\n}\n\n/**\n * Read the AI SDK's nested `inputTokenDetails` (cache read/write counts) onto\n * `raw`. Present-but-empty details still seed `input_token_details` so the\n * \"the SDK reported details\" signal survives even when both counts are absent.\n */\nfunction read_input_details(usage: object, raw: RawProviderUsage): void {\n const details = Reflect.get(usage, 'inputTokenDetails')\n if (details === null || typeof details !== 'object') return\n raw.input_token_details = {}\n const cache_read = read_number(details, 'cacheReadTokens')\n if (cache_read !== undefined) raw.input_token_details.cached_tokens = cache_read\n const cache_write = read_number(details, 'cacheWriteTokens')\n if (cache_write !== undefined) raw.input_token_details.cache_creation_input_tokens = cache_write\n}\n\n/**\n * Read the AI SDK's nested `outputTokenDetails` (reasoning-token count) onto\n * `raw`, seeding `output_token_details` whenever the details object is present.\n */\nfunction read_output_details(usage: object, raw: RawProviderUsage): void {\n const details = Reflect.get(usage, 'outputTokenDetails')\n if (details === null || typeof details !== 'object') return\n raw.output_token_details = {}\n const reasoning = read_number(details, 'reasoningTokens')\n if (reasoning !== undefined) raw.output_token_details.reasoning_tokens = reasoning\n}\n\n/**\n * Read the flattened snake_case usage fields some provider mocks return\n * directly. The `input_tokens`/`output_tokens` flats are fallbacks: they fill\n * in only when the camelCase read did not already set the same total.\n */\nfunction read_flat_usage(usage: object, raw: RawProviderUsage): void {\n const cached = read_number(usage, 'cached_input_tokens')\n if (cached !== undefined) raw.cached_input_tokens = cached\n const cache_write = read_number(usage, 'cache_write_tokens')\n if (cache_write !== undefined) raw.cache_write_tokens = cache_write\n const reasoning = read_number(usage, 'reasoning_tokens')\n if (reasoning !== undefined) raw.reasoning_tokens = reasoning\n const input_flat = read_number(usage, 'input_tokens')\n if (raw.input_tokens === undefined && input_flat !== undefined) raw.input_tokens = input_flat\n const output_flat = read_number(usage, 'output_tokens')\n if (raw.output_tokens === undefined && output_flat !== undefined) raw.output_tokens = output_flat\n}\n\n/**\n * Extract the usage fields `default_normalize_usage` understands from an AI\n * SDK usage object, tolerating both the SDK's camelCase shape and the\n * flattened snake_case fields some provider mocks return directly.\n */\nexport function to_raw_provider_usage(usage: unknown): RawProviderUsage {\n if (usage === null || typeof usage !== 'object') return {}\n const raw: RawProviderUsage = {}\n const input_tokens = read_number(usage, 'inputTokens')\n if (input_tokens !== undefined) raw.input_tokens = input_tokens\n const output_tokens = read_number(usage, 'outputTokens')\n if (output_tokens !== undefined) raw.output_tokens = output_tokens\n read_input_details(usage, raw)\n read_output_details(usage, raw)\n read_flat_usage(usage, raw)\n return raw\n}\n\n/**\n * Normalize an AI SDK `providerMetadata` value into the neutral\n * TurnResult.provider_reported shape.\n *\n * The SDK's metadata is already keyed by provider name, which is the shape\n * provider_reported documents, so the keys ride through untranslated and every\n * ai_sdk provider is served by this one seam: bedrock's guardrail `trace`,\n * anthropic's cache detail, openai's own fields. The payloads stay opaque\n * (callers narrow them at the use site), so this copies the top level and\n * inspects nothing below it. An absent or empty map returns undefined, keeping\n * \"the provider reported nothing\" spelled one way.\n */\nexport function to_provider_reported(metadata: unknown): Record<string, unknown> | undefined {\n if (metadata === null || typeof metadata !== 'object') return undefined\n const keys = Object.keys(metadata)\n if (keys.length === 0) return undefined\n const reported: Record<string, unknown> = {}\n for (const key of keys) reported[key] = Reflect.get(metadata, key)\n return reported\n}\n\n/**\n * Map fascicle's Message[] to the AI SDK's ModelMessage[] shape.\n */\nexport function to_sdk_messages(messages: ReadonlyArray<Message>): ModelMessage[] {\n const out: ModelMessage[] = []\n for (const m of messages) {\n if (m.role === 'system') {\n out.push({ role: 'system', content: m.content })\n continue\n }\n if (m.role === 'user') {\n if (typeof m.content === 'string') {\n out.push({ role: 'user', content: m.content })\n } else {\n const parts: Array<\n | { type: 'text'; text: string }\n | { type: 'image'; image: string | Uint8Array; mediaType?: string }\n > = m.content.map((p) => {\n if (p.type === 'text') return { type: 'text', text: p.text }\n const image_part: { type: 'image'; image: string | Uint8Array; mediaType?: string } = {\n type: 'image',\n image: p.image,\n }\n if (p.media_type !== undefined) image_part.mediaType = p.media_type\n return image_part\n })\n out.push({ role: 'user', content: parts })\n }\n continue\n }\n if (m.role === 'tool') {\n out.push({\n role: 'tool',\n content: [\n {\n type: 'tool-result',\n toolCallId: m.tool_call_id,\n toolName: m.name,\n output: { type: 'text', value: m.content },\n },\n ],\n })\n continue\n }\n // assistant\n if (typeof m.content === 'string') {\n out.push({ role: 'assistant', content: m.content })\n continue\n }\n const parts = m.content.map((p) => {\n if (p.type === 'text') return { type: 'text' as const, text: p.text }\n return {\n type: 'tool-call' as const,\n toolCallId: p.id,\n toolName: p.name,\n input: p.input,\n }\n })\n out.push({ role: 'assistant', content: parts })\n }\n return out\n}\n\n/**\n * Hoist a leading run of system messages out of the SDK message list into the\n * AI SDK's top-level `system` option.\n *\n * Passing a `role: 'system'` entry inside `messages` makes the AI SDK treat it\n * as potentially attacker-controlled: it warns on every call (and newer `ai`\n * versions throw unless `allowSystemInMessages` is set). fascicle's system\n * content is the developer's own prompt, and the SDK's own recommendation is to\n * deliver it through the top-level `instructions` option (v7's rename of the\n * former `system` option), which removes the warning at its source rather than\n * suppressing it.\n *\n * Only the *leading* run is hoisted (fascicle's only shape: one or more system\n * messages, then the conversation). A system message that appears after a\n * non-system message keeps its position rather than being silently reordered to\n * the top, and the original list is returned untouched when hoisting would leave\n * `messages` empty, since the SDK rejects an empty messages array.\n */\nexport function split_leading_system(messages: ReadonlyArray<ModelMessage>): {\n system?: string\n messages: ModelMessage[]\n} {\n return split_leading_system_run(messages, (m) => m.content)\n}\n\n/**\n * Map fascicle's Tool[] to the AI SDK's ToolSet.\n *\n * Returns undefined for an empty tool list so the caller can omit `tools`\n * from the call params entirely instead of passing an empty object.\n */\nexport function to_sdk_tools(tools: ReadonlyArray<Tool>): ToolSet | undefined {\n if (tools.length === 0) return undefined\n const entries: ToolSet = {}\n for (const t of tools) {\n entries[t.name] = ai_tool({\n description: t.description,\n inputSchema: t.input_schema,\n })\n }\n return entries\n}\n\n/**\n * Map one AI SDK stream part to the engine's StreamChunk shape, or undefined\n * for a part kind the engine does not model.\n */\nexport function map_stream_part_to_chunk(\n part: TextStreamPart<ToolSet>,\n step_index: number,\n): StreamChunk | undefined {\n switch (part.type) {\n case 'text-delta':\n return { kind: 'text', text: part.text, step_index }\n case 'reasoning-delta':\n return { kind: 'reasoning', text: part.text, step_index }\n case 'tool-input-start':\n return {\n kind: 'tool_call_start',\n id: part.id,\n name: part.toolName,\n step_index,\n }\n case 'tool-input-delta':\n return {\n kind: 'tool_call_input_delta',\n id: part.id,\n delta: part.delta,\n step_index,\n }\n case 'tool-call':\n return {\n kind: 'tool_call_end',\n id: part.toolCallId,\n input: part.input,\n step_index,\n }\n case 'finish-step':\n return {\n kind: 'step_finish',\n step_index,\n finish_reason: map_finish_reason(part.finishReason),\n usage: default_usage_from_sdk(part.usage),\n }\n default:\n // v7 parts with no engine StreamChunk kind (file, reasoning-file,\n // source, block framing) drop here on purpose: the engine models\n // text, reasoning, and tool traffic, not generated files.\n return undefined\n }\n}\n\n/**\n * Normalize a raw AI SDK usage object into UsageTotals for a streamed\n * step_finish chunk.\n */\nexport function default_usage_from_sdk(usage: unknown): UsageTotals {\n // Streamed step_finish chunks must carry the same cache/reasoning\n // granularity the step record gets via adapter.normalize_usage; every\n // built-in adapter routes through default_normalize_usage, so this keeps\n // the chunk surface consistent with the non-streamed result.\n return default_normalize_usage(to_raw_provider_usage(usage))\n}\n\n/**\n * The running TurnResult fields collect_stream builds as it consumes the SDK\n * stream: text and tool calls accrue across parts, while finish reason, usage,\n * and provider_reported are overwritten by the terminal finish-step.\n */\ntype StreamAccumulator = {\n text: string\n tool_calls: RawToolCall[]\n finish_reason: FinishReason\n raw_usage: RawProviderUsage\n provider_reported: Record<string, unknown> | undefined\n}\n\n/**\n * Fold one stream part's accumulated state into `acc`: text deltas append,\n * tool-call parts push a RawToolCall, and the finish-step overwrites finish\n * reason, usage, and provider_reported. The finish-step's providerMetadata is\n * the same value generateText returns on its result, which is what keeps a\n * streamed run's provider_reported identical to a plain run's. Parts with no\n * accumulated state (error, abort, stream framing) are the caller's to handle.\n */\nfunction accumulate_stream_part(part: TextStreamPart<ToolSet>, acc: StreamAccumulator): void {\n if (part.type === 'text-delta') {\n acc.text += part.text\n return\n }\n if (part.type === 'tool-call') {\n acc.tool_calls.push({\n id: part.toolCallId,\n name: part.toolName,\n input: part.input,\n })\n return\n }\n if (part.type === 'finish-step') {\n acc.finish_reason = map_finish_reason(part.finishReason)\n acc.raw_usage = to_raw_provider_usage(part.usage)\n acc.provider_reported = to_provider_reported(part.providerMetadata)\n }\n}\n\n/**\n * Run one streamText call, dispatching StreamChunks as parts arrive and\n * accumulating them into a TurnResult once the stream completes.\n */\nasync function collect_stream(\n params: Parameters<typeof streamText>[0],\n step_index: number,\n dispatcher: ChunkDispatcher,\n on_first_chunk: () => void,\n internal_controller: AbortController,\n adapter: AiSdkProviderAdapter,\n): Promise<TurnResult> {\n const stream_result = streamText(params)\n const acc: StreamAccumulator = {\n text: '',\n tool_calls: [],\n finish_reason: 'stop',\n raw_usage: {},\n provider_reported: undefined,\n }\n let first = true\n\n for await (const part of stream_result.stream) {\n if (first) {\n first = false\n on_first_chunk()\n }\n accumulate_stream_part(part, acc)\n if (part.type === 'error') {\n throw part.error\n }\n if (part.type === 'abort') {\n throw new aborted_error('aborted', { step_index })\n }\n const chunk = map_stream_part_to_chunk(part, step_index)\n if (chunk === undefined) continue\n try {\n await dispatcher.dispatch(chunk)\n } catch (err: unknown) {\n internal_controller.abort()\n throw err\n }\n }\n\n return {\n text: acc.text,\n tool_calls: acc.tool_calls,\n finish_reason: acc.finish_reason,\n usage: adapter.normalize_usage(acc.raw_usage),\n // Stryker disable next-line ConditionalExpression: an always-true spread only adds an explicit `provider_reported: undefined` key, which every reader of TurnResult treats identically to the absent key.\n ...(acc.provider_reported !== undefined ? { provider_reported: acc.provider_reported } : {}),\n }\n}\n\n/**\n * Run one generateText call and map its result into a TurnResult, recovering\n * a schema-validation failure from the SDK via recover_no_object_generated\n * instead of letting it throw.\n */\nasync function collect_non_stream(\n params: Parameters<typeof generateText>[0],\n adapter: AiSdkProviderAdapter,\n): Promise<TurnResult> {\n let result: Awaited<ReturnType<typeof generateText>>\n try {\n result = await generateText(params)\n } catch (err: unknown) {\n const recovered = recover_no_object_generated(err, adapter)\n if (recovered !== undefined) return recovered\n throw err\n }\n const tool_calls: RawToolCall[] = []\n for (const tc of result.toolCalls) {\n tool_calls.push({\n id: tc.toolCallId,\n name: tc.toolName,\n input: tc.input,\n })\n }\n const raw_usage = to_raw_provider_usage(result.usage)\n // result.providerMetadata rather than result.finalStep.providerMetadata: the\n // two are the same value under stopWhen isStepCount(1), and the flat field\n // exists across the whole `ai` ^7 peer range this package declares.\n const provider_reported = to_provider_reported(result.providerMetadata)\n return {\n text: result.text,\n tool_calls,\n finish_reason: map_finish_reason(result.finishReason),\n usage: adapter.normalize_usage(raw_usage),\n // Stryker disable next-line ConditionalExpression: see collect_stream; the always-true spread is unobservable through every TurnResult reader.\n ...(provider_reported !== undefined ? { provider_reported } : {}),\n }\n}\n\n/**\n * When `output` (structured output) is in play, `generateText` eagerly parses the\n * model's text against the schema and throws `NoObjectGeneratedError` if it\n * does not conform. That parse is the SDK's, not fascicle's: turning it into a\n * thrown error would skip the engine's own schema-parse + repair loop (and the\n * error is not a retryable transient, so it would surface raw). Instead we\n * recover the model's raw text from the error and hand it back as a normal\n * turn result, so `parse_with_schema` re-validates it and the repair loop\n * engages exactly as it does for the prompt-based path. Returns undefined for\n * any other error so the caller rethrows.\n *\n * The recovered turn carries no provider_reported: the SDK's error exposes\n * text, usage, finishReason and response metadata, but not providerMetadata,\n * so there is nothing to read. The repair turn that follows reports normally.\n */\nfunction recover_no_object_generated(\n err: unknown,\n adapter: AiSdkProviderAdapter,\n): TurnResult | undefined {\n if (!NoObjectGeneratedError.isInstance(err)) return undefined\n const text_field = Reflect.get(err, 'text')\n const finish_field = Reflect.get(err, 'finishReason')\n const raw_usage = to_raw_provider_usage(Reflect.get(err, 'usage'))\n return {\n text: typeof text_field === 'string' ? text_field : '',\n tool_calls: [],\n finish_reason: map_finish_reason(typeof finish_field === 'string' ? finish_field : undefined),\n usage: adapter.normalize_usage(raw_usage),\n }\n}\n\ntype AiSdkCallParams = Parameters<typeof streamText>[0] & Parameters<typeof generateText>[0]\n\nexport type AiSdkTurnConfig = {\n readonly adapter: AiSdkProviderAdapter\n readonly model_id: string\n readonly dispatcher: ChunkDispatcher\n readonly tools: ReadonlyArray<Tool>\n readonly schema: ToolSchema | undefined\n readonly provider_options: Readonly<Record<string, Readonly<Record<string, unknown>>>> | undefined\n readonly temperature: number | undefined\n readonly max_tokens: number | undefined\n readonly top_p: number | undefined\n readonly telemetry: AiSdkTelemetrySettings | undefined\n}\n\nexport type AiSdkTurnArgs = {\n readonly step_index: number\n readonly messages: ReadonlyArray<Message>\n readonly abort: AbortSignal\n readonly stream: boolean\n readonly on_first_chunk: () => void\n}\n\nexport type AiSdkTurn = (args: AiSdkTurnArgs) => Promise<TurnResult>\n\n/**\n * Build the single-attempt SDK turn for one generate call: the\n * generateText/streamText call body behind the same neutral seam a native\n * adapter's invoke_turn implements. The built model is memoized across steps\n * of one generate call. No retry here: generate.ts wraps the returned turn in\n * the engine-owned retry_turn.\n */\nexport function create_ai_sdk_turn(cfg: AiSdkTurnConfig): AiSdkTurn {\n let model_instance: LanguageModel | undefined\n const get_model = async (): Promise<LanguageModel> => {\n if (model_instance === undefined) {\n const built = await cfg.adapter.build_model(cfg.model_id)\n // oxlint-disable-next-line typescript-eslint/no-unsafe-type-assertion\n model_instance = built as LanguageModel\n }\n return model_instance\n }\n\n // Telemetry is resolved once per generate call and memoized across its steps,\n // mirroring get_model. build_ai_sdk_telemetry returns undefined immediately\n // (no peer load) unless telemetry is explicitly enabled, so the disabled\n // default costs nothing.\n let telemetry_options: AiSdkTelemetryPassthrough | undefined\n let telemetry_resolved = false\n const get_telemetry = async (): Promise<AiSdkTelemetryPassthrough | undefined> => {\n if (!telemetry_resolved) {\n telemetry_options = await build_ai_sdk_telemetry(cfg.telemetry)\n telemetry_resolved = true\n }\n return telemetry_options\n }\n\n const sdk_tools = to_sdk_tools(cfg.tools)\n\n // Native structured output: when a schema is requested and the provider\n // constrains decoding to it (the 'structured_output' capability), route\n // through the AI SDK's Output.object seam so the schema becomes the\n // provider's responseFormat (e.g. Ollama's `format`) instead of a\n // prompt-for-JSON-then-scrape. Gated on no tools: forcing a JSON\n // responseFormat alongside tool calls breaks tool dispatch on most\n // providers, so tool runs keep the prompt-based schema path. The engine's\n // schema parse + repair loop still owns validation either way. This seam\n // is ai_sdk-only: a native adapter that constrains decoding honors\n // TurnRequest.schema inside its own invoke_turn.\n let output_spec: NonNullable<AiSdkCallParams['output']> | undefined\n if (\n cfg.schema !== undefined &&\n cfg.tools.length === 0 &&\n cfg.adapter.supports('structured_output')\n ) {\n // Output.object<T> is not structurally assignable to the SDK's default\n // Output<string, string> param slot, but the runtime shape is exactly\n // what generateText/streamText consume to set responseFormat.\n // eslint-disable-next-line typescript-eslint/no-unsafe-type-assertion\n output_spec = Output.object({ schema: cfg.schema }) as NonNullable<\n AiSdkCallParams['output']\n >\n }\n\n // provider_options is Record<string, Record<string, unknown>>; the SDK\n // expects SharedV3ProviderOptions (Record<string, JSONObject>) which is\n // structurally compatible for our usage.\n // eslint-disable-next-line typescript-eslint/no-unsafe-type-assertion\n const provider_options = cfg.provider_options as AiSdkCallParams['providerOptions']\n\n return async (args: AiSdkTurnArgs): Promise<TurnResult> => {\n const model = await get_model()\n const telemetry = await get_telemetry()\n const internal_controller = new AbortController()\n const cancel_on_user_abort = (): void => {\n internal_controller.abort(args.abort.reason)\n }\n if (args.abort.aborted) {\n internal_controller.abort(args.abort.reason)\n } else {\n args.abort.addEventListener('abort', cancel_on_user_abort, { once: true })\n }\n const { system: hoisted_system, messages: sdk_messages } = split_leading_system(\n to_sdk_messages(args.messages),\n )\n const base_params: AiSdkCallParams = {\n model,\n messages: sdk_messages,\n abortSignal: internal_controller.signal,\n stopWhen: isStepCount(1),\n // The engine owns retry via retry_turn in generate.ts; disable the AI\n // SDK's own retry (default 2) so it does not nest inside each of our\n // attempts and inflate provider round-trips / distort backoff.\n maxRetries: 0,\n }\n if (hoisted_system !== undefined) base_params.instructions = hoisted_system\n if (sdk_tools !== undefined) base_params.tools = sdk_tools\n if (output_spec !== undefined) base_params.output = output_spec\n if (provider_options !== undefined) base_params.providerOptions = provider_options\n if (cfg.temperature !== undefined) base_params.temperature = cfg.temperature\n if (cfg.max_tokens !== undefined) base_params.maxOutputTokens = cfg.max_tokens\n if (cfg.top_p !== undefined) base_params.topP = cfg.top_p\n if (telemetry !== undefined) {\n // AiSdkTelemetryPassthrough uses the SDK's own telemetry keys; the slot's\n // generic (RUNTIME_CONTEXT/TOOLS) is erased for our usage.\n // eslint-disable-next-line typescript-eslint/no-unsafe-type-assertion\n base_params.experimental_telemetry = telemetry as NonNullable<\n AiSdkCallParams['experimental_telemetry']\n >\n }\n\n try {\n if (args.stream) {\n return await collect_stream(\n base_params,\n args.step_index,\n cfg.dispatcher,\n args.on_first_chunk,\n internal_controller,\n cfg.adapter,\n )\n }\n return await collect_non_stream(base_params, cfg.adapter)\n } finally {\n args.abort.removeEventListener('abort', cancel_on_user_abort)\n }\n }\n}\n"],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import "./core-
|
|
1
|
+
import "./core-DgH4mDbK.js";
|
|
2
2
|
//#region src/engine/errors.ts
|
|
3
3
|
var rate_limit_error = class extends Error {
|
|
4
4
|
kind = "rate_limit_error";
|
|
@@ -221,6 +221,18 @@ function default_normalize_usage(raw) {
|
|
|
221
221
|
return totals;
|
|
222
222
|
}
|
|
223
223
|
/**
|
|
224
|
+
* Usage mapper for local backends (Ollama, LM Studio) whose servers never
|
|
225
|
+
* report cache or reasoning tokens: default-normalize, then strip those
|
|
226
|
+
* fields so a stray *_details container cannot invent them.
|
|
227
|
+
*/
|
|
228
|
+
function normalize_local_usage(raw) {
|
|
229
|
+
const base = default_normalize_usage(raw);
|
|
230
|
+
delete base.cached_input_tokens;
|
|
231
|
+
delete base.cache_write_tokens;
|
|
232
|
+
delete base.reasoning_tokens;
|
|
233
|
+
return base;
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
224
236
|
* Build the standard missing-peer error: names the package and the install
|
|
225
237
|
* command so a missing peer is diagnosable from the message alone. Shared so
|
|
226
238
|
* every optional-peer failure reads identically, whether the failing
|
|
@@ -248,6 +260,48 @@ async function load_optional_peer(specifier) {
|
|
|
248
260
|
return mod;
|
|
249
261
|
}
|
|
250
262
|
//#endregion
|
|
251
|
-
|
|
263
|
+
//#region src/engine/leading_system.ts
|
|
264
|
+
/**
|
|
265
|
+
* Collapse a leading run of system messages into a single joined string,
|
|
266
|
+
* returning the remaining messages.
|
|
267
|
+
*
|
|
268
|
+
* Both message paths hoist a leading system run out of their list the same way:
|
|
269
|
+
* the engine-Message side (generate.ts split_leading_system_messages) hands the
|
|
270
|
+
* run to a native adapter's TurnRequest.system, and the AI SDK side
|
|
271
|
+
* (providers/ai_sdk/invoke.ts split_leading_system) hands it to the SDK's
|
|
272
|
+
* top-level `instructions` option. Same guard, same '\n\n' join, and the same
|
|
273
|
+
* "return the list untouched when hoisting would leave `messages` empty" rule,
|
|
274
|
+
* since provider APIs reject an empty messages array. They differ only in the
|
|
275
|
+
* element type and how a system message's text is read, so each caller supplies
|
|
276
|
+
* `system_text`; the traversal and its guards live here once.
|
|
277
|
+
*/
|
|
278
|
+
function split_leading_system_run(messages, system_text) {
|
|
279
|
+
let run_end = 0;
|
|
280
|
+
const system_parts = [];
|
|
281
|
+
while (run_end < messages.length) {
|
|
282
|
+
const m = messages[run_end];
|
|
283
|
+
if (!is_leading_system(m)) break;
|
|
284
|
+
system_parts.push(system_text(m));
|
|
285
|
+
run_end += 1;
|
|
286
|
+
}
|
|
287
|
+
const rest = messages.slice(run_end);
|
|
288
|
+
if (system_parts.length === 0 || rest.length === 0) return { messages: [...messages] };
|
|
289
|
+
return {
|
|
290
|
+
system: system_parts.join("\n\n"),
|
|
291
|
+
messages: rest
|
|
292
|
+
};
|
|
293
|
+
}
|
|
294
|
+
/**
|
|
295
|
+
* Narrow a possibly-undefined message to the system member of its union.
|
|
296
|
+
*
|
|
297
|
+
* A cast-free type guard so `split_leading_system_run` can hand the narrowed
|
|
298
|
+
* message straight to `system_text` without a `T`-eroding assertion; the
|
|
299
|
+
* optional chain covers the out-of-bounds `undefined` the index access yields.
|
|
300
|
+
*/
|
|
301
|
+
function is_leading_system(m) {
|
|
302
|
+
return m?.role === "system";
|
|
303
|
+
}
|
|
304
|
+
//#endregion
|
|
305
|
+
export { rate_limit_error as _, normalize_local_usage as a, tool_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, schema_validation_error as v, turn_timeout_error as x, tool_approval_denied_error as y };
|
|
252
306
|
|
|
253
|
-
//# sourceMappingURL=
|
|
307
|
+
//# sourceMappingURL=leading_system-CpkjHoCQ.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"leading_system-CpkjHoCQ.js","names":[],"sources":["../src/engine/errors.ts","../src/engine/providers/types.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\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 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 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 // classify_retryable reads this off an `unknown` via read_string(err, 'kind'),\n // a dynamic access no static analysis can resolve back to this field.\n // fallow-ignore-next-line unused-class-member\n readonly kind = 'timeout' as const;\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 // Part of the published discriminant surface: consumers switch on `kind`\n // outside this repo, so the field has no in-repo production reader.\n // fallow-ignore-next-line unused-class-member\n readonly kind = 'schema_validation_error' as const;\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 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 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 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\nexport class provider_not_configured_error extends Error {\n readonly kind = 'provider_not_configured_error' as const;\n readonly provider: string;\n constructor(provider: string) {\n super(`provider '${provider}' is not configured on this engine`)\n this.name = 'provider_not_configured_error'\n this.provider = provider\n }\n}\n\nexport class engine_config_error extends Error {\n readonly kind = 'engine_config_error' as const;\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 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 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 constructor(message = 'engine has been disposed; further calls are not permitted') {\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 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 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 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}\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 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: pnpm add ${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 * 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.js
CHANGED
package/dist/stdio.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { k as run, p as validate_schema } from "./core-
|
|
2
|
-
import { r as stderr_logger } from "./adapters-
|
|
1
|
+
import { k as run, p as validate_schema } from "./core-DgH4mDbK.js";
|
|
2
|
+
import { r as stderr_logger } from "./adapters-hmnJOOgf.js";
|
|
3
3
|
import { text } from "node:stream/consumers";
|
|
4
4
|
//#region src/stdio/execute_stdio.ts
|
|
5
5
|
/**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fascicle",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.11.1",
|
|
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",
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"adapters-CJnu1687.js","names":[],"sources":["../src/adapters/line_logger.ts","../src/adapters/filesystem_logger.ts","../src/adapters/http_logger.ts","../src/adapters/noop_logger.ts","../src/adapters/stderr_logger.ts","../src/adapters/tee_logger.ts","../src/adapters/filesystem_store.ts"],"sourcesContent":["/**\n * Shared line-oriented trajectory logger core.\n *\n * `filesystem_logger` and `stderr_logger` emit the same wire format (one JSON\n * object per line) and differ only in where the line goes. This module holds\n * the common span bookkeeping: `start_span` and `end_span` each emit a line;\n * `record` emits the event as written. When the caller supplies\n * `parent_span_id` in the span meta (the runner threads the true structural\n * parent through `RunContext`), that value is used verbatim, so span trees are\n * correct even for concurrent children under `parallel`/`map`. Only when no\n * parent is supplied does the logger fall back to an in-memory stack of\n * still-open spans, which is best-effort under concurrency.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\n/**\n * Create a `TrajectoryLogger` that writes one JSON object per line via\n * `write_line`.\n */\nexport function line_logger(write_line: (event: Record<string, unknown>) => void): TrajectoryLogger {\n const stack: string[] = []\n\n const start_span: TrajectoryLogger['start_span'] = (name, meta) => {\n const span_id = `${name}:${randomUUID().slice(0, 8)}`\n const event: Record<string, unknown> = { kind: 'span_start', span_id, name, ...meta }\n if (event['parent_span_id'] === undefined && stack.length > 0) {\n event['parent_span_id'] = stack[stack.length - 1]\n }\n write_line(event)\n stack.push(span_id)\n return span_id\n }\n\n const end_span: TrajectoryLogger['end_span'] = (id, meta) => {\n write_line({ kind: 'span_end', span_id: id, ...meta })\n const idx = stack.lastIndexOf(id)\n if (idx !== -1) stack.splice(idx, 1)\n }\n\n const record: TrajectoryLogger['record'] = (event) => {\n write_line({ ...event })\n }\n\n return { record, start_span, end_span }\n}\n","/**\n * Filesystem JSONL trajectory logger.\n *\n * Appends one JSON object per line to a configured output file. Span\n * bookkeeping (including the `parent_span_id` handling that keeps span trees\n * correct for concurrent children under `parallel`/`map`) lives in\n * `line_logger`. Two concurrent `run(...)` calls that pass distinct logger\n * instances (constructed with distinct `output_path`s) share nothing.\n *\n * Paths are accepted at construction; the logger never reads `process.env`.\n */\n\nimport { appendFileSync, mkdirSync } from 'node:fs'\nimport { dirname } from 'node:path'\nimport type { TrajectoryLogger } from '#core'\nimport { line_logger } from './line_logger.js'\n\nexport type FilesystemLoggerOptions = {\n readonly output_path: string\n}\n\n/**\n * Create a `TrajectoryLogger` that appends one JSON object per line to\n * `output_path`, creating the parent directory if needed.\n */\nexport function filesystem_logger(options: FilesystemLoggerOptions): TrajectoryLogger {\n const { output_path } = options\n mkdirSync(dirname(output_path), { recursive: true })\n\n return line_logger((event) => {\n appendFileSync(output_path, `${JSON.stringify(event)}\\n`)\n })\n}\n","/**\n * HTTP push trajectory logger.\n *\n * Conforms to `TrajectoryLogger`. POSTs each event as a single line of\n * newline-delimited JSON to a configured URL. Pairs naturally with the\n * fascicle viewer's `/api/ingest` endpoint, but is a generic adapter: the\n * receiver can be anything that accepts NDJSON over HTTP.\n *\n * Failure policy: drop on transport error and invoke the optional `on_error`\n * callback. Never throws, never blocks the user's flow on a dev tool being\n * up. The flow always wins; the viewer is best-effort.\n *\n * Hierarchical span ids are tracked in-process, mirroring `filesystem_logger`\n * so the wire format is identical.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\nexport type HttpLoggerFetch = (\n url: string,\n init: { method: 'POST'; headers: Record<string, string>; body: string },\n) => Promise<{ ok: boolean; status: number }>\n\nexport type HttpLoggerOptions = {\n readonly url: string\n readonly fetch?: HttpLoggerFetch\n readonly on_error?: (err: unknown) => void\n}\n\n/**\n * Default `HttpLoggerFetch`, backed by the global `fetch`.\n */\nconst default_fetch: HttpLoggerFetch = async (url, init) => {\n const res = await fetch(url, init)\n return { ok: res.ok, status: res.status }\n}\n\n/**\n * Create a `TrajectoryLogger` that POSTs each event as NDJSON to\n * `options.url`.\n *\n * Never throws: a transport failure is dropped and reported through the\n * optional `on_error` callback, so a dev viewer being unreachable never\n * blocks the flow.\n */\nexport function http_logger(options: HttpLoggerOptions): TrajectoryLogger {\n const { url, on_error } = options\n const send = options.fetch ?? default_fetch\n const stack: string[] = []\n\n const post = (event: Record<string, unknown>): void => {\n const body = `${JSON.stringify(event)}\\n`\n void send(url, {\n method: 'POST',\n headers: { 'content-type': 'application/x-ndjson' },\n body,\n })\n .then((res) => {\n if (!res.ok && on_error) on_error(new Error(`http_logger: POST ${url} -> ${res.status}`))\n })\n .catch((err: unknown) => {\n if (on_error) on_error(err)\n })\n }\n\n const start_span: TrajectoryLogger['start_span'] = (name, meta) => {\n const span_id = `${name}:${randomUUID().slice(0, 8)}`\n const event: Record<string, unknown> = { kind: 'span_start', span_id, name, ...meta }\n // Prefer the caller-threaded structural parent; fall back to the open-span\n // stack only when none was supplied (best-effort under concurrency).\n if (event['parent_span_id'] === undefined && stack.length > 0) {\n event['parent_span_id'] = stack[stack.length - 1]\n }\n post(event)\n stack.push(span_id)\n return span_id\n }\n\n const end_span: TrajectoryLogger['end_span'] = (id, meta) => {\n post({ kind: 'span_end', span_id: id, ...meta })\n const idx = stack.lastIndexOf(id)\n if (idx !== -1) stack.splice(idx, 1)\n }\n\n const record: TrajectoryLogger['record'] = (event) => {\n post({ ...event })\n }\n\n return { record, start_span, end_span }\n}\n","/**\n * No-op trajectory logger.\n *\n * Satisfies `TrajectoryLogger` from `core` without emitting any\n * output. Used as the default when no logger is supplied to `run(...)` and as\n * a cheap fallback in tests that do not care about trajectory output.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport type { TrajectoryLogger } from '#core'\n\n/**\n * Create a `TrajectoryLogger` whose methods do nothing.\n */\nexport function noop_logger(): TrajectoryLogger {\n return {\n record: () => {},\n start_span: (name) => `${name}:${randomUUID().slice(0, 8)}`,\n end_span: () => {},\n }\n}\n","/**\n * Stderr JSONL trajectory logger.\n *\n * Writes one JSON object per line to stderr (or an injected stream), leaving\n * stdout untouched. This is the blessed console logger for agents that run as\n * somebody's child process: under the stdio agent contract, stdout carries the\n * result envelope and belongs to the parent, so trajectory must go elsewhere.\n * The wire format is identical to `filesystem_logger`, so captured stderr is a\n * valid trajectory JSONL file (`2>events.jsonl`) the viewer parses unchanged.\n *\n * Writes never throw: a broken pipe or closed stream drops the event rather\n * than failing the flow.\n */\n\nimport type { TrajectoryLogger } from '#core'\nimport { line_logger } from './line_logger.js'\n\nexport type StderrLoggerOptions = {\n readonly stream?: { write(chunk: string): unknown }\n}\n\n/**\n * Create a `TrajectoryLogger` that writes one JSON object per line to\n * stderr, or to `options.stream` when supplied.\n */\nexport function stderr_logger(options: StderrLoggerOptions = {}): TrajectoryLogger {\n const stream = options.stream ?? process.stderr\n return line_logger((event) => {\n try {\n stream.write(`${JSON.stringify(event)}\\n`)\n } catch {\n // Never throw from a logger; the flow always wins.\n }\n })\n}\n","/**\n * tee_logger: fan one TrajectoryLogger contract out to many sinks.\n *\n * Each sink receives every record/start_span/end_span call. Sinks are called\n * in registration order and exceptions in one sink do not prevent the others\n * from receiving the event.\n *\n * The first sink's `start_span` return value is treated as canonical and\n * returned to the caller; the tee remembers each sink's per-sink id so that\n * `end_span(canonical_id, ...)` translates back to the right id for each sink.\n * Within any one sink the wire format stays internally consistent; only the\n * across-sink ids may differ.\n */\n\nimport type { TrajectoryLogger } from '#core'\n\n/**\n * Create a `TrajectoryLogger` that fans every call out to `loggers`.\n */\nexport function tee_logger(...loggers: ReadonlyArray<TrajectoryLogger>): TrajectoryLogger {\n if (loggers.length === 0) {\n throw new Error('tee_logger: at least one logger required')\n }\n\n const id_map = new Map<string, ReadonlyArray<string>>()\n\n const safe_each = (fn: (l: TrajectoryLogger, idx: number) => void): void => {\n for (let i = 0; i < loggers.length; i += 1) {\n const l = loggers[i]\n if (l === undefined) continue\n try {\n fn(l, i)\n } catch {\n // best-effort fan-out: a misbehaving sink must not derail the others\n }\n }\n }\n\n return {\n record: (event) => {\n safe_each((l) => l.record(event))\n },\n start_span: (name, meta) => {\n const ids: string[] = []\n safe_each((l) => {\n ids.push(l.start_span(name, meta))\n })\n const canonical = ids[0] ?? `${name}:tee`\n if (loggers.length > 1) id_map.set(canonical, ids)\n return canonical\n },\n end_span: (id, meta) => {\n const ids = id_map.get(id)\n if (ids === undefined) {\n safe_each((l) => l.end_span(id, meta))\n return\n }\n id_map.delete(id)\n safe_each((l, idx) => l.end_span(ids[idx] ?? id, meta))\n },\n }\n}\n","/**\n * Filesystem-backed checkpoint store.\n *\n * Satisfies `CheckpointStore` from `core`. Each key is stored as\n * a JSON file under the configured root directory. Writes are all-or-nothing:\n * values are written to a temporary sibling file and then atomically renamed\n * into place, so an interrupted write never leaves a partially-written file\n * at the target key. On `get`, a missing file, a partial temp file that was\n * never atomically renamed, or a JSON parse failure each read as a cache\n * miss (returning `null`) rather than an error.\n *\n * Paths are accepted at construction; the store never reads `process.env`.\n */\n\nimport { createHash, randomUUID } from 'node:crypto'\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport type { CheckpointStore } from '#core'\n\nexport type FilesystemStoreOptions = {\n readonly root_dir: string\n}\n\n/**\n * Turn a checkpoint key into a filesystem-safe filename.\n *\n * Slugs the key down to `[a-zA-Z0-9._-]` and appends a short hash of the\n * full key, so two keys that slug to the same string still land on distinct\n * files.\n */\nfunction safe_filename(key: string): string {\n const hash = createHash('sha256').update(key).digest('hex').slice(0, 12)\n const slug = key.replace(/[^a-zA-Z0-9._-]/g, '_').slice(0, 64)\n return `${slug}.${hash}.json`\n}\n\n/**\n * Create a `CheckpointStore` backed by JSON files under `options.root_dir`.\n */\nexport function filesystem_store(options: FilesystemStoreOptions): CheckpointStore {\n const { root_dir } = options\n\n const ensure_root = async (): Promise<void> => {\n await mkdir(root_dir, { recursive: true })\n }\n\n const path_for = (key: string): string => join(root_dir, safe_filename(key))\n\n const get = async (key: string): Promise<unknown> => {\n const path = path_for(key)\n let raw: string\n try {\n raw = await readFile(path, 'utf8')\n } catch {\n return null\n }\n try {\n return JSON.parse(raw) as unknown\n } catch {\n return null\n }\n }\n\n const set = async (key: string, value: unknown): Promise<void> => {\n await ensure_root()\n const target = path_for(key)\n const tmp = `${target}.${randomUUID().slice(0, 8)}.tmp`\n await writeFile(tmp, JSON.stringify(value), 'utf8')\n await rename(tmp, target)\n }\n\n const delete_key = async (key: string): Promise<void> => {\n const target = path_for(key)\n await rm(target, { force: true })\n }\n\n return { get, set, delete: delete_key }\n}\n"],"mappings":"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"}
|