@stigmer/react 0.4.8 → 0.5.1

package/resource-workbench/hooks/useViewPreference.js

@@ -0,0 +1,60 @@
+"use client";
+import { useCallback, useState } from "react";
+const VALID_MODES = new Set([
+    "table",
+    "cards",
+    "list",
+]);
+function isValidMode(value) {
+    return VALID_MODES.has(value);
+}
+/**
+ * Persists the user's preferred view mode (table / cards / list) in
+ * localStorage, scoped by a caller-provided storage key.
+ *
+ * Falls back to `defaultMode` when no persisted value exists or when
+ * the stored value is invalid (forward-compatible with future modes).
+ *
+ * Pass `undefined` for `storageKey` to use an ephemeral (non-persisted)
+ * view mode that resets on unmount.
+ *
+ * @param storageKey  localStorage key (e.g. `"stigmer:workbench:agents:viewMode"`).
+ *                    Pass `undefined` to disable persistence.
+ * @param defaultMode The view mode to use when no persisted value exists.
+ *
+ * @example
+ * ```tsx
+ * const { viewMode, setViewMode } = useViewPreference(
+ *   "stigmer:workbench:agents:viewMode",
+ *   "table",
+ * );
+ * ```
+ */
+export function useViewPreference(storageKey, defaultMode) {
+    const [viewMode, setViewModeState] = useState(() => {
+        if (!storageKey || typeof window === "undefined")
+            return defaultMode;
+        try {
+            const stored = localStorage.getItem(storageKey);
+            if (stored && isValidMode(stored))
+                return stored;
+        }
+        catch {
+            // localStorage may be unavailable (e.g. sandboxed iframe).
+        }
+        return defaultMode;
+    });
+    const setViewMode = useCallback((mode) => {
+        setViewModeState(mode);
+        if (!storageKey)
+            return;
+        try {
+            localStorage.setItem(storageKey, mode);
+        }
+        catch {
+            // Silently ignore write failures.
+        }
+    }, [storageKey]);
+    return { viewMode, setViewMode };
+}
+//# sourceMappingURL=useViewPreference.js.map

package/resource-workbench/hooks/useViewPreference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewPreference.js","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useViewPreference.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAW9C,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAW;IACzD,OAAO;IACP,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA8B,EAC9B,WAAqB;IAErB,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAW,GAAG,EAAE;QAC3D,IAAI,CAAC,UAAU,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAChD,IAAI,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,IAAc,EAAE,EAAE;QACjB,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,UAAU;YAAE,OAAO;QACxB,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC"}

package/resource-workbench/index.d.ts

@@ -0,0 +1,34 @@
+export type { ViewMode, StatusPhase, WorkbenchColumnDef, FilterOperator, FilterValue, FilterDef, FilterOption, SortDirection, SortValue, SortDef, ResourceAction, BulkAction, WorkbenchState, } from "./types";
+export { useViewPreference } from "./hooks/useViewPreference";
+export type { UseViewPreferenceReturn } from "./hooks/useViewPreference";
+export { useResourceCollection } from "./hooks/useResourceCollection";
+export type { UseResourceCollectionOptions, UseResourceCollectionReturn, } from "./hooks/useResourceCollection";
+export { useResourceSelection } from "./hooks/useResourceSelection";
+export type { UseResourceSelectionReturn } from "./hooks/useResourceSelection";
+export { useResourceFilters } from "./hooks/useResourceFilters";
+export type { UseResourceFiltersOptions, UseResourceFiltersReturn, FilterSortState, } from "./hooks/useResourceFilters";
+export { StatusBadge } from "./components/StatusBadge";
+export type { StatusBadgeProps } from "./components/StatusBadge";
+export { ColumnHeader } from "./components/ColumnHeader";
+export type { ColumnHeaderProps } from "./components/ColumnHeader";
+export { SelectionCheckbox } from "./components/SelectionCheckbox";
+export type { SelectionCheckboxProps } from "./components/SelectionCheckbox";
+export { ResourceTable } from "./components/ResourceTable";
+export type { ResourceTableProps } from "./components/ResourceTable";
+export { ResourceCards } from "./components/ResourceCards";
+export type { ResourceCardsProps } from "./components/ResourceCards";
+export { ResourceList } from "./components/ResourceList";
+export type { ResourceListProps } from "./components/ResourceList";
+export { BulkActionBar } from "./components/BulkActionBar";
+export type { BulkActionBarProps } from "./components/BulkActionBar";
+export { FilterBar } from "./components/FilterBar";
+export type { FilterBarProps } from "./components/FilterBar";
+export { ViewSwitcher } from "./components/ViewSwitcher";
+export type { ViewSwitcherProps } from "./components/ViewSwitcher";
+export { ResourceInspector } from "./components/ResourceInspector";
+export type { ResourceInspectorProps } from "./components/ResourceInspector";
+export { ResourceWorkbench } from "./components/ResourceWorkbench";
+export type { ResourceWorkbenchProps } from "./components/ResourceWorkbench";
+export { ResourceAvatar } from "./components/ResourceAvatar";
+export type { ResourceAvatarProps } from "./components/ResourceAvatar";
+//# sourceMappingURL=index.d.ts.map

package/resource-workbench/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resource-workbench/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,SAAS,EACT,OAAO,EACP,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/resource-workbench/index.js

@@ -0,0 +1,19 @@
+// Hooks
+export { useViewPreference } from "./hooks/useViewPreference";
+export { useResourceCollection } from "./hooks/useResourceCollection";
+export { useResourceSelection } from "./hooks/useResourceSelection";
+export { useResourceFilters } from "./hooks/useResourceFilters";
+// Components
+export { StatusBadge } from "./components/StatusBadge";
+export { ColumnHeader } from "./components/ColumnHeader";
+export { SelectionCheckbox } from "./components/SelectionCheckbox";
+export { ResourceTable } from "./components/ResourceTable";
+export { ResourceCards } from "./components/ResourceCards";
+export { ResourceList } from "./components/ResourceList";
+export { BulkActionBar } from "./components/BulkActionBar";
+export { FilterBar } from "./components/FilterBar";
+export { ViewSwitcher } from "./components/ViewSwitcher";
+export { ResourceInspector } from "./components/ResourceInspector";
+export { ResourceWorkbench } from "./components/ResourceWorkbench";
+export { ResourceAvatar } from "./components/ResourceAvatar";
+//# sourceMappingURL=index.js.map

package/resource-workbench/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resource-workbench/index.ts"],"names":[],"mappings":"AAiBA,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAMtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAOhE,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/resource-workbench/types.d.ts

@@ -0,0 +1,165 @@
+import type { ReactNode } from "react";
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+/** Available layout modes for the resource workbench. */
+export type ViewMode = "table" | "cards" | "list";
+/**
+ * Resource status phases that map to `--stgm-status-*` design tokens.
+ *
+ * Each phase corresponds to a token group defined in `@stigmer/theme`
+ * (e.g. `--stgm-status-ready`, `--stgm-status-failed-subtle`).
+ */
+export type StatusPhase = "ready" | "running" | "pending" | "degraded" | "failed" | "disabled" | "draft";
+/**
+ * Defines a single column in the {@link ResourceTable}.
+ *
+ * Generic over `TData` so platform builders can use richer item types
+ * beyond `SearchResult` while the Console uses `SearchResult` directly.
+ */
+export interface WorkbenchColumnDef<TData = SearchResult> {
+    /** Stable column identifier (used for visibility persistence and URL state). */
+    readonly id: string;
+    /** Column header label. */
+    readonly header: string;
+    /**
+     * Accessor function that extracts the cell value from a row item.
+     * Return a `ReactNode` for custom cell rendering.
+     */
+    readonly cell: (item: TData) => ReactNode;
+    /**
+     * Whether this column is sortable. When `true`, clicking the header
+     * toggles sort direction.
+     * @default false
+     */
+    readonly sortable?: boolean;
+    /**
+     * Whether this column is visible by default.
+     * Users can toggle visibility via column preferences.
+     * @default true
+     */
+    readonly defaultVisible?: boolean;
+    /**
+     * Minimum column width in pixels. The table uses this as a CSS
+     * `min-width` to prevent content collapse.
+     */
+    readonly minWidth?: number;
+    /**
+     * Relative flex weight for distributing remaining horizontal space.
+     * Columns with higher weight receive more space.
+     * @default 1
+     */
+    readonly flex?: number;
+}
+/** Operator for a single filter expression. */
+export type FilterOperator = "eq" | "neq" | "contains" | "gt" | "lt" | "gte" | "lte" | "in";
+/** A single active filter value applied to the collection. */
+export interface FilterValue {
+    /** The filter definition ID this value applies to. */
+    readonly filterId: string;
+    /** Comparison operator. */
+    readonly operator: FilterOperator;
+    /**
+     * Filter value(s). A string for scalar operators, an array for `in`.
+     */
+    readonly value: string | readonly string[];
+}
+/**
+ * Defines a filterable property for the {@link FilterBar}.
+ *
+ * Platform builders declare which properties are filterable and how
+ * they appear in the filter UI.
+ */
+export interface FilterDef {
+    /** Stable filter identifier (used in URL state serialization). */
+    readonly id: string;
+    /** Human-readable label shown in the filter picker and chips. */
+    readonly label: string;
+    /** Filter input type. */
+    readonly type: "text" | "select" | "multi-select" | "date";
+    /**
+     * Available options for `select` and `multi-select` types.
+     * Ignored for `text` and `date`.
+     */
+    readonly options?: readonly FilterOption[];
+    /**
+     * Allowed operators. Defaults to `["eq"]` for selects,
+     * `["contains"]` for text, and `["gte", "lte"]` for dates.
+     */
+    readonly operators?: readonly FilterOperator[];
+}
+/** A selectable option within a `select` or `multi-select` filter. */
+export interface FilterOption {
+    /** The value sent in the filter expression. */
+    readonly value: string;
+    /** Display label. */
+    readonly label: string;
+    /** Optional icon rendered before the label. */
+    readonly icon?: ReactNode;
+}
+/** Sort direction. */
+export type SortDirection = "asc" | "desc";
+/** A single active sort applied to the collection. */
+export interface SortValue {
+    /** Column or property ID to sort by. */
+    readonly id: string;
+    /** Sort direction. */
+    readonly direction: SortDirection;
+}
+/**
+ * Defines a sortable property. Used by hooks to validate incoming sort
+ * state and by the UI to render sort options in column headers and
+ * sort dropdowns.
+ */
+export interface SortDef {
+    /** Stable identifier matching a column ID or virtual sort key. */
+    readonly id: string;
+    /** Human-readable label (e.g. "Name", "Last updated"). */
+    readonly label: string;
+    /** Default direction when this sort is first activated. @default "asc" */
+    readonly defaultDirection?: SortDirection;
+}
+/** A single action available for a resource item (shown in context menus). */
+export interface ResourceAction<TData = SearchResult> {
+    /** Stable action identifier. */
+    readonly id: string;
+    /** Display label. */
+    readonly label: string;
+    /** Icon rendered before the label. */
+    readonly icon?: ReactNode;
+    /** Keyboard shortcut hint displayed in the menu. */
+    readonly shortcut?: string;
+    /** Visual variant. @default "default" */
+    readonly variant?: "default" | "destructive";
+    /** Called when the action is selected. Receives the target item. */
+    readonly onAction: (item: TData) => void;
+    /** When `true`, the action is shown but non-interactive. */
+    readonly disabled?: boolean;
+}
+/** A bulk action available when multiple items are selected. */
+export interface BulkAction<TData = SearchResult> {
+    /** Stable action identifier. */
+    readonly id: string;
+    /** Display label (e.g. "Delete", "Change visibility"). */
+    readonly label: string;
+    /** Icon rendered before the label. */
+    readonly icon?: ReactNode;
+    /** Visual variant. @default "default" */
+    readonly variant?: "default" | "destructive";
+    /** Called with the full set of selected items. */
+    readonly onAction: (items: readonly TData[]) => void;
+    /** When `true`, the action is shown but non-interactive. */
+    readonly disabled?: boolean;
+}
+/**
+ * Serializable snapshot of the workbench's filter, sort, pagination,
+ * and view state. Passed to `onStateChange` so consumers can sync
+ * this state to URL search params or other persistence layers.
+ */
+export interface WorkbenchState {
+    readonly filters: readonly FilterValue[];
+    readonly sort: SortValue | null;
+    readonly page: number;
+    readonly pageSize: number;
+    readonly query: string;
+    readonly viewMode: ViewMode;
+}
+//# sourceMappingURL=types.d.ts.map

package/resource-workbench/types.d.ts.map

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

package/resource-workbench/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/resource-workbench/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resource-workbench/types.ts"],"names":[],"mappings":""}

package/runner/RunnerDetailView.d.ts

@@ -0,0 +1,44 @@
+import type { DetailAction } from "../resource-detail/types";
+/** Props for {@link RunnerDetailView}. */
+export interface RunnerDetailViewProps {
+    /** Runner ID. */
+    readonly id: string;
+    /**
+     * Called once when the runner resource has been fetched successfully.
+     * Provides the resource display name for use cases like breadcrumbs
+     * or document titles.
+     */
+    readonly onResourceLoad?: (meta: {
+        name: string;
+        id: string;
+    }) => void;
+    /**
+     * Primary action rendered as a visible button in the header area.
+     */
+    readonly primaryAction?: DetailAction;
+    /**
+     * Secondary actions rendered in the kebab overflow menu.
+     */
+    readonly actions?: readonly DetailAction[];
+    /** Additional CSS classes for the root container. */
+    readonly className?: string;
+}
+/**
+ * Operational detail view for a Runner.
+ *
+ * Fetches the runner via {@link useRunner} internally and renders its
+ * status, connection information, and machine details inside a
+ * {@link ResourceDetailShell}. Polls automatically when the runner is
+ * in a transitional phase (Starting, Pending).
+ *
+ * Handles loading, error, and not-found states automatically.
+ * Zero Console dependencies — safe for platform builder embedding.
+ * All visual properties flow through `--stgm-*` design tokens.
+ *
+ * @example
+ * ```tsx
+ * <RunnerDetailView id={runnerId} />
+ * ```
+ */
+export declare function RunnerDetailView({ id, onResourceLoad, primaryAction, actions, className, }: RunnerDetailViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=RunnerDetailView.d.ts.map

package/runner/RunnerDetailView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunnerDetailView.d.ts","sourceRoot":"","sources":["../../src/runner/RunnerDetailView.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,0BAA0B,CAAC;AAGjF,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,iBAAiB;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;IACtC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,EAAE,EACF,cAAc,EACd,aAAa,EACb,OAAO,EACP,SAAS,GACV,EAAE,qBAAqB,2CA4EvB"}

package/runner/RunnerDetailView.js

@@ -0,0 +1,154 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { cn } from "@stigmer/theme";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { RunnerPhase } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/enum_pb";
+import { useRunner } from "./useRunner";
+import { phaseLabel, phaseDotColor, isTransitionalPhase } from "./phase";
+import { ErrorMessage } from "../error/ErrorMessage";
+import { ResourceDetailShell } from "../resource-detail/ResourceDetailShell";
+const TRANSITIONAL_POLL_MS = 5_000;
+/**
+ * Operational detail view for a Runner.
+ *
+ * Fetches the runner via {@link useRunner} internally and renders its
+ * status, connection information, and machine details inside a
+ * {@link ResourceDetailShell}. Polls automatically when the runner is
+ * in a transitional phase (Starting, Pending).
+ *
+ * Handles loading, error, and not-found states automatically.
+ * Zero Console dependencies — safe for platform builder embedding.
+ * All visual properties flow through `--stgm-*` design tokens.
+ *
+ * @example
+ * ```tsx
+ * <RunnerDetailView id={runnerId} />
+ * ```
+ */
+export function RunnerDetailView({ id, onResourceLoad, primaryAction, actions, className, }) {
+    const phase = useRef(RunnerPhase.UNSPECIFIED);
+    const opts = {
+        refetchInterval: isTransitionalPhase(phase.current)
+            ? TRANSITIONAL_POLL_MS
+            : false,
+    };
+    const { runner, isLoading, error, refetch } = useRunner(id, opts);
+    if (runner?.status?.phase != null) {
+        phase.current = runner.status.phase;
+    }
+    const onResourceLoadRef = useRef(onResourceLoad);
+    onResourceLoadRef.current = onResourceLoad;
+    useEffect(() => {
+        if (runner?.metadata?.name) {
+            onResourceLoadRef.current?.({
+                name: runner.metadata.name,
+                id: runner.metadata.id,
+            });
+        }
+    }, [runner]);
+    if (isLoading)
+        return _jsx(LoadingSkeleton, { className: className });
+    if (error)
+        return _jsx(ErrorMessage, { error: error, retry: refetch, className: className });
+    if (!runner)
+        return _jsx(NotFoundState, { className: className });
+    const meta = runner.metadata;
+    const status = runner.status;
+    const info = status?.connectionInfo;
+    const runnerPhase = status?.phase ?? RunnerPhase.UNSPECIFIED;
+    const headerMeta = {
+        name: meta?.name || meta?.id || "Unnamed Runner",
+        id: meta?.id || id,
+        org: meta?.org,
+        icon: _jsx(RunnerIcon, { className: "size-6 text-muted-foreground" }),
+        status: phaseToStatusPhase(runnerPhase),
+        statusLabel: phaseLabel(runnerPhase),
+    };
+    return (_jsx(ResourceDetailShell, { header: headerMeta, primaryAction: primaryAction, actions: actions, className: className, children: _jsxs("div", { className: "flex flex-col gap-6 pt-2", children: [_jsx(StatusSection, { phase: runnerPhase, lastHeartbeat: status?.lastHeartbeatAt
+                        ? timestampDate(status.lastHeartbeatAt)
+                        : null, currentExecutions: status?.currentExecutions ?? 0, taskQueue: status?.taskQueue }), info && (_jsx(ConnectionInfoSection, { hostname: info.hostname, os: info.os, arch: info.arch, runnerVersion: info.runnerVersion }))] }) }));
+}
+// ---------------------------------------------------------------------------
+// Phase → StatusPhase mapping
+// ---------------------------------------------------------------------------
+function phaseToStatusPhase(phase) {
+    switch (phase) {
+        case RunnerPhase.READY:
+            return "ready";
+        case RunnerPhase.BUSY:
+            return "running";
+        case RunnerPhase.STARTING:
+        case RunnerPhase.PENDING:
+            return "pending";
+        case RunnerPhase.FAILED:
+            return "failed";
+        case RunnerPhase.STOPPED:
+            return "disabled";
+        default:
+            return "draft";
+    }
+}
+// ---------------------------------------------------------------------------
+// Sections
+// ---------------------------------------------------------------------------
+function StatusSection({ phase, lastHeartbeat, currentExecutions, taskQueue, }) {
+    return (_jsx(Section, { title: "Status", children: _jsxs("div", { className: "grid grid-cols-2 gap-4 p-4 sm:grid-cols-4", children: [_jsx(StatusItem, { label: "Phase", children: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: cn("size-2 shrink-0 rounded-full", phaseDotColor(phase)), "aria-hidden": "true" }), _jsx("span", { className: "text-sm font-medium text-foreground", children: phaseLabel(phase) })] }) }), _jsx(StatusItem, { label: "Executions", children: _jsx("span", { className: "text-sm font-medium text-foreground", children: currentExecutions }) }), _jsx(StatusItem, { label: "Last heartbeat", children: _jsx("span", { className: "text-sm text-foreground", children: lastHeartbeat ? formatRelativeTime(lastHeartbeat) : "—" }) }), taskQueue && (_jsx(StatusItem, { label: "Task queue", children: _jsx("code", { className: "rounded bg-muted px-1.5 py-0.5 font-mono text-xs text-foreground", children: taskQueue }) }))] }) }));
+}
+function StatusItem({ label, children, }) {
+    return (_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("span", { className: "text-[11px] font-medium text-muted-foreground", children: label }), children] }));
+}
+function ConnectionInfoSection({ hostname, os, arch, runnerVersion, }) {
+    const osArch = os && arch ? `${os}/${arch}` : os || arch || undefined;
+    const hasAnyInfo = hostname || osArch || runnerVersion;
+    if (!hasAnyInfo)
+        return null;
+    return (_jsx(Section, { title: "Machine", children: _jsxs("div", { className: "flex flex-col divide-y divide-border", children: [hostname && (_jsx(InfoRow, { label: "Hostname", value: hostname })), osArch && (_jsx(InfoRow, { label: "Platform", value: osArch, mono: true })), runnerVersion && (_jsx(InfoRow, { label: "Runner version", value: runnerVersion, mono: true }))] }) }));
+}
+function InfoRow({ label, value, mono, }) {
+    return (_jsxs("div", { className: "flex items-baseline justify-between px-4 py-2.5", children: [_jsx("span", { className: "text-xs font-medium text-muted-foreground", children: label }), _jsx("span", { className: cn("text-sm text-foreground", mono && "font-mono text-xs"), children: value })] }));
+}
+// ---------------------------------------------------------------------------
+// Shared layout primitives
+// ---------------------------------------------------------------------------
+function Section({ title, children, }) {
+    return (_jsxs("section", { children: [_jsx("h3", { className: "mb-2 text-xs font-medium uppercase tracking-wider text-muted-foreground", children: title }), _jsx("div", { className: "overflow-hidden rounded-lg border border-border", children: children })] }));
+}
+// ---------------------------------------------------------------------------
+// Non-happy states
+// ---------------------------------------------------------------------------
+function LoadingSkeleton({ className }) {
+    return (_jsxs("div", { className: cn("flex flex-col gap-6", className), "aria-busy": "true", "aria-label": "Loading runner details", children: [_jsxs("div", { className: "flex items-start gap-3", children: [_jsx("div", { className: "mt-1 size-6 shrink-0 animate-pulse rounded bg-muted" }), _jsxs("div", { className: "flex-1 space-y-2", children: [_jsx("div", { className: "h-5 w-48 animate-pulse rounded bg-muted" }), _jsx("div", { className: "h-3 w-32 animate-pulse rounded bg-muted" })] })] }), _jsxs("div", { className: "space-y-2", children: [_jsx("div", { className: "h-3 w-16 animate-pulse rounded bg-muted" }), _jsx("div", { className: "animate-pulse rounded-lg border border-border bg-muted-faint", style: { height: "96px" } })] }), _jsxs("div", { className: "space-y-2", children: [_jsx("div", { className: "h-3 w-20 animate-pulse rounded bg-muted" }), _jsx("div", { className: "animate-pulse rounded-lg border border-border bg-muted-faint", style: { height: "96px" } })] })] }));
+}
+function NotFoundState({ className }) {
+    return (_jsxs("div", { role: "status", className: cn("flex flex-col items-center gap-2 py-12 text-center", className), children: [_jsx(RunnerIcon, { className: "size-10 text-muted-foreground-faint" }), _jsx("p", { className: "text-sm font-medium text-muted-foreground", children: "Runner not found" }), _jsx("p", { className: "text-xs text-muted-foreground-subtle", children: "This runner doesn't exist or has been removed." })] }));
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+function formatRelativeTime(date) {
+    const now = Date.now();
+    const diffMs = now - date.getTime();
+    const diffSec = Math.floor(diffMs / 1000);
+    if (diffSec < 10)
+        return "Just now";
+    if (diffSec < 60)
+        return `${diffSec}s ago`;
+    const diffMin = Math.floor(diffSec / 60);
+    if (diffMin < 60)
+        return `${diffMin}m ago`;
+    const diffHour = Math.floor(diffMin / 60);
+    if (diffHour < 24)
+        return `${diffHour}h ago`;
+    return date.toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+    });
+}
+// ---------------------------------------------------------------------------
+// Icon
+// ---------------------------------------------------------------------------
+function RunnerIcon({ className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "2", y: "4", width: "12", height: "9", rx: "1.5" }), _jsx("path", { d: "M5 1v3M11 1v3M5 8.5h6" })] }));
+}
+//# sourceMappingURL=RunnerDetailView.js.map

package/runner/RunnerDetailView.js.map

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

package/runner/RunnerListPanel.d.ts

@@ -1,4 +1,7 @@
+import { RunnerPhase } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/enum_pb";
 import type { Runner } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/api_pb";
+/** Sort key for the runner list. */
+export type RunnerSortKey = "phase" | "name" | "heartbeat" | "executions";
 /** Props for {@link RunnerListPanel}. */
 export interface RunnerListPanelProps {
     /** Organization slug to scope the runner list. */
@@ -14,6 +17,28 @@ export interface RunnerListPanelProps {
      * @default false
      */
     readonly includeSystemManaged?: boolean;
+    /**
+     * Restrict the list to runners in the specified phases.
+     *
+     * When provided, only runners whose phase is in this array are shown.
+     * When omitted or empty, all phases are included.
+     */
+    readonly filterPhases?: readonly RunnerPhase[];
+    /**
+     * Client-side text filter. When provided, only runners whose name
+     * or hostname contains this substring (case-insensitive) are shown.
+     */
+    readonly searchQuery?: string;
+    /**
+     * Sort key for ordering the runner list.
+     * @default "phase"
+     */
+    readonly sortBy?: RunnerSortKey;
+    /**
+     * Sort direction.
+     * @default "asc"
+     */
+    readonly sortDirection?: "asc" | "desc";
     /** Expose refetch so parent components can trigger a list refresh. */
     readonly onRefetchRef?: (refetch: () => void) => void;
     /**
@@ -66,5 +91,5 @@ export interface RunnerListPanelProps {
  * />
  * ```
  */
-export declare function RunnerListPanel({ org, includeSystemManaged, onRefetchRef, onStopped, onDeleted, className, }: RunnerListPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function RunnerListPanel({ org, includeSystemManaged, filterPhases, searchQuery, sortBy, sortDirection, onRefetchRef, onStopped, onDeleted, className, }: RunnerListPanelProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=RunnerListPanel.d.ts.map

package/runner/RunnerListPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RunnerListPanel.d.ts","sourceRoot":"","sources":["../../src/runner/RunnerListPanel.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAwBlF,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,oBAA4B,EAC5B,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,GACV,EAAE,oBAAoB,2CAqHtB"}
+{"version":3,"file":"RunnerListPanel.d.ts","sourceRoot":"","sources":["../../src/runner/RunnerListPanel.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AA0BlF,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;AAE1E,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,oBAA4B,EAC5B,YAAY,EACZ,WAAW,EACX,MAAgB,EAChB,aAAqB,EACrB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,GACV,EAAE,oBAAoB,2CAgJtB"}