@xenosystem/blocks 0.13.11 → 0.13.13

package/dist/ops/index.d.ts

@@ -1,5 +1,5 @@
-import { PanelModule, PanelManifest } from '@xenosystem/block-sdk';
-import { ReactNode } from 'react';
+import { PanelModule, PanelManifest, BlockDeclaration } from '@xenosystem/block-sdk';
+import { ReactNode, ReactElement } from 'react';
 import { ThrottleClock } from '@xenosystem/tree-core';
 
 /**
@@ -433,6 +433,18 @@ declare class ConsoleController {
     /** Every source seen, with its contribution count and current visibility. */
     sources(): XenoLogSource[];
     /** Follow the tail. Auto-disabled by the view when the user scrolls up. */
+    private expandedId;
+    private viewport;
+    /** Which record's data is expanded under its row, if any. */
+    getExpanded(): string | null;
+    /** Toggle a record's expanded detail (only records carrying `data` expand). */
+    toggleExpanded(recordId: string): void;
+    /** The scroller reports its viewport; the view state windows the rows from it. */
+    setViewport(height: number, scrollTop: number): void;
+    getViewport(): {
+        height: number;
+        scrollTop: number;
+    };
     setFollow(follow: boolean): void;
     /** Collapse adjacent duplicates. */
     setCollapse(collapse: boolean): void;
@@ -512,7 +524,101 @@ declare const CONSOLE_PANEL_ID = "xeno.core.console";
 declare const consoleManifest: PanelManifest;
 
 /**
- * The Console panel view — virtualized, follow-tail, per-source chips.
+ * The Console panel AS A DECLARATION — the fourteenth declared block, and the second virtualized list
+ * (after history): a multiplexed log.
+ *
+ * Everything drawn is data: the toolbar (search, the minimum-level control, the error/warn counts,
+ * copy and clear), the per-source `FilterChip`s (only when there is more than one stream), the
+ * empty states, the windowed rows — each a `Row` whose label is the time, the level `Badge`, the
+ * source and the message, with a repeat badge trailing and the expanded record as a `Code` block
+ * under it — and the status bar. What a declaration cannot hold: the SCROLLER (`console/Scroller`,
+ * the element the virtualizer measures and follow-mode pins to the bottom) — the one runtime-bound
+ * unit. Which row is expanded lives in the controller now, not in React state.
+ */
+
+interface ConsoleViewRow {
+    id: string;
+    time?: string;
+    level: string;
+    tone: 'neutral' | 'info' | 'warning' | 'error';
+    source?: string;
+    message: string;
+    repeat?: string;
+    expanded: boolean;
+    detail?: string;
+}
+interface ConsoleViewSource {
+    id: string;
+    label: string;
+    on: boolean;
+    title: string;
+}
+interface ConsoleViewModel {
+    search: string;
+    levels: {
+        value: string;
+        label: string;
+    }[];
+    level: string;
+    errors?: string;
+    warns?: string;
+    multiSource: boolean;
+    sources: ConsoleViewSource[];
+    empty: boolean;
+    emptyTitle: string;
+    emptyHint: string;
+    listed: boolean;
+    rowHeight: number;
+    totalHeight: number;
+    offsetTop: number;
+    rows: ConsoleViewRow[];
+    countLabel: string;
+    followLabel?: string;
+}
+type ConsoleUiIntent = {
+    kind: 'search';
+    value: string;
+} | {
+    kind: 'level';
+    level: string;
+} | {
+    kind: 'copyVisible';
+} | {
+    kind: 'clear';
+} | {
+    kind: 'source';
+    id: string;
+    on: boolean;
+} | {
+    kind: 'row';
+    id: string;
+} | {
+    kind: 'contextMenu';
+    id: string;
+    x: number;
+    y: number;
+};
+interface ConsoleViewOptions {
+    rowHeight?: number;
+    showTimestamps?: boolean;
+    emptyHint?: string;
+}
+/** Derive the view from the live controller — the runtime calls this on every draw. */
+declare function consoleViewState(c: ConsoleController, options?: ConsoleViewOptions): ConsoleViewModel;
+declare function applyConsoleUi(c: ConsoleController, intent: ConsoleUiIntent): void;
+declare const consoleViewManifest: PanelManifest;
+declare const BEHAVIOURS$1: {
+    'ops/consolePanelView': (inputs: Record<string, unknown>) => ConsoleViewModel;
+};
+/** The runtime-bound unit: the scroller the virtualizer measures and follow-mode pins. */
+declare const CONSOLE_RUNTIME_UNITS: readonly ["console/Scroller"];
+declare const CONSOLE_DECLARATION: BlockDeclaration;
+
+/**
+ * The Console panel view — the CODE VIEW of `CONSOLE_DECLARATION`, drawing the same
+ * `ConsoleViewModel` byte-identical (the equivalence suite holds the two together). The one thing this
+ * file owns that the declaration cannot is `console/Scroller`: the element the virtualizer measures,
+ * whose scroll position the controller mirrors, and which follow-mode pins to the bottom.
  *
  * Composes `@xenosystem/components/chrome`; the host must ensure `@xenosystem/workbench/primitives.css` is
  * present.
@@ -521,14 +627,18 @@ declare const consoleManifest: PanelManifest;
  */
 
 /** Props for {@link ConsolePanelView}. */
-interface ConsolePanelViewProps {
+interface ConsolePanelViewProps extends ConsoleViewOptions {
     controller: ConsoleController;
-    rowHeight?: number;
-    showTimestamps?: boolean;
-    emptyHint?: string;
 }
+/** `console/Scroller` — measures the viewport for the virtualizer, mirrors scroll, pins follow-mode to the bottom. */
+declare function ConsoleScroller({ controller, rowHeight, children }: {
+    controller: ConsoleController;
+    rowHeight?: number;
+    children?: ReactNode;
+}): ReactElement;
+declare function consoleRuntimeComponents(controller: ConsoleController, rowHeight?: number): Record<(typeof CONSOLE_RUNTIME_UNITS)[number], React.ComponentType<any>>;
 /** The Console panel view. */
-declare function ConsolePanelView({ controller, rowHeight, showTimestamps, emptyHint, }: ConsolePanelViewProps): ReactNode;
+declare function ConsolePanelView({ controller, ...options }: ConsolePanelViewProps): ReactNode;
 
 /**
  * The `xeno.core.runs` contract.
@@ -1309,26 +1419,128 @@ interface FlattenOptions {
 declare function flattenRunRows(runs: readonly XenoRun[], options: FlattenOptions): XenoRunRow[];
 
 /**
- * The Runs panel view.
+ * The Runs panel AS A DECLARATION — the fifteenth declared block: the run/step tree of every agent
+ * and workflow surface, as ONE flat row shape.
+ *
+ * Everything drawn is data: the toolbar (search, Clear finished), the status and source `FilterChip`s
+ * (clicking `failed` alone IS the dead-letter view), the empty states, the rows — the controller has
+ * already walked the tree once (`flattenRunRows`), so a run row and a step row are the same `Row`
+ * with a depth, a status badge, a label, the trigger / retry / truncation badges, a `Progress` or a
+ * duration in the meta slot, cancel / retry trailing, and a run's error line as an inset `Note` —
+ * and the status bar with the success rate. No runtime-bound unit; the clock is a view option.
+ */
+
+type Tone = 'neutral' | 'info' | 'success' | 'warning' | 'error';
+/** Never index `TONE` directly with a status off the wire — a host one version ahead sends a status this build does not know. */
+declare const toneOf: (status: XenoRunStatus) => Tone;
+interface RunsViewChip {
+    id: string;
+    label: string;
+    on: boolean;
+    tone: Tone;
+    title?: string;
+}
+interface RunsViewRow {
+    key: string;
+    runId: string;
+    stepPath: XenoRunPath;
+    depth: number;
+    step: boolean;
+    status: string;
+    tone: Tone;
+    label: string;
+    trigger?: string;
+    retries?: string;
+    truncated?: string;
+    truncatedHint?: string;
+    hasProgress: boolean;
+    progress: number;
+    progressLabel: string;
+    duration?: string;
+    canCancel: boolean;
+    cancelLabel: string;
+    canRetry: boolean;
+    retryLabel: string;
+    hasError: boolean;
+    errorCode?: string;
+    errorMessage?: string;
+}
+interface RunsViewModel {
+    search: string;
+    statuses: RunsViewChip[];
+    multiSource: boolean;
+    sources: RunsViewChip[];
+    hasChips: boolean;
+    empty: boolean;
+    emptyTitle: string;
+    emptyHint: string;
+    listed: boolean;
+    rows: RunsViewRow[];
+    countLabel: string;
+    statsLabel?: string;
+}
+type RunsUiIntent = {
+    kind: 'search';
+    value: string;
+} | {
+    kind: 'clearTerminal';
+} | {
+    kind: 'status';
+    status: string;
+    on: boolean;
+} | {
+    kind: 'source';
+    id: string;
+    on: boolean;
+} | {
+    kind: 'row';
+    runId: string;
+    stepPath: XenoRunPath;
+} | {
+    kind: 'contextMenu';
+    runId: string;
+    x: number;
+    y: number;
+} | {
+    kind: 'cancel';
+    runId: string;
+} | {
+    kind: 'retry';
+    runId: string;
+};
+interface RunsViewOptions {
+    showStats?: boolean;
+    showProgress?: boolean;
+    emptyHint?: string;
+    now?: () => number;
+}
+/** Derive the view from the live controller — the runtime calls this on every draw. */
+declare function runsViewState(c: RunsController, options?: RunsViewOptions): RunsViewModel;
+declare function applyRunsUi(c: RunsController, intent: RunsUiIntent): void;
+declare const runsViewManifest: PanelManifest;
+declare const BEHAVIOURS: {
+    'ops/runsPanelView': (inputs: Record<string, unknown>) => RunsViewModel;
+};
+declare const RUNS_RUNTIME_UNITS: readonly [];
+declare const RUNS_DECLARATION: BlockDeclaration;
+
+/**
+ * The Runs panel view — the CODE VIEW of `RUNS_DECLARATION`, drawing the same `RunsViewModel`
+ * byte-identical (the equivalence suite holds the two together). No runtime-bound unit; every
+ * intent goes through `applyRunsUi`.
  *
  * Composes `@xenosystem/components/chrome`; the host must ensure `@xenosystem/workbench/primitives.css` is
- * present. `ProportionBar` carries progress — it is exactly the right mark, and it means the panel
- * ships no chart code of its own.
+ * present.
  *
  * @module
  */
 
 /** Props for {@link RunsPanelView}. */
-interface RunsPanelViewProps {
+interface RunsPanelViewProps extends RunsViewOptions {
     controller: RunsController;
-    showStats?: boolean;
-    showProgress?: boolean;
-    emptyHint?: string;
-    /** Injectable clock, so a duration column is testable. */
-    now?: () => number;
 }
 /** The Runs panel view. */
-declare function RunsPanelView({ controller, showStats, showProgress, emptyHint, now, }: RunsPanelViewProps): ReactNode;
+declare function RunsPanelView({ controller, ...options }: RunsPanelViewProps): ReactNode;
 
 /**
  * The Terminal contract.
@@ -2232,4 +2444,4 @@ interface DiffPanelViewProps {
 /** The Diff panel view. */
 declare function DiffPanelView({ controller, highlighter, review }: DiffPanelViewProps): ReactNode;
 
-export { ALL_STATUSES, CONSOLE_PANEL_ID, ConsoleController, type ConsoleControllerOptions, type ConsoleHostBridge, type ConsolePanelState, ConsolePanelView, type ConsolePanelViewProps, type ConsoleRenderContext, type ConsoleViewState, type CreateConsolePanelOptions, type CreateDiffPanelOptions, type CreateRunsPanelOptions, type CreateTerminalPanelOptions, DEFAULT_MAX_STEP_DEPTH, DIFF_PANEL_ID, DiffController, type DiffControllerOptions, type DiffFileView, type DiffHostBridge, type DiffPanelState, DiffPanelView, type DiffPanelViewProps, type DiffRenderContext, type DiffViewState, type FlattenOptions, LEVEL_ORDER, MESSAGE_ELISION, REDACTION_CARRY, RUNS_PANEL_ID, RUN_PATH_SEPARATOR, RUN_STATUSES, RunsController, type RunsControllerOptions, type RunsHostBridge, type RunsPanelState, RunsPanelView, type RunsPanelViewProps, type RunsRenderContext, type RunsViewState, TERMINAL_PANEL_ID, TERMINAL_STATUSES, TerminalController, type TerminalControllerOptions, type TerminalHostBridge, type TerminalInstanceView, type TerminalPanelState, TerminalPanelView, type TerminalPanelViewProps, type TerminalRenderContext, type TerminalViewState, XENO_TERMINAL_THEME_KEYS, type XenoDiffAction, type XenoDiffDecision, type XenoDiffDecisionIntent, type XenoDiffDecisionState, type XenoDiffFile, type XenoDiffFileOmission, type XenoDiffHighlighter, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, type XenoDiffModel, type XenoDiffNavigate, type XenoDiffSegment, type XenoDiffStatus, type XenoDiffView, type XenoLogActivate, type XenoLogDelta, type XenoLogFilter, type XenoLogLevel, type XenoLogPatch, type XenoLogRecord, type XenoLogSource, type XenoRun, type XenoRunAction, type XenoRunActivate, type XenoRunDelta, type XenoRunError, type XenoRunFilter, type XenoRunLifecycle, type XenoRunPath, type XenoRunRow, type XenoRunRunRow, type XenoRunStats, type XenoRunStatus, type XenoRunStep, type XenoRunStepAppend, type XenoRunStepPatch, type XenoRunStepRow, type XenoRunTruncation, type XenoTerminalData, type XenoTerminalEmulator, type XenoTerminalId, type XenoTerminalIntent, type XenoTerminalSession, type XenoTerminalStatus, type XenoTerminalTheme, appendStepsAtPath, canCancel, canRetry, collapseAdjacent, computeStats, consoleManifest, consolePanel, countChanges, createConsolePanel, createDiffPanel, createRunsPanel, createTerminalPanel, decodeRunPath, diffManifest, diffPanel, durationOf, encodeRunPath, flattenHunks, flattenRunRows, formatDuration, formatRecord, isActive, isLive, isSettled, isTerminal, isWaiting, lifecycleOf, matchesSearch as matchesRunSearch, matchesSearch$1 as matchesSearch, measuredSize, meetsLevel, needsAttention, omissionLabel, patchStepAtPath, queueDurationOf, readTerminalTheme, resolveStepPath, runsManifest, runsPanel, safeJson, spliceRedactedAppend, splitRows, statusLabel, terminalManifest, terminalPanel, terminalThemeVar, truncateLogMessage };
+export { ALL_STATUSES, BEHAVIOURS$1 as CONSOLE_BEHAVIOURS, CONSOLE_DECLARATION, CONSOLE_PANEL_ID, CONSOLE_RUNTIME_UNITS, ConsoleController, type ConsoleControllerOptions, type ConsoleHostBridge, type ConsolePanelState, ConsolePanelView, type ConsolePanelViewProps, type ConsoleRenderContext, ConsoleScroller, type ConsoleUiIntent, type ConsoleViewModel, type ConsoleViewOptions, type ConsoleViewRow, type ConsoleViewSource, type ConsoleViewState, type CreateConsolePanelOptions, type CreateDiffPanelOptions, type CreateRunsPanelOptions, type CreateTerminalPanelOptions, DEFAULT_MAX_STEP_DEPTH, DIFF_PANEL_ID, DiffController, type DiffControllerOptions, type DiffFileView, type DiffHostBridge, type DiffPanelState, DiffPanelView, type DiffPanelViewProps, type DiffRenderContext, type DiffViewState, type FlattenOptions, LEVEL_ORDER, MESSAGE_ELISION, REDACTION_CARRY, BEHAVIOURS as RUNS_BEHAVIOURS, RUNS_DECLARATION, RUNS_PANEL_ID, RUNS_RUNTIME_UNITS, RUN_PATH_SEPARATOR, RUN_STATUSES, RunsController, type RunsControllerOptions, type RunsHostBridge, type RunsPanelState, RunsPanelView, type RunsPanelViewProps, type RunsRenderContext, type RunsUiIntent, type RunsViewChip, type RunsViewModel, type RunsViewOptions, type RunsViewRow, type RunsViewState, TERMINAL_PANEL_ID, TERMINAL_STATUSES, TerminalController, type TerminalControllerOptions, type TerminalHostBridge, type TerminalInstanceView, type TerminalPanelState, TerminalPanelView, type TerminalPanelViewProps, type TerminalRenderContext, type TerminalViewState, XENO_TERMINAL_THEME_KEYS, type XenoDiffAction, type XenoDiffDecision, type XenoDiffDecisionIntent, type XenoDiffDecisionState, type XenoDiffFile, type XenoDiffFileOmission, type XenoDiffHighlighter, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, type XenoDiffModel, type XenoDiffNavigate, type XenoDiffSegment, type XenoDiffStatus, type XenoDiffView, type XenoLogActivate, type XenoLogDelta, type XenoLogFilter, type XenoLogLevel, type XenoLogPatch, type XenoLogRecord, type XenoLogSource, type XenoRun, type XenoRunAction, type XenoRunActivate, type XenoRunDelta, type XenoRunError, type XenoRunFilter, type XenoRunLifecycle, type XenoRunPath, type XenoRunRow, type XenoRunRunRow, type XenoRunStats, type XenoRunStatus, type XenoRunStep, type XenoRunStepAppend, type XenoRunStepPatch, type XenoRunStepRow, type XenoRunTruncation, type XenoTerminalData, type XenoTerminalEmulator, type XenoTerminalId, type XenoTerminalIntent, type XenoTerminalSession, type XenoTerminalStatus, type XenoTerminalTheme, appendStepsAtPath, applyConsoleUi, applyRunsUi, canCancel, canRetry, collapseAdjacent, computeStats, consoleManifest, consolePanel, consoleRuntimeComponents, consoleViewManifest, consoleViewState, countChanges, createConsolePanel, createDiffPanel, createRunsPanel, createTerminalPanel, decodeRunPath, diffManifest, diffPanel, durationOf, encodeRunPath, flattenHunks, flattenRunRows, formatDuration, formatRecord, isActive, isLive, isSettled, isTerminal, isWaiting, lifecycleOf, matchesSearch as matchesRunSearch, matchesSearch$1 as matchesSearch, measuredSize, meetsLevel, needsAttention, omissionLabel, patchStepAtPath, queueDurationOf, readTerminalTheme, resolveStepPath, runsManifest, runsPanel, runsViewManifest, runsViewState, safeJson, spliceRedactedAppend, splitRows, statusLabel, terminalManifest, terminalPanel, terminalThemeVar, toneOf, truncateLogMessage };