ionbase-ui 0.73.0 → 0.76.0

package/dist/components/Chart.d.ts

@@ -0,0 +1,95 @@
+import React from 'react';
+/**
+ * Chart parts for charts drawn with visx.
+ *
+ * IonBase does not draw charts, and does not depend on visx. visx owns scales,
+ * shapes and layout; these own what a chart looks like and the two pieces
+ * every chart needs and no charting library supplies — a tooltip panel and a
+ * legend. See `styles/chart.css` for the classes, and why they are classes.
+ */
+/** Which of `--chart-1…8` a series takes. Series are coloured in order. */
+export type ChartSeries = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+/** The class that colours a series: its line, bar, area, points and swatch. */
+export declare const chartSeriesClass: (series: ChartSeries) => string;
+/**
+ * Spread onto visx `AxisLeft` / `AxisBottom` / `Axis`. Themes the axis line,
+ * tick marks and tick labels through `chart.css`, overriding the `#222` visx
+ * writes as attributes.
+ *
+ *   <AxisBottom scale={x} top={h} {...chartAxisProps} />
+ *
+ * Passing your own `tickLabelProps` replaces this one — keep
+ * `className: 'ion-chart__tick'` in it.
+ */
+export declare const chartAxisProps: {
+    axisLineClassName: string;
+    tickClassName: string;
+    labelClassName: string;
+    tickLabelProps: {
+        className: string;
+    };
+};
+/**
+ * Spread onto visx `GridRows` / `GridColumns`. Gridlines take `border/subtle`,
+ * the quietest rule, so they sit behind the data rather than competing with it.
+ */
+export declare const chartGridProps: {
+    className: string;
+};
+/**
+ * Spread onto visx `Tooltip` / `TooltipWithBounds` / `TooltipInPortal`, with a
+ * `ChartTooltip` inside. visx then only positions it; the panel is ours.
+ */
+export declare const chartTooltipProps: {
+    unstyled: boolean;
+    applyPositionStyle: boolean;
+};
+export interface ChartTooltipRow {
+    /** The series or measure, e.g. "Success rate". */
+    label: React.ReactNode;
+    /** Already formatted — the tooltip cannot know the unit or precision. */
+    value: React.ReactNode;
+    /** Shows the series' swatch beside the label, matching the legend. */
+    series?: ChartSeries;
+}
+export interface ChartTooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** What the pointer is over — usually the x value, e.g. a date. */
+    title?: React.ReactNode;
+    /** One row per series at that point. */
+    rows?: ChartTooltipRow[];
+    /** Free content after the rows, for anything that is not label/value. */
+    children?: React.ReactNode;
+}
+/**
+ * ChartTooltip — the panel that shows the values under the pointer.
+ *
+ * Put it inside visx's Tooltip with `chartTooltipProps`, so visx places it and
+ * this draws it: raised, rimmed and shadowed like Popover and Toast.
+ *
+ * IT IS NOT THE ACCESSIBLE WAY TO THE DATA. It appears on hover, so a keyboard
+ * or screen-reader user never sees it. Every chart still needs a text summary
+ * and the values in a table (visually hidden is fine) — the tooltip is a
+ * convenience for pointer users, never the only route to a number.
+ */
+export declare const ChartTooltip: React.ForwardRefExoticComponent<ChartTooltipProps & React.RefAttributes<HTMLDivElement>>;
+export type ChartLegendShape = 'square' | 'line';
+export interface ChartLegendItem {
+    label: React.ReactNode;
+    series: ChartSeries;
+}
+export interface ChartLegendProps extends Omit<React.HTMLAttributes<HTMLUListElement>, 'children'> {
+    /** One per series, in the order the series are drawn. */
+    items: ChartLegendItem[];
+    /** `square` for bars and areas, `line` for line charts. */
+    shape?: ChartLegendShape;
+}
+/**
+ * ChartLegend — which colour is which series.
+ *
+ * Colour alone never identifies a series (SC 1.4.1), so any chart with more
+ * than one series needs this, or direct labels on the lines. The swatch reads
+ * the same `--chart-<n>` as the series itself, through `chartSeriesClass`, so
+ * the two cannot drift apart.
+ */
+export declare const ChartLegend: React.ForwardRefExoticComponent<ChartLegendProps & React.RefAttributes<HTMLUListElement>>;
+//# sourceMappingURL=Chart.d.ts.map

package/dist/components/Chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chart.d.ts","sourceRoot":"","sources":["../../src/components/Chart.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C;;;;;;;GAOG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExD,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,QAAQ,WAAW,WACtB,CAAC;AAE/B;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;CAK1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc;;CAE1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AAOF,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EACpC,OAAO,CACR;IACC,mEAAmE;IACnE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,wCAAwC;IACxC,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,0FA2BxB,CAAC;AAMF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAC5C,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,EACtC,UAAU,CACX;IACC,yDAAyD;IACzD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,2FAuBvB,CAAC"}

package/dist/components/Chart.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+/** The class that colours a series: its line, bar, area, points and swatch. */
+export const chartSeriesClass = (series) => `ion-chart-series-${series}`;
+/**
+ * Spread onto visx `AxisLeft` / `AxisBottom` / `Axis`. Themes the axis line,
+ * tick marks and tick labels through `chart.css`, overriding the `#222` visx
+ * writes as attributes.
+ *
+ *   <AxisBottom scale={x} top={h} {...chartAxisProps} />
+ *
+ * Passing your own `tickLabelProps` replaces this one — keep
+ * `className: 'ion-chart__tick'` in it.
+ */
+export const chartAxisProps = {
+    axisLineClassName: 'ion-chart__axis-line',
+    tickClassName: 'ion-chart__axis-tick',
+    labelClassName: 'ion-chart__axis-label',
+    tickLabelProps: { className: 'ion-chart__tick' },
+};
+/**
+ * Spread onto visx `GridRows` / `GridColumns`. Gridlines take `border/subtle`,
+ * the quietest rule, so they sit behind the data rather than competing with it.
+ */
+export const chartGridProps = {
+    className: 'ion-chart__grid',
+};
+/**
+ * Spread onto visx `Tooltip` / `TooltipWithBounds` / `TooltipInPortal`, with a
+ * `ChartTooltip` inside. visx then only positions it; the panel is ours.
+ */
+export const chartTooltipProps = {
+    unstyled: true,
+    applyPositionStyle: true,
+};
+const cx = (...c) => c.filter(Boolean).join(' ');
+/**
+ * ChartTooltip — the panel that shows the values under the pointer.
+ *
+ * Put it inside visx's Tooltip with `chartTooltipProps`, so visx places it and
+ * this draws it: raised, rimmed and shadowed like Popover and Toast.
+ *
+ * IT IS NOT THE ACCESSIBLE WAY TO THE DATA. It appears on hover, so a keyboard
+ * or screen-reader user never sees it. Every chart still needs a text summary
+ * and the values in a table (visually hidden is fine) — the tooltip is a
+ * convenience for pointer users, never the only route to a number.
+ */
+export const ChartTooltip = forwardRef(({ title, rows, children, className, ...rest }, ref) => (_jsxs("div", { ...rest, ref: ref, className: cx('ion-chart-tooltip', className), children: [title != null && _jsx("div", { className: "ion-chart-tooltip__title", children: title }), rows && rows.length > 0 && (_jsx("dl", { className: "ion-chart-tooltip__rows", children: rows.map((row, i) => (_jsxs("div", { className: "ion-chart-tooltip__row", children: [_jsxs("dt", { className: cx('ion-chart-tooltip__label', row.series && chartSeriesClass(row.series)), children: [row.series && (_jsx("span", { className: "ion-chart-swatch", "aria-hidden": "true" })), row.label] }), _jsx("dd", { className: "ion-chart-tooltip__value", children: row.value })] }, i))) })), children] })));
+ChartTooltip.displayName = 'ChartTooltip';
+/**
+ * ChartLegend — which colour is which series.
+ *
+ * Colour alone never identifies a series (SC 1.4.1), so any chart with more
+ * than one series needs this, or direct labels on the lines. The swatch reads
+ * the same `--chart-<n>` as the series itself, through `chartSeriesClass`, so
+ * the two cannot drift apart.
+ */
+export const ChartLegend = forwardRef(({ items, shape = 'square', className, ...rest }, ref) => (_jsx("ul", { ...rest, ref: ref, className: cx('ion-chart-legend', className), children: items.map((item, i) => (_jsxs("li", { className: cx('ion-chart-legend__item', chartSeriesClass(item.series)), children: [_jsx("span", { className: cx('ion-chart-swatch', shape === 'line' && 'ion-chart-swatch--line'), "aria-hidden": "true" }), item.label] }, i))) })));
+ChartLegend.displayName = 'ChartLegend';
+//# sourceMappingURL=Chart.js.map

package/dist/components/Chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chart.js","sourceRoot":"","sources":["../../src/components/Chart.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAc1C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAmB,EAAE,EAAE,CACtD,oBAAoB,MAAM,EAAE,CAAC;AAE/B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,iBAAiB,EAAE,sBAAsB;IACzC,aAAa,EAAE,sBAAsB;IACrC,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE;CACjD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,iBAAiB;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,IAAI;IACd,kBAAkB,EAAE,IAAI;CACzB,CAAC;AAEF,MAAM,EAAE,GAAG,CAAC,GAAG,CAAiC,EAAE,EAAE,CAClD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAyB9B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CACpC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CACtD,kBAAS,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,mBAAmB,EAAE,SAAS,CAAC,aACnE,KAAK,IAAI,IAAI,IAAI,cAAK,SAAS,EAAC,0BAA0B,YAAE,KAAK,GAAO,EACxE,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAC1B,aAAI,SAAS,EAAC,yBAAyB,YACpC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CACpB,eAAa,SAAS,EAAC,wBAAwB,aAC7C,cACE,SAAS,EAAE,EAAE,CACX,0BAA0B,EAC1B,GAAG,CAAC,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAC3C,aAEA,GAAG,CAAC,MAAM,IAAI,CACb,eAAM,SAAS,EAAC,kBAAkB,iBAAa,MAAM,GAAG,CACzD,EACA,GAAG,CAAC,KAAK,IACP,EACL,aAAI,SAAS,EAAC,0BAA0B,YAAE,GAAG,CAAC,KAAK,GAAM,KAZjD,CAAC,CAaL,CACP,CAAC,GACC,CACN,EACA,QAAQ,IACL,CACP,CACF,CAAC;AAEF,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC;AAqB1C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CACnC,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CACxD,gBAAQ,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,kBAAkB,EAAE,SAAS,CAAC,YACjE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACtB,cAEE,SAAS,EAAE,EAAE,CACX,wBAAwB,EACxB,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAC9B,aAED,eACE,SAAS,EAAE,EAAE,CACX,kBAAkB,EAClB,KAAK,KAAK,MAAM,IAAI,wBAAwB,CAC7C,iBACW,MAAM,GAClB,EACD,IAAI,CAAC,KAAK,KAbN,CAAC,CAcH,CACN,CAAC,GACC,CACN,CACF,CAAC;AAEF,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC"}

package/dist/components/NavItem.d.ts

@@ -4,6 +4,13 @@ interface NavItemOwnProps {
     icon?: React.ReactNode;
     /** Figma's `Show Chevron`. Set on a nav item that opens a menu, not a plain link. */
     showChevron?: boolean;
+    /**
+     * The page the user is on. Marks the item `aria-current="page"` and draws
+     * the same indicator Tabs' underline does — so a section switcher built from
+     * NavItems says where you are, in words for a screen reader and in more than
+     * colour for everyone else.
+     */
+    isCurrent?: boolean;
     isDisabled?: boolean;
     /**
      * @deprecated Use `isDisabled`. Accepted as an alias for one minor version.

package/dist/components/NavItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavItem.d.ts","sourceRoot":"","sources":["../../src/components/NavItem.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkD,MAAM,OAAO,CAAC;AAmBvE,UAAU,eAAe;IACvB,sDAAsD;IACtD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,eAAe,GACxC,CACI,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CACtB,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,MAAM,eAAe,CACtB,CAAC,GACF,CAAC;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAC1B,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,MAAM,eAAe,GAAG,MAAM,CAC/B,CAAC,CACL,CAAC;AAEJ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,4GA+GlB,CAAC"}
+{"version":3,"file":"NavItem.d.ts","sourceRoot":"","sources":["../../src/components/NavItem.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkD,MAAM,OAAO,CAAC;AAmBvE,UAAU,eAAe;IACvB,sDAAsD;IACtD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,eAAe,GACxC,CACI,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CACtB,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,MAAM,eAAe,CACtB,CAAC,GACF,CAAC;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAC1B,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,MAAM,eAAe,GAAG,MAAM,CAC/B,CAAC,CACL,CAAC;AAEJ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,4GAkHlB,CAAC"}

package/dist/components/NavItem.js

@@ -20,7 +20,7 @@ const Chevron = () => (_jsx("svg", { viewBox: "0 0 24 24", fill: "none", "aria-h
  * `:focus-visible` rules so the stylesheet still works without React.
  */
 export const NavItem = forwardRef((props, forwardedRef) => {
-    const { icon, showChevron, isDisabled: isDisabledProp, disabled, children, className, href, ...rest } = props;
+    const { icon, showChevron, isCurrent, isDisabled: isDisabledProp, disabled, children, className, href, ...rest } = props;
     const isDisabled = resolveDisabled(isDisabledProp, disabled);
     const domRef = useRef(null);
     useImperativeHandle(forwardedRef, () => domRef.current);
@@ -28,6 +28,7 @@ export const NavItem = forwardRef((props, forwardedRef) => {
     const { focusProps, isFocusVisible } = useFocusRing();
     const classNames = [
         'ion-nav-item',
+        isCurrent ? 'ion-nav-item--current' : '',
         isDisabled ? 'ion-nav-item--disabled' : '',
         className || '',
     ]
@@ -37,6 +38,7 @@ export const NavItem = forwardRef((props, forwardedRef) => {
         'data-hovered': isHovered || undefined,
         'data-focused': isFocusVisible || undefined,
         'data-disabled': isDisabled || undefined,
+        'aria-current': isCurrent ? 'page' : undefined,
     };
     const content = (_jsxs(_Fragment, { children: [icon && (_jsx("span", { className: "ion-nav-item__icon", "aria-hidden": "true", children: icon })), children, showChevron && (_jsx("span", { className: "ion-nav-item__chevron", "aria-hidden": "true", children: _jsx(Chevron, {}) }))] }));
     if (href !== undefined) {

package/dist/components/NavItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"NavItem.js","sourceRoot":"","sources":["../../src/components/NavItem.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"NavItem.js","sourceRoot":"","sources":["../../src/components/NavItem.tsx"],"names":[],"mappings":"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"}

package/dist/components/agent-run.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Agent run state, as a reducer over events.
+ *
+ * AgentActivity, ApprovalGate, StreamingText and AgentStop each render one
+ * state well, and none of them knows about the others. What turns "the agent
+ * started step 3" into the right props on all four — one step active at a
+ * time, a stopped run keeping what it did, an unanswered approval never
+ * counting as a yes — was left to every product, and every product got a
+ * different edge wrong. This file is that logic, once.
+ *
+ * It is plain data in, plain data out: no React, no timers. The same events
+ * drive a live run (from a stream, a socket, a poll) and a recorded one
+ * (`replayAgentRun`), and `agentRunFrom` rebuilds a finished run for a history
+ * page without playing it. `useAgentRun` wraps it for components.
+ *
+ * Events are JSON-serialisable on purpose, so a recording can be stored as a
+ * run log and a backend can emit them as-is.
+ */
+/** Where a run is. The last four are ends; nothing changes a run after one. */
+export type AgentRunPhase = 'idle' | 'running' | 'awaiting' | 'finished' | 'failed' | 'stopped' | 'expired';
+/** The same five statuses AgentActivityStep and ToolCall take. */
+export type AgentRunStepStatus = 'pending' | 'active' | 'done' | 'failed' | 'skipped';
+export interface AgentRunStep {
+    id: string;
+    status: AgentRunStepStatus;
+    label?: string;
+    /** Why it failed, from `step-failed`. */
+    error?: string;
+    /** Whether it ever began. A planned step the run never reached is not in `log`. */
+    started: boolean;
+}
+export interface AgentRunApproval {
+    /** The step the approval belongs to. */
+    stepId: string;
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    /** What happened, in words — ApprovalGate's `resolution`. */
+    resolution?: string;
+    /** A decision is on its way to the server. */
+    isSubmitting: boolean;
+    /** The decision did not arrive. The approval is still pending. */
+    error?: string;
+}
+export interface AgentRunState {
+    phase: AgentRunPhase;
+    /** Every step known so far, in the order it was planned or started. */
+    steps: AgentRunStep[];
+    /** The latest approval, or null if the run has not asked for one. */
+    approval: AgentRunApproval | null;
+    output: string;
+    isStreaming: boolean;
+    /** Stop was requested and the run has not confirmed it yet. */
+    isStopping: boolean;
+    /** From `run-failed`, when the failure is the run's and not one step's. */
+    error?: string;
+}
+/**
+ * What a run reports. A producer — a backend stream, a script, a recording —
+ * emits these; it never computes a status itself.
+ */
+export type AgentRunEvent = 
+/** Optionally with the plan, so later steps can be listed as not done. */
+{
+    type: 'run-started';
+    steps?: {
+        id: string;
+        label?: string;
+    }[];
+} | {
+    type: 'step-started';
+    id: string;
+    label?: string;
+} | {
+    type: 'step-done';
+    id: string;
+} | {
+    type: 'step-failed';
+    id: string;
+    error?: string;
+} | {
+    type: 'step-skipped';
+    id: string;
+} | {
+    type: 'approval-requested';
+    id: string;
+} | {
+    type: 'approval-resolved';
+    id: string;
+    decision: 'approved' | 'rejected' | 'expired';
+    resolution?: string;
+}
+/** A chunk of output, appended. */
+ | {
+    type: 'output';
+    text: string;
+} | {
+    type: 'output-done';
+} | {
+    type: 'run-finished';
+} | {
+    type: 'run-failed';
+    error?: string;
+}
+/** `resolution` explains an approval the stop left undecided. */
+ | {
+    type: 'run-stopped';
+    resolution?: string;
+} | {
+    type: 'stop-requested';
+} | {
+    type: 'stop-failed';
+} | {
+    type: 'reset';
+} | {
+    type: 'decision-submitted';
+    id: string;
+} | {
+    type: 'decision-failed';
+    id: string;
+    error: string;
+};
+export declare const initialAgentRunState: AgentRunState;
+/** Whether the run has reached an end — finished, failed, stopped or expired. */
+export declare const agentRunHasEnded: (state: AgentRunState) => boolean;
+/**
+ * The whole policy. Every rule here is one the AgentRun or HumanApproval
+ * pattern states; the comment says which.
+ */
+export declare function agentRunReducer(state: AgentRunState, event: AgentRunEvent): AgentRunState;
+/** A finished run rebuilt from its events, without playing it — for a history page. */
+export declare const agentRunFrom: (events: AgentRunEvent[]) => AgentRunState;
+/** Steps that began, in order — what AgentActivity lists. Never planned-but-unreached ones. */
+export declare const agentRunLog: (state: AgentRunState) => AgentRunStep[];
+/** A recording: each event with the milliseconds to wait before it. */
+export type AgentRunRecording = {
+    delay: number;
+    event: AgentRunEvent;
+}[];
+export interface ReplayAgentRunOptions {
+    /** 2 plays twice as fast. Default 1. */
+    speed?: number;
+}
+/**
+ * Plays a recording into `dispatch` on timers. Returns a function that cancels
+ * the rest — call it on unmount, or on stop before dispatching `run-stopped`.
+ */
+export declare function replayAgentRun(recording: AgentRunRecording, dispatch: (event: AgentRunEvent) => void, { speed }?: ReplayAgentRunOptions): () => void;
+//# sourceMappingURL=agent-run.d.ts.map

package/dist/components/agent-run.d.ts.map

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

package/dist/components/agent-run.js

@@ -0,0 +1,250 @@
+/**
+ * Agent run state, as a reducer over events.
+ *
+ * AgentActivity, ApprovalGate, StreamingText and AgentStop each render one
+ * state well, and none of them knows about the others. What turns "the agent
+ * started step 3" into the right props on all four — one step active at a
+ * time, a stopped run keeping what it did, an unanswered approval never
+ * counting as a yes — was left to every product, and every product got a
+ * different edge wrong. This file is that logic, once.
+ *
+ * It is plain data in, plain data out: no React, no timers. The same events
+ * drive a live run (from a stream, a socket, a poll) and a recorded one
+ * (`replayAgentRun`), and `agentRunFrom` rebuilds a finished run for a history
+ * page without playing it. `useAgentRun` wraps it for components.
+ *
+ * Events are JSON-serialisable on purpose, so a recording can be stored as a
+ * run log and a backend can emit them as-is.
+ */
+export const initialAgentRunState = {
+    phase: 'idle',
+    steps: [],
+    approval: null,
+    output: '',
+    isStreaming: false,
+    isStopping: false,
+};
+const ENDED = ['finished', 'failed', 'stopped', 'expired'];
+/** Whether the run has reached an end — finished, failed, stopped or expired. */
+export const agentRunHasEnded = (state) => ENDED.includes(state.phase);
+const upsert = (steps, id, patch) => steps.some((s) => s.id === id)
+    ? steps.map((s) => (s.id === id ? { ...s, ...patch } : s))
+    : [...steps, { id, status: 'pending', started: false, ...patch }];
+/** Exactly one step is active: starting `id` finishes whichever else was. */
+const closeActive = (steps, id) => steps.map((s) => s.status === 'active' && s.id !== id
+    ? { ...s, status: 'done' }
+    : s);
+/** Anything still pending or active becomes skipped — nothing looks queued after an end. */
+const skipUnfinished = (steps) => steps.map((s) => s.status === 'pending' || s.status === 'active'
+    ? { ...s, status: 'skipped' }
+    : s);
+/**
+ * The whole policy. Every rule here is one the AgentRun or HumanApproval
+ * pattern states; the comment says which.
+ */
+export function agentRunReducer(state, event) {
+    if (event.type === 'reset')
+        return initialAgentRunState;
+    // An ended run is a record. A late event from a slow stream must not
+    // reopen it — a "finished" run whose step flips back to active is a lie.
+    if (agentRunHasEnded(state))
+        return state;
+    switch (event.type) {
+        case 'run-started':
+            return {
+                ...initialAgentRunState,
+                phase: 'running',
+                steps: (event.steps ?? []).map((s) => ({
+                    id: s.id,
+                    label: s.label,
+                    status: 'pending',
+                    started: false,
+                })),
+            };
+        case 'step-started': {
+            // Exactly one step is active at a time (AgentRun). A producer that
+            // starts the next step without closing the last has finished it.
+            return {
+                ...state,
+                phase: state.phase === 'idle' ? 'running' : state.phase,
+                steps: upsert(closeActive(state.steps, event.id), event.id, {
+                    status: 'active',
+                    started: true,
+                    ...(event.label !== undefined ? { label: event.label } : {}),
+                }),
+            };
+        }
+        case 'step-done':
+            return {
+                ...state,
+                steps: upsert(state.steps, event.id, { status: 'done' }),
+            };
+        case 'step-skipped':
+            return {
+                ...state,
+                steps: upsert(state.steps, event.id, { status: 'skipped' }),
+            };
+        case 'step-failed':
+            return {
+                ...state,
+                steps: upsert(state.steps, event.id, {
+                    status: 'failed',
+                    started: true,
+                    error: event.error,
+                }),
+            };
+        case 'approval-requested':
+            return {
+                ...state,
+                phase: 'awaiting',
+                steps: upsert(closeActive(state.steps, event.id), event.id, {
+                    status: 'active',
+                    started: true,
+                }),
+                approval: { stepId: event.id, status: 'pending', isSubmitting: false },
+            };
+        case 'decision-submitted':
+            return state.approval?.stepId === event.id
+                ? {
+                    ...state,
+                    approval: {
+                        ...state.approval,
+                        isSubmitting: true,
+                        error: undefined,
+                    },
+                }
+                : state;
+        case 'decision-failed':
+            // The decision did not arrive, so nothing happened: the approval stays
+            // pending and the buttons come back (HumanApproval, error).
+            return state.approval?.stepId === event.id
+                ? {
+                    ...state,
+                    approval: {
+                        ...state.approval,
+                        isSubmitting: false,
+                        error: event.error,
+                    },
+                }
+                : state;
+        case 'approval-resolved': {
+            const approval = {
+                stepId: event.id,
+                status: event.decision,
+                resolution: event.resolution,
+                isSubmitting: false,
+            };
+            if (event.decision === 'expired') {
+                // Silence is not consent: an approval nobody answered ends the run
+                // without doing the thing (HumanApproval).
+                return {
+                    ...state,
+                    phase: 'expired',
+                    approval,
+                    isStreaming: false,
+                    isStopping: false,
+                    steps: skipUnfinished(state.steps),
+                };
+            }
+            return {
+                ...state,
+                phase: 'running',
+                approval,
+                steps: upsert(state.steps, event.id, {
+                    status: event.decision === 'approved' ? 'done' : 'skipped',
+                }),
+            };
+        }
+        case 'output':
+            return {
+                ...state,
+                output: state.output + event.text,
+                isStreaming: true,
+            };
+        case 'output-done':
+            return { ...state, isStreaming: false };
+        case 'run-finished':
+            return {
+                ...state,
+                phase: 'finished',
+                isStreaming: false,
+                isStopping: false,
+                steps: state.steps.map((s) => s.status === 'active'
+                    ? { ...s, status: 'done' }
+                    : s.status === 'pending'
+                        ? { ...s, status: 'skipped' }
+                        : s),
+            };
+        case 'run-failed': {
+            // Mark the step that was running as the one that failed, keep every
+            // earlier step, and skip the rest (AgentRun, error).
+            const hasFailed = state.steps.some((s) => s.status === 'failed');
+            const steps = hasFailed
+                ? state.steps
+                : state.steps.map((s) => s.status === 'active' ? { ...s, status: 'failed' } : s);
+            return {
+                ...state,
+                phase: 'failed',
+                error: event.error,
+                isStreaming: false,
+                isStopping: false,
+                steps: skipUnfinished(steps),
+            };
+        }
+        case 'stop-requested':
+            return { ...state, isStopping: true };
+        case 'stop-failed':
+            // The run is still going, so the stop control must work again.
+            return { ...state, isStopping: false };
+        case 'run-stopped':
+            // Keep what was done, mark the interrupted step skipped (AgentRun,
+            // partial). An approval nobody answered did not happen.
+            return {
+                ...state,
+                phase: 'stopped',
+                isStreaming: false,
+                isStopping: false,
+                steps: skipUnfinished(state.steps),
+                approval: state.approval?.status === 'pending'
+                    ? {
+                        ...state.approval,
+                        status: 'expired',
+                        isSubmitting: false,
+                        resolution: event.resolution ?? state.approval.resolution,
+                    }
+                    : state.approval,
+            };
+    }
+}
+/** A finished run rebuilt from its events, without playing it — for a history page. */
+export const agentRunFrom = (events) => events.reduce(agentRunReducer, initialAgentRunState);
+/** Steps that began, in order — what AgentActivity lists. Never planned-but-unreached ones. */
+export const agentRunLog = (state) => state.steps.filter((s) => s.started);
+/**
+ * Plays a recording into `dispatch` on timers. Returns a function that cancels
+ * the rest — call it on unmount, or on stop before dispatching `run-stopped`.
+ */
+export function replayAgentRun(recording, dispatch, { speed = 1 } = {}) {
+    let cancelled = false;
+    let timer;
+    let i = 0;
+    const next = () => {
+        if (cancelled || i >= recording.length)
+            return;
+        const { delay, event } = recording[i];
+        timer = setTimeout(() => {
+            if (cancelled)
+                return;
+            i++;
+            dispatch(event);
+            next();
+        }, Math.max(0, delay / speed));
+    };
+    next();
+    return () => {
+        cancelled = true;
+        if (timer !== undefined)
+            clearTimeout(timer);
+    };
+}
+//# sourceMappingURL=agent-run.js.map

package/dist/components/agent-run.js.map

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