@stigmer/react 0.0.36 → 0.0.40

package/agent/AgentPicker.d.ts

@@ -0,0 +1,44 @@
+import type { ResourceRef } from "@stigmer/sdk";
+export interface AgentPickerProps {
+    /** Organization slug to scope the search. */
+    readonly org: string;
+    /** Currently selected agent reference, or null if none selected. */
+    readonly value: ResourceRef | null;
+    /** Called when the selection changes. Pass null to deselect. */
+    readonly onChange: (ref: ResourceRef | null) => void;
+    /** Called with the display name when an agent is selected (for chip rendering). */
+    readonly onDisplayNameResolved?: (key: string, name: string) => void;
+    readonly disabled?: boolean;
+    readonly className?: string;
+}
+/**
+ * Single-select searchable picker for choosing an agent from the platform.
+ *
+ * Renders a search input and scrollable list of available agents.
+ * Designed to be placed inside a popover container — this component
+ * renders the picker content, not the popover shell.
+ *
+ * Unlike the multi-select {@link SkillPicker} and McpServerPicker,
+ * this picker enforces single selection: clicking a result replaces
+ * the current selection. A session runs against exactly one agent.
+ *
+ * This is a Layer 1 building-block component used by both platform
+ * builders (Profile A) and direct Stigmer users (Profile B). Platform
+ * builders can use it standalone with their own popover or inline layout.
+ * The Stigmer Console places it inside a `ContextPopover` within the
+ * {@link SessionComposer}.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ *
+ * @example
+ * ```tsx
+ * // Platform builder: standalone agent picker
+ * const [agent, setAgent] = useState<ResourceRef | null>(null);
+ * <AgentPicker org="acme" value={agent} onChange={setAgent} />
+ *
+ * // Access the selected agent
+ * if (agent) console.log(`Selected: ${agent.org}/${agent.slug}`);
+ * ```
+ */
+export declare function AgentPicker({ org, value, onChange, onDisplayNameResolved, disabled, className, }: AgentPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AgentPicker.d.ts.map

package/agent/AgentPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPicker.d.ts","sourceRoot":"","sources":["../../src/agent/AgentPicker.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,mFAAmF;IACnF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,KAAK,EACL,QAAQ,EACR,qBAAqB,EACrB,QAAQ,EACR,SAAS,GACV,EAAE,gBAAgB,2CA6LlB"}

package/agent/AgentPicker.js

@@ -0,0 +1,121 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useCallback, useEffect, useRef, useMemo, } from "react";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { cn } from "@stigmer/theme";
+import { useAgentSearch } from "./useAgentSearch";
+import { useScrollShadows } from "../internal/useScrollShadows";
+import { ScrollFade } from "../internal/ScrollFade";
+function refKey(ref) {
+    return `${ref.org}/${ref.slug}`;
+}
+const LIST_ID = "stgm-agent-list";
+/**
+ * Single-select searchable picker for choosing an agent from the platform.
+ *
+ * Renders a search input and scrollable list of available agents.
+ * Designed to be placed inside a popover container — this component
+ * renders the picker content, not the popover shell.
+ *
+ * Unlike the multi-select {@link SkillPicker} and McpServerPicker,
+ * this picker enforces single selection: clicking a result replaces
+ * the current selection. A session runs against exactly one agent.
+ *
+ * This is a Layer 1 building-block component used by both platform
+ * builders (Profile A) and direct Stigmer users (Profile B). Platform
+ * builders can use it standalone with their own popover or inline layout.
+ * The Stigmer Console places it inside a `ContextPopover` within the
+ * {@link SessionComposer}.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ *
+ * @example
+ * ```tsx
+ * // Platform builder: standalone agent picker
+ * const [agent, setAgent] = useState<ResourceRef | null>(null);
+ * <AgentPicker org="acme" value={agent} onChange={setAgent} />
+ *
+ * // Access the selected agent
+ * if (agent) console.log(`Selected: ${agent.org}/${agent.slug}`);
+ * ```
+ */
+export function AgentPicker({ org, value, onChange, onDisplayNameResolved, disabled, className, }) {
+    const { results, isLoading, error, query, setQuery } = useAgentSearch(org);
+    const [focusIndex, setFocusIndex] = useState(-1);
+    const searchRef = useRef(null);
+    const { scrollRef: listRef, canScrollUp, canScrollDown } = useScrollShadows();
+    const selectedKey = useMemo(() => (value ? refKey(value) : null), [value]);
+    const availableResults = useMemo(() => selectedKey
+        ? results.filter((r) => `${r.org}/${r.slug}` !== selectedKey)
+        : results, [results, selectedKey]);
+    useEffect(() => {
+        setFocusIndex(-1);
+    }, [query]);
+    useEffect(() => {
+        if (focusIndex >= 0) {
+            listRef.current
+                ?.querySelector(`[data-idx="${focusIndex}"]`)
+                ?.scrollIntoView({ block: "nearest" });
+        }
+    }, [focusIndex, listRef]);
+    const handleSelect = useCallback((result) => {
+        const ref = {
+            org: result.org,
+            slug: result.slug,
+            kind: ApiResourceKind.agent,
+        };
+        onChange(ref);
+        onDisplayNameResolved?.(`${result.org}/${result.slug}`, result.name);
+    }, [onChange, onDisplayNameResolved]);
+    const handleDeselect = useCallback(() => {
+        onChange(null);
+    }, [onChange]);
+    const handleSearchKeyDown = useCallback((e) => {
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setFocusIndex((prev) => prev < availableResults.length - 1 ? prev + 1 : prev);
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setFocusIndex((prev) => (prev > 0 ? prev - 1 : -1));
+        }
+        else if (e.key === "Enter" &&
+            focusIndex >= 0 &&
+            focusIndex < availableResults.length) {
+            e.preventDefault();
+            handleSelect(availableResults[focusIndex]);
+        }
+        else if (e.key === "Enter") {
+            e.preventDefault();
+        }
+    }, [availableResults, focusIndex, handleSelect]);
+    return (_jsxs("div", { className: ["space-y-2 w-72", className].filter(Boolean).join(" "), children: [value && (_jsxs("div", { className: "space-y-1", children: [_jsx("div", { className: "text-[0.65rem] font-medium text-muted-foreground", children: "Selected" }), _jsxs("div", { className: "flex items-center gap-2 rounded-md bg-muted/30 px-2 py-1 text-xs", children: [_jsx(AgentIcon, {}), _jsx("span", { className: "min-w-0 flex-1 truncate text-foreground", children: value.slug }), _jsx("button", { type: "button", onClick: handleDeselect, disabled: disabled, className: "shrink-0 text-muted-foreground hover:text-destructive disabled:pointer-events-none", "aria-label": `Remove ${value.slug}`, children: _jsx(XIcon, {}) })] })] })), _jsx("input", { ref: searchRef, type: "text", role: "combobox", "aria-expanded": true, "aria-controls": LIST_ID, "aria-activedescendant": focusIndex >= 0 ? `stgm-agent-${focusIndex}` : undefined, placeholder: "Search agents...", value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: handleSearchKeyDown, disabled: disabled, className: "w-full rounded-md border border-input bg-background px-2.5 py-1.5 text-xs text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50", autoFocus: true }), error && _jsx("p", { className: "text-xs text-destructive", children: error }), _jsxs("div", { className: "relative", children: [canScrollUp && _jsx(ScrollFade, { position: "top" }), _jsx("div", { ref: listRef, id: LIST_ID, role: "listbox", "aria-label": "Agents", className: "max-h-52 overflow-y-auto", children: isLoading ? (_jsx(LoadingSkeleton, {})) : availableResults.length === 0 ? (_jsx("div", { className: "py-4 text-center text-xs text-muted-foreground", children: query
+                                ? "No agents match your search"
+                                : value
+                                    ? "No other agents available"
+                                    : "No agents found" })) : (availableResults.map((result, idx) => (_jsxs("button", { id: `stgm-agent-${idx}`, type: "button", "data-idx": idx, onClick: () => handleSelect(result), disabled: disabled, className: cn("group flex w-full flex-col gap-0.5 rounded-md px-2 py-1.5 text-left text-xs transition-colors", "disabled:pointer-events-none disabled:opacity-50", idx === focusIndex
+                                ? "bg-accent text-foreground"
+                                : "text-foreground hover:bg-accent/50"), role: "option", "aria-selected": idx === focusIndex, children: [_jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx(AgentIcon, {}), _jsx("span", { className: "truncate font-medium", children: _jsx(HighlightMatch, { text: result.name, query: query }) }), _jsx("span", { className: "ml-auto shrink-0 text-[0.6rem] text-muted-foreground", children: result.org })] }), result.description && (_jsx("span", { className: cn("pl-5 text-[0.65rem] text-muted-foreground", idx !== focusIndex &&
+                                        "line-clamp-2 group-hover:line-clamp-none"), children: result.description }))] }, result.id)))) }), canScrollDown && _jsx(ScrollFade, { position: "bottom" })] })] }));
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+function HighlightMatch({ text, query }) {
+    if (!query)
+        return _jsx(_Fragment, { children: text });
+    const idx = text.toLowerCase().indexOf(query.toLowerCase());
+    if (idx === -1)
+        return _jsx(_Fragment, { children: text });
+    return (_jsxs(_Fragment, { children: [text.slice(0, idx), _jsx("span", { className: "font-semibold", children: text.slice(idx, idx + query.length) }), text.slice(idx + query.length)] }));
+}
+function LoadingSkeleton() {
+    return (_jsx("div", { className: "space-y-1 py-1", children: [50, 65, 40, 58].map((w, i) => (_jsxs("div", { className: "flex flex-col gap-1 px-2 py-1.5", children: [_jsx("div", { className: "h-3 rounded bg-muted animate-pulse", style: { width: `${w}%` } }), _jsx("div", { className: "h-2 rounded bg-muted/60 animate-pulse", style: { width: `${Math.min(w + 15, 90)}%` } })] }, i))) }));
+}
+function AgentIcon() {
+    return (_jsxs("svg", { width: "12", height: "12", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: [_jsx("rect", { x: "3", y: "5", width: "10", height: "8", rx: "2" }), _jsx("circle", { cx: "6", cy: "9", r: "1", fill: "currentColor", stroke: "none" }), _jsx("circle", { cx: "10", cy: "9", r: "1", fill: "currentColor", stroke: "none" }), _jsx("path", { d: "M8 1v4" }), _jsx("circle", { cx: "8", cy: "1", r: "1" })] }));
+}
+function XIcon() {
+    return (_jsx("svg", { width: "12", height: "12", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M4 4L10 10M10 4L4 10" }) }));
+}
+//# sourceMappingURL=AgentPicker.js.map

package/agent/AgentPicker.js.map

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

package/agent/agentSetupReducer.d.ts

@@ -0,0 +1,123 @@
+import type { EnvVarInput, ResourceRef } from "@stigmer/sdk";
+import type { AgentEnvFormVariable } from "./AgentEnvForm";
+/**
+ * Describes how the agent was resolved, determining how the caller
+ * should create the session and its first execution.
+ *
+ * - `"saved"` — Secrets were persisted to the user's personal
+ *   environment and a personal agent instance was created (or already
+ *   existed). Use `instanceId` with `createSession`.
+ * - `"oneTime"` — Secrets were collected but **not** persisted. Pass
+ *   `runtimeEnv` to `createExecution` for this run only.
+ * - `"direct"` — The agent has no `env_spec` and needs no secrets.
+ *   Create the session with `agentRef` directly.
+ */
+export type AgentResolution = {
+    readonly mode: "saved";
+    readonly instanceId: string;
+} | {
+    readonly mode: "oneTime";
+    readonly runtimeEnv: Record<string, EnvVarInput>;
+} | {
+    readonly mode: "direct";
+};
+/**
+ * Discriminated union representing the current phase of the agent
+ * setup flow managed by {@link useAgentSetup}.
+ *
+ * The `status` field serves as the discriminant. Phase-specific data
+ * (agent reference, missing variables, resolution) is only present
+ * on the variants where it is meaningful, enabling TypeScript
+ * narrowing in consumer code.
+ */
+export type AgentSetupPhase = {
+    readonly status: "idle";
+} | {
+    readonly status: "resolving";
+    readonly agentRef: ResourceRef;
+} | {
+    readonly status: "needsEnvVars";
+    readonly agentRef: ResourceRef;
+    readonly agentId: string;
+    readonly agentName: string;
+    readonly missingVariables: AgentEnvFormVariable[];
+} | {
+    readonly status: "submitting";
+    readonly agentRef: ResourceRef;
+    readonly agentId: string;
+    readonly agentName: string;
+    readonly missingVariables: AgentEnvFormVariable[];
+} | {
+    readonly status: "ready";
+    readonly agentRef: ResourceRef;
+    readonly agentName: string;
+    readonly resolution: AgentResolution;
+};
+/**
+ * Full state of the agent setup reducer: the current phase plus an
+ * orthogonal error slot.
+ *
+ * Errors can occur in any async transition (`resolving`, `submitting`)
+ * and are surfaced alongside the phase so the UI can show inline
+ * error messages without losing the current phase context.
+ */
+export type AgentSetupState = AgentSetupPhase & {
+    readonly error: Error | null;
+};
+/**
+ * Result returned by {@link useAgentSetup.resolveAgent}.
+ *
+ * - `"ready"` — the agent can be used immediately.
+ * - `"needsEnvVars"` — the agent requires environment variables
+ *   the user has not yet provided.
+ */
+export type AgentSetupResult = {
+    readonly status: "ready";
+    readonly agentRef: ResourceRef;
+    readonly agentName: string;
+    readonly resolution: AgentResolution;
+} | {
+    readonly status: "needsEnvVars";
+    readonly agentRef: ResourceRef;
+    readonly agentName: string;
+    readonly missingVariables: AgentEnvFormVariable[];
+};
+/** Result returned by {@link useAgentSetup.submitEnvVars} — always `"ready"`. */
+export type AgentSetupReadyResult = AgentSetupResult & {
+    readonly status: "ready";
+};
+export type AgentSetupAction = {
+    readonly type: "RESOLVE_START";
+    readonly agentRef: ResourceRef;
+} | {
+    readonly type: "RESOLVE_NEEDS_ENV";
+    readonly agentRef: ResourceRef;
+    readonly agentId: string;
+    readonly agentName: string;
+    readonly missingVariables: AgentEnvFormVariable[];
+} | {
+    readonly type: "RESOLVE_READY";
+    readonly agentRef: ResourceRef;
+    readonly agentName: string;
+    readonly resolution: AgentResolution;
+} | {
+    readonly type: "POOL_RESOLVE";
+    readonly missingVariables: AgentEnvFormVariable[];
+} | {
+    readonly type: "SUBMIT_START";
+} | {
+    readonly type: "SUBMIT_READY";
+    readonly agentRef: ResourceRef;
+    readonly agentName: string;
+    readonly resolution: AgentResolution;
+} | {
+    readonly type: "ERROR";
+    readonly error: Error;
+} | {
+    readonly type: "CLEAR_ERROR";
+} | {
+    readonly type: "RESET";
+};
+export declare const INITIAL_STATE: AgentSetupState;
+export declare function agentSetupReducer(state: AgentSetupState, action: AgentSetupAction): AgentSetupState;
+//# sourceMappingURL=agentSetupReducer.d.ts.map

package/agent/agentSetupReducer.d.ts.map

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

package/agent/agentSetupReducer.js

@@ -0,0 +1,86 @@
+// ---------------------------------------------------------------------------
+// Reducer
+// ---------------------------------------------------------------------------
+export const INITIAL_STATE = {
+    status: "idle",
+    error: null,
+};
+export function agentSetupReducer(state, action) {
+    switch (action.type) {
+        case "RESOLVE_START":
+            return { status: "resolving", agentRef: action.agentRef, error: null };
+        case "RESOLVE_NEEDS_ENV":
+            return {
+                status: "needsEnvVars",
+                agentRef: action.agentRef,
+                agentId: action.agentId,
+                agentName: action.agentName,
+                missingVariables: action.missingVariables,
+                error: null,
+            };
+        case "RESOLVE_READY":
+            return {
+                status: "ready",
+                agentRef: action.agentRef,
+                agentName: action.agentName,
+                resolution: action.resolution,
+                error: null,
+            };
+        case "POOL_RESOLVE": {
+            if (state.status !== "needsEnvVars")
+                return state;
+            if (action.missingVariables.length === 0) {
+                return {
+                    status: "ready",
+                    agentRef: state.agentRef,
+                    agentName: state.agentName,
+                    resolution: { mode: "direct" },
+                    error: null,
+                };
+            }
+            return {
+                ...state,
+                missingVariables: action.missingVariables,
+            };
+        }
+        case "SUBMIT_START": {
+            if (state.status !== "needsEnvVars")
+                return state;
+            return {
+                status: "submitting",
+                agentRef: state.agentRef,
+                agentId: state.agentId,
+                agentName: state.agentName,
+                missingVariables: state.missingVariables,
+                error: null,
+            };
+        }
+        case "SUBMIT_READY":
+            return {
+                status: "ready",
+                agentRef: action.agentRef,
+                agentName: action.agentName,
+                resolution: action.resolution,
+                error: null,
+            };
+        case "ERROR":
+            if (state.status === "submitting") {
+                return {
+                    status: "needsEnvVars",
+                    agentRef: state.agentRef,
+                    agentId: state.agentId,
+                    agentName: state.agentName,
+                    missingVariables: state.missingVariables,
+                    error: action.error,
+                };
+            }
+            return { ...state, error: action.error };
+        case "CLEAR_ERROR":
+            return { ...state, error: null };
+        case "RESET":
+            return INITIAL_STATE;
+        default:
+            return state;
+    }
+}
+//# sourceMappingURL=agentSetupReducer.js.map

package/agent/agentSetupReducer.js.map

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

package/agent/index.d.ts

@@ -1,9 +1,20 @@
-export { useAgentSearch } from "./hooks/useAgentSearch";
-export type { UseAgentSearchOptions, UseAgentSearchReturn, AgentSearchResult, } from "./hooks/useAgentSearch";
-export { AgentCard } from "./components/AgentCard";
-export type { AgentCardProps } from "./components/AgentCard";
-export { AgentOverview } from "./components/AgentOverview";
-export type { AgentOverviewProps } from "./components/AgentOverview";
-export { AgentPicker } from "./components/AgentPicker";
-export type { AgentPickerProps, SelectedAgent } from "./components/AgentPicker";
+export { useAgentList } from "./useAgentList";
+export type { UseAgentListOptions, UseAgentListReturn, } from "./useAgentList";
+export { useAgentCount } from "./useAgentCount";
+export type { UseAgentCountOptions, UseAgentCountReturn, } from "./useAgentCount";
+export { useAgentSearch } from "./useAgentSearch";
+export type { UseAgentSearchOptions, UseAgentSearchReturn, } from "./useAgentSearch";
+export { AgentPicker } from "./AgentPicker";
+export type { AgentPickerProps } from "./AgentPicker";
+export { AgentEnvForm } from "./AgentEnvForm";
+export type { AgentEnvFormProps, AgentEnvFormSubmitOptions, AgentEnvFormVariable, } from "./AgentEnvForm";
+export { diffEnvSpec } from "../environment/diffEnvSpec";
+export { useAgentSetup } from "./useAgentSetup";
+export type { AgentSetupResult, AgentSetupReadyResult, AgentSetupState, AgentSetupPhase, AgentResolution, SubmitEnvVarsOptions, UseAgentSetupReturn, } from "./useAgentSetup";
+export { useAgent } from "./useAgent";
+export type { UseAgentReturn } from "./useAgent";
+export { AgentDetailView } from "./AgentDetailView";
+export type { AgentDetailViewProps } from "./AgentDetailView";
+export { useDefaultAgent } from "./useDefaultAgent";
+export type { UseDefaultAgentReturn } from "./useDefaultAgent";
 //# sourceMappingURL=index.d.ts.map

package/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/agent/index.js

@@ -1,7 +1,11 @@
-// Hooks
-export { useAgentSearch } from "./hooks/useAgentSearch";
-// Components
-export { AgentCard } from "./components/AgentCard";
-export { AgentOverview } from "./components/AgentOverview";
-export { AgentPicker } from "./components/AgentPicker";
+export { useAgentList } from "./useAgentList";
+export { useAgentCount } from "./useAgentCount";
+export { useAgentSearch } from "./useAgentSearch";
+export { AgentPicker } from "./AgentPicker";
+export { AgentEnvForm } from "./AgentEnvForm";
+export { diffEnvSpec } from "../environment/diffEnvSpec";
+export { useAgentSetup } from "./useAgentSetup";
+export { useAgent } from "./useAgent";
+export { AgentDetailView } from "./AgentDetailView";
+export { useDefaultAgent } from "./useDefaultAgent";
 //# sourceMappingURL=index.js.map

package/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAOxD,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWhD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/agent/useAgent.d.ts

@@ -0,0 +1,48 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+export interface UseAgentReturn {
+    /** The resolved agent, or `null` while loading, on error, or when not found. */
+    readonly agent: Agent | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    /** Re-fetch the agent with the same org and slug. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single Agent blueprint by organization and slug.
+ *
+ * Wraps `stigmer.agent.getByReference()` with loading, error, and
+ * not-found state management. When the `org` or `slug` parameters
+ * change, the previous in-flight request is discarded and a fresh
+ * fetch begins.
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op). This is useful when the slug is not yet available — for
+ * example, while a parent component is still resolving route params.
+ *
+ * **Not-found handling:** If the API returns a 404 (NOT_FOUND), the
+ * hook sets `agent` to `null` without raising an error. Consumers
+ * distinguish "not found" from "loading" by checking all three fields:
+ * `agent === null && !isLoading && !error` means the resource does
+ * not exist.
+ *
+ * @example
+ * ```tsx
+ * function AgentDetail({ org, slug }: { org: string; slug: string }) {
+ *   const { agent, isLoading, error } = useAgent(org, slug);
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!agent) return <NotFound />;
+ *
+ *   return <h1>{agent.metadata?.name}</h1>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Skip fetching until slug is known
+ * const { agent } = useAgent(org, slug ?? null);
+ * ```
+ */
+export declare function useAgent(org: string | null, slug: string | null): UseAgentReturn;
+//# sourceMappingURL=useAgent.d.ts.map

package/agent/useAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.d.ts","sourceRoot":"","sources":["../../src/agent/useAgent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAKhF,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,cAAc,CA6ChB"}

package/agent/useAgent.js

@@ -0,0 +1,82 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches a single Agent blueprint by organization and slug.
+ *
+ * Wraps `stigmer.agent.getByReference()` with loading, error, and
+ * not-found state management. When the `org` or `slug` parameters
+ * change, the previous in-flight request is discarded and a fresh
+ * fetch begins.
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op). This is useful when the slug is not yet available — for
+ * example, while a parent component is still resolving route params.
+ *
+ * **Not-found handling:** If the API returns a 404 (NOT_FOUND), the
+ * hook sets `agent` to `null` without raising an error. Consumers
+ * distinguish "not found" from "loading" by checking all three fields:
+ * `agent === null && !isLoading && !error` means the resource does
+ * not exist.
+ *
+ * @example
+ * ```tsx
+ * function AgentDetail({ org, slug }: { org: string; slug: string }) {
+ *   const { agent, isLoading, error } = useAgent(org, slug);
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!agent) return <NotFound />;
+ *
+ *   return <h1>{agent.metadata?.name}</h1>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Skip fetching until slug is known
+ * const { agent } = useAgent(org, slug ?? null);
+ * ```
+ */
+export function useAgent(org, slug) {
+    const stigmer = useStigmer();
+    const [agent, setAgent] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!org || !slug) {
+            setAgent(null);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.agent.getByReference({ org, slug }).then((result) => {
+            if (cancelled.current)
+                return;
+            setAgent(result);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            if (isNotFound(err)) {
+                setAgent(null);
+                setIsLoading(false);
+                return;
+            }
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, slug, stigmer, fetchKey]);
+    return { agent, isLoading, error, refetch };
+}
+//# sourceMappingURL=useAgent.js.map

package/agent/useAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.js","sourceRoot":"","sources":["../../src/agent/useAgent.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAW9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAkB,EAClB,IAAmB;IAEnB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC9C,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}