agentfootprint 10.2.0 → 10.3.1

package/dist/types/answer-validation/outputSchema.d.ts

@@ -0,0 +1,207 @@
+/**
+ * outputSchema — declarative terminal contract for an Agent's final answer.
+ *
+ * The Block A6 piece. Lets a consumer say:
+ *
+ *   "Whatever this agent says at the end of a run, it MUST be JSON
+ *    matching this Zod (or Zod-like) schema. Auto-instruct the LLM,
+ *    parse + validate the final answer for me."
+ *
+ * Why a typed contract matters: agentic code that calls an LLM and
+ * then JSON.parses the string answer is brittle. The schema serves
+ * three jobs at once:
+ *
+ *   1. **Instruction**: a system-prompt sentence telling the LLM the
+ *      output shape (auto-generated from `schema.description` /
+ *      JSON-schema introspection where available, or from a consumer-
+ *      supplied `instruction` override).
+ *
+ *   2. **Validation**: a `parser.parse(rawString)` step on the run's
+ *      final answer, throwing `OutputSchemaError` on parse / shape
+ *      failure rather than returning malformed data.
+ *
+ *   3. **Type narrowing**: `agent.runTyped({...})` returns the inferred
+ *      shape `T` instead of `string`, so callers stop reaching for
+ *      `as MyType` casts.
+ *
+ * Pattern: Strategy (GoF) over the parser interface; structural
+ *          duck-typing (Zod / Valibot / ArkType / hand-written —
+ *          anything with a `parse(unknown): T` method satisfies it).
+ *
+ * Role:    Layer-6 (Agent) — terminal contract on the run output.
+ *          NOT a context-engineering Injection per se, but composes
+ *          with the InjectionEngine (auto-injects an Instruction).
+ *
+ * @example  zod schema
+ *   import { z } from 'zod';
+ *   const Output = z.object({ status: z.enum(['ok', 'err']), items: z.array(z.string()) });
+ *
+ *   const agent = Agent.create({ ... })
+ *     .system('You answer support tickets.')
+ *     .outputSchema(Output)
+ *     .build();
+ *
+ *   const typed = await agent.runTyped({ message: 'list pending tickets' });
+ *   typed.status; // narrowed to 'ok' | 'err'
+ *
+ * @example  valibot / arktype / hand-written parser
+ *   const Output = { parse(v: unknown): MyType { ... } };
+ *   const agent = Agent.create({...}).outputSchema(Output, { instruction: '...' }).build();
+ */
+/**
+ * Minimum shape any validation library must expose to satisfy
+ * `outputSchema`. Covers Zod (`schema.parse`), Valibot
+ * (`v.parse(schema, value)` — pass `{ parse: v => v.parse(schema, v) }`),
+ * ArkType (`type.assert`), and hand-written parsers.
+ *
+ * Implementations MUST throw on validation failure (the runtime
+ * catches the throw, wraps it in `OutputSchemaError`, and emits the
+ * diagnostic event).
+ */
+export interface OutputSchemaParser<T> {
+    parse(value: unknown): T;
+    /**
+     * Human-readable description of the output shape. Used by
+     * `outputSchema` to auto-build the system-prompt instruction when
+     * `opts.instruction` is not provided. Zod schemas expose this via
+     * `.describe('...')`; consumers can attach the field directly on
+     * hand-written parsers.
+     */
+    readonly description?: string;
+}
+/**
+ * How the schema reaches the model.
+ *
+ *   • `'instruct'` (default) — the shape is described in the system prompt
+ *     and the model is asked for JSON. Works on every provider, because it
+ *     is only words.
+ *   • `'tool-forced'` — the shape is presented as a synthetic tool and the
+ *     provider's tool choice is FORCED to it, so generation is constrained
+ *     at the source instead of requested in prose. Requires a provider that
+ *     declares `carriesForcedToolChoice` and permits the selected model
+ *     through its optional `supportsForcedToolChoice`; a provider that does not is
+ *     refused BY NAME at run start rather than quietly downgraded, because
+ *     a strategy that silently falls back to the other one is config that
+ *     lies.
+ *   • `'native'` — the provider's own structured output: the schema rides the
+ *     request as Anthropic's `output_config.format` (`{ type: 'json_schema',
+ *     schema }`) and the model's text answer is decoded under it. Unlike
+ *     `'tool-forced'` it keeps the agent's tools: the model may still call a
+ *     tool first, and answers in JSON when it answers. Requires a provider
+ *     that declares `carriesNativeOutputSchema` and permits the selected model
+ *     through its optional `supportsNativeOutputSchema`; the same refusal BY
+ *     NAME applies at run start. The schema sent is a wire copy made
+ *     API-compatible by `nativeOutputFormat.ts · nativeOutputFormat` (every
+ *     object closed with `additionalProperties: false`, the constraints the
+ *     API does not take moved into the description); a schema the API cannot
+ *     express is refused at build. The parser still judges every answer
+ *     against the full contract, and a `stop_reason` of `'refusal'`,
+ *     `'max_tokens'` or `'model_context_window_exceeded'` fails the attempt by
+ *     name even when the text parses (a refusal is not re-asked).
+ */
+export type OutputSchemaStrategy = 'instruct' | 'tool-forced' | 'native';
+/**
+ * Optional configuration for `outputSchema`.
+ */
+export interface OutputSchemaOptions {
+    /**
+     * Injection id for the auto-generated "respond with this shape"
+     * instruction. Defaults to `'output-schema'`. Override when you
+     * have multiple agents with different schemas in one process and
+     * want the diagnostic events to disambiguate.
+     */
+    readonly name?: string;
+    /**
+     * Custom system-prompt instruction text. Defaults to a generic
+     * "Respond with valid JSON matching the output schema. Do not
+     * include prose." sentence (extended with `parser.description`
+     * when present). Override when the LLM benefits from a
+     * domain-specific framing.
+     */
+    readonly instruction?: string;
+    /**
+     * How many corrective re-asks the run may spend when the final answer
+     * fails the schema. Default `0` — the historical behaviour, where the
+     * first answer is the only answer and `runTyped()` throws on a bad one.
+     *
+     * Each retry is a REAL turn: the failed answer and an authored corrective
+     * message join the conversation, the ReAct loop re-enters, and the next
+     * attempt gets its own `llm_start`/`llm_end` bracket and its own
+     * `cost.tick` against `costBudget`. A retry therefore consumes one
+     * iteration of the agent's budget, the same way a tool call does.
+     *
+     * When the cap is spent the last answer stands and `runTyped()` throws
+     * `OutputSchemaError` exactly as it always has — `.outputFallback()`
+     * composes on top, unchanged.
+     */
+    readonly retries?: number;
+    /**
+     * How the schema reaches the model. Default `'instruct'`.
+     * See {@link OutputSchemaStrategy}.
+     */
+    readonly strategy?: OutputSchemaStrategy;
+    /**
+     * The JSON Schema for the synthetic tool (`strategy: 'tool-forced'`) or
+     * for the provider's structured output (`strategy: 'native'`), required by
+     * both unless the parser can produce one itself
+     * (a `toJsonSchema()` method, which ArkType has). The library will not
+     * infer a shape from a `parse()` function — guessing what your schema
+     * means is not a thing it gets to do.
+     *
+     * @example  `'native'` on Anthropic
+     *   .outputSchema(Verdict, {
+     *     strategy: 'native',
+     *     retries: 1,
+     *     jsonSchema: {
+     *       type: 'object',
+     *       properties: { status: { type: 'string', enum: ['ok', 'err'] } },
+     *       required: ['status'],
+     *     },
+     *   })
+     *
+     * This value and the parser CAN disagree. Nothing here prevents that,
+     * and nothing needs to: the forced shape satisfies the wire, the parser
+     * still judges the answer, and a disagreement surfaces as an ordinary
+     * validation failure that the retry loop corrects using the validator's
+     * own words. The schema constrains generation; the parser remains the
+     * judge.
+     */
+    readonly jsonSchema?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Thrown by `agent.parseOutput(...)` / `agent.runTyped(...)` when the
+ * agent's final answer fails JSON parsing OR schema validation.
+ *
+ * `cause` carries the underlying parse error (Zod's ZodError, etc.).
+ * `rawOutput` carries the agent's untyped string output so callers
+ * can log / persist the failed response for triage.
+ */
+export declare class OutputSchemaError extends Error {
+    readonly rawOutput: string;
+    readonly stage: 'json-parse' | 'schema-validate';
+    readonly cause?: unknown;
+    constructor(message: string, opts: {
+        rawOutput: string;
+        stage: 'json-parse' | 'schema-validate';
+        cause?: unknown;
+    });
+}
+/**
+ * Default instruction template — used when `opts.instruction` is not
+ * provided. Concatenates the parser's `.description` (if present) so
+ * Zod schemas authored with `.describe('...')` propagate naturally.
+ */
+export declare function buildDefaultInstruction(parser: OutputSchemaParser<unknown>): string;
+/**
+ * Parse + validate a raw string answer against a parser. Used by
+ * `agent.parseOutput()` / `agent.runTyped()`. Centralized here so
+ * both call sites share identical error-mapping behavior.
+ *
+ * Two-stage error reporting:
+ *   - JSON parse failure → `stage: 'json-parse'` (LLM emitted prose
+ *     or malformed JSON)
+ *   - Schema validation failure → `stage: 'schema-validate'` (JSON
+ *     was valid but didn't match the contracted shape)
+ */
+export declare function applyOutputSchema<T>(raw: string, parser: OutputSchemaParser<T>): T;
+//# sourceMappingURL=outputSchema.d.ts.map

package/dist/types/answer-validation/outputSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputSchema.d.ts","sourceRoot":"","sources":["../../../src/answer-validation/outputSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAAC;IACjD,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQxF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,MAAM,CAOnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAmBlF"}

package/dist/types/answer-validation/validate.d.ts

@@ -1,5 +1,5 @@
 /** One explicit JSON-answer validation; the runner owns when to invoke it. */
-import { type OutputSchemaParser } from '../core/outputSchema.js';
+import { type OutputSchemaParser } from './outputSchema.js';
 import type { ArtifactScope, ArtifactStore } from '../artifacts/types.js';
 import type { AnswerValidationOptions, AnswerValidationReport, ResolvedAnswerValidation } from './types.js';
 /** Validate and snapshot an authored contract once, before running an agent. */

package/dist/types/answer-validation/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/answer-validation/validate.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,KAAK,EAGV,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAkBpB,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EACjD,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,wBAAwB,CAkC1B;AAmDD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,EACnC,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,sBAAsB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgH/D"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/answer-validation/validate.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,KAAK,EAGV,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAkBpB,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EACjD,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,wBAAwB,CAkC1B;AAmDD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,EACnC,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,sBAAsB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgH/D"}

package/dist/types/artifacts/datasetResult.d.ts

@@ -1,5 +1,5 @@
 /** Declared datasets -> scope-bound artifacts. No transport, row discovery or domain vocabulary. */
-import type { Tool } from '../core/tools.js';
+import type { Tool } from '../tools/tools.js';
 import type { ToolArtifactPutInput, ToolArtifacts } from './capability.js';
 import { type ArtifactMeta } from './types.js';
 /** Producer-owned payloads. A source is an optional artifact, not an inferred fact. */

package/dist/types/artifacts/datasetResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datasetResult.d.ts","sourceRoot":"","sources":["../../../src/artifacts/datasetResult.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAOrE,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAED,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CAAA;CAAE,CAAC;AAEpG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED,sGAAsG;AACtG,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,OAAO;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,OAAO,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,oBAAoB,CACnC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAG,OAAO,EACjB,UAAU,GAAG,OAAO;IAEpB,iFAAiF;IACjF,QAAQ,CACN,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,KAAK,GACV,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAAC;CACnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAC7D,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAC1B,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,GACxD,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC,CAwBnC;AAED,sGAAsG;AACtG,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,SAAS,EAAE,aAAa,GACvB,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAmBxC"}
+{"version":3,"file":"datasetResult.d.ts","sourceRoot":"","sources":["../../../src/artifacts/datasetResult.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAIrE,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAED,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CAAA;CAAE,CAAC;AAEpG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED,sGAAsG;AACtG,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,OAAO;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,OAAO,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,oBAAoB,CACnC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAG,OAAO,EACjB,UAAU,GAAG,OAAO;IAEpB,iFAAiF;IACjF,QAAQ,CACN,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,KAAK,GACV,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAAC;CACnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAC7D,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAC1B,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,GACxD,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC,CAwBnC;AAED,sGAAsG;AACtG,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,SAAS,EAAE,aAAa,GACvB,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAmBxC"}

package/dist/types/artifacts/index.d.ts

@@ -25,5 +25,5 @@ export { recordingPutInput, RECORDING_ARTIFACT_KIND, RECORDING_MEDIA_TYPE, CHART
 export { artifactStoreConformance, formatArtifactStoreReport, runArtifactStoreCase, runArtifactStoreConformance, type ArtifactConformanceKit, type ArtifactStoreCase, type ArtifactStoreCaseName, type ArtifactStoreHarness, type ArtifactStoreHarnessHook, type ArtifactStoreMember, type ArtifactStoreOutcome, type ArtifactStoreReport, } from './conformance/index.js';
 export { assertArtifactPlacement, isPlacedToolResult, placedResultKind, placedToolResult, type ArtifactPlacement, type PlacedToolResult, } from './placement.js';
 export { withDatasetArtifacts, stageDatasetArtifacts, type DatasetArtifactInput, type DatasetArtifactReceipt, type DatasetPublication, type DatasetResultAdapter, type DatasetResultPlan, } from './datasetResult.js';
-export { describeTimeAxis, normaliseInstants, readTimeAxis, timeAxisIssues, TIME_AXIS_AGGREGATES, TIME_AXIS_UNITS, type AxisCounts, type AxisOverlapNote, type AxisPoint, type AxisPrecision, type DatasetTimeAxis, type NaiveValues, type NormalisedAxis, type NormaliseOptions, type TimeAxisAggregate, type TimeAxisReading, type TimeAxisUnit, } from '../core/time/axis.js';
+export { describeTimeAxis, normaliseInstants, readTimeAxis, timeAxisIssues, TIME_AXIS_AGGREGATES, TIME_AXIS_UNITS, type AxisCounts, type AxisOverlapNote, type AxisPoint, type AxisPrecision, type DatasetTimeAxis, type NaiveValues, type NormalisedAxis, type NormaliseOptions, type TimeAxisAggregate, type TimeAxisReading, type TimeAxisUnit, } from '../time/axis.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/artifacts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/artifacts/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/artifacts/index.ts"],"names":[],"mappings":"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"}

package/dist/types/artifacts/types.d.ts

@@ -39,7 +39,7 @@
  * the two things streaming costs you (a stated `bytes`, and no digest).
  */
 import type { MemoryIdentity } from '../memory/identity/types.js';
-import type { DatasetTimeAxis } from '../core/time/axis.js';
+import type { DatasetTimeAxis } from '../time/axis.js';
 /**
  * The isolation tuple every artifact call presents — the SAME tuple memory
  * scopes on (`{ tenant?, principal?, conversationId }`), under a name that
@@ -104,7 +104,7 @@ export interface ArtifactMeta {
     /** The rows' TIME AXIS as the producer declared it — which column is time,
      *  how its values are written, and how each row summarises its interval.
      *  Validated at mint (a malformed one is refused, never repaired); absent =
-     *  undeclared, and a consumer keeps its own heuristic. See `core/time/axis.ts`. */
+     *  undeclared, and a consumer keeps its own heuristic. See `time/axis.ts`. */
     readonly timeAxis?: DatasetTimeAxis;
     /** Unix ms when the artifact was stored. */
     readonly createdAt: number;

package/dist/types/artifacts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/artifacts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;uEACuE;AACvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B;;oCAEgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;0DAEsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;iFAE6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7C;;;uFAGmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;yEACyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;CACrC;AAED,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;AAEpE,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC9C;AAED;;;;;;;;sEAQsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE/E;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAE3E;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAE5E;4CACwC;IACxC,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D,uDAAuD;IACvD,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEvF;;;;;;;;OAQG;IACH,SAAS,CAAC,CACR,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,sBAAsB,EAC7B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CAC1F;AAID;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,2BAAqC;IAClD,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;gBAEhC,UAAU,EAAE,SAAS,WAAW,EAAE;CAU/C;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,2BAAqC;IAClD,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAa/D;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,yBAAmC;gBAEpC,MAAM,EAAE,MAAM;CAI3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/artifacts/types.ts"],"names":[],"mappings":"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"}

package/dist/types/bug-report/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/bug-report/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AAUH,OAAO,KAAK,EACV,SAAS,EAIT,cAAc,EACd,iBAAiB,EAIjB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAknBpB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAyCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAWnB;AAoCD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,sBAAsB,GAAG,SAAS,CA4EjG;AAMD,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAErE;AAED,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7C"}

package/dist/types/bug-report/envelope.d.ts

@@ -0,0 +1,80 @@
+/**
+ * stampConversation — put the bundle's evidence in the archive contract, or
+ * say in one sentence why it could not be.
+ *
+ * The repo has ONE archive contract (`RecordingEnvelope`) and several
+ * presentations over it. This bundle used to be an exception: it packed a bare
+ * `recording.json` plus an `environment.json` that repeated the producer facts
+ * the envelope already stamps, so the same two versions were written by two
+ * different pieces of code with no relationship between them. This is the fold
+ * — the envelope is BUILT here, never re-implemented, so every rule it enforces
+ * (identity is never invented, `droppedEvents` is proven or refused, an
+ * incomplete recording gets no `endedAt`) arrives whole.
+ *
+ * ## Why a refusal is a return value here, not a throw
+ *
+ * `persistRecording` throws when a run fact is indeterminate, and it is right
+ * to: its caller asked for an ARCHIVE, and an archive stamped with a guess is
+ * worse than none. A bug report's caller asked for something else — the
+ * evidence, in a zip, so a maintainer can open it. Throwing would leave that
+ * person with no bundle at all because the library could not name a start time.
+ *
+ * So the refusal travels instead of stopping the export: this returns the
+ * REASON, the bundle carries the bare recording under its own honest name, and
+ * the manifest states which fact was missing and the one line that supplies it.
+ * Nothing is stamped that was not known — which is the rule the throw exists to
+ * keep — and the report still gets filed.
+ *
+ * @internal Not a public export; `exportBugReport` is the door.
+ */
+import { type RecordingEnvelope, type RecordingSource } from '../recorders/observability/recordingEnvelope.js';
+import type { BugReportRunFacts } from './types.js';
+/**
+ * One recording, plus the one thing only the CALL SITE knows about it: whether
+ * the thing we were handed can count its own dropped events.
+ */
+export interface EnvelopeSource {
+    /** What `buildRecordingEnvelope` reads: a live handle, or a bare recording. */
+    readonly source: RecordingSource;
+    /**
+     * `true` for a live `recordRun` handle — it counts what the `maxEvents` cap
+     * discarded, so nothing the caller states may override it.
+     */
+    readonly countsDrops: boolean;
+}
+/**
+ * The result for ONE conversation: every recording enveloped, or none of them
+ * and the reason.
+ *
+ * All-or-nothing on purpose. A conversation file holding two envelopes and one
+ * bare recording would need a reader to check each entry's shape before it
+ * could read any of them, and a file whose shape depends on its contents is the
+ * kind of archive this program exists to stop producing.
+ */
+export interface StampedConversation {
+    /** In the recordings' own order. Absent when {@link refusal} is present. */
+    readonly envelopes?: readonly RecordingEnvelope[];
+    /** One sentence naming the missing fact and how to supply it. */
+    readonly refusal?: string;
+    /**
+     * The envelope field that could not be determined — `'complete'` when the
+     * reporter stated no run facts at all.
+     *
+     * The caller needs it to know whether the fix is even available at this door:
+     * `complete` and `droppedEvents` are stated HERE, while `startedAt` and the
+     * identity fields are read from the recording's own events, so a refusal
+     * naming one of those has to be fixed at recording time.
+     */
+    readonly field?: string;
+}
+/**
+ * Envelope every recording of one conversation.
+ *
+ * @param sources  the conversation's recordings, in order, each with whether it
+ *                 can prove its own drop count.
+ * @param facts    what the reporter stated. `undefined` — the default, since
+ *                 `run` is optional on both entry points — is itself a refusal
+ *                 reason, and a named one.
+ */
+export declare function stampConversation(sources: readonly EnvelopeSource[], facts: BugReportRunFacts | undefined): StampedConversation;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/types/bug-report/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/bug-report/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GACnC,mBAAmB,CAoCrB"}

package/dist/types/bug-report/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bug-report/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EACV,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/bug-report/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/bug-report/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AASH,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;4DAGwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEN,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C;AAgBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,UAAU,GAAG,SAAS,CAsFnF"}