@peasant-labs/fairtrade 0.0.2 → 0.0.4

package/dist/lib/types/transcript/graph/GraphToolNode.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The trajectory-graph tool-cluster pill visual.
+ * @param {GraphToolNodeProps} props
+ * @returns {JSX.Element}
+ */
+export function GraphToolNode({ tools, totalDurationMs, hasError, isFilteredOut, max, className, }: GraphToolNodeProps): JSX.Element;
+export default GraphToolNode;
+/**
+ * One cooked tool entry for the cluster. A strict presentational subset of
+ * ToolCallVM — note the absence of any raw wire `arguments`/`result` string, by
+ * design, so the visual cannot parse wire JSON.
+ */
+export type GraphToolItem = {
+    id: string;
+    /**
+     * display name (e.g. "Read", "Bash")
+     */
+    name: string;
+    /**
+     * tool kind (decorative grouping hint)
+     */
+    kind?: string;
+    /**
+     * cooked path; basename is the preview fallback
+     */
+    filePath?: string;
+    /**
+     * cooked one-line arg summary (NEVER parsed here)
+     */
+    preview?: string;
+    isError?: boolean;
+    exitCode?: number;
+};
+export type GraphToolNodeProps = {
+    /**
+     * the cooked tool calls for this turn
+     */
+    tools: GraphToolItem[];
+    /**
+     * summed duration → header badge
+     */
+    totalDurationMs?: number;
+    /**
+     * cluster carries a failed call
+     */
+    hasError?: boolean;
+    /**
+     * engine: dimmed by an active filter
+     */
+    isFilteredOut?: boolean;
+    /**
+     * rows before collapsing to "+ N more" (default 4)
+     */
+    max?: number;
+    className?: string;
+};

package/dist/lib/types/transcript/graph/GraphTurnNode.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The trajectory-graph turn card visual.
+ * @param {GraphTurnNodeProps} props
+ * @returns {JSX.Element}
+ */
+export function GraphTurnNode({ role, agentName, turnNumber, contentPreview, toolCount, totalTokens, tokensIn, tokensOut, hasError, hasRetry, hasRevert, isSearchMatch, isFilteredOut, isSelected, provider, className, }: GraphTurnNodeProps): JSX.Element;
+export default GraphTurnNode;
+export type Role = import("../wire-types.js").Role;
+/**
+ * Cooked, engine-agnostic props for one trajectory-graph turn card. Every field
+ * is a finished display value — the component does no parsing, truncation, or
+ * data derivation beyond choosing the accent token and chrome label.
+ */
+export type GraphTurnNodeProps = {
+    /**
+     * canonical role; selects the chrome label + base accent
+     */
+    role: Role;
+    /**
+     * subagent name; PRESENT ⇒ render as a subagent (mauve)
+     */
+    agentName?: string;
+    /**
+     * the display number shown as "#…"
+     */
+    turnNumber: string | number;
+    /**
+     * one-line, already-truncated preview (may be empty)
+     */
+    contentPreview: string;
+    /**
+     * tool-call count for the footer ("N tools")
+     */
+    toolCount: number;
+    /**
+     * total tokens for the footer badge
+     */
+    totalTokens: number;
+    /**
+     * optional split, surfaced via title for hover detail
+     */
+    tokensIn?: number;
+    tokensOut?: number;
+    /**
+     * clay accent + error flag (highest-priority flag)
+     */
+    hasError?: boolean;
+    /**
+     * "retry" flag (when not an error)
+     */
+    hasRetry?: boolean;
+    /**
+     * "re-edit" flag (when not an error or retry)
+     */
+    hasRevert?: boolean;
+    /**
+     * engine: highlighted as a search hit
+     */
+    isSearchMatch?: boolean;
+    /**
+     * engine: dimmed because a filter excludes it
+     */
+    isFilteredOut?: boolean;
+    /**
+     * engine: the active/selected node
+     */
+    isSelected?: boolean;
+    /**
+     * harness key (e.g. "claude-code") → assistant accent
+     */
+    provider?: string;
+    /**
+     * extra classes appended after the base
+     */
+    className?: string;
+};

package/dist/lib/types/transcript/graph/index.d.ts

@@ -0,0 +1,10 @@
+export { GraphTurnNode } from "./GraphTurnNode.jsx";
+export { GraphToolNode } from "./GraphToolNode.jsx";
+export { GraphSubagentBranch } from "./GraphSubagentBranch.jsx";
+export type GraphTurnNodeProps = import("./GraphTurnNode.jsx").GraphTurnNodeProps;
+export type GraphToolNodeProps = import("./GraphToolNode.jsx").GraphToolNodeProps;
+export type GraphToolItem = import("./GraphToolNode.jsx").GraphToolItem;
+export type GraphSubagentBranchProps = import("./GraphSubagentBranch.jsx").GraphSubagentBranchProps;
+export type GraphLegendProps = import("./GraphLegend.jsx").GraphLegendProps;
+export type GraphLegendItem = import("./GraphLegend.jsx").GraphLegendItem;
+export { GraphLegend, GRAPH_LEGEND_ITEMS } from "./GraphLegend.jsx";

package/dist/lib/types/transcript/index.d.ts

@@ -0,0 +1,69 @@
+export { TOOL_GROUPS } from "./view-model.js";
+export { default as TranscriptTurnCard } from "./TurnCard.jsx";
+export { default as TranscriptThinking } from "./Thinking.jsx";
+export { default as TranscriptMarkdown } from "./Markdown.jsx";
+export { default as TranscriptToolCall } from "./ToolCall.jsx";
+export { default as TranscriptToolBody } from "./ToolBody.jsx";
+export { default as TranscriptTaskBody } from "./TaskBody.jsx";
+export { default as TranscriptViewer } from "./TranscriptViewer.jsx";
+export { default as TranscriptOutlineRail } from "./OutlineRail.jsx";
+export { default as TranscriptFiltersRail } from "./FiltersRail.jsx";
+export { default as TranscriptFilterSection } from "./FilterSection.jsx";
+export { default as TranscriptCheckRow } from "./CheckRow.jsx";
+export { default as TranscriptViewSwitch } from "./ViewSwitch.jsx";
+export { default as TranscriptScrubber } from "./Scrubber.jsx";
+export { default as TranscriptScorecard } from "./Scorecard.jsx";
+export { default as TranscriptLabelPopover } from "./LabelPopover.jsx";
+export type TaskGroup = import("./analytics.js").TaskGroup;
+export type WaterfallSegment = import("./analytics.js").WaterfallSegment;
+export type TranscriptAnnotation = import("./analytics.js").TranscriptAnnotation;
+export type PersonalMedians = import("./analytics.js").PersonalMedians;
+export type PersonalMedianSession = import("./analytics.js").PersonalMedianSession;
+export type PhaseType = import("./analytics.js").PhaseType;
+export type Role = import("./wire-types.js").Role;
+export type EntryType = import("./wire-types.js").EntryType;
+export type ToolCallKind = import("./wire-types.js").ToolCallKind;
+export type StopReason = import("./wire-types.js").StopReason;
+export type SessionOutcome = import("./wire-types.js").SessionOutcome;
+export type Harness = import("./wire-types.js").Harness;
+export type ToolCallDetail = import("./wire-types.js").ToolCallDetail;
+export type TurnDetail = import("./wire-types.js").TurnDetail;
+export type ChildSessionRef = import("./wire-types.js").ChildSessionRef;
+export type SessionScorecard = import("./wire-types.js").SessionScorecard;
+export type CommitInfo = import("./wire-types.js").CommitInfo;
+export type GitContext = import("./wire-types.js").GitContext;
+export type AnnotationSummary = import("./wire-types.js").AnnotationSummary;
+export type SessionDetailPayload = import("./wire-types.js").SessionDetailPayload;
+export type TranscriptWireInput = import("./wire-types.js").TranscriptWireInput;
+export type TranscriptViewerProps = import("./state-capabilities.js").TranscriptViewerProps;
+export type ViewerCapabilities = import("./state-capabilities.js").ViewerCapabilities;
+export type ViewerCallbacks = import("./state-capabilities.js").ViewerCallbacks;
+export type GraphSlotContext = import("./state-capabilities.js").GraphSlotContext;
+export type TranscriptFilters = import("./state-capabilities.js").TranscriptFilters;
+export type SavedLabel = import("./state-capabilities.js").SavedLabel;
+export type Theme = import("./state-capabilities.js").Theme;
+export type TranscriptTab = import("./state-capabilities.js").TranscriptTab;
+export type ViewMode = import("./state-capabilities.js").ViewMode;
+export type TranscriptViewModel = import("./view-model.js").TranscriptViewModel;
+export type SessionVM = import("./view-model.js").SessionVM;
+export type SessionGitVM = import("./view-model.js").SessionGitVM;
+export type CommitVM = import("./view-model.js").CommitVM;
+export type TurnVM = import("./view-model.js").TurnVM;
+export type ThinkingVM = import("./view-model.js").ThinkingVM;
+export type ToolCallVM = import("./view-model.js").ToolCallVM;
+export type ToolGroup = import("./view-model.js").ToolGroup;
+export type DiffLineVM = import("./view-model.js").DiffLineVM;
+export type DiffHunkVM = import("./view-model.js").DiffHunkVM;
+export type DiffEntryVM = import("./view-model.js").DiffEntryVM;
+export type FileEntryVM = import("./view-model.js").FileEntryVM;
+export type TaskGroupVM = import("./view-model.js").TaskGroupVM;
+export type HighlightVM = import("./view-model.js").HighlightVM;
+export type AnnotationVM = import("./view-model.js").AnnotationVM;
+export type FilterIndexVM = import("./view-model.js").FilterIndexVM;
+export type PhaseVM = import("./view-model.js").PhaseVM;
+export type ScorecardBandVM = import("./view-model.js").ScorecardBandVM;
+export type TranscriptAnalyticsVM = import("./view-model.js").TranscriptAnalyticsVM;
+export { ROLES, ENTRY_TYPES, TOOL_CALL_KINDS, STOP_REASONS, SESSION_OUTCOMES, HARNESSES } from "./wire-types.js";
+export { adaptTranscript, prefilterTurns, diffLines } from "./adapter.js";
+export { computeTasks, computeTurnLabels, buildTaskWaterfall, annotateTranscript, computePersonalMedians, detectPhases, assessScorecard, computeAnalytics, computeTaskGroups, phaseLabel } from "./analytics.js";
+export { default as TranscriptDiffEntryCard, DiffHunks as TranscriptDiffHunks } from "./DiffEntryCard.jsx";

package/dist/lib/types/transcript/state-capabilities.d.ts

@@ -0,0 +1,161 @@
+/**
+ * The five session views. `highlights` is backed by `vm.highlights`; the rest
+ * read their cooked slices off the same `TranscriptViewModel`.
+ */
+export type TranscriptTab = "highlights" | "trace" | "diffs" | "files" | "annotations";
+/**
+ * The trace canvas render mode: the lifted turn-card list, or the graph slot.
+ */
+export type ViewMode = "list" | "graph";
+/**
+ * The optional theme; defaults to `dark` when unset.
+ */
+export type Theme = "dark" | "light";
+/**
+ * A per-turn saved label (the LabelPopover's output). `outcome` is the verdict
+ * band; `flag` is an optional friction tag. Keyed by turn index in `savedLabels`.
+ */
+export type SavedLabel = {
+    outcome: "good" | "neutral" | "bad";
+    flag?: string;
+};
+/**
+ * The cooked filter state the FiltersRail drives. Categories gate turn KINDS;
+ * `toolGroups` gate tool-call groups (keyed by the cooked `ToolGroup` ids);
+ * `tags` gate semantic friction tags; `views` are display toggles; `checkpoint`
+ * scopes the trace to a commit (`'all'` = unscoped).
+ */
+export type TranscriptFilters = {
+    categories: {
+        prompts: boolean;
+        responses: boolean;
+        thinking: boolean;
+        toolcalls: boolean;
+    };
+    toolGroups: Partial<Record<import("./view-model.js").ToolGroup, boolean>>;
+    tags: {
+        errors: boolean;
+        retries: boolean;
+        revert: boolean;
+    };
+    views: {
+        hidden: boolean;
+        expandAll: boolean;
+        compact: boolean;
+    };
+    checkpoint: string;
+};
+/**
+ * The consumer/auth-derived permission surface — REQUIRED on TranscriptViewer
+ * (no default). Every flag is required (not optional) so a consumer cannot pass
+ * a partial surface and silently leave a permission unset; the host decides each
+ * one explicitly. The composite gates each capability's affordance + callback on
+ * its flag, so a `false` capability removes the affordance entirely.
+ */
+export type ViewerCapabilities = {
+    /**
+     * show the "edit" action + wire `onEdit`
+     */
+    canEdit: boolean;
+    /**
+     * show the per-turn "label" affordance + the LabelPopover
+     */
+    canLabel: boolean;
+    /**
+     * show the "contribute" share action + wire `onContribute`
+     */
+    canContribute: boolean;
+    /**
+     * show the visibility control + wire `onChangeVisibility`
+     */
+    canChangeVisibility: boolean;
+    /**
+     * show the download (json/jsonl/markdown) actions + wire `onExport`
+     */
+    canExport: boolean;
+};
+/**
+ * The host callbacks. All optional; each is wired ONLY when its matching
+ * capability is true (see ViewerCapabilities). `onLabel` carries the popover's
+ * cooked result; `onExport` carries the requested format. The viewer never
+ * mutates the host's data — it reports intent through these.
+ */
+export type ViewerCallbacks = {
+    onEdit?: () => void;
+    onLabel?: (turnIndex: number, label: SavedLabel) => void;
+    onContribute?: () => void;
+    onCopyLink?: () => void;
+    onChangeVisibility?: () => void;
+    onExport?: (format: "json" | "jsonl" | "markdown") => void;
+};
+/**
+ * What the `graphSlot` render-prop receives. The composite owns NO graph engine
+ * (no `@xyflow` dependency); in `viewMode: 'graph'` it hands the consumer this
+ * cooked context and renders whatever the consumer returns (TB plugs its
+ */
+export type GraphSlotContext = {
+    viewModel: import("./view-model.js").TranscriptViewModel;
+    activeTurn: number;
+    onSelectTurn: (turnIndex: number) => void;
+};
+/**
+ * Every TranscriptViewer prop. `viewModel` + `capabilities` are the only required
+ * props; everything else is optional with a sane internal default, so
+ * `<TranscriptViewer viewModel={vm} capabilities={caps} />` renders the whole
+ * surface unmanaged. Each view-state prop is the `value?` half of a controllable
+ * pair whose `onChange?` half sits beside it (React's controlled-component
+ * convention): pass neither ⇒ internal default; pass both ⇒ fully controlled.
+ */
+export type TranscriptViewerProps = {
+    /**
+     * the cooked VM (the adapter's output)
+     */
+    viewModel: import("./view-model.js").TranscriptViewModel;
+    /**
+     * REQUIRED — no default
+     */
+    capabilities: ViewerCapabilities;
+    callbacks?: ViewerCallbacks;
+    /**
+     * optional; defaults to 'dark'
+     */
+    theme?: Theme;
+    /**
+     * render-prop for the graph engine
+     */
+    graphSlot?: (ctx: GraphSlotContext) => unknown;
+    activeTab?: TranscriptTab;
+    onTabChange?: (tab: TranscriptTab) => void;
+    viewMode?: ViewMode;
+    onViewModeChange?: (mode: ViewMode) => void;
+    leftRailOpen?: boolean;
+    onLeftRailOpenChange?: (open: boolean) => void;
+    rightRailOpen?: boolean;
+    onRightRailOpenChange?: (open: boolean) => void;
+    /**
+     * tool id → open?
+     */
+    openTools?: Record<string, boolean>;
+    onOpenToolsChange?: (openTools: Record<string, boolean>) => void;
+    activeTurn?: number;
+    onActiveTurnChange?: (turnIndex: number) => void;
+    search?: string;
+    onSearchChange?: (query: string) => void;
+    filters?: TranscriptFilters;
+    onFiltersChange?: (filters: TranscriptFilters) => void;
+    /**
+     * turn index → saved label
+     */
+    savedLabels?: Record<number, SavedLabel>;
+    onSavedLabelsChange?: (savedLabels: Record<number, SavedLabel>) => void;
+    /**
+     * share action-menu disclosure (default closed)
+     */
+    shareOpen?: boolean;
+    onShareOpenChange?: (open: boolean) => void;
+    /**
+     * more action-menu disclosure (default closed)
+     */
+    moreOpen?: boolean;
+    onMoreOpenChange?: (open: boolean) => void;
+};