@tracemarketplace/shared 0.0.10 → 0.0.13

package/src/types.ts

@@ -1,7 +1,15 @@
 export type SourceTool = "claude_code" | "codex_cli" | "cursor";
 
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+
+export interface JsonObject {
+  [key: string]: JsonValue;
+}
+
 export type FailureMode =
   | "tool_call_failure"
+  | "repeated_failing_root_cause"
   | "repeated_tool_calls"
   | "context_limit_approached"
   | "catastrophic_failure"
@@ -10,6 +18,8 @@ export type FailureMode =
   | "wrong_tool_sequence"
   | "no_failure";
 
+export type QualityTier = "bronze" | "silver" | "gold";
+
 export interface TokenUsage {
   input_tokens: number;
   output_tokens: number;
@@ -49,6 +59,43 @@ export interface EnvState {
   extraction_method: "passive" | "active";
 }
 
+export type TraceScoreComponentSource =
+  | "trace"
+  | "normalization"
+  | "label"
+  | "judge"
+  | "corpus";
+
+export interface TraceScoreComponent {
+  key: string;
+  label: string;
+  score: number;
+  weight: number;
+  source: TraceScoreComponentSource;
+  available: boolean;
+  reason: string;
+  evidence: JsonValue | null;
+}
+
+export interface TraceScoreBreakdown {
+  aggregation: "weighted_average";
+  component_count: number;
+  available_weight: number;
+  total_weight: number;
+  components: TraceScoreComponent[];
+}
+
+export interface TraceScoreContext {
+  failure_modes_override?: FailureMode[];
+  anomaly_score?: number | null;
+  workflow_shape?: string | null;
+  length_bucket?: string | null;
+  tool_density?: string | null;
+  failure_judge_verdict?: string | null;
+  failure_judge_agreement?: string | null;
+  failure_judge_confidence?: number | null;
+}
+
 export interface TraceScore {
   completeness: "complete" | "incomplete" | "malformed";
   failure_modes: FailureMode[];
@@ -57,6 +104,7 @@ export interface TraceScore {
   content_fidelity: "full" | "chat_only";
   total: number;
   payout_cents: number;
+  breakdown: TraceScoreBreakdown;
   failure_taxonomy_label: string | null;
   failure_taxonomy_explanation: string | null;
   rarity_score: number | null;
@@ -99,6 +147,8 @@ export interface NormalizedTrace {
   content_fidelity: "full" | "chat_only";
   env_state: EnvState | null;
   score: TraceScore | null;
+  raw_json?: JsonValue | null;
+  raw_json_format?: string | null;
   raw_r2_key: string;
   normalized_r2_key: string;
 }

package/src/validators.test.ts

@@ -34,6 +34,14 @@ describe("NormalizedTraceSchema", () => {
     const result = NormalizedTraceSchema.safeParse(makeTrace({ turn_count: -1 }));
     expect(result.success).toBe(false);
   });
+
+  it("accepts raw_json payloads", () => {
+    const result = NormalizedTraceSchema.safeParse(makeTrace({
+      raw_json: { events: [{ type: "session_meta" }] },
+      raw_json_format: "codex_cli.jsonl",
+    }));
+    expect(result.success).toBe(true);
+  });
 });
 
 describe("BatchSubmitSchema", () => {

package/src/validators.ts

@@ -1,4 +1,10 @@
 import { z } from "zod";
+import type { JsonValue } from "./types.js";
+
+const JsonLiteralSchema = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+const JsonValueSchema: z.ZodType<JsonValue> = z.lazy(() =>
+  z.union([JsonLiteralSchema, z.array(JsonValueSchema), z.record(JsonValueSchema)])
+);
 
 export const NormalizedTraceSchema = z.object({
   trace_id: z.string().optional(),
@@ -32,6 +38,8 @@ export const NormalizedTraceSchema = z.object({
   content_fidelity: z.enum(["full", "chat_only"]).optional(),
   env_state: z.any().nullable().optional(),
   score: z.any().nullable().optional(),
+  raw_json: JsonValueSchema.nullable().optional(),
+  raw_json_format: z.string().nullable().optional(),
   raw_r2_key: z.string().optional(),
   normalized_r2_key: z.string().optional(),
 });