markform 0.1.20 → 0.1.22

package/dist/fillRecord-DTl5lnK0.d.mts

@@ -0,0 +1,345 @@
+
+import { z } from "zod";
+
+//#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;
+  startMs: z.ZodNumber;
+  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;
+  startMs: z.ZodNumber;
+  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;
+    startMs: z.ZodNumber;
+    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;
+    startMs: z.ZodNumber;
+    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;
+      startMs: z.ZodNumber;
+      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
+export { ToolSummary as _, FillRecordStatus as a, TimelineEntrySchema as c, TimingBreakdownItemSchema as d, TimingBreakdownSchema as f, ToolStatsSchema as g, ToolStats as h, FillRecordSchema as i, TimingBreakdown as l, ToolCallRecordSchema as m, ExecutionMetadataSchema as n, FillRecordStatusSchema as o, ToolCallRecord as p, FillRecord as r, TimelineEntry as s, ExecutionMetadata as t, TimingBreakdownItem as u, ToolSummarySchema as v };
+//# sourceMappingURL=fillRecord-DTl5lnK0.d.mts.map