@peasant-labs/fairtrade 0.0.59 → 0.0.61

package/dist/lib/share.js

@@ -1,6 +1,6 @@
 import { _ as e, c as t, g as n, h as r, m as i, p as a, v as o } from "./time-CpVBzcqQ.js";
 import { r as s } from "./format-B3uT2wzU.js";
-import { c, l, t as u } from "./adapter-VlAohr64.js";
+import { c, s as l, t as u } from "./adapter-BSfSbqWE.js";
 import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region public/tokens.json
 var p = {
@@ -556,7 +556,7 @@ function y(e) {
 	return s(e);
 }
 function ce(e, t) {
-	return c({
+	return l({
 		title: typeof e.title == "string" && e.title.trim() !== "" ? e.title.trim() : void 0,
 		hasNormalizedEvidence: t.session.hasNormalizedEvidence,
 		firstTaskPrompt: t.tasks?.[0]?.prompt,
@@ -574,7 +574,7 @@ function le(e) {
 	} catch {
 		return null;
 	}
-	let i = r.session, a = ce(n, r), o = typeof i.harness == "string" ? i.harness : "", s = oe(o) ? t[o] : null, c = n.turns.find((e) => e?.role === "user" && (e.depth ?? 0) === 0), d = typeof c?.content == "string" ? c.content : "", f = ae(i.harness === "cursor" ? l(d) : d).trim(), p = f || a, m = i.inputSubmissionCount, h = i.totalTokens, g = !r.usageScopes?.length && h != null, _ = m != null && g ? {
+	let i = r.session, a = ce(n, r), o = typeof i.harness == "string" ? i.harness : "", s = oe(o) ? t[o] : null, l = n.turns.find((e) => e?.role === "user" && (e.depth ?? 0) === 0), d = typeof l?.content == "string" ? l.content : "", f = ae(i.harness === "cursor" ? c(d) : d).trim(), p = f || a, m = i.inputSubmissionCount, h = i.totalTokens, g = !r.usageScopes?.length && h != null, _ = m != null && g ? {
 		prompts: Number(m),
 		tokens: Number(h)
 	} : null;

package/dist/lib/types/closed-value.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A closed value: a frozen object that carries its wire value, the label a
+ * surface shows for it, and the conversion hooks.
+ *
+ * - `wire` is the exact value persisted, compared, and sent on the wire.
+ * - `label` is the human-readable text shown for the member.
+ * - `String()` is the Go-style explicit text conversion; it returns `String(wire)`.
+ * - `toString()` is the text conversion used by `String(value)` and template literals.
+ * - `toJSON()` is the persistence conversion used by `JSON.stringify`; it returns `wire`.
+ *
+ * @template {string | number} W - the exact value persisted, compared, and sent on the wire.
+ * @template {string} L - the human-readable label shown for the member.
+ * @typedef {{
+ *   readonly wire: W,
+ *   readonly label: L,
+ *   String: () => string,
+ *   toString: () => string,
+ *   toJSON: () => W,
+ * }} ClosedValue
+ */
+/**
+ * Create one frozen closed-set member.
+ *
+ * @template {string | number} W
+ * @template {string} L
+ * @param {W} wire - the exact value persisted, compared, and sent on the wire.
+ * @param {L} label - the human-readable text shown for the member.
+ * @returns {ClosedValue<W, L>} a new frozen member for this `(wire, label)` pair.
+ */
+export function closed<W extends string | number, L extends string>(wire: W, label: L): ClosedValue<W, L>;
+/**
+ * A closed value: a frozen object that carries its wire value, the label a
+ * surface shows for it, and the conversion hooks.
+ *
+ * - `wire` is the exact value persisted, compared, and sent on the wire.
+ * - `label` is the human-readable text shown for the member.
+ * - `String()` is the Go-style explicit text conversion; it returns `String(wire)`.
+ * - `toString()` is the text conversion used by `String(value)` and template literals.
+ * - `toJSON()` is the persistence conversion used by `JSON.stringify`; it returns `wire`.
+ */
+export type ClosedValue<W extends string | number, L extends string> = {
+    readonly wire: W;
+    readonly label: L;
+    String: () => string;
+    toString: () => string;
+    toJSON: () => W;
+};

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

@@ -0,0 +1,12 @@
+/**
+ * @param {object} props
+ * @param {TurnVM} [props.turn]
+ * @param {import('react').ReactNode} [props.actions] the turn's trailing controls (copy anchor + host actions)
+ * @param {number} [props.revealRequest] explicit search navigation sequence; a new value opens the row
+ */
+export default function TranscriptControlRow({ turn, actions, revealRequest }: {
+    turn?: TurnVM;
+    actions?: import("react").ReactNode;
+    revealRequest?: number;
+}): import("react").JSX.Element;
+export type TurnVM = import("./view-model.js").TurnVM;

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

@@ -1,26 +1,26 @@
 export default function FiltersRail({ tab, filters, onFiltersChange, counts, checkpoints, filtersActive, onClear, onJumpStart, onJumpLatest, }: {
     tab: any;
-    filters?: {
-        categories: {
-            prompts: boolean;
-            responses: boolean;
-            thinking: boolean;
-            toolcalls: boolean;
-            system: boolean;
-        };
-        toolGroups: {};
-        tags: {
-            errors: boolean;
-            retries: boolean;
-            revert: boolean;
-        };
-        views: {
-            hidden: boolean;
-            expandAll: boolean;
-            compact: boolean;
-        };
-        checkpoint: string;
-    };
+    filters?: Readonly<{
+        categories: Readonly<{
+            prompts: true;
+            responses: true;
+            thinking: true;
+            toolcalls: true;
+            system: false;
+        }>;
+        toolGroups: Readonly<Record<import("./view-model.js").ToolGroup, boolean>>;
+        tags: Readonly<{
+            errors: false;
+            retries: false;
+            revert: false;
+        }>;
+        views: Readonly<{
+            hidden: true;
+            expandAll: false;
+            compact: false;
+        }>;
+        checkpoint: "all";
+    }>;
     onFiltersChange?: () => void;
     counts?: {
         categories: {

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

@@ -0,0 +1,19 @@
+/** @typedef {import('./system-groups.js').SystemGroupVM} SystemGroupVM */
+/**
+ * @param {object} props
+ * @param {SystemGroupVM} props.group
+ * @param {boolean} [props.open]
+ * @param {(open: boolean) => void} [props.onToggle]
+ * @param {import('react').ReactNode} [props.owner]  the owner's own row, rendered in place
+ * @param {import('react').ReactNode} [props.children] members 2..N, rendered inside the fold
+ * @param {number} [props.revealRequest] explicit navigation sequence; a new value opens the group
+ */
+export default function TranscriptSystemGroup({ group, open: openProp, onToggle, owner, children, revealRequest }: {
+    group: SystemGroupVM;
+    open?: boolean;
+    onToggle?: (open: boolean) => void;
+    owner?: import("react").ReactNode;
+    children?: import("react").ReactNode;
+    revealRequest?: number;
+}): import("react").JSX.Element;
+export type SystemGroupVM = import("./system-groups.js").SystemGroupVM;

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

@@ -10,13 +10,6 @@
  * @returns {number | undefined}
  */
 export function thinkingDurationMs(previous: TurnDetail | undefined, turn: TurnDetail): number | undefined;
-/**
- * Is this wire turn one of Claude Code's session metadata records rather than conversation?
- * @param {TurnDetail} turn
- * @param {string | undefined} harness  the session's harness
- * @returns {boolean}
- */
-export function isSessionMetadataTurn(turn: TurnDetail, harness: string | undefined): boolean;
 /**
  * Default turn prefilter the adapter applies independently per partition:
  * preserve normalized evidence, including unknown provenance and folded refs.

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

@@ -93,6 +93,12 @@ export function assessScorecard(sc: SessionScorecard | null | undefined, medians
  * The cooked task groups for a turn list (`computeTasks` mapped onto
  * `TaskGroupVM`). Exported so the adapter can populate the always-present
  * `vm.tasks` from the same single computation `computeAnalytics` uses.
+ *
+ * The list is the user turns: a session that opens with harness bookkeeping gets a
+ * leading span that starts on a system entry and has no prompt. That entry is not a
+ * user turn, so it never becomes a task card; the spans that survive keep their
+ * ORIGINAL ordinal so a card's `#` and the classic turn-boundary chip still agree
+ * with the turn labels they were cooked beside.
  * @param {TurnDetail[]} turns
  * @returns {TaskGroupVM[]}
  */

package/dist/lib/types/transcript/control-value.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The recorded value with its leading kind phrase removed; the recorded bytes
+ * otherwise, verbatim. Returns '' when the value names the kind and nothing else,
+ * so the row renders the kind once instead of printing it twice.
+ * @param {string | undefined | null} kind  the producer's `controlKind`
+ * @param {string | undefined | null} value the recorded value
+ * @returns {string}
+ */
+export function controlValueRemainder(kind: string | undefined | null, value: string | undefined | null): string;

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

@@ -1,3 +1,13 @@
+/**
+ * How many filter choices deviate from {@link DEFAULT_TRANSCRIPT_FILTERS}: the number
+ * the rail's "clear (N)" badge shows. Tool groups count only while `tool calls` is on,
+ * because the umbrella has already cascaded every group off and counting those would
+ * report eight active filters for one click.
+ *
+ * @param {TranscriptFilters} [filters]
+ * @returns {number}
+ */
+export function filtersActive(filters?: TranscriptFilters): number;
 /** @typedef {import('./view-model.js').TurnVM} TurnVM */
 /** @typedef {import('./view-model.js').ToolGroup} ToolGroup */
 /** @typedef {import('./state-capabilities.js').TranscriptFilters} TranscriptFilters */
@@ -121,6 +131,36 @@ export function toggleToolGroup(filters: TranscriptFilters, id: ToolGroup, count
  * @returns {TranscriptFilters}
  */
 export function setToolCalls(filters: TranscriptFilters, next: boolean): TranscriptFilters;
+/**
+ * The canonical filter state every consumer starts from. Complete (every category,
+ * every tool group, every tag, every view) because the viewer's controllable state
+ * does not merge a partial object: a host that supplies filters owns every key.
+ * Deep-frozen so a handler cannot mutate the default through a spread-by-reference.
+ *
+ * `system` is FALSE: system entries are harness bookkeeping, not conversation, and a
+ * reader reveals them from the rail when they want the evidence.
+ */
+export const DEFAULT_TRANSCRIPT_FILTERS: Readonly<{
+    categories: Readonly<{
+        prompts: true;
+        responses: true;
+        thinking: true;
+        toolcalls: true;
+        system: false;
+    }>;
+    toolGroups: Readonly<Record<import("./view-model.js").ToolGroup, boolean>>;
+    tags: Readonly<{
+        errors: false;
+        retries: false;
+        revert: false;
+    }>;
+    views: Readonly<{
+        hidden: true;
+        expandAll: false;
+        compact: false;
+    }>;
+    checkpoint: "all";
+}>;
 export type TurnVM = import("./view-model.js").TurnVM;
 export type ToolGroup = import("./view-model.js").ToolGroup;
 export type TranscriptFilters = import("./state-capabilities.js").TranscriptFilters;

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

@@ -1,4 +1,8 @@
 export { TOOL_GROUPS } from "./view-model.js";
+export { default as TranscriptControlRow } from "./ControlRow.jsx";
+export { default as TranscriptSystemGroup } from "./SystemGroup.jsx";
+export { systemGroups } from "./system-groups.js";
+export { systemGroupSummary } from "./system-summary.js";
 export { nextNavTurn } from "./turnNav.js";
 export { workSummary } from "./work-summary.js";
 export { default as TranscriptTurnCard } from "./TurnCard.jsx";
@@ -78,7 +82,7 @@ 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, isSessionMetadataTurn, diffLines } from "./adapter.js";
+export { adaptTranscript, prefilterTurns, diffLines } from "./adapter.js";
 export { computeTasks, computeTurnLabels, buildTaskWaterfall, annotateTranscript, computePersonalMedians, detectPhases, assessScorecard, computeAnalytics, computeTaskGroups, phaseLabel } from "./analytics.js";
 export { formatRelative, formatDurationMins, formatDurationMs, formatDurationSeconds, formatDateLong, isKnownTime } from "./time.js";
 export { summarizePrompt, composeSessionTitle, projectLabel, cleanSessionTitle, unwrapUserQuery } from "./title.js";

package/dist/lib/types/transcript/system-groups.d.ts

@@ -0,0 +1,30 @@
+/** @typedef {import('./view-model.js').TurnVM} TurnVM */
+/**
+ * @typedef {object} SystemGroupVM
+ * @property {string} id            stable key for the run (its owner's turn index)
+ * @property {TurnVM} owner         the first member; it renders in place, outside the collapsible
+ * @property {TurnVM[]} members     every member in turn order, owner first
+ */
+/**
+ * Group runs of two or more consecutive visible system turns.
+ *
+ * @param {TurnVM[]} [visibleTurns]
+ * @returns {Map<number, SystemGroupVM>} member turn index → its group; a non-system
+ *          turn and a singleton system turn are absent
+ */
+export function systemGroups(visibleTurns?: TurnVM[]): Map<number, SystemGroupVM>;
+export type TurnVM = import("./view-model.js").TurnVM;
+export type SystemGroupVM = {
+    /**
+     * stable key for the run (its owner's turn index)
+     */
+    id: string;
+    /**
+     * the first member; it renders in place, outside the collapsible
+     */
+    owner: TurnVM;
+    /**
+     * every member in turn order, owner first
+     */
+    members: TurnVM[];
+};

package/dist/lib/types/transcript/system-summary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The summary under a system-entry group head: `6 entries: 4 mode, 2 attachment`.
+ * A member without a producer kind is a plain system message and is named `system`.
+ * Kinds sort by count (descending) then by name, so the head is stable across renders.
+ *
+ * @param {TurnVM[]} [members]
+ * @returns {string}
+ */
+export function systemGroupSummary(members?: TurnVM[]): string;
+export type TurnVM = import("./view-model.js").TurnVM;

package/dist/lib/types/transcript/view-model.d.ts

@@ -360,6 +360,16 @@ export type TurnVM = {
      * subagent name when depth > 0
      */
     agentName?: string;
+    /**
+     * the producer's control-record kind for this turn, when the
+     *          server classified it (mode / permission-mode / attachment /
+     *          agent-name / custom-title); never inferred from any other field
+     */
+    controlKind?: string;
+    /**
+     * true exactly when `controlKind` is present
+     */
+    isControl?: boolean;
     thinking?: ThinkingVM;
     usage?: import("@peasant-labs/schema").UsageDetail;
     toolCalls: ToolCallVM[];

package/dist/lib/types/ui/transcript/adapter.d.ts

@@ -10,13 +10,6 @@
  * @returns {number | undefined}
  */
 export function thinkingDurationMs(previous: TurnDetail | undefined, turn: TurnDetail): number | undefined;
-/**
- * Is this wire turn one of Claude Code's session metadata records rather than conversation?
- * @param {TurnDetail} turn
- * @param {string | undefined} harness  the session's harness
- * @returns {boolean}
- */
-export function isSessionMetadataTurn(turn: TurnDetail, harness: string | undefined): boolean;
 /**
  * Default turn prefilter the adapter applies independently per partition:
  * preserve normalized evidence, including unknown provenance and folded refs.

package/dist/lib/types/ui/transcript/analytics.d.ts

@@ -93,6 +93,12 @@ export function assessScorecard(sc: SessionScorecard | null | undefined, medians
  * The cooked task groups for a turn list (`computeTasks` mapped onto
  * `TaskGroupVM`). Exported so the adapter can populate the always-present
  * `vm.tasks` from the same single computation `computeAnalytics` uses.
+ *
+ * The list is the user turns: a session that opens with harness bookkeeping gets a
+ * leading span that starts on a system entry and has no prompt. That entry is not a
+ * user turn, so it never becomes a task card; the spans that survive keep their
+ * ORIGINAL ordinal so a card's `#` and the classic turn-boundary chip still agree
+ * with the turn labels they were cooked beside.
  * @param {TurnDetail[]} turns
  * @returns {TaskGroupVM[]}
  */

package/dist/lib/types/ui/transcript/view-model.d.ts

@@ -360,6 +360,16 @@ export type TurnVM = {
      * subagent name when depth > 0
      */
     agentName?: string;
+    /**
+     * the producer's control-record kind for this turn, when the
+     *          server classified it (mode / permission-mode / attachment /
+     *          agent-name / custom-title); never inferred from any other field
+     */
+    controlKind?: string;
+    /**
+     * true exactly when `controlKind` is present
+     */
+    isControl?: boolean;
     thinking?: ThinkingVM;
     usage?: import("@peasant-labs/schema").UsageDetail;
     toolCalls: ToolCallVM[];