The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
/**
* RunItemDataBrowser (Phase 6)
* ----------------------------
*
* Per-item data browser for a single run step's output, extracted from
* {@link FlowRunInspectorDrawer} to keep both files small. Renders the n8n
* signature **table ⟷ JSON** toggle over the step's normalized output items
* (see `lib/flows/runItems.ts`):
*
* - **Table view** — one row per item, columns derived from the union of the
* items' `json` keys. Long cell values truncate (full value on hover via
* `title`); the whole table scrolls horizontally when wide.
* - **JSON view** — the items' `json` payloads pretty-printed, vertically
* scrollable.
*
* Binary attachments are never inlined — they render as placeholder chips
* (name / MIME). When an output item carries a resolved `paired_item` and the
* caller supplied the step's `inputItems`, a "Source" affordance reveals the
* input item that produced it; absent pairing, no affordance is offered.
*/
import debug from 'debug';
import { useMemo, useState } from 'react';
import {
cellValue,
collectColumns,
type FlowRunItem,
formatCell,
formatJson,
hasObjectRows,
} from '../../lib/flows/runItems';
import { useT } from '../../lib/i18n/I18nContext';
import { truncateText } from '../../utils/truncateText';
import {
Badge,
Table,
TableBody,
TableCell,
TableHead,
TableHeader,
TableRow,
Toggle,
ToggleGroupItem,
ToggleGroupRoot,
} from '../ui';
const log = debug('flows:run-item-data-browser');
/** Cap a single table cell's rendered text so one huge value can't blow out the row. */
const MAX_CELL_CHARS = 200;
type ViewMode = 'table' | 'json';
function truncate(text: string): string {
return truncateText(text, MAX_CELL_CHARS);
}
interface BinaryChipsProps {
binary: FlowRunItem['binary'];
testId: string;
}
/** Placeholder chips for an item's binary attachments — metadata only, no bytes. */
function BinaryChips({ binary, testId }: BinaryChipsProps) {
const { t } = useT();
if (binary.length === 0) return null;
return (
<div className="flex flex-wrap gap-1" data-testid={testId}>
{binary.map(ref => (
<Badge key={ref.key} dot={false} title={ref.mimeType ?? undefined}>
<span aria-hidden>📎</span>
<span className="font-mono">{ref.fileName ?? ref.key}</span>
<span className="rounded bg-surface-muted px-1 text-[9px] uppercase text-content-faint">
{ref.mimeType ?? t('flowRuns.inspector.binaryLabel')}
</span>
</Badge>
))}
</div>
);
}
interface Props {
/** Normalized output items of the step being inspected. */
items: FlowRunItem[];
/**
* Normalized items of the step's *input* (typically the upstream step's
* output). When present, output items carrying a resolved `paired_item` gain
* a "Source" affordance that reveals the input item at that index. Omitted →
* no pairing affordance is offered.
*/
inputItems?: FlowRunItem[];
/** Stable prefix for `data-testid`s so multiple browsers on one screen don't collide. */
testIdPrefix: string;
}
export function RunItemDataBrowser({ items, inputItems, testIdPrefix }: Props) {
const { t } = useT();
const [view, setView] = useState<ViewMode>('table');
// Which output row currently has its paired source input revealed (single-open).
const [revealedSource, setRevealedSource] = useState<number | null>(null);
const columns = useMemo(() => collectColumns(items), [items]);
const useColumns = hasObjectRows(items) && columns.length > 0;
const showActions = useMemo(
() =>
items.some(
item => item.binary.length > 0 || (item.pairedIndex !== null && inputItems !== undefined)
),
[items, inputItems]
);
const jsonText = useMemo(() => formatJson(items.map(item => item.json)), [items]);
const totalColSpan = 1 + (useColumns ? columns.length : 1) + (showActions ? 1 : 0);
if (items.length === 0) {
return (
<p className="text-[11px] italic text-content-faint" data-testid={`${testIdPrefix}-no-items`}>
{t('flowRuns.inspector.noItems')}
</p>
);
}
const toggleSource = (index: number, pairedIndex: number) => {
const next = revealedSource === index ? null : index;
log(
'toggleSource: prefix=%s row=%d paired=%d open=%s',
testIdPrefix,
index,
pairedIndex,
next !== null
);
setRevealedSource(next);
};
return (
<div data-testid={`${testIdPrefix}-data-browser`}>
{/* Header: view toggle + item count. */}
<div className="mb-1.5 flex items-center justify-between gap-2">
<ToggleGroupRoot
type="single"
variant="secondary"
size="xs"
value={view}
onValueChange={next => {
if (next) setView(next as ViewMode);
}}
aria-label={t('flowRuns.inspector.dataViewLabel')}
className="overflow-hidden rounded-md border border-line gap-0 *:rounded-none">
<ToggleGroupItem
value="table"
data-testid={`${testIdPrefix}-view-table`}
className="border-0 px-2 py-0.5 text-[11px]">
{t('flowRuns.inspector.dataTable')}
</ToggleGroupItem>
<ToggleGroupItem
value="json"
data-testid={`${testIdPrefix}-view-json`}
className="border-0 border-l border-line px-2 py-0.5 text-[11px]">
{t('flowRuns.inspector.dataJson')}
</ToggleGroupItem>
</ToggleGroupRoot>
<span className="text-[10px] text-content-faint" data-testid={`${testIdPrefix}-item-count`}>
{t('flowRuns.inspector.itemCount').replace('{count}', String(items.length))}
</span>
</div>
{view === 'json' ? (
<pre
data-testid={`${testIdPrefix}-json`}
className="max-h-72 overflow-auto whitespace-pre-wrap wrap-break-word rounded bg-surface px-2 py-1.5 font-mono text-[11px] leading-relaxed text-content-secondary">
{jsonText}
</pre>
) : (
<div
className="max-h-72 overflow-auto rounded border border-line"
data-testid={`${testIdPrefix}-table-scroll`}>
<Table className="text-left text-[11px]" data-testid={`${testIdPrefix}-table`}>
<TableHeader>
<TableRow className="bg-surface-muted text-content-muted hover:bg-surface-muted">
<TableHead className="h-auto px-1.5 py-1 font-medium" aria-hidden />
{useColumns ? (
columns.map(column => (
<TableHead key={column} className="h-auto px-1.5 py-1 font-mono font-medium">
{column}
</TableHead>
))
) : (
<TableHead className="h-auto px-1.5 py-1 font-medium">
{t('flowRuns.inspector.dataJson')}
</TableHead>
)}
{showActions && <TableHead className="h-auto px-1.5 py-1" aria-hidden />}
</TableRow>
</TableHeader>
<TableBody>
{items.map((item, index) => {
const canPair = item.pairedIndex !== null && inputItems !== undefined;
const sourceItem =
canPair && item.pairedIndex !== null ? inputItems?.[item.pairedIndex] : undefined;
const isRevealed = revealedSource === index;
return (
<FragmentRow
key={index}
item={item}
index={index}
columns={columns}
useColumns={useColumns}
showActions={showActions}
canPair={canPair}
isRevealed={isRevealed}
sourceItem={sourceItem}
totalColSpan={totalColSpan}
testIdPrefix={testIdPrefix}
onToggleSource={() =>
item.pairedIndex !== null && toggleSource(index, item.pairedIndex)
}
/>
);
})}
</TableBody>
</Table>
</div>
)}
</div>
);
}
interface FragmentRowProps {
item: FlowRunItem;
index: number;
columns: string[];
useColumns: boolean;
showActions: boolean;
canPair: boolean;
isRevealed: boolean;
sourceItem: FlowRunItem | undefined;
totalColSpan: number;
testIdPrefix: string;
onToggleSource: () => void;
}
function FragmentRow({
item,
index,
columns,
useColumns,
showActions,
canPair,
isRevealed,
sourceItem,
totalColSpan,
testIdPrefix,
onToggleSource,
}: FragmentRowProps) {
const { t } = useT();
return (
<>
<TableRow
data-testid={`${testIdPrefix}-row-${index}`}
className="align-top hover:bg-transparent">
<th
scope="row"
data-slot="table-cell"
className="px-1.5 py-1 text-left align-middle font-mono font-normal text-content-faint">
{index + 1}
</th>
{useColumns ? (
columns.map(column => {
const text = formatCell(cellValue(item, column));
return (
<TableCell
key={column}
className="max-w-[16rem] truncate px-1.5 py-1 font-mono text-content-secondary"
title={text || undefined}>
{truncate(text)}
</TableCell>
);
})
) : (
<TableCell
className="max-w-[16rem] truncate px-1.5 py-1 font-mono text-content-secondary"
title={formatCell(item.json) || undefined}>
{truncate(formatCell(item.json))}
</TableCell>
)}
{showActions && (
<TableCell className="whitespace-nowrap px-1.5 py-1">
<div className="flex items-center justify-end gap-1.5">
<BinaryChips binary={item.binary} testId={`${testIdPrefix}-binary-${index}`} />
{canPair && (
<Toggle
variant="secondary"
size="xs"
data-testid={`${testIdPrefix}-source-toggle-${index}`}
pressed={isRevealed}
onPressedChange={onToggleSource}
className="h-auto px-1.5 py-0.5 text-[10px]">
{isRevealed
? t('flowRuns.inspector.hideSource')
: t('flowRuns.inspector.showSource')}
</Toggle>
)}
</div>
</TableCell>
)}
</TableRow>
{canPair && isRevealed && (
<TableRow data-testid={`${testIdPrefix}-source-${index}`} className="hover:bg-transparent">
<TableCell colSpan={totalColSpan} className="bg-surface-muted px-1.5 py-1.5">
<div className="text-[10px] font-semibold uppercase tracking-wide text-content-faint">
{t('flowRuns.inspector.sourceInputTitle')}
</div>
<pre className="mt-1 max-h-48 overflow-auto whitespace-pre-wrap wrap-break-word rounded bg-surface px-2 py-1.5 font-mono text-[11px] leading-relaxed text-content-secondary">
{sourceItem ? formatJson(sourceItem.json) : t('flowRuns.inspector.emptyValue')}
</pre>
</TableCell>
</TableRow>
)}
</>
);
}