@stigmer/ink 3.0.8-dev.20260613074252 → 3.0.8

package/components/AgentPicker.d.ts

@@ -0,0 +1,33 @@
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+/** Props for {@link AgentPicker}. */
+export interface AgentPickerProps {
+    /** Organization to search within. */
+    readonly org: string;
+    /** Seeds the search box (e.g. an unresolved slug the user already typed). */
+    readonly initialQuery?: string;
+    /** `"org"` (default) searches the org; `"all"` includes public agents. */
+    readonly scope?: "org" | "all";
+    /** Called with the chosen agent's search result on selection. */
+    readonly onSelect: (agent: SearchResult) => void;
+    /** Called when the user cancels (Esc / Ctrl+C). */
+    readonly onCancel: () => void;
+}
+/**
+ * Interactive picker for choosing an agent by name.
+ *
+ * Composes the {@link useAgentSearch} data hook with {@link ResourcePicker}:
+ * the user types, results stream in (debounced by the hook), and the selected
+ * agent's {@link SearchResult} is returned via `onSelect`. Use the `id` field of
+ * that result to resolve and run the agent.
+ *
+ * @example
+ * ```tsx
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <AgentPicker org="acme" onSelect={(a) => run(a.id)} onCancel={() => process.exit(0)} />
+ *   </InkStigmerProvider>,
+ * );
+ * ```
+ */
+export declare function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }: AgentPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AgentPicker.d.ts.map

package/components/AgentPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPicker.d.ts","sourceRoot":"","sources":["../../src/components/AgentPicker.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAI/E,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,gBAAgB,2CAkC7F"}

package/components/AgentPicker.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo } from "react";
+import { useAgentSearch } from "@stigmer/react";
+import { ResourcePicker } from "./ResourcePicker.js";
+/** Max description length shown as the row subtitle before truncation. */
+const SUBTITLE_MAX = 60;
+/**
+ * Interactive picker for choosing an agent by name.
+ *
+ * Composes the {@link useAgentSearch} data hook with {@link ResourcePicker}:
+ * the user types, results stream in (debounced by the hook), and the selected
+ * agent's {@link SearchResult} is returned via `onSelect`. Use the `id` field of
+ * that result to resolve and run the agent.
+ *
+ * @example
+ * ```tsx
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <AgentPicker org="acme" onSelect={(a) => run(a.id)} onCancel={() => process.exit(0)} />
+ *   </InkStigmerProvider>,
+ * );
+ * ```
+ */
+export function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }) {
+    const { results, isLoading, error, query, setQuery } = useAgentSearch(org, { scope });
+    // Seed the typed-but-unresolved query once on mount so the user picks up
+    // where the smart-resolution attempt left off.
+    useEffect(() => {
+        if (initialQuery !== undefined && initialQuery !== "")
+            setQuery(initialQuery);
+        // Mount-only: re-seeding on every render would fight the user's typing.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    const items = useMemo(() => results.map(toAgentItem), [results]);
+    const handleSelect = useCallback((item) => {
+        const found = results.find((r) => r.id === item.id);
+        if (found !== undefined)
+            onSelect(found);
+    }, [results, onSelect]);
+    return (_jsx(ResourcePicker, { prompt: "Select an agent", items: items, query: query, onQueryChange: setQuery, isLoading: isLoading, error: error, onSelect: handleSelect, onCancel: onCancel, emptyLabel: "no agents found" }));
+}
+/** Map a search result to a picker row: org/slug title, description subtitle. */
+function toAgentItem(result) {
+    const title = result.qualifiedSlug !== "" ? result.qualifiedSlug : `${result.org}/${result.slug}`;
+    return { id: result.id, title, subtitle: truncate(result.description, SUBTITLE_MAX) };
+}
+function truncate(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+}
+//# sourceMappingURL=AgentPicker.js.map

package/components/AgentPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPicker.js","sourceRoot":"","sources":["../../src/components/AgentPicker.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAmB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBtE,0EAA0E;AAC1E,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAoB;IAC5F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAEtF,yEAAyE;IACzE,+CAA+C;IAC/C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE;YAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC9E,wEAAwE;QACxE,uDAAuD;IACzD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,OAAO,CAAe,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/E,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAgB,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,EACD,CAAC,OAAO,EAAE,QAAQ,CAAC,CACpB,CAAC;IAEF,OAAO,CACL,KAAC,cAAc,IACb,MAAM,EAAC,iBAAiB,EACxB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,QAAQ,EACvB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAC,iBAAiB,GAC5B,CACH,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,SAAS,WAAW,CAAC,MAAoB;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IAClG,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;AAClE,CAAC"}

package/components/ResourcePicker.d.ts

@@ -0,0 +1,72 @@
+/**
+ * A single selectable entry in a {@link ResourcePicker}.
+ *
+ * Callers map their domain objects (agents, sessions, ...) into this shape and
+ * receive the chosen item back via `onSelect`. The picker is domain-agnostic:
+ * it knows only how to render and navigate these rows.
+ */
+export interface PickerItem {
+    /** Opaque identity returned to the caller on selection. */
+    readonly id: string;
+    /** Primary display text, rendered bold when active (e.g. "acme/deploy"). */
+    readonly title: string;
+    /** Secondary text, rendered dimmed after the title (e.g. a description). */
+    readonly subtitle?: string;
+    /** Right-aligned metadata, rendered dimmed (e.g. "2 hours ago"). */
+    readonly meta?: string;
+}
+/** Props for {@link ResourcePicker}. */
+export interface ResourcePickerProps {
+    /** The current result rows to choose from (owned by the caller). */
+    readonly items: readonly PickerItem[];
+    /** Current query text (controlled — the caller owns search state). */
+    readonly query: string;
+    /** Called when the query text changes; the caller re-runs its search. */
+    readonly onQueryChange: (query: string) => void;
+    /** Called with the chosen item when the user presses Enter. */
+    readonly onSelect: (item: PickerItem) => void;
+    /** Called when the user cancels (Esc or Ctrl+C). */
+    readonly onCancel: () => void;
+    /** `true` while a search request is in flight. */
+    readonly isLoading?: boolean;
+    /** Error from the last failed search, shown in place of the list. */
+    readonly error?: Error | null;
+    /** Label shown before the input (e.g. "Select an agent"). */
+    readonly prompt?: string;
+    /** Placeholder shown in the empty input. */
+    readonly placeholder?: string;
+    /** Label shown when a completed search returns no rows. */
+    readonly emptyLabel?: string;
+}
+/**
+ * Generic, interactive search-and-select list for the terminal.
+ *
+ * Renders a text input above a scrollable result list. The user types to
+ * filter (the caller performs the actual search via `onQueryChange`), navigates
+ * with the arrow keys, selects with Enter, and cancels with Esc. It holds no
+ * data of its own — pass `items`/`query`/`isLoading` from a data hook such as
+ * `useAgentSearch` or `useSessionList`.
+ *
+ * This is the reusable organism behind {@link AgentPicker} and
+ * {@link SessionPicker}; platform builders can compose it with any search
+ * function to pick any resource.
+ *
+ * @example
+ * ```tsx
+ * const { results, isLoading, query, setQuery } = useAgentSearch("acme");
+ * const items = results.map((r) => ({ id: r.id, title: r.qualifiedSlug }));
+ * render(
+ *   <ResourcePicker
+ *     prompt="Select an agent"
+ *     items={items}
+ *     query={query}
+ *     onQueryChange={setQuery}
+ *     isLoading={isLoading}
+ *     onSelect={(item) => console.log(item.id)}
+ *     onCancel={() => process.exit(0)}
+ *   />,
+ * );
+ * ```
+ */
+export declare function ResourcePicker({ items, query, onQueryChange, onSelect, onCancel, isLoading, error, prompt, placeholder, emptyLabel, }: ResourcePickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ResourcePicker.d.ts.map

package/components/ResourcePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourcePicker.d.ts","sourceRoot":"","sources":["../../src/components/ResourcePicker.tsx"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,KAAK,EACL,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAiB,EACjB,KAAY,EACZ,MAAiB,EACjB,WAAiC,EACjC,UAAyB,GAC1B,EAAE,mBAAmB,2CA6DrB"}

package/components/ResourcePicker.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import TextInput from "ink-text-input";
+/** Maximum rows shown at once; the list scrolls a window around the cursor. */
+const MAX_VISIBLE = 10;
+/**
+ * Generic, interactive search-and-select list for the terminal.
+ *
+ * Renders a text input above a scrollable result list. The user types to
+ * filter (the caller performs the actual search via `onQueryChange`), navigates
+ * with the arrow keys, selects with Enter, and cancels with Esc. It holds no
+ * data of its own — pass `items`/`query`/`isLoading` from a data hook such as
+ * `useAgentSearch` or `useSessionList`.
+ *
+ * This is the reusable organism behind {@link AgentPicker} and
+ * {@link SessionPicker}; platform builders can compose it with any search
+ * function to pick any resource.
+ *
+ * @example
+ * ```tsx
+ * const { results, isLoading, query, setQuery } = useAgentSearch("acme");
+ * const items = results.map((r) => ({ id: r.id, title: r.qualifiedSlug }));
+ * render(
+ *   <ResourcePicker
+ *     prompt="Select an agent"
+ *     items={items}
+ *     query={query}
+ *     onQueryChange={setQuery}
+ *     isLoading={isLoading}
+ *     onSelect={(item) => console.log(item.id)}
+ *     onCancel={() => process.exit(0)}
+ *   />,
+ * );
+ * ```
+ */
+export function ResourcePicker({ items, query, onQueryChange, onSelect, onCancel, isLoading = false, error = null, prompt = "Search", placeholder = "type to search...", emptyLabel = "no results", }) {
+    const [cursor, setCursor] = useState(0);
+    // Reset the cursor to the top whenever the query changes — the result set is
+    // about to be replaced, so a stale cursor would point at the wrong row.
+    useEffect(() => {
+        setCursor(0);
+    }, [query]);
+    const active = items.length === 0 ? 0 : Math.min(cursor, items.length - 1);
+    useInput((input, key) => {
+        if (key.escape || (key.ctrl && input === "c")) {
+            onCancel();
+            return;
+        }
+        if (key.return) {
+            if (items.length > 0)
+                onSelect(items[active]);
+            return;
+        }
+        if (key.upArrow) {
+            setCursor((c) => Math.max(0, Math.min(c, items.length - 1) - 1));
+            return;
+        }
+        if (key.downArrow) {
+            setCursor((c) => Math.min(items.length - 1, c + 1));
+        }
+    });
+    const [start, end] = visibleWindow(active, items.length);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: "?" }), _jsxs(Text, { bold: true, children: [prompt, ":"] }), _jsx(TextInput, { value: query, onChange: onQueryChange, placeholder: placeholder })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: error !== null ? (_jsx(Text, { color: "red", children: `  Error: ${error.message}` })) : isLoading ? (_jsx(Text, { dimColor: true, children: "  searching..." })) : items.length === 0 ? (_jsx(Text, { dimColor: true, children: `  ${emptyLabel}` })) : (_jsxs(_Fragment, { children: [items.slice(start, end).map((item, i) => (_jsx(PickerRow, { item: item, isActive: start + i === active }, item.id))), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: `  ${countLabel(items.length)}  |  up/down: navigate  |  enter: select  |  esc: cancel` }) })] })) })] }));
+}
+/** One result row: a cursor glyph, the title, then optional subtitle/meta. */
+function PickerRow({ item, isActive }) {
+    return (_jsxs(Box, { children: [_jsx(Text, { color: isActive ? "cyan" : undefined, children: isActive ? "❯ " : "  " }), _jsx(Text, { color: isActive ? "cyan" : undefined, bold: isActive, children: item.title }), item.subtitle !== undefined && item.subtitle !== "" ? _jsx(Text, { dimColor: true, children: `  ${item.subtitle}` }) : null, item.meta !== undefined && item.meta !== "" ? _jsx(Text, { dimColor: true, children: `  ${item.meta}` }) : null] }));
+}
+/** "1 result" / "N results" — matches the Go picker's footer wording. */
+function countLabel(count) {
+    return `${count} result${count === 1 ? "" : "s"}`;
+}
+/**
+ * Compute the visible slice `[start, end)` so the active row stays in view,
+ * centering the cursor once the list grows past {@link MAX_VISIBLE}.
+ */
+function visibleWindow(active, total) {
+    if (total <= MAX_VISIBLE)
+        return [0, total];
+    const half = Math.floor(MAX_VISIBLE / 2);
+    let start = Math.max(0, active - half);
+    let end = start + MAX_VISIBLE;
+    if (end > total) {
+        end = total;
+        start = end - MAX_VISIBLE;
+    }
+    return [start, end];
+}
+//# sourceMappingURL=ResourcePicker.js.map

package/components/ResourcePicker.js.map

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

package/components/SessionPicker.d.ts

@@ -0,0 +1,31 @@
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+/** Props for {@link SessionPicker}. */
+export interface SessionPickerProps {
+    /** Seeds the filter box (e.g. text the user already typed). */
+    readonly initialQuery?: string;
+    /** Maximum sessions to fetch. Defaults to 50. */
+    readonly pageSize?: number;
+    /** Called with the chosen session on selection. */
+    readonly onSelect: (session: Session) => void;
+    /** Called when the user cancels (Esc / Ctrl+C). */
+    readonly onCancel: () => void;
+}
+/**
+ * Interactive picker for re-opening an existing session.
+ *
+ * Unlike agents, sessions are not search-indexed, so this composes
+ * {@link useSessionList} with client-side text filtering over the recent
+ * session list. The selected {@link Session} is returned via `onSelect`; use
+ * `session.metadata.id` to resume it.
+ *
+ * @example
+ * ```tsx
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <SessionPicker onSelect={(s) => resume(s.metadata?.id)} onCancel={() => process.exit(0)} />
+ *   </InkStigmerProvider>,
+ * );
+ * ```
+ */
+export declare function SessionPicker({ initialQuery, pageSize, onSelect, onCancel }: SessionPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SessionPicker.d.ts.map

package/components/SessionPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionPicker.d.ts","sourceRoot":"","sources":["../../src/components/SessionPicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAIpF,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAAE,YAAY,EAAE,QAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB,2CA4BpG"}

package/components/SessionPicker.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo, useState } from "react";
+import { useSessionList } from "@stigmer/react";
+import { ResourcePicker } from "./ResourcePicker.js";
+const PENDING_SUBJECT = "Auto-created session";
+/**
+ * Interactive picker for re-opening an existing session.
+ *
+ * Unlike agents, sessions are not search-indexed, so this composes
+ * {@link useSessionList} with client-side text filtering over the recent
+ * session list. The selected {@link Session} is returned via `onSelect`; use
+ * `session.metadata.id` to resume it.
+ *
+ * @example
+ * ```tsx
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <SessionPicker onSelect={(s) => resume(s.metadata?.id)} onCancel={() => process.exit(0)} />
+ *   </InkStigmerProvider>,
+ * );
+ * ```
+ */
+export function SessionPicker({ initialQuery, pageSize = 50, onSelect, onCancel }) {
+    const { sessions, isLoading, error } = useSessionList({ pageSize });
+    const [query, setQuery] = useState(initialQuery ?? "");
+    const filtered = useMemo(() => filterSessions(sessions, query), [sessions, query]);
+    const items = useMemo(() => filtered.map(toSessionItem), [filtered]);
+    const handleSelect = useCallback((item) => {
+        const found = sessions.find((s) => (s.metadata?.id ?? "") === item.id);
+        if (found !== undefined)
+            onSelect(found);
+    }, [sessions, onSelect]);
+    return (_jsx(ResourcePicker, { prompt: "Select a session", items: items, query: query, onQueryChange: setQuery, isLoading: isLoading, error: error, onSelect: handleSelect, onCancel: onCancel, emptyLabel: "no sessions found" }));
+}
+/** Case-insensitive filter over a session's subject, agent, and id. */
+function filterSessions(sessions, query) {
+    const needle = query.trim().toLowerCase();
+    if (needle === "")
+        return sessions;
+    return sessions.filter((s) => sessionHaystack(s).includes(needle));
+}
+function sessionHaystack(session) {
+    return [sessionSubject(session), session.spec?.agentInstanceId ?? "", session.metadata?.id ?? ""]
+        .join(" ")
+        .toLowerCase();
+}
+/** Map a session to a picker row: subject title, agent subtitle, age meta. */
+function toSessionItem(session) {
+    return {
+        id: session.metadata?.id ?? "",
+        title: sessionSubject(session),
+        subtitle: session.spec?.agentInstanceId ?? "",
+        meta: relativeTime(session.status?.audit?.specAudit?.createdAt),
+    };
+}
+// The session's display subject, suppressing the backend's auto-create
+// sentinel (the async title activity replaces it shortly after creation).
+function sessionSubject(session) {
+    const subject = session.spec?.subject ?? "";
+    if (subject !== "" && subject !== PENDING_SUBJECT)
+        return subject;
+    return session.metadata?.name !== undefined && session.metadata.name !== ""
+        ? session.metadata.name
+        : (session.metadata?.id ?? "(untitled session)");
+}
+// Coarse "N units ago" label from a protobuf Timestamp. Empty when unknown.
+function relativeTime(ts) {
+    if (ts === undefined)
+        return "";
+    const then = Number(ts.seconds) * 1000;
+    if (!Number.isFinite(then) || then <= 0)
+        return "";
+    const seconds = Math.max(0, Math.floor((Date.now() - then) / 1000));
+    const units = [
+        [86400, "day"],
+        [3600, "hour"],
+        [60, "minute"],
+    ];
+    for (const [size, label] of units) {
+        const value = Math.floor(seconds / size);
+        if (value >= 1)
+            return `${value} ${label}${value === 1 ? "" : "s"} ago`;
+    }
+    return "just now";
+}
+//# sourceMappingURL=SessionPicker.js.map

package/components/SessionPicker.js.map

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

package/components/ToolCallItem.js

@@ -69,12 +69,26 @@ function describeResultView(view) {
             return truncate(view.text);
         case "json":
             return truncate(JSON.stringify(view.value));
+        case "outputRef": {
+            const size = view.sizeBytes ? ` (${formatBytes(view.sizeBytes)})` : "";
+            if (view.isImage)
+                return `image${size}: ${view.downloadUrl}`;
+            const preview = view.preview ? `${truncate(view.preview)}\n` : "";
+            return `${preview}full output${size}: ${view.downloadUrl}`;
+        }
         case "error":
             return view.message;
         case "empty":
             return null;
     }
 }
+function formatBytes(n) {
+    if (n >= 1024 * 1024)
+        return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+    if (n >= 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${n} B`;
+}
 function truncate(s, maxLines = 5) {
     const lines = s.split("\n");
     if (lines.length <= maxLines)

package/components/ToolCallItem.js.map

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

package/index.d.ts

@@ -12,6 +12,9 @@ export { ExecutionProgress, type ExecutionProgressProps } from "./components/Exe
 export { FollowUpInput, type FollowUpInputProps } from "./components/FollowUpInput.js";
 export { UsageWidget, type UsageWidgetProps } from "./components/UsageWidget.js";
 export { ContextGauge, type ContextGaugeProps } from "./components/ContextGauge.js";
+export { ResourcePicker, type ResourcePickerProps, type PickerItem } from "./components/ResourcePicker.js";
+export { AgentPicker, type AgentPickerProps } from "./components/AgentPicker.js";
+export { SessionPicker, type SessionPickerProps } from "./components/SessionPicker.js";
 export { SessionView, type SessionViewProps, type InteractionMode } from "./app/SessionView.js";
 export { SessionApp, type SessionAppProps } from "./app/SessionApp.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/index.js

@@ -16,6 +16,10 @@ export { ExecutionProgress } from "./components/ExecutionProgress.js";
 export { FollowUpInput } from "./components/FollowUpInput.js";
 export { UsageWidget } from "./components/UsageWidget.js";
 export { ContextGauge } from "./components/ContextGauge.js";
+// Pickers (interactive search-and-select)
+export { ResourcePicker } from "./components/ResourcePicker.js";
+export { AgentPicker } from "./components/AgentPicker.js";
+export { SessionPicker } from "./components/SessionPicker.js";
 // Composed views
 export { SessionView } from "./app/SessionView.js";
 export { SessionApp } from "./app/SessionApp.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AAEpF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA+C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AAEpF,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAA6C,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AAEvF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA+C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/ink",
-  "version": "3.0.8-dev.20260613074252",
+  "version": "3.0.8",
   "description": "Ink (React for terminals) components for rendering Stigmer agent sessions in the terminal",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@connectrpc/connect-node": "^2.1.1",
-    "@stigmer/react": "3.0.8-dev.20260613074252",
+    "@stigmer/react": "3.0.8",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "marked": "^15.0.7",
@@ -43,8 +43,8 @@
   },
   "peerDependencies": {
     "@bufbuild/protobuf": "^2.0.0",
-    "@stigmer/protos": "3.0.8-dev.20260613074252",
-    "@stigmer/sdk": "3.0.8-dev.20260613074252",
+    "@stigmer/protos": "3.0.8",
+    "@stigmer/sdk": "3.0.8",
     "ink": "^7.0.0",
     "react": ">=19.0.0"
   }

package/src/__tests__/data-pickers.test.tsx

@@ -0,0 +1,108 @@
+import React from "react";
+import { describe, it, expect, vi } from "vitest";
+import { render } from "ink-testing-library";
+import { create } from "@bufbuild/protobuf";
+import type { Stigmer } from "@stigmer/sdk";
+import { SearchResultSchema } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { SessionSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import { InkStigmerProvider } from "../provider.js";
+import { AgentPicker } from "../components/AgentPicker.js";
+import { SessionPicker } from "../components/SessionPicker.js";
+
+const KEY = { enter: "\r" } as const;
+
+// Allow the hooks' async fetch + a re-render to settle.
+function settle(): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, 60));
+}
+
+function agentResult(id: string, slug: string, description: string) {
+  return create(SearchResultSchema, { id, qualifiedSlug: slug, description });
+}
+
+function session(id: string, subject: string, agentInstanceId: string) {
+  return create(SessionSchema, {
+    metadata: { id },
+    spec: { subject, agentInstanceId },
+  });
+}
+
+// Minimal Stigmer stub exposing only the methods the picker hooks call.
+function fakeClient(overrides: Record<string, unknown>): Stigmer {
+  return overrides as unknown as Stigmer;
+}
+
+describe("AgentPicker", () => {
+  it("renders search results and returns the chosen agent on Enter", async () => {
+    const results = [
+      agentResult("agt_1", "acme/alpha", "first"),
+      agentResult("agt_2", "acme/beta", "second"),
+    ];
+    const client = fakeClient({
+      agent: { list: vi.fn(async () => ({ entries: results, totalPages: 1, totalCount: 2 })) },
+    });
+    const onSelect = vi.fn();
+
+    const { lastFrame, stdin } = render(
+      <InkStigmerProvider client={client}>
+        <AgentPicker org="acme" onSelect={onSelect} onCancel={vi.fn()} />
+      </InkStigmerProvider>,
+    );
+
+    await settle();
+    expect(lastFrame() ?? "").toContain("acme/alpha");
+    expect(lastFrame() ?? "").toContain("first");
+
+    stdin.write(KEY.enter);
+    await settle();
+    expect(onSelect).toHaveBeenCalledTimes(1);
+    expect(onSelect.mock.calls[0][0].id).toBe("agt_1");
+  });
+
+  it("seeds the search box from initialQuery", async () => {
+    const list = vi.fn(async () => ({ entries: [], totalPages: 0, totalCount: 0 }));
+    const client = fakeClient({ agent: { list } });
+
+    const { lastFrame } = render(
+      <InkStigmerProvider client={client}>
+        <AgentPicker org="acme" initialQuery="deploy" onSelect={vi.fn()} onCancel={vi.fn()} />
+      </InkStigmerProvider>,
+    );
+
+    await settle();
+    // The picker pre-fills the input with the unresolved query the user
+    // already typed; useAgentSearch then re-searches it (debounced).
+    expect(lastFrame() ?? "").toContain("deploy");
+  });
+});
+
+describe("SessionPicker", () => {
+  it("client-side filters the session list and returns the chosen session", async () => {
+    const sessions = [
+      session("ses_1", "deploy staging", "ai_1"),
+      session("ses_2", "review PR", "ai_2"),
+      session("ses_3", "deploy prod", "ai_3"),
+    ];
+    const client = fakeClient({
+      session: { list: vi.fn(async () => ({ entries: sessions })) },
+    });
+    const onSelect = vi.fn();
+
+    const { lastFrame, stdin } = render(
+      <InkStigmerProvider client={client}>
+        <SessionPicker initialQuery="deploy" onSelect={onSelect} onCancel={vi.fn()} />
+      </InkStigmerProvider>,
+    );
+
+    await settle();
+    const frame = lastFrame() ?? "";
+    expect(frame).toContain("deploy staging");
+    expect(frame).toContain("deploy prod");
+    expect(frame).not.toContain("review PR");
+
+    stdin.write(KEY.enter);
+    await settle();
+    expect(onSelect).toHaveBeenCalledTimes(1);
+    expect(onSelect.mock.calls[0][0].metadata.id).toBe("ses_1");
+  });
+});

package/src/__tests__/resource-picker.test.tsx

@@ -0,0 +1,176 @@
+import React from "react";
+import { describe, it, expect, vi } from "vitest";
+import { render } from "ink-testing-library";
+import { type PickerItem, ResourcePicker } from "../components/ResourcePicker.js";
+
+// Key escape sequences understood by ink's input parser.
+const KEY = {
+  up: "\u001B[A",
+  down: "\u001B[B",
+  enter: "\r",
+  escape: "\u001B",
+} as const;
+
+const ITEMS: PickerItem[] = [
+  { id: "agt_1", title: "acme/alpha", subtitle: "first agent" },
+  { id: "agt_2", title: "acme/beta", subtitle: "second agent" },
+  { id: "agt_3", title: "acme/gamma", subtitle: "third agent", meta: "2 hours ago" },
+];
+
+// Ink processes stdin asynchronously; yield a macrotask so the frame settles.
+function tick(): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, 20));
+}
+
+function noop(): void {}
+
+describe("ResourcePicker", () => {
+  it("renders the prompt, all items, and the result count", () => {
+    const { lastFrame } = render(
+      <ResourcePicker
+        prompt="Select an agent"
+        items={ITEMS}
+        query=""
+        onQueryChange={noop}
+        onSelect={noop}
+        onCancel={noop}
+      />,
+    );
+    const out = lastFrame() ?? "";
+    expect(out).toContain("Select an agent");
+    expect(out).toContain("acme/alpha");
+    expect(out).toContain("acme/gamma");
+    expect(out).toContain("first agent");
+    expect(out).toContain("2 hours ago");
+    expect(out).toContain("3 results");
+  });
+
+  it("marks the first item active by default", () => {
+    const { lastFrame } = render(
+      <ResourcePicker items={ITEMS} query="" onQueryChange={noop} onSelect={noop} onCancel={noop} />,
+    );
+    expect(lastFrame() ?? "").toContain("❯ acme/alpha");
+  });
+
+  it("selects the active item on Enter", async () => {
+    const onSelect = vi.fn();
+    const { stdin } = render(
+      <ResourcePicker items={ITEMS} query="" onQueryChange={noop} onSelect={onSelect} onCancel={noop} />,
+    );
+    stdin.write(KEY.enter);
+    await tick();
+    expect(onSelect).toHaveBeenCalledTimes(1);
+    expect(onSelect).toHaveBeenCalledWith(ITEMS[0]);
+  });
+
+  it("moves the cursor down and selects the new active item", async () => {
+    const onSelect = vi.fn();
+    const { stdin } = render(
+      <ResourcePicker items={ITEMS} query="" onQueryChange={noop} onSelect={onSelect} onCancel={noop} />,
+    );
+    stdin.write(KEY.down);
+    await tick();
+    stdin.write(KEY.down);
+    await tick();
+    stdin.write(KEY.enter);
+    await tick();
+    expect(onSelect).toHaveBeenCalledWith(ITEMS[2]);
+  });
+
+  it("clamps cursor movement at the list boundaries", async () => {
+    const onSelect = vi.fn();
+    const { stdin } = render(
+      <ResourcePicker items={ITEMS} query="" onQueryChange={noop} onSelect={onSelect} onCancel={noop} />,
+    );
+    // Up at the top stays on the first row.
+    stdin.write(KEY.up);
+    await tick();
+    stdin.write(KEY.enter);
+    await tick();
+    expect(onSelect).toHaveBeenLastCalledWith(ITEMS[0]);
+    // Past the bottom stays on the last row.
+    stdin.write(KEY.down);
+    await tick();
+    stdin.write(KEY.down);
+    await tick();
+    stdin.write(KEY.down);
+    await tick();
+    stdin.write(KEY.enter);
+    await tick();
+    expect(onSelect).toHaveBeenLastCalledWith(ITEMS[2]);
+  });
+
+  it("cancels on Escape without selecting", async () => {
+    const onSelect = vi.fn();
+    const onCancel = vi.fn();
+    const { stdin } = render(
+      <ResourcePicker items={ITEMS} query="" onQueryChange={noop} onSelect={onSelect} onCancel={onCancel} />,
+    );
+    stdin.write(KEY.escape);
+    await tick();
+    expect(onCancel).toHaveBeenCalledTimes(1);
+    expect(onSelect).not.toHaveBeenCalled();
+  });
+
+  it("forwards typed characters to onQueryChange", async () => {
+    const onQueryChange = vi.fn();
+    const { stdin } = render(
+      <ResourcePicker items={ITEMS} query="" onQueryChange={onQueryChange} onSelect={noop} onCancel={noop} />,
+    );
+    stdin.write("a");
+    await tick();
+    expect(onQueryChange).toHaveBeenCalledWith("a");
+  });
+
+  it("does not select when Enter is pressed on an empty list", async () => {
+    const onSelect = vi.fn();
+    const { stdin, lastFrame } = render(
+      <ResourcePicker items={[]} query="zzz" onQueryChange={noop} onSelect={onSelect} onCancel={noop} />,
+    );
+    expect(lastFrame() ?? "").toContain("no results");
+    stdin.write(KEY.enter);
+    await tick();
+    expect(onSelect).not.toHaveBeenCalled();
+  });
+
+  it("shows a loading state while searching", () => {
+    const { lastFrame } = render(
+      <ResourcePicker items={[]} query="x" onQueryChange={noop} onSelect={noop} onCancel={noop} isLoading />,
+    );
+    expect(lastFrame() ?? "").toContain("searching...");
+  });
+
+  it("shows an error state in place of the list", () => {
+    const { lastFrame } = render(
+      <ResourcePicker
+        items={[]}
+        query="x"
+        onQueryChange={noop}
+        onSelect={noop}
+        onCancel={noop}
+        error={new Error("backend unreachable")}
+      />,
+    );
+    expect(lastFrame() ?? "").toContain("Error: backend unreachable");
+  });
+
+  it("scrolls the visible window to keep the active row in view", async () => {
+    const many: PickerItem[] = Array.from({ length: 14 }, (_, i) => ({
+      id: `id_${i}`,
+      title: `item-${i}`,
+    }));
+    const { stdin, lastFrame } = render(
+      <ResourcePicker items={many} query="" onQueryChange={noop} onSelect={noop} onCancel={noop} />,
+    );
+    // Initially the top of the list is visible, the tail is not.
+    expect(lastFrame() ?? "").toContain("item-0");
+    expect(lastFrame() ?? "").not.toContain("item-13");
+    // Drive the cursor to the bottom; the window should scroll to reveal it.
+    for (let i = 0; i < 13; i++) {
+      stdin.write(KEY.down);
+      await tick();
+    }
+    expect(lastFrame() ?? "").toContain("item-13");
+    expect(lastFrame() ?? "").not.toContain("item-0");
+  }, 20000);
+});

package/src/components/AgentPicker.tsx

@@ -0,0 +1,84 @@
+import React, { useCallback, useEffect, useMemo } from "react";
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { useAgentSearch } from "@stigmer/react";
+import { type PickerItem, ResourcePicker } from "./ResourcePicker.js";
+
+/** Props for {@link AgentPicker}. */
+export interface AgentPickerProps {
+  /** Organization to search within. */
+  readonly org: string;
+  /** Seeds the search box (e.g. an unresolved slug the user already typed). */
+  readonly initialQuery?: string;
+  /** `"org"` (default) searches the org; `"all"` includes public agents. */
+  readonly scope?: "org" | "all";
+  /** Called with the chosen agent's search result on selection. */
+  readonly onSelect: (agent: SearchResult) => void;
+  /** Called when the user cancels (Esc / Ctrl+C). */
+  readonly onCancel: () => void;
+}
+
+/** Max description length shown as the row subtitle before truncation. */
+const SUBTITLE_MAX = 60;
+
+/**
+ * Interactive picker for choosing an agent by name.
+ *
+ * Composes the {@link useAgentSearch} data hook with {@link ResourcePicker}:
+ * the user types, results stream in (debounced by the hook), and the selected
+ * agent's {@link SearchResult} is returned via `onSelect`. Use the `id` field of
+ * that result to resolve and run the agent.
+ *
+ * @example
+ * ```tsx
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <AgentPicker org="acme" onSelect={(a) => run(a.id)} onCancel={() => process.exit(0)} />
+ *   </InkStigmerProvider>,
+ * );
+ * ```
+ */
+export function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }: AgentPickerProps) {
+  const { results, isLoading, error, query, setQuery } = useAgentSearch(org, { scope });
+
+  // Seed the typed-but-unresolved query once on mount so the user picks up
+  // where the smart-resolution attempt left off.
+  useEffect(() => {
+    if (initialQuery !== undefined && initialQuery !== "") setQuery(initialQuery);
+    // Mount-only: re-seeding on every render would fight the user's typing.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  const items = useMemo<PickerItem[]>(() => results.map(toAgentItem), [results]);
+
+  const handleSelect = useCallback(
+    (item: PickerItem) => {
+      const found = results.find((r) => r.id === item.id);
+      if (found !== undefined) onSelect(found);
+    },
+    [results, onSelect],
+  );
+
+  return (
+    <ResourcePicker
+      prompt="Select an agent"
+      items={items}
+      query={query}
+      onQueryChange={setQuery}
+      isLoading={isLoading}
+      error={error}
+      onSelect={handleSelect}
+      onCancel={onCancel}
+      emptyLabel="no agents found"
+    />
+  );
+}
+
+/** Map a search result to a picker row: org/slug title, description subtitle. */
+function toAgentItem(result: SearchResult): PickerItem {
+  const title = result.qualifiedSlug !== "" ? result.qualifiedSlug : `${result.org}/${result.slug}`;
+  return { id: result.id, title, subtitle: truncate(result.description, SUBTITLE_MAX) };
+}
+
+function truncate(text: string, max: number): string {
+  return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+}

package/src/components/ResourcePicker.tsx

@@ -0,0 +1,187 @@
+import React, { useEffect, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import TextInput from "ink-text-input";
+
+/**
+ * A single selectable entry in a {@link ResourcePicker}.
+ *
+ * Callers map their domain objects (agents, sessions, ...) into this shape and
+ * receive the chosen item back via `onSelect`. The picker is domain-agnostic:
+ * it knows only how to render and navigate these rows.
+ */
+export interface PickerItem {
+  /** Opaque identity returned to the caller on selection. */
+  readonly id: string;
+  /** Primary display text, rendered bold when active (e.g. "acme/deploy"). */
+  readonly title: string;
+  /** Secondary text, rendered dimmed after the title (e.g. a description). */
+  readonly subtitle?: string;
+  /** Right-aligned metadata, rendered dimmed (e.g. "2 hours ago"). */
+  readonly meta?: string;
+}
+
+/** Props for {@link ResourcePicker}. */
+export interface ResourcePickerProps {
+  /** The current result rows to choose from (owned by the caller). */
+  readonly items: readonly PickerItem[];
+  /** Current query text (controlled — the caller owns search state). */
+  readonly query: string;
+  /** Called when the query text changes; the caller re-runs its search. */
+  readonly onQueryChange: (query: string) => void;
+  /** Called with the chosen item when the user presses Enter. */
+  readonly onSelect: (item: PickerItem) => void;
+  /** Called when the user cancels (Esc or Ctrl+C). */
+  readonly onCancel: () => void;
+  /** `true` while a search request is in flight. */
+  readonly isLoading?: boolean;
+  /** Error from the last failed search, shown in place of the list. */
+  readonly error?: Error | null;
+  /** Label shown before the input (e.g. "Select an agent"). */
+  readonly prompt?: string;
+  /** Placeholder shown in the empty input. */
+  readonly placeholder?: string;
+  /** Label shown when a completed search returns no rows. */
+  readonly emptyLabel?: string;
+}
+
+/** Maximum rows shown at once; the list scrolls a window around the cursor. */
+const MAX_VISIBLE = 10;
+
+/**
+ * Generic, interactive search-and-select list for the terminal.
+ *
+ * Renders a text input above a scrollable result list. The user types to
+ * filter (the caller performs the actual search via `onQueryChange`), navigates
+ * with the arrow keys, selects with Enter, and cancels with Esc. It holds no
+ * data of its own — pass `items`/`query`/`isLoading` from a data hook such as
+ * `useAgentSearch` or `useSessionList`.
+ *
+ * This is the reusable organism behind {@link AgentPicker} and
+ * {@link SessionPicker}; platform builders can compose it with any search
+ * function to pick any resource.
+ *
+ * @example
+ * ```tsx
+ * const { results, isLoading, query, setQuery } = useAgentSearch("acme");
+ * const items = results.map((r) => ({ id: r.id, title: r.qualifiedSlug }));
+ * render(
+ *   <ResourcePicker
+ *     prompt="Select an agent"
+ *     items={items}
+ *     query={query}
+ *     onQueryChange={setQuery}
+ *     isLoading={isLoading}
+ *     onSelect={(item) => console.log(item.id)}
+ *     onCancel={() => process.exit(0)}
+ *   />,
+ * );
+ * ```
+ */
+export function ResourcePicker({
+  items,
+  query,
+  onQueryChange,
+  onSelect,
+  onCancel,
+  isLoading = false,
+  error = null,
+  prompt = "Search",
+  placeholder = "type to search...",
+  emptyLabel = "no results",
+}: ResourcePickerProps) {
+  const [cursor, setCursor] = useState(0);
+
+  // Reset the cursor to the top whenever the query changes — the result set is
+  // about to be replaced, so a stale cursor would point at the wrong row.
+  useEffect(() => {
+    setCursor(0);
+  }, [query]);
+
+  const active = items.length === 0 ? 0 : Math.min(cursor, items.length - 1);
+
+  useInput((input, key) => {
+    if (key.escape || (key.ctrl && input === "c")) {
+      onCancel();
+      return;
+    }
+    if (key.return) {
+      if (items.length > 0) onSelect(items[active]);
+      return;
+    }
+    if (key.upArrow) {
+      setCursor((c) => Math.max(0, Math.min(c, items.length - 1) - 1));
+      return;
+    }
+    if (key.downArrow) {
+      setCursor((c) => Math.min(items.length - 1, c + 1));
+    }
+  });
+
+  const [start, end] = visibleWindow(active, items.length);
+
+  return (
+    <Box flexDirection="column">
+      <Box gap={1}>
+        <Text color="cyan" bold>
+          ?
+        </Text>
+        <Text bold>{prompt}:</Text>
+        <TextInput value={query} onChange={onQueryChange} placeholder={placeholder} />
+      </Box>
+
+      <Box marginTop={1} flexDirection="column">
+        {error !== null ? (
+          <Text color="red">{`  Error: ${error.message}`}</Text>
+        ) : isLoading ? (
+          <Text dimColor>  searching...</Text>
+        ) : items.length === 0 ? (
+          <Text dimColor>{`  ${emptyLabel}`}</Text>
+        ) : (
+          <>
+            {items.slice(start, end).map((item, i) => (
+              <PickerRow key={item.id} item={item} isActive={start + i === active} />
+            ))}
+            <Box marginTop={1}>
+              <Text dimColor>{`  ${countLabel(items.length)}  |  up/down: navigate  |  enter: select  |  esc: cancel`}</Text>
+            </Box>
+          </>
+        )}
+      </Box>
+    </Box>
+  );
+}
+
+/** One result row: a cursor glyph, the title, then optional subtitle/meta. */
+function PickerRow({ item, isActive }: { readonly item: PickerItem; readonly isActive: boolean }) {
+  return (
+    <Box>
+      <Text color={isActive ? "cyan" : undefined}>{isActive ? "❯ " : "  "}</Text>
+      <Text color={isActive ? "cyan" : undefined} bold={isActive}>
+        {item.title}
+      </Text>
+      {item.subtitle !== undefined && item.subtitle !== "" ? <Text dimColor>{`  ${item.subtitle}`}</Text> : null}
+      {item.meta !== undefined && item.meta !== "" ? <Text dimColor>{`  ${item.meta}`}</Text> : null}
+    </Box>
+  );
+}
+
+/** "1 result" / "N results" — matches the Go picker's footer wording. */
+function countLabel(count: number): string {
+  return `${count} result${count === 1 ? "" : "s"}`;
+}
+
+/**
+ * Compute the visible slice `[start, end)` so the active row stays in view,
+ * centering the cursor once the list grows past {@link MAX_VISIBLE}.
+ */
+function visibleWindow(active: number, total: number): readonly [number, number] {
+  if (total <= MAX_VISIBLE) return [0, total];
+  const half = Math.floor(MAX_VISIBLE / 2);
+  let start = Math.max(0, active - half);
+  let end = start + MAX_VISIBLE;
+  if (end > total) {
+    end = total;
+    start = end - MAX_VISIBLE;
+  }
+  return [start, end];
+}

package/src/components/SessionPicker.tsx

@@ -0,0 +1,117 @@
+import React, { useCallback, useMemo, useState } from "react";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import { useSessionList } from "@stigmer/react";
+import { type PickerItem, ResourcePicker } from "./ResourcePicker.js";
+
+/** Props for {@link SessionPicker}. */
+export interface SessionPickerProps {
+  /** Seeds the filter box (e.g. text the user already typed). */
+  readonly initialQuery?: string;
+  /** Maximum sessions to fetch. Defaults to 50. */
+  readonly pageSize?: number;
+  /** Called with the chosen session on selection. */
+  readonly onSelect: (session: Session) => void;
+  /** Called when the user cancels (Esc / Ctrl+C). */
+  readonly onCancel: () => void;
+}
+
+const PENDING_SUBJECT = "Auto-created session";
+
+/**
+ * Interactive picker for re-opening an existing session.
+ *
+ * Unlike agents, sessions are not search-indexed, so this composes
+ * {@link useSessionList} with client-side text filtering over the recent
+ * session list. The selected {@link Session} is returned via `onSelect`; use
+ * `session.metadata.id` to resume it.
+ *
+ * @example
+ * ```tsx
+ * render(
+ *   <InkStigmerProvider client={client}>
+ *     <SessionPicker onSelect={(s) => resume(s.metadata?.id)} onCancel={() => process.exit(0)} />
+ *   </InkStigmerProvider>,
+ * );
+ * ```
+ */
+export function SessionPicker({ initialQuery, pageSize = 50, onSelect, onCancel }: SessionPickerProps) {
+  const { sessions, isLoading, error } = useSessionList({ pageSize });
+  const [query, setQuery] = useState(initialQuery ?? "");
+
+  const filtered = useMemo(() => filterSessions(sessions, query), [sessions, query]);
+  const items = useMemo<PickerItem[]>(() => filtered.map(toSessionItem), [filtered]);
+
+  const handleSelect = useCallback(
+    (item: PickerItem) => {
+      const found = sessions.find((s) => (s.metadata?.id ?? "") === item.id);
+      if (found !== undefined) onSelect(found);
+    },
+    [sessions, onSelect],
+  );
+
+  return (
+    <ResourcePicker
+      prompt="Select a session"
+      items={items}
+      query={query}
+      onQueryChange={setQuery}
+      isLoading={isLoading}
+      error={error}
+      onSelect={handleSelect}
+      onCancel={onCancel}
+      emptyLabel="no sessions found"
+    />
+  );
+}
+
+/** Case-insensitive filter over a session's subject, agent, and id. */
+function filterSessions(sessions: readonly Session[], query: string): readonly Session[] {
+  const needle = query.trim().toLowerCase();
+  if (needle === "") return sessions;
+  return sessions.filter((s) => sessionHaystack(s).includes(needle));
+}
+
+function sessionHaystack(session: Session): string {
+  return [sessionSubject(session), session.spec?.agentInstanceId ?? "", session.metadata?.id ?? ""]
+    .join(" ")
+    .toLowerCase();
+}
+
+/** Map a session to a picker row: subject title, agent subtitle, age meta. */
+function toSessionItem(session: Session): PickerItem {
+  return {
+    id: session.metadata?.id ?? "",
+    title: sessionSubject(session),
+    subtitle: session.spec?.agentInstanceId ?? "",
+    meta: relativeTime(session.status?.audit?.specAudit?.createdAt),
+  };
+}
+
+// The session's display subject, suppressing the backend's auto-create
+// sentinel (the async title activity replaces it shortly after creation).
+function sessionSubject(session: Session): string {
+  const subject = session.spec?.subject ?? "";
+  if (subject !== "" && subject !== PENDING_SUBJECT) return subject;
+  return session.metadata?.name !== undefined && session.metadata.name !== ""
+    ? session.metadata.name
+    : (session.metadata?.id ?? "(untitled session)");
+}
+
+// Coarse "N units ago" label from a protobuf Timestamp. Empty when unknown.
+function relativeTime(ts: Timestamp | undefined): string {
+  if (ts === undefined) return "";
+  const then = Number(ts.seconds) * 1000;
+  if (!Number.isFinite(then) || then <= 0) return "";
+  const seconds = Math.max(0, Math.floor((Date.now() - then) / 1000));
+  const units: ReadonlyArray<readonly [number, string]> = [
+    [86400, "day"],
+    [3600, "hour"],
+    [60, "minute"],
+  ];
+  for (const [size, label] of units) {
+    const value = Math.floor(seconds / size);
+    if (value >= 1) return `${value} ${label}${value === 1 ? "" : "s"} ago`;
+  }
+  return "just now";
+}

package/src/components/ToolCallItem.tsx

@@ -115,6 +115,12 @@ function describeResultView(view: ToolResultView): string | null {
       return truncate(view.text);
     case "json":
       return truncate(JSON.stringify(view.value));
+    case "outputRef": {
+      const size = view.sizeBytes ? ` (${formatBytes(view.sizeBytes)})` : "";
+      if (view.isImage) return `image${size}: ${view.downloadUrl}`;
+      const preview = view.preview ? `${truncate(view.preview)}\n` : "";
+      return `${preview}full output${size}: ${view.downloadUrl}`;
+    }
     case "error":
       return view.message;
     case "empty":
@@ -122,6 +128,12 @@ function describeResultView(view: ToolResultView): string | null {
   }
 }
 
+function formatBytes(n: number): string {
+  if (n >= 1024 * 1024) return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+  if (n >= 1024) return `${(n / 1024).toFixed(1)} KB`;
+  return `${n} B`;
+}
+
 function truncate(s: string, maxLines = 5): string {
   const lines = s.split("\n");
   if (lines.length <= maxLines) return s;

package/src/index.ts

@@ -24,6 +24,11 @@ export { FollowUpInput, type FollowUpInputProps } from "./components/FollowUpInp
 export { UsageWidget, type UsageWidgetProps } from "./components/UsageWidget.js";
 export { ContextGauge, type ContextGaugeProps } from "./components/ContextGauge.js";
 
+// Pickers (interactive search-and-select)
+export { ResourcePicker, type ResourcePickerProps, type PickerItem } from "./components/ResourcePicker.js";
+export { AgentPicker, type AgentPickerProps } from "./components/AgentPicker.js";
+export { SessionPicker, type SessionPickerProps } from "./components/SessionPicker.js";
+
 // Composed views
 export { SessionView, type SessionViewProps, type InteractionMode } from "./app/SessionView.js";
 export { SessionApp, type SessionAppProps } from "./app/SessionApp.js";