@uvl000/claude-trace 3.0.13-workflowexp.1

package/dist/types.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @file types.ts
+ * @description Shared TypeScript interfaces used across the backend and frontend.
+ *
+ * These types define the shape of logged API traffic (`RawPair`), processed
+ * conversation views, HTML generation payloads, and Bedrock-specific event
+ * structures. They must stay compatible with the Lit-based frontend viewer
+ * embedded in self-contained HTML reports.
+ */
+/** A single captured HTTP request/response pair written to JSONL logs. */
+export interface RawPair {
+    request: {
+        /** Unix epoch milliseconds when the outbound request was sent. */
+        timestamp: number;
+        /** HTTP method (typically POST for LLM APIs). */
+        method: string;
+        /** Full request URL as seen by the interceptor or reverse proxy. */
+        url: string;
+        /** Request headers; auth tokens may be redacted unless logging sensitive headers. */
+        headers: Record<string, string>;
+        /** Parsed JSON request body, or raw structure for non-JSON payloads. */
+        body: any;
+    };
+    response: {
+        /** Unix epoch milliseconds when the upstream response was received. */
+        timestamp: number;
+        /** HTTP status code from the upstream API. */
+        status_code: number;
+        headers: Record<string, string>;
+        /** Parsed JSON response body when available. */
+        body?: any;
+        /** Raw response text (e.g. non-JSON or partially parsed SSE accumulation). */
+        body_raw?: string;
+        /** Parsed Server-Sent Events for streaming responses. */
+        events?: SSEEvent[];
+        /** Detected or annotated API wire format for display in the viewer. */
+        api_format?: import("./tools/types").ApiFormat;
+    } | null;
+    /** ISO-8601 timestamp when this pair was persisted to disk. */
+    logged_at: string;
+    /** Optional human-readable note (used for orphaned requests). */
+    note?: string;
+}
+/** One parsed SSE frame from a streaming LLM response. */
+export interface SSEEvent {
+    /** SSE event type (e.g. "message_start", "content_block_delta"). */
+    event: string;
+    /** Parsed JSON payload from the `data:` field. */
+    data: any;
+    /** ISO-8601 timestamp when this event was observed. */
+    timestamp: string;
+}
+/** Root payload injected into generated HTML reports (`window.claudeData`). */
+export interface ClaudeData {
+    rawPairs: RawPair[];
+    timestamp?: string;
+    metadata?: Record<string, any>;
+}
+/** Input to the HTML generator when building a report from in-memory or file data. */
+export interface HTMLGenerationData {
+    rawPairs: RawPair[];
+    timestamp: string;
+    title?: string;
+    /** When true, include non-message traffic in the viewer filters. */
+    includeAllRequests?: boolean;
+    /** Tool identifier for report title/branding ("claude" | "opencode" | "codex"). */
+    tool?: string;
+}
+/**
+ * Placeholder keys in the HTML template replaced at build/generation time.
+ * Unique suffixes prevent accidental collision with user content in logs.
+ */
+export interface TemplateReplacements {
+    __CLAUDE_LOGGER_BUNDLE_REPLACEMENT_UNIQUE_9487__: string;
+    __CLAUDE_LOGGER_DATA_REPLACEMENT_UNIQUE_9487__: string;
+    __CLAUDE_LOGGER_TITLE_REPLACEMENT_UNIQUE_9487__: string;
+}
+/**
+ * A conversation reconstructed from one or more RawPairs for the index/summary UI.
+ */
+export interface ProcessedConversation {
+    id: string;
+    model: string;
+    /** Original API message objects preserved for faithful rendering. */
+    messages: any[];
+    system?: any;
+    latestResponse?: string;
+    pairs: RawPair[];
+    metadata: {
+        startTime: string;
+        endTime: string;
+        totalPairs: number;
+        /** Last request context size; alias of `lastTurnInputTokens`. */
+        inputTokens?: number;
+        /** Sum of output tokens across all pairs; alias of `sessionOutputTokens`. */
+        outputTokens?: number;
+        /** Alias of `sessionOutputTokens` (not input + output). */
+        totalTokens?: number;
+        /** Context token count from the chronologically last API response. */
+        lastTurnInputTokens?: number;
+        /** Output token count from the chronologically last API response. */
+        lastTurnOutputTokens?: number;
+        /** Sum of `output_tokens` across every pair in the thread. */
+        sessionOutputTokens?: number;
+        /** Prompt cache hits on the last turn, when reported by the API. */
+        cacheReadTokens?: number | null;
+        /** Prompt cache writes on the last turn, when reported by the API. */
+        cacheCreationTokens?: number | null;
+        /** @deprecated Use `inputTokens` / `lastTurnInputTokens` instead. */
+        tokenUsage?: {
+            input: number;
+            output: number;
+        };
+    };
+    /** Duplicate of `pairs` kept for backward compatibility with older viewers. */
+    rawPairs: RawPair[];
+}
+/** Normalized message used by simplified conversation views. */
+export interface ProcessedMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+    thinking?: string;
+    toolCalls?: ToolCall[];
+    metadata?: {
+        timestamp: string;
+        model?: string;
+    };
+}
+/** A tool invocation extracted from assistant messages. */
+export interface ToolCall {
+    id: string;
+    type: string;
+    name: string;
+    input: any;
+    result?: any;
+    error?: string;
+}
+/** AWS Bedrock streaming binary envelope (base64-encoded inner JSON). */
+export interface BedrockBinaryEvent {
+    bytes: string;
+    p?: string;
+}
+/** Token and latency metrics emitted by Bedrock invocations. */
+export interface BedrockInvocationMetrics {
+    inputTokenCount: number;
+    outputTokenCount: number;
+    invocationLatency: number;
+    firstByteLatency: number;
+    cacheReadInputTokenCount?: number;
+    cacheWriteInputTokenCount?: number;
+}
+declare global {
+    interface Window {
+        /** Populated by HTMLGenerator so the embedded frontend can load trace data. */
+        claudeData: ClaudeData;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * @file types.ts
+ * @description Shared TypeScript interfaces used across the backend and frontend.
+ *
+ * These types define the shape of logged API traffic (`RawPair`), processed
+ * conversation views, HTML generation payloads, and Bedrock-specific event
+ * structures. They must stay compatible with the Lit-based frontend viewer
+ * embedded in self-contained HTML reports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}