markform 0.1.18 → 0.1.20

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 
-import { $ as HarnessConfigSchema, $n as TableValueSchema, $t as SetDatePatch, A as ExecutionPlan, An as SourceRangeSchema, Ar as YearValueSchema, At as Patch, B as FieldPriorityLevel, Bn as StringValueSchema, Bt as QualifiedOptionRef, C as DateFieldSchema, Cn as SingleSelectField, Cr as WireToolCall, Ct as NumberValue, D as DocumentationBlockSchema, Dn as SourcePosition, Dr as YearField, Dt as OptionIdSchema, E as DocumentationBlock, En as SingleSelectValueSchema, Er as WireToolResultSchema, Et as OptionId, F as FieldBase, Fn as StringListField, Ft as ProgressState, G as FieldSchema, Gn as TableColumnSchema, Gt as SessionTranscript, H as FieldProgressSchema, Hn as StructureSummarySchema, Ht as RunModeSchema, I as FieldGroup, In as StringListFieldSchema, It as ProgressStateSchema, J as FillMode, Jn as TableRowPatch, Jt as SessionTurnContext, K as FieldValue, Kn as TableField, Kt as SessionTranscriptSchema, L as FieldGroupSchema, Ln as StringListValue, Lt as ProgressSummary, M as ExplicitCheckboxValue, Mn as StepResultSchema, Mt as PatchSchema, N as ExplicitCheckboxValueSchema, Nn as StringField, Nt as ProgressCounts, O as DocumentationTag, On as SourcePositionSchema, Or as YearFieldSchema, Ot as OptionSchema, P as Field, Pn as StringFieldSchema, Pt as ProgressCountsSchema, Q as HarnessConfig, Qn as TableValue, Qt as SetCheckboxesPatchSchema, R as FieldKind, Rn as StringListValueSchema, Rt as ProgressSummarySchema, S as DateField, Sn as SimpleCheckboxStateSchema, Sr as WireResponseStepSchema, St as NumberFieldSchema, T as DateValueSchema, Tn as SingleSelectValue, Tr as WireToolResult, Tt as Option, U as FieldResponse, Un as SyntaxStyle, Ut as SessionFinal, V as FieldProgress, Vn as StructureSummary, Vt as RunMode, W as FieldResponseSchema, Wn as TableColumn, Wt as SessionFinalSchema, X as FormSchemaSchema, Xn as TableRowResponse, Xt as SessionTurnStats, Y as FormSchema, Yn as TableRowPatchSchema, Yt as SessionTurnSchema, Z as FrontmatterHarnessConfig, Zn as TableRowResponseSchema, Zt as SetCheckboxesPatch, _ as CheckboxesValueSchema, _n as SetYearPatch, _r as WireRequestFormat, _t as MultiSelectValue, a as ApprovalMode, an as SetSingleSelectPatch, ar as UrlListValueSchema, at as InspectResult, b as ColumnTypeName, bn as SeveritySchema, br as WireResponseFormatSchema, bt as Note, c as CheckboxMode, cn as SetStringListPatchSchema, cr as ValidationIssue, ct as IssueReasonSchema, d as CheckboxProgressCountsSchema, dn as SetTablePatch, dr as ValidatorFn, dt as MarkformFrontmatter, en as SetDatePatchSchema, er as UrlField, et as Id, f as CheckboxValue, fn as SetTablePatchSchema, fr as ValidatorRef, ft as MarkformFrontmatterSchema, g as CheckboxesValue, gn as SetUrlPatchSchema, gr as WireFormatSchema, gt as MultiSelectFieldSchema, h as CheckboxesFieldSchema, hn as SetUrlPatch, hr as WireFormat, ht as MultiSelectField, i as ApplyResultSchema, in as SetNumberPatchSchema, ir as UrlListValue, it as InspectIssueSchema, j as ExecutionPlanItem, jn as StepResult, jt as PatchRejection, k as DocumentationTagSchema, kn as SourceRange, kr as YearValue, kt as ParsedForm, l as CheckboxModeSchema, ln as SetStringPatch, lr as ValidationIssueSchema, lt as IssueScope, m as CheckboxesField, mn as SetUrlListPatchSchema, mr as ValidatorRegistry, mt as MultiCheckboxStateSchema, n as AnswerStateSchema, nn as SetMultiSelectPatchSchema, nr as UrlListField, nt as IdSchema, o as CellResponse, on as SetSingleSelectPatchSchema, or as UrlValue, ot as InspectResultSchema, p as CheckboxValueSchema, pn as SetUrlListPatch, pr as ValidatorRefSchema, pt as MultiCheckboxState, q as FieldValueSchema, qn as TableFieldSchema, qt as SessionTurn, r as ApplyResult, rn as SetNumberPatch, rr as UrlListFieldSchema, rt as InspectIssue, s as CellResponseSchema, sn as SetStringListPatch, sr as UrlValueSchema, st as IssueReason, t as AnswerState, tn as SetMultiSelectPatch, tr as UrlFieldSchema, tt as IdIndexEntry, u as CheckboxProgressCounts, un as SetStringPatchSchema, ur as ValidatorContext, ut as IssueScopeSchema, v as ClearFieldPatch, vn as SetYearPatchSchema, vr as WireRequestFormatSchema, vt as MultiSelectValueSchema, w as DateValue, wn as SingleSelectFieldSchema, wr as WireToolCallSchema, wt as NumberValueSchema, x as ColumnTypeNameSchema, xn as SimpleCheckboxState, xr as WireResponseStep, xt as NumberField, y as ClearFieldPatchSchema, yn as Severity, yr as WireResponseFormat, yt as NodeType, z as FieldKindSchema, zn as StringValue, zt as QualifiedColumnRef } from "./coreTypes-BMEs8h_2.mjs";
+import { $ as HarnessConfigSchema, $n as TableValueSchema, $t as SetDatePatch, A as ExecutionPlan, An as SourceRangeSchema, Ar as YearValueSchema, At as Patch, B as FieldPriorityLevel, Bn as StringValueSchema, Bt as QualifiedOptionRef, C as DateFieldSchema, Cn as SingleSelectField, Cr as WireToolCall, Ct as NumberValue, D as DocumentationBlockSchema, Dn as SourcePosition, Dr as YearField, Dt as OptionIdSchema, E as DocumentationBlock, En as SingleSelectValueSchema, Er as WireToolResultSchema, Et as OptionId, F as FieldBase, Fn as StringListField, Ft as ProgressState, G as FieldSchema, Gn as TableColumnSchema, Gt as SessionTranscript, H as FieldProgressSchema, Hn as StructureSummarySchema, Ht as RunModeSchema, I as FieldGroup, In as StringListFieldSchema, It as ProgressStateSchema, J as FillMode, Jn as TableRowPatch, Jt as SessionTurnContext, K as FieldValue, Kn as TableField, Kt as SessionTranscriptSchema, L as FieldGroupSchema, Ln as StringListValue, Lt as ProgressSummary, M as ExplicitCheckboxValue, Mn as StepResultSchema, Mt as PatchSchema, N as ExplicitCheckboxValueSchema, Nn as StringField, Nt as ProgressCounts, O as DocumentationTag, On as SourcePositionSchema, Or as YearFieldSchema, Ot as OptionSchema, P as Field, Pn as StringFieldSchema, Pt as ProgressCountsSchema, Q as HarnessConfig, Qn as TableValue, Qt as SetCheckboxesPatchSchema, R as FieldKind, Rn as StringListValueSchema, Rt as ProgressSummarySchema, S as DateField, Sn as SimpleCheckboxStateSchema, Sr as WireResponseStepSchema, St as NumberFieldSchema, T as DateValueSchema, Tn as SingleSelectValue, Tr as WireToolResult, Tt as Option, U as FieldResponse, Un as SyntaxStyle, Ut as SessionFinal, V as FieldProgress, Vn as StructureSummary, Vt as RunMode, W as FieldResponseSchema, Wn as TableColumn, Wt as SessionFinalSchema, X as FormSchemaSchema, Xn as TableRowResponse, Xt as SessionTurnStats, Y as FormSchema, Yn as TableRowPatchSchema, Yt as SessionTurnSchema, Z as FrontmatterHarnessConfig, Zn as TableRowResponseSchema, Zt as SetCheckboxesPatch, _ as CheckboxesValueSchema, _n as SetYearPatch, _r as WireRequestFormat, _t as MultiSelectValue, a as ApprovalMode, an as SetSingleSelectPatch, ar as UrlListValueSchema, at as InspectResult, b as ColumnTypeName, bn as SeveritySchema, br as WireResponseFormatSchema, bt as Note, c as CheckboxMode, cn as SetStringListPatchSchema, cr as ValidationIssue, ct as IssueReasonSchema, d as CheckboxProgressCountsSchema, dn as SetTablePatch, dr as ValidatorFn, dt as MarkformFrontmatter, en as SetDatePatchSchema, er as UrlField, et as Id, f as CheckboxValue, fn as SetTablePatchSchema, fr as ValidatorRef, ft as MarkformFrontmatterSchema, g as CheckboxesValue, gn as SetUrlPatchSchema, gr as WireFormatSchema, gt as MultiSelectFieldSchema, h as CheckboxesFieldSchema, hn as SetUrlPatch, hr as WireFormat, ht as MultiSelectField, i as ApplyResultSchema, in as SetNumberPatchSchema, ir as UrlListValue, it as InspectIssueSchema, j as ExecutionPlanItem, jn as StepResult, jt as PatchRejection, k as DocumentationTagSchema, kn as SourceRange, kr as YearValue, kt as ParsedForm, l as CheckboxModeSchema, ln as SetStringPatch, lr as ValidationIssueSchema, lt as IssueScope, m as CheckboxesField, mn as SetUrlListPatchSchema, mr as ValidatorRegistry, mt as MultiCheckboxStateSchema, n as AnswerStateSchema, nn as SetMultiSelectPatchSchema, nr as UrlListField, nt as IdSchema, o as CellResponse, on as SetSingleSelectPatchSchema, or as UrlValue, ot as InspectResultSchema, p as CheckboxValueSchema, pn as SetUrlListPatch, pr as ValidatorRefSchema, pt as MultiCheckboxState, q as FieldValueSchema, qn as TableFieldSchema, qt as SessionTurn, r as ApplyResult, rn as SetNumberPatch, rr as UrlListFieldSchema, rt as InspectIssue, s as CellResponseSchema, sn as SetStringListPatch, sr as UrlValueSchema, st as IssueReason, t as AnswerState, tn as SetMultiSelectPatch, tr as UrlFieldSchema, tt as IdIndexEntry, u as CheckboxProgressCounts, un as SetStringPatchSchema, ur as ValidatorContext, ut as IssueScopeSchema, v as ClearFieldPatch, vn as SetYearPatchSchema, vr as WireRequestFormatSchema, vt as MultiSelectValueSchema, w as DateValue, wn as SingleSelectFieldSchema, wr as WireToolCallSchema, wt as NumberValueSchema, x as ColumnTypeNameSchema, xn as SimpleCheckboxState, xr as WireResponseStep, xt as NumberField, y as ClearFieldPatchSchema, yn as Severity, yr as WireResponseFormat, yt as NodeType, z as FieldKindSchema, zn as StringValue, zt as QualifiedColumnRef } from "./coreTypes-CkxML8g2.mjs";
+import { z } from "zod";
 import { LanguageModel, Tool } from "ai";
 
 //#region src/errors.d.ts
-
 /**
  * Structured error types for markform.
  *
@@ -170,7 +170,6 @@ declare const ParseError: typeof MarkformParseError;
 declare function parseForm(markdown: string): ParsedForm;
 //#endregion
 //#region src/engine/serialize.d.ts
-
 interface SerializeOptions {
   /** Markform spec version to use in frontmatter. Defaults to MF_SPEC_VERSION. */
   specVersion?: string;
@@ -862,6 +861,341 @@ declare class FormHarness {
  */
 declare function createHarness(form: ParsedForm, config?: Partial<HarnessConfig>): FormHarness;
 //#endregion
+//#region src/harness/fillRecord.d.ts
+/**
+ * Per-tool statistics with timing percentiles.
+ * Enables analysis like "web_search p95 is 2.5s" or "fill_form has 98% success rate"
+ */
+declare const ToolStatsSchema: z.ZodObject<{
+  toolName: z.ZodString;
+  callCount: z.ZodNumber;
+  successCount: z.ZodNumber;
+  failureCount: z.ZodNumber;
+  successRate: z.ZodNumber;
+  results: z.ZodOptional<z.ZodObject<{
+    totalResults: z.ZodNumber;
+    avgResultsPerCall: z.ZodNumber;
+    zeroResultCalls: z.ZodNumber;
+  }, z.core.$strip>>;
+  timing: z.ZodObject<{
+    totalMs: z.ZodNumber;
+    avgMs: z.ZodNumber;
+    minMs: z.ZodNumber;
+    maxMs: z.ZodNumber;
+    p50Ms: z.ZodNumber;
+    p95Ms: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type ToolStats = z.infer<typeof ToolStatsSchema>;
+/**
+ * Individual tool call in the timeline.
+ */
+declare const ToolCallRecordSchema: z.ZodObject<{
+  tool: z.ZodString;
+  startedAt: z.ZodString;
+  completedAt: z.ZodString;
+  durationMs: z.ZodNumber;
+  success: z.ZodBoolean;
+  input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  result: z.ZodOptional<z.ZodObject<{
+    resultCount: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ToolCallRecord = z.infer<typeof ToolCallRecordSchema>;
+/**
+ * Single turn in the fill timeline.
+ */
+declare const TimelineEntrySchema: z.ZodObject<{
+  turnNumber: z.ZodNumber;
+  order: z.ZodNumber;
+  executionId: z.ZodString;
+  startedAt: z.ZodString;
+  completedAt: z.ZodString;
+  durationMs: z.ZodNumber;
+  issuesAddressed: z.ZodNumber;
+  patchesApplied: z.ZodNumber;
+  patchesRejected: z.ZodNumber;
+  tokens: z.ZodObject<{
+    input: z.ZodNumber;
+    output: z.ZodNumber;
+  }, z.core.$strip>;
+  toolCalls: z.ZodArray<z.ZodObject<{
+    tool: z.ZodString;
+    startedAt: z.ZodString;
+    completedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+    success: z.ZodBoolean;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    result: z.ZodOptional<z.ZodObject<{
+      resultCount: z.ZodOptional<z.ZodNumber>;
+      error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type TimelineEntry = z.infer<typeof TimelineEntrySchema>;
+/**
+ * Breakdown item for visualization.
+ */
+declare const TimingBreakdownItemSchema: z.ZodObject<{
+  category: z.ZodEnum<{
+    llm: "llm";
+    tools: "tools";
+    overhead: "overhead";
+  }>;
+  label: z.ZodString;
+  ms: z.ZodNumber;
+  percentage: z.ZodNumber;
+}, z.core.$strip>;
+type TimingBreakdownItem = z.infer<typeof TimingBreakdownItemSchema>;
+/**
+ * Timing breakdown showing where time was spent.
+ */
+declare const TimingBreakdownSchema: z.ZodObject<{
+  totalMs: z.ZodNumber;
+  llmTimeMs: z.ZodNumber;
+  toolTimeMs: z.ZodNumber;
+  overheadMs: z.ZodNumber;
+  breakdown: z.ZodArray<z.ZodObject<{
+    category: z.ZodEnum<{
+      llm: "llm";
+      tools: "tools";
+      overhead: "overhead";
+    }>;
+    label: z.ZodString;
+    ms: z.ZodNumber;
+    percentage: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type TimingBreakdown = z.infer<typeof TimingBreakdownSchema>;
+/**
+ * Aggregated tool usage statistics.
+ */
+declare const ToolSummarySchema: z.ZodObject<{
+  totalCalls: z.ZodNumber;
+  successfulCalls: z.ZodNumber;
+  failedCalls: z.ZodNumber;
+  successRate: z.ZodNumber;
+  totalDurationMs: z.ZodNumber;
+  byTool: z.ZodArray<z.ZodObject<{
+    toolName: z.ZodString;
+    callCount: z.ZodNumber;
+    successCount: z.ZodNumber;
+    failureCount: z.ZodNumber;
+    successRate: z.ZodNumber;
+    results: z.ZodOptional<z.ZodObject<{
+      totalResults: z.ZodNumber;
+      avgResultsPerCall: z.ZodNumber;
+      zeroResultCalls: z.ZodNumber;
+    }, z.core.$strip>>;
+    timing: z.ZodObject<{
+      totalMs: z.ZodNumber;
+      avgMs: z.ZodNumber;
+      minMs: z.ZodNumber;
+      maxMs: z.ZodNumber;
+      p50Ms: z.ZodNumber;
+      p95Ms: z.ZodNumber;
+    }, z.core.$strip>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ToolSummary = z.infer<typeof ToolSummarySchema>;
+/**
+ * Execution metadata for the fill.
+ */
+declare const ExecutionMetadataSchema: z.ZodObject<{
+  totalTurns: z.ZodNumber;
+  parallelEnabled: z.ZodBoolean;
+  maxParallelAgents: z.ZodOptional<z.ZodNumber>;
+  orderLevels: z.ZodArray<z.ZodNumber>;
+  executionThreads: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ExecutionMetadata = z.infer<typeof ExecutionMetadataSchema>;
+/**
+ * Fill status enum.
+ */
+declare const FillRecordStatusSchema: z.ZodEnum<{
+  partial: "partial";
+  completed: "completed";
+  failed: "failed";
+  cancelled: "cancelled";
+}>;
+type FillRecordStatus = z.infer<typeof FillRecordStatusSchema>;
+/**
+ * Complete record of a form fill operation.
+ *
+ * Captures everything that happened during the fill for:
+ * - Provenance/corroboration
+ * - Cost analysis
+ * - Debugging
+ * - Analytics
+ */
+declare const FillRecordSchema: z.ZodObject<{
+  sessionId: z.ZodString;
+  startedAt: z.ZodString;
+  completedAt: z.ZodString;
+  durationMs: z.ZodNumber;
+  form: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    structure: z.ZodObject<{
+      groupCount: z.ZodNumber;
+      fieldCount: z.ZodNumber;
+      optionCount: z.ZodNumber;
+      fieldCountByKind: z.ZodRecord<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        string_list: "string_list";
+        url: "url";
+        url_list: "url_list";
+        single_select: "single_select";
+        multi_select: "multi_select";
+        checkboxes: "checkboxes";
+        date: "date";
+        year: "year";
+        table: "table";
+      }>, z.ZodNumber>;
+      groupsById: z.ZodRecord<z.ZodString, z.ZodLiteral<"field_group">>;
+      fieldsById: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        string: "string";
+        number: "number";
+        string_list: "string_list";
+        url: "url";
+        url_list: "url_list";
+        single_select: "single_select";
+        multi_select: "multi_select";
+        checkboxes: "checkboxes";
+        date: "date";
+        year: "year";
+        table: "table";
+      }>>;
+      optionsById: z.ZodRecord<z.ZodString, z.ZodObject<{
+        parentFieldId: z.ZodString;
+        parentFieldKind: z.ZodEnum<{
+          string: "string";
+          number: "number";
+          string_list: "string_list";
+          url: "url";
+          url_list: "url_list";
+          single_select: "single_select";
+          multi_select: "multi_select";
+          checkboxes: "checkboxes";
+          date: "date";
+          year: "year";
+          table: "table";
+        }>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  }, z.core.$strip>;
+  status: z.ZodEnum<{
+    partial: "partial";
+    completed: "completed";
+    failed: "failed";
+    cancelled: "cancelled";
+  }>;
+  statusDetail: z.ZodOptional<z.ZodString>;
+  formProgress: z.ZodObject<{
+    totalFields: z.ZodNumber;
+    requiredFields: z.ZodNumber;
+    unansweredFields: z.ZodNumber;
+    answeredFields: z.ZodNumber;
+    skippedFields: z.ZodNumber;
+    abortedFields: z.ZodNumber;
+    validFields: z.ZodNumber;
+    invalidFields: z.ZodNumber;
+    emptyFields: z.ZodNumber;
+    filledFields: z.ZodNumber;
+    emptyRequiredFields: z.ZodNumber;
+    totalNotes: z.ZodNumber;
+  }, z.core.$strip>;
+  llm: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    totalCalls: z.ZodNumber;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+  }, z.core.$strip>;
+  toolSummary: z.ZodObject<{
+    totalCalls: z.ZodNumber;
+    successfulCalls: z.ZodNumber;
+    failedCalls: z.ZodNumber;
+    successRate: z.ZodNumber;
+    totalDurationMs: z.ZodNumber;
+    byTool: z.ZodArray<z.ZodObject<{
+      toolName: z.ZodString;
+      callCount: z.ZodNumber;
+      successCount: z.ZodNumber;
+      failureCount: z.ZodNumber;
+      successRate: z.ZodNumber;
+      results: z.ZodOptional<z.ZodObject<{
+        totalResults: z.ZodNumber;
+        avgResultsPerCall: z.ZodNumber;
+        zeroResultCalls: z.ZodNumber;
+      }, z.core.$strip>>;
+      timing: z.ZodObject<{
+        totalMs: z.ZodNumber;
+        avgMs: z.ZodNumber;
+        minMs: z.ZodNumber;
+        maxMs: z.ZodNumber;
+        p50Ms: z.ZodNumber;
+        p95Ms: z.ZodNumber;
+      }, z.core.$strip>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+  timingBreakdown: z.ZodObject<{
+    totalMs: z.ZodNumber;
+    llmTimeMs: z.ZodNumber;
+    toolTimeMs: z.ZodNumber;
+    overheadMs: z.ZodNumber;
+    breakdown: z.ZodArray<z.ZodObject<{
+      category: z.ZodEnum<{
+        llm: "llm";
+        tools: "tools";
+        overhead: "overhead";
+      }>;
+      label: z.ZodString;
+      ms: z.ZodNumber;
+      percentage: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+  timeline: z.ZodArray<z.ZodObject<{
+    turnNumber: z.ZodNumber;
+    order: z.ZodNumber;
+    executionId: z.ZodString;
+    startedAt: z.ZodString;
+    completedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+    issuesAddressed: z.ZodNumber;
+    patchesApplied: z.ZodNumber;
+    patchesRejected: z.ZodNumber;
+    tokens: z.ZodObject<{
+      input: z.ZodNumber;
+      output: z.ZodNumber;
+    }, z.core.$strip>;
+    toolCalls: z.ZodArray<z.ZodObject<{
+      tool: z.ZodString;
+      startedAt: z.ZodString;
+      completedAt: z.ZodString;
+      durationMs: z.ZodNumber;
+      success: z.ZodBoolean;
+      input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      result: z.ZodOptional<z.ZodObject<{
+        resultCount: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  execution: z.ZodObject<{
+    totalTurns: z.ZodNumber;
+    parallelEnabled: z.ZodBoolean;
+    maxParallelAgents: z.ZodOptional<z.ZodNumber>;
+    orderLevels: z.ZodArray<z.ZodNumber>;
+    executionThreads: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  customData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type FillRecord = z.infer<typeof FillRecordSchema>;
+//#endregion
 //#region src/harness/harnessTypes.d.ts
 /**
  * Per-turn statistics from LLM calls.
@@ -875,27 +1209,19 @@ interface TurnStats {
   outputTokens?: number;
   /** Tool calls made during this turn */
   toolCalls: {
-    /** Tool name */
-    name: string;
-    /** Number of times called */
+    /** Tool name */name: string; /** Number of times called */
     count: number;
   }[];
   /** Form progress after this turn */
   formProgress: {
-    /** Fields with values */
-    answeredFields: number;
-    /** Fields marked as skipped */
-    skippedFields: number;
-    /** Required issues still remaining */
-    requiredRemaining: number;
-    /** Optional/recommended issues still remaining */
+    /** Fields with values */answeredFields: number; /** Fields marked as skipped */
+    skippedFields: number; /** Required issues still remaining */
+    requiredRemaining: number; /** Optional/recommended issues still remaining */
     optionalRemaining: number;
   };
   /** Full prompts sent to LLM (for verbose logging) */
   prompts?: {
-    /** System prompt with instructions */
-    system: string;
-    /** Context prompt with form state and issues */
+    /** System prompt with instructions */system: string; /** Context prompt with form state and issues */
     context: string;
   };
   /**
@@ -955,7 +1281,9 @@ interface FillCallbacks {
   /** Called when a turn begins */
   onTurnStart?(turn: {
     turnNumber: number;
-    issuesCount: number;
+    issuesCount: number; /** Field ordering level for parallel execution (can be negative) */
+    order: number; /** Execution thread ID (e.g., "0-serial", "1-batch-contacts-0") */
+    executionId: string;
   }): void;
   /** Called after inspect identifies issues for this turn (before agent generates patches) */
   onIssuesIdentified?(info: {
@@ -973,24 +1301,28 @@ interface FillCallbacks {
   /** Called before a tool executes */
   onToolStart?(call: {
     name: string;
-    input: unknown;
+    input: unknown; /** Execution thread ID for parallel tracking */
+    executionId: string;
   }): void;
   /** Called after a tool completes */
   onToolEnd?(call: {
     name: string;
     output: unknown;
     durationMs: number;
-    error?: string;
+    error?: string; /** Execution thread ID for parallel tracking */
+    executionId: string;
   }): void;
   /** Called before an LLM request */
   onLlmCallStart?(call: {
-    model: string;
+    model: string; /** Execution thread ID for parallel tracking */
+    executionId: string;
   }): void;
   /** Called after an LLM response */
   onLlmCallEnd?(call: {
     model: string;
     inputTokens: number;
-    outputTokens: number;
+    outputTokens: number; /** Execution thread ID for parallel tracking */
+    executionId: string;
   }): void;
   /** Called when a parallel batch starts execution */
   onBatchStart?(info: {
@@ -1011,6 +1343,18 @@ interface FillCallbacks {
     order: number;
     patchesApplied: number;
   }): void;
+  /**
+   * Called when a web search is performed.
+   *
+   * This provides access to the search query and result count for analytics and debugging.
+   * Note: Not all providers expose the exact query. When available, this is called.
+   */
+  onWebSearch?(info: {
+    /** The search query that was executed */query: string; /** Number of results returned (0 if none) */
+    resultCount: number; /** Provider that performed the search (e.g., "anthropic", "openai") */
+    provider: string; /** Execution thread ID for parallel tracking */
+    executionId: string;
+  }): void;
 }
 /**
  * Options for the fillForm function.
@@ -1108,6 +1452,22 @@ interface FillOptions {
    * per multi-turn session). Set to false for production use.
    */
   captureWireFormat: boolean;
+  /**
+   * Collect a complete FillRecord capturing all execution details.
+   *
+   * When true, the FillResult will include a `record` field containing:
+   * - Turn-by-turn timeline with token usage
+   * - Tool calls with timing and results
+   * - Aggregated statistics with percentiles
+   * - Execution metadata for parallel fills
+   *
+   * Useful for:
+   * - Cost analysis and billing
+   * - Debugging and troubleshooting
+   * - Analytics and optimization
+   * - Audit trails and provenance
+   */
+  recordFill: boolean;
 }
 /**
  * Progress information for each turn.
@@ -1169,6 +1529,13 @@ interface FillResult {
     severity: 'required' | 'recommended';
     priority: number;
   }[];
+  /**
+   * Complete fill record when recordFill option is enabled.
+   *
+   * Contains timeline, token usage, tool calls, and execution metadata.
+   * Useful for cost analysis, debugging, and analytics.
+   */
+  record?: FillRecord;
 }
 //#endregion
 //#region src/harness/mockAgent.d.ts
@@ -1355,6 +1722,132 @@ declare class ParallelHarness {
  */
 declare function createParallelHarness(form: ParsedForm, config?: ParallelHarnessConfig): ParallelHarness;
 //#endregion
+//#region src/harness/fillRecordCollector.d.ts
+interface FillRecordCollectorOptions {
+  /** Form metadata */
+  form: {
+    id: string;
+    title?: string;
+    description?: string;
+    structure: StructureSummary;
+  };
+  /** LLM provider name */
+  provider: string;
+  /** Model identifier */
+  model: string;
+  /** Whether parallel execution is enabled */
+  parallelEnabled?: boolean;
+  /** Maximum parallel agents */
+  maxParallelAgents?: number;
+  /** Custom data to include in record */
+  customData?: Record<string, unknown>;
+}
+/**
+ * Thread-safe collector for FillRecord data.
+ *
+ * Uses an append-only event log pattern for thread safety.
+ * Events are aggregated when getRecord() is called.
+ */
+declare class FillRecordCollector implements FillCallbacks {
+  private readonly startedAt;
+  private readonly sessionId;
+  private readonly form;
+  private readonly provider;
+  private readonly model;
+  private readonly parallelEnabled;
+  private readonly maxParallelAgents?;
+  private customData;
+  private events;
+  private explicitStatus?;
+  private explicitStatusDetail?;
+  private pendingToolCalls;
+  private pendingLlmCalls;
+  constructor(options: FillRecordCollectorOptions);
+  onTurnStart(turn: {
+    turnNumber: number;
+    issuesCount: number;
+    order: number;
+    executionId: string;
+  }): void;
+  onTurnComplete(progress: TurnProgress): void;
+  onLlmCallStart(call: {
+    model: string;
+    executionId: string;
+  }): void;
+  onLlmCallEnd(call: {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    executionId: string;
+  }): void;
+  onToolStart(call: {
+    name: string;
+    input: unknown;
+    executionId: string;
+  }): void;
+  onToolEnd(call: {
+    name: string;
+    output: unknown;
+    durationMs: number;
+    error?: string;
+    executionId: string;
+  }): void;
+  onWebSearch(info: {
+    query: string;
+    resultCount: number;
+    provider: string;
+    executionId: string;
+  }): void;
+  /**
+   * Add custom data during execution.
+   */
+  addCustomData(key: string, value: unknown): void;
+  /**
+   * Set explicit status (overrides auto-detection from progress).
+   */
+  setStatus(status: FillRecordStatus, detail?: string): void;
+  /**
+   * Assemble the complete FillRecord from collected events.
+   */
+  getRecord(formProgress: ProgressCounts): FillRecord;
+  private buildTimeline;
+  private findTurnForExecutionId;
+  private normalizeInput;
+  private extractResultCount;
+  private calculateLlmTotals;
+  private calculateToolSummary;
+  private extractResultCountFromOutput;
+  private percentile;
+  private calculateTimingBreakdown;
+  private buildExecutionMetadata;
+  private determineStatus;
+}
+//#endregion
+//#region src/harness/formatFillRecordSummary.d.ts
+/**
+ * Options for formatting the summary.
+ */
+interface FormatFillRecordSummaryOptions {
+  /** Show detailed breakdown including per-tool stats */
+  verbose?: boolean;
+}
+/**
+ * Format FillRecord as a human-readable text summary.
+ *
+ * @param record - The FillRecord to format
+ * @param options - Formatting options (verbose mode for more detail)
+ * @returns Multi-line text summary
+ *
+ * @example
+ * ```typescript
+ * const result = await fillForm({ form, model, recordFill: true });
+ * if (result.record) {
+ *   console.log(formatFillRecordSummary(result.record));
+ * }
+ * ```
+ */
+declare function formatFillRecordSummary(record: FillRecord, options?: FormatFillRecordSummaryOptions): string;
+//#endregion
 //#region src/research/researchTypes.d.ts
 /**
  * Research execution status.
@@ -1442,5 +1935,5 @@ declare function validateResearchForm(form: ParsedForm): {
 /** Markform version (injected at build time). */
 declare const VERSION: string;
 //#endregion
-export { type AgentResponse, type AnswerState, AnswerStateSchema, type ApplyResult, ApplyResultSchema, type CellResponse, CellResponseSchema, type CellScopeRef, type CheckboxInfo, type CheckboxMode, CheckboxModeSchema, type CheckboxProgressCounts, CheckboxProgressCountsSchema, type CheckboxValue, CheckboxValueSchema, type CheckboxesField, CheckboxesFieldSchema, type CheckboxesValue, CheckboxesValueSchema, type ClearFieldPatch, ClearFieldPatchSchema, type CoerceInputContextResult, type CoercionResult, type ColumnTypeName, ColumnTypeNameSchema, type ComputedSummaries, type DateField, DateFieldSchema, type DateValue, DateValueSchema, type DocumentationBlock, DocumentationBlockSchema, type DocumentationTag, DocumentationTagSchema, type ExplicitCheckboxValue, ExplicitCheckboxValueSchema, type Field, type FieldBase, type FieldGroup, FieldGroupSchema, type FieldKind, FieldKindSchema, type FieldProgress, FieldProgressSchema, type FieldResponse, FieldResponseSchema, FieldSchema, type FieldScopeRef, type FieldValue, FieldValueSchema, type FillCallbacks, type FillOptions, type FillResult, type FillStatus, FormHarness, type FormSchema, FormSchemaSchema, type FrontmatterHarnessConfig, type HarnessConfig, HarnessConfigSchema, type HeadingInfo, type Id, type IdIndexEntry, IdSchema, type InjectCheckboxIdsOptions, type InjectHeaderIdsOptions, type InjectIdsResult, type InputContext, type InspectIssue, InspectIssueSchema, type InspectOptions, type InspectResult, InspectResultSchema, type IssueReason, IssueReasonSchema, type IssueScope, IssueScopeSchema, type JsonSchemaDraft, type JsonSchemaOptions, type JsonSchemaResult, MarkformAbortError, MarkformConfigError, MarkformError, type MarkformFieldExtension, type MarkformFrontmatter, MarkformFrontmatterSchema, MarkformLlmError, MarkformParseError, MarkformPatchError, type MarkformSchemaExtension, MarkformValidationError, MockAgent, type MultiCheckboxState, MultiCheckboxStateSchema, type MultiSelectField, MultiSelectFieldSchema, type MultiSelectValue, MultiSelectValueSchema, type NodeType, type NumberField, NumberFieldSchema, type NumberValue, NumberValueSchema, type Option, type OptionId, OptionIdSchema, OptionSchema, ParallelHarness, type ParallelHarnessConfig, type ParallelRunResult, type ParallelStepResult, ParseError, type ParseScopeRefResult, type ParseTableResult, type ParsedForm, type ParsedRawTable, type ParsedScopeRef, type Patch, type PatchRejection, PatchSchema, type ProgressCounts, ProgressCountsSchema, type ProgressState, ProgressStateSchema, type ProgressSummary, ProgressSummarySchema, type QualifiedColumnRef, type QualifiedOptionRef, type QualifiedScopeRef, type RawFieldValue, type ResearchOptions, type ResearchResult, type ResearchStatus, type RunMode, RunModeSchema, type ScopedFillRequest, type SerializeOptions, type SessionFinal, SessionFinalSchema, type SessionTranscript, SessionTranscriptSchema, type SessionTurn, SessionTurnSchema, type SessionTurnStats, type SetCheckboxesPatch, SetCheckboxesPatchSchema, type SetDatePatch, SetDatePatchSchema, type SetMultiSelectPatch, SetMultiSelectPatchSchema, type SetNumberPatch, SetNumberPatchSchema, type SetSingleSelectPatch, SetSingleSelectPatchSchema, type SetStringListPatch, SetStringListPatchSchema, type SetStringPatch, SetStringPatchSchema, type SetTablePatch, SetTablePatchSchema, type SetUrlListPatch, SetUrlListPatchSchema, type SetUrlPatch, SetUrlPatchSchema, type SetYearPatch, SetYearPatchSchema, type Severity, SeveritySchema, type SimpleCheckboxState, SimpleCheckboxStateSchema, type SingleSelectField, SingleSelectFieldSchema, type SingleSelectValue, SingleSelectValueSchema, type SourcePosition, SourcePositionSchema, type SourceRange, SourceRangeSchema, type StepResult, StepResultSchema, type StringField, StringFieldSchema, type StringListField, StringListFieldSchema, type StringListValue, StringListValueSchema, type StringValue, StringValueSchema, type StructureSummary, StructureSummarySchema, type TableColumn, TableColumnSchema, type TableField, TableFieldSchema, type TableRowPatch, TableRowPatchSchema, type TableRowResponse, TableRowResponseSchema, type TableValue, TableValueSchema, type TurnProgress, type TurnStats, type UrlField, UrlFieldSchema, type UrlListField, UrlListFieldSchema, type UrlListValue, UrlListValueSchema, type UrlValue, UrlValueSchema, VERSION, type ValidateOptions, type ValidateResult, type ValidationIssue, ValidationIssueSchema, type ValidatorContext, type ValidatorFn, type ValidatorRef, ValidatorRefSchema, type ValidatorRegistry, type WireFormat, WireFormatSchema, type WireRequestFormat, WireRequestFormatSchema, type WireResponseFormat, WireResponseFormatSchema, type WireResponseStep, WireResponseStepSchema, type WireToolCall, WireToolCallSchema, type WireToolResult, WireToolResultSchema, type YearField, YearFieldSchema, type YearValue, YearValueSchema, applyPatches, coerceInputContext, coerceToFieldPatch, computeAllSummaries, computeFormState, computeProgressSummary, computeStructureSummary, createHarness, createMockAgent, createParallelHarness, fieldToJsonSchema, fillForm, findAllCheckboxes, findAllHeadings, findEnclosingHeadings, findFieldById, formToJsonSchema, getFieldId, injectCheckboxIds, injectHeaderIds, inspect, isAbortError, isCellRef, isConfigError, isFieldRef, isFormComplete, isLlmError, isMarkformError, isParseError, isPatchError, isQualifiedRef, isResearchForm, isRetryableError, isValidationError, parseCellValue, parseForm, parseMarkdownTable, parseRawTable, parseScopeRef, parseSession, resolveHarnessConfig, runResearch, scopeIssuesForItem, serializeForm, serializeReport, serializeScopeRef, serializeSession, validate, validateResearchForm };
+export { type AgentResponse, type AnswerState, AnswerStateSchema, type ApplyResult, ApplyResultSchema, type CellResponse, CellResponseSchema, type CellScopeRef, type CheckboxInfo, type CheckboxMode, CheckboxModeSchema, type CheckboxProgressCounts, CheckboxProgressCountsSchema, type CheckboxValue, CheckboxValueSchema, type CheckboxesField, CheckboxesFieldSchema, type CheckboxesValue, CheckboxesValueSchema, type ClearFieldPatch, ClearFieldPatchSchema, type CoerceInputContextResult, type CoercionResult, type ColumnTypeName, ColumnTypeNameSchema, type ComputedSummaries, type DateField, DateFieldSchema, type DateValue, DateValueSchema, type DocumentationBlock, DocumentationBlockSchema, type DocumentationTag, DocumentationTagSchema, type ExecutionMetadata, ExecutionMetadataSchema, type ExplicitCheckboxValue, ExplicitCheckboxValueSchema, type Field, type FieldBase, type FieldGroup, FieldGroupSchema, type FieldKind, FieldKindSchema, type FieldProgress, FieldProgressSchema, type FieldResponse, FieldResponseSchema, FieldSchema, type FieldScopeRef, type FieldValue, FieldValueSchema, type FillCallbacks, type FillOptions, type FillRecord, FillRecordCollector, type FillRecordCollectorOptions, FillRecordSchema, type FillRecordStatus, FillRecordStatusSchema, type FillResult, type FillStatus, FormHarness, type FormSchema, FormSchemaSchema, type FormatFillRecordSummaryOptions, type FrontmatterHarnessConfig, type HarnessConfig, HarnessConfigSchema, type HeadingInfo, type Id, type IdIndexEntry, IdSchema, type InjectCheckboxIdsOptions, type InjectHeaderIdsOptions, type InjectIdsResult, type InputContext, type InspectIssue, InspectIssueSchema, type InspectOptions, type InspectResult, InspectResultSchema, type IssueReason, IssueReasonSchema, type IssueScope, IssueScopeSchema, type JsonSchemaDraft, type JsonSchemaOptions, type JsonSchemaResult, MarkformAbortError, MarkformConfigError, MarkformError, type MarkformFieldExtension, type MarkformFrontmatter, MarkformFrontmatterSchema, MarkformLlmError, MarkformParseError, MarkformPatchError, type MarkformSchemaExtension, MarkformValidationError, MockAgent, type MultiCheckboxState, MultiCheckboxStateSchema, type MultiSelectField, MultiSelectFieldSchema, type MultiSelectValue, MultiSelectValueSchema, type NodeType, type NumberField, NumberFieldSchema, type NumberValue, NumberValueSchema, type Option, type OptionId, OptionIdSchema, OptionSchema, ParallelHarness, type ParallelHarnessConfig, type ParallelRunResult, type ParallelStepResult, ParseError, type ParseScopeRefResult, type ParseTableResult, type ParsedForm, type ParsedRawTable, type ParsedScopeRef, type Patch, type PatchRejection, PatchSchema, type ProgressCounts, ProgressCountsSchema, type ProgressState, ProgressStateSchema, type ProgressSummary, ProgressSummarySchema, type QualifiedColumnRef, type QualifiedOptionRef, type QualifiedScopeRef, type RawFieldValue, type ResearchOptions, type ResearchResult, type ResearchStatus, type RunMode, RunModeSchema, type ScopedFillRequest, type SerializeOptions, type SessionFinal, SessionFinalSchema, type SessionTranscript, SessionTranscriptSchema, type SessionTurn, SessionTurnSchema, type SessionTurnStats, type SetCheckboxesPatch, SetCheckboxesPatchSchema, type SetDatePatch, SetDatePatchSchema, type SetMultiSelectPatch, SetMultiSelectPatchSchema, type SetNumberPatch, SetNumberPatchSchema, type SetSingleSelectPatch, SetSingleSelectPatchSchema, type SetStringListPatch, SetStringListPatchSchema, type SetStringPatch, SetStringPatchSchema, type SetTablePatch, SetTablePatchSchema, type SetUrlListPatch, SetUrlListPatchSchema, type SetUrlPatch, SetUrlPatchSchema, type SetYearPatch, SetYearPatchSchema, type Severity, SeveritySchema, type SimpleCheckboxState, SimpleCheckboxStateSchema, type SingleSelectField, SingleSelectFieldSchema, type SingleSelectValue, SingleSelectValueSchema, type SourcePosition, SourcePositionSchema, type SourceRange, SourceRangeSchema, type StepResult, StepResultSchema, type StringField, StringFieldSchema, type StringListField, StringListFieldSchema, type StringListValue, StringListValueSchema, type StringValue, StringValueSchema, type StructureSummary, StructureSummarySchema, type TableColumn, TableColumnSchema, type TableField, TableFieldSchema, type TableRowPatch, TableRowPatchSchema, type TableRowResponse, TableRowResponseSchema, type TableValue, TableValueSchema, type TimelineEntry, TimelineEntrySchema, type TimingBreakdown, type TimingBreakdownItem, TimingBreakdownItemSchema, TimingBreakdownSchema, type ToolCallRecord, ToolCallRecordSchema, type ToolStats, ToolStatsSchema, type ToolSummary, ToolSummarySchema, type TurnProgress, type TurnStats, type UrlField, UrlFieldSchema, type UrlListField, UrlListFieldSchema, type UrlListValue, UrlListValueSchema, type UrlValue, UrlValueSchema, VERSION, type ValidateOptions, type ValidateResult, type ValidationIssue, ValidationIssueSchema, type ValidatorContext, type ValidatorFn, type ValidatorRef, ValidatorRefSchema, type ValidatorRegistry, type WireFormat, WireFormatSchema, type WireRequestFormat, WireRequestFormatSchema, type WireResponseFormat, WireResponseFormatSchema, type WireResponseStep, WireResponseStepSchema, type WireToolCall, WireToolCallSchema, type WireToolResult, WireToolResultSchema, type YearField, YearFieldSchema, type YearValue, YearValueSchema, applyPatches, coerceInputContext, coerceToFieldPatch, computeAllSummaries, computeFormState, computeProgressSummary, computeStructureSummary, createHarness, createMockAgent, createParallelHarness, fieldToJsonSchema, fillForm, findAllCheckboxes, findAllHeadings, findEnclosingHeadings, findFieldById, formToJsonSchema, formatFillRecordSummary, getFieldId, injectCheckboxIds, injectHeaderIds, inspect, isAbortError, isCellRef, isConfigError, isFieldRef, isFormComplete, isLlmError, isMarkformError, isParseError, isPatchError, isQualifiedRef, isResearchForm, isRetryableError, isValidationError, parseCellValue, parseForm, parseMarkdownTable, parseRawTable, parseScopeRef, parseSession, resolveHarnessConfig, runResearch, scopeIssuesForItem, serializeForm, serializeReport, serializeScopeRef, serializeSession, validate, validateResearchForm };
 //# sourceMappingURL=index.d.mts.map