@stigmer/react 0.0.36 → 0.0.40

package/mcp-server/useMcpServerList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServerList.d.ts","sourceRoot":"","sources":["../../src/mcp-server/useMcpServerList.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CAaxB"}

package/mcp-server/useMcpServerList.js

@@ -0,0 +1,38 @@
+"use client";
+import { useCallback } from "react";
+import { useStigmer } from "../hooks";
+import { useResourceList } from "../search";
+/**
+ * Data hook that fetches a paginated list of MCP servers for the Library.
+ *
+ * Wraps `stigmer.mcpServer.list()` with pagination, scope filtering,
+ * and text search. All parameters are externally controlled — the
+ * consumer manages page state, query debouncing, and scope toggling.
+ *
+ * For picker/type-ahead search with internal debouncing and query
+ * state management, use {@link useMcpServerSearch} instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { mcpServers, totalCount, isLoading } = useMcpServerList("acme", {
+ *   page: 1,
+ *   pageSize: 20,
+ *   scope: "org",
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Show all MCP servers including public/platform ones
+ * const { mcpServers } = useMcpServerList("acme", { scope: "all" });
+ * ```
+ */
+export function useMcpServerList(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useCallback((params) => stigmer.mcpServer.list(params), [stigmer]);
+    const { entries, totalCount, totalPages, currentPage, isLoading, error, refetch } = useResourceList(listFn, org, options);
+    return { mcpServers: entries, totalCount, totalPages, currentPage, isLoading, error, refetch };
+}
+//# sourceMappingURL=useMcpServerList.js.map

package/mcp-server/useMcpServerList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServerList.js","sourceRoot":"","sources":["../../src/mcp-server/useMcpServerList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAA0B,MAAM,WAAW,CAAC;AAmCpE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAkB,EAClB,OAAiC;IAEjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,MAAoD,EAAE,EAAE,CACvD,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAChC,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAC/E,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAExC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjG,CAAC"}

package/mcp-server/useMcpServerSearch.d.ts

@@ -0,0 +1,18 @@
+import { type UseResourceSearchOptions, type UseResourceSearchReturn } from "../search";
+export type UseMcpServerSearchOptions = UseResourceSearchOptions;
+export type UseMcpServerSearchReturn = UseResourceSearchReturn;
+/**
+ * Data hook that searches MCP servers available in the given organization.
+ *
+ * Wraps `stigmer.mcpServer.list()` with debounced search, loading/error
+ * tracking, and cancellation-safe fetching. Platform builders use this
+ * when they want full control over rendering; the {@link McpServerPicker}
+ * styled component uses it internally.
+ *
+ * @example
+ * ```tsx
+ * const { results, isLoading, query, setQuery } = useMcpServerSearch("acme");
+ * ```
+ */
+export declare function useMcpServerSearch(org: string, options?: UseMcpServerSearchOptions): UseMcpServerSearchReturn;
+//# sourceMappingURL=useMcpServerSearch.d.ts.map

package/mcp-server/useMcpServerSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServerSearch.d.ts","sourceRoot":"","sources":["../../src/mcp-server/useMcpServerSearch.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AACjE,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,yBAAyB,GAClC,wBAAwB,CAQ1B"}

package/mcp-server/useMcpServerSearch.js

@@ -0,0 +1,23 @@
+"use client";
+import { useCallback } from "react";
+import { useStigmer } from "../hooks";
+import { useResourceSearch, } from "../search";
+/**
+ * Data hook that searches MCP servers available in the given organization.
+ *
+ * Wraps `stigmer.mcpServer.list()` with debounced search, loading/error
+ * tracking, and cancellation-safe fetching. Platform builders use this
+ * when they want full control over rendering; the {@link McpServerPicker}
+ * styled component uses it internally.
+ *
+ * @example
+ * ```tsx
+ * const { results, isLoading, query, setQuery } = useMcpServerSearch("acme");
+ * ```
+ */
+export function useMcpServerSearch(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useCallback((params) => stigmer.mcpServer.list(params), [stigmer]);
+    return useResourceSearch(listFn, org, options);
+}
+//# sourceMappingURL=useMcpServerSearch.js.map

package/mcp-server/useMcpServerSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServerSearch.js","sourceRoot":"","sources":["../../src/mcp-server/useMcpServerSearch.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EACL,iBAAiB,GAGlB,MAAM,WAAW,CAAC;AAKnB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,OAAmC;IAEnC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,MAAoD,EAAE,EAAE,CACvD,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAChC,CAAC,OAAO,CAAC,CACV,CAAC;IACF,OAAO,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

package/mcp-server/useMcpServerSetup.d.ts

@@ -0,0 +1,162 @@
+import type { EnvVarInput, McpServerUsageInput, ResourceRef } from "@stigmer/sdk";
+export type { McpServerSetupEntry, McpServerSetupPhase, McpServerSetupState, } from "./mcpServerSetupReducer";
+export { toServerKey } from "./mcpServerSetupReducer";
+export interface SubmitMcpEnvVarsOptions {
+    /**
+     * When `true` (default), the provided values are saved to the user's
+     * personal environment. Subsequent sessions using the same MCP server
+     * will reuse these credentials.
+     *
+     * When `false`, the values are collected as `pendingRuntimeEnv` for
+     * this session only — no data is persisted and no network calls are
+     * made. The runtime env is passed to execution creation.
+     *
+     * @default true
+     */
+    readonly saveForFuture?: boolean;
+}
+export interface UseMcpServerSetupReturn {
+    /**
+     * Per-server setup state, keyed by `"org/slug"` (see {@link toServerKey}).
+     *
+     * Each entry tracks an individual MCP server through the setup
+     * lifecycle: `loading → needsSetup → submitting → ready` (or
+     * `loading → ready` when no credentials are required).
+     */
+    readonly entries: Readonly<Record<string, import("./mcpServerSetupReducer").McpServerSetupEntry>>;
+    /**
+     * Add an MCP server to the setup flow.
+     *
+     * Fetches the full server resource, checks `env_spec` against the
+     * personal environment, and resolves the entry to either `ready`
+     * (no credentials needed or all present) or `needsSetup` (missing
+     * variables). Also extracts discovered tools and approval policies
+     * for the tool selector.
+     *
+     * If the server is already in entries, its entry is reset to
+     * `loading` and re-evaluated.
+     */
+    readonly addServer: (ref: ResourceRef) => Promise<void>;
+    /**
+     * Remove an MCP server from the setup flow.
+     *
+     * Removes the entry from state. Safe to call for servers not in
+     * entries (no-op).
+     */
+    readonly removeServer: (ref: ResourceRef) => void;
+    /**
+     * Complete credential collection for a server in `needsSetup` status.
+     *
+     * Behavior depends on `options.saveForFuture`:
+     * - `true` (default) — Saves values to the personal environment via
+     *   `addVariables`. The server transitions to `ready`.
+     * - `false` — Accumulates values into {@link pendingRuntimeEnv}
+     *   without API calls. The server transitions to `ready` immediately.
+     *
+     * Must only be called when the entry is in `needsSetup` status.
+     */
+    readonly submitEnvVars: (ref: ResourceRef, values: Record<string, EnvVarInput>, options?: SubmitMcpEnvVarsOptions) => Promise<void>;
+    /**
+     * Update the enabled tools for a server in `ready` status.
+     *
+     * Dispatches directly to the reducer. Safe to call frequently
+     * (e.g., from tool selector checkboxes).
+     */
+    readonly setEnabledTools: (ref: ResourceRef, tools: string[]) => void;
+    /** Clear the error on a specific server entry without changing its phase. */
+    readonly clearError: (ref: ResourceRef) => void;
+    /** Reset all entries and pending runtime env to initial state. */
+    readonly reset: () => void;
+    /**
+     * `true` when every selected server is in `ready` status, or when
+     * no servers are selected. `false` during `loading`, `needsSetup`,
+     * or `submitting` for any entry.
+     *
+     * Use this for submission blocking in the session composer.
+     */
+    readonly allReady: boolean;
+    /**
+     * Count of entries in `needsSetup` status — servers that require
+     * user-provided credentials before the session can be created.
+     */
+    readonly needsSetupCount: number;
+    /**
+     * Accumulated one-time env vars from servers whose credentials were
+     * submitted with `saveForFuture: false`.
+     *
+     * Consumed imperatively at session creation time and merged into
+     * the execution's `runtimeEnv`. Cleared on {@link reset}.
+     */
+    readonly pendingRuntimeEnv: Record<string, EnvVarInput>;
+    /**
+     * Ready servers as `McpServerUsageInput[]` for session creation.
+     *
+     * Derived from entries: only `ready` entries are included. When a
+     * server's `enabledTools` matches all discovered tools, `enabledTools`
+     * is omitted (API convention for "all tools").
+     */
+    readonly usageInputs: McpServerUsageInput[];
+}
+/**
+ * Layer 2 behavior hook that orchestrates the setup flow for multiple
+ * MCP servers selected in the {@link McpServerPicker}.
+ *
+ * When a user toggles an MCP server ON, this hook fetches the server's
+ * full resource, checks its `env_spec` against the personal environment
+ * (via {@link diffEnvSpec}), and determines whether credentials are
+ * needed. It also extracts discovered tools and approval policies for
+ * the tool selector UI.
+ *
+ * The hook supports two credential delivery paths via the `saveForFuture`
+ * option on {@link submitEnvVars}:
+ * - **Saved** — secrets are persisted to the personal environment for
+ *   reuse across sessions.
+ * - **One-time** — secrets are collected as `pendingRuntimeEnv` for a
+ *   single execution, with no data persisted.
+ *
+ * State is managed by `useReducer(mcpServerSetupReducer)` — a per-server
+ * state machine with four phases:
+ * `loading → needsSetup → submitting → ready`.
+ *
+ * Composes {@link usePersonalEnvironment} for credential persistence and
+ * the Stigmer client for MCP server queries.
+ *
+ * Mirrors the architecture of {@link useAgentSetup} but adapted for
+ * multi-server orchestration (N independent entries vs. single agent).
+ *
+ * Pass `null` as `org` to disable all operations (stable no-op).
+ *
+ * @param org - Organization slug. Pass `null` to disable.
+ * @param poolKeys - Optional set of env-var keys already available
+ *   from the session env pool (manual secrets, one-time env vars from
+ *   other components). When provided, servers whose `env_spec` keys
+ *   are fully covered by `poolKeys` + personal env auto-resolve to
+ *   `ready` without prompting. Reactive — when `poolKeys` changes,
+ *   `needsSetup` entries are re-evaluated.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   entries,
+ *   addServer,
+ *   submitEnvVars,
+ *   setEnabledTools,
+ *   allReady,
+ *   usageInputs,
+ * } = useMcpServerSetup("acme", pool.availableKeys);
+ *
+ * // When user toggles a server ON in the picker:
+ * await addServer({ org: "acme", slug: "github", kind: ApiResourceKind.mcp_server });
+ *
+ * // If the entry resolves to "needsSetup":
+ * await submitEnvVars(ref, { GITHUB_TOKEN: { value: "ghp_...", isSecret: true } });
+ *
+ * // Customize tools for a ready server:
+ * setEnabledTools(ref, ["create_issue", "list_issues"]);
+ *
+ * // At session creation:
+ * const session = await createSession({ mcpServerUsages: usageInputs });
+ * ```
+ */
+export declare function useMcpServerSetup(org: string | null, poolKeys?: Set<string>): UseMcpServerSetupReturn;
+//# sourceMappingURL=useMcpServerSetup.d.ts.map

package/mcp-server/useMcpServerSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServerSetup.d.ts","sourceRoot":"","sources":["../../src/mcp-server/useMcpServerSetup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkBlF,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,yBAAyB,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAElG;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IAElD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,EAAE,CACtB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAEtE,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IAEhD,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAE3B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,uBAAuB,CAgQzB"}

package/mcp-server/useMcpServerSetup.js

@@ -0,0 +1,269 @@
+"use client";
+import { useCallback, useEffect, useMemo, useReducer, useRef } from "react";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { useStigmer } from "../hooks";
+import { usePersonalEnvironment } from "../environment/usePersonalEnvironment";
+import { diffEnvSpec } from "../environment/diffEnvSpec";
+import { toError } from "../internal/toError";
+import { mcpServerSetupReducer, INITIAL_MCP_SETUP_STATE, toServerKey, } from "./mcpServerSetupReducer";
+export { toServerKey } from "./mcpServerSetupReducer";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Compute the initial enabled tools for a server based on its spec
+ * defaults and discovered capabilities.
+ *
+ * If `default_enabled_tools` is non-empty, uses that subset. Otherwise,
+ * enables all discovered tools (empty array when nothing is discovered —
+ * equivalent to "all" at runtime).
+ */
+function computeDefaultEnabledTools(mcpServer, discoveredTools) {
+    const defaults = mcpServer.spec?.defaultEnabledTools;
+    if (defaults && defaults.length > 0)
+        return [...defaults];
+    return discoveredTools.map(t => t.name);
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Layer 2 behavior hook that orchestrates the setup flow for multiple
+ * MCP servers selected in the {@link McpServerPicker}.
+ *
+ * When a user toggles an MCP server ON, this hook fetches the server's
+ * full resource, checks its `env_spec` against the personal environment
+ * (via {@link diffEnvSpec}), and determines whether credentials are
+ * needed. It also extracts discovered tools and approval policies for
+ * the tool selector UI.
+ *
+ * The hook supports two credential delivery paths via the `saveForFuture`
+ * option on {@link submitEnvVars}:
+ * - **Saved** — secrets are persisted to the personal environment for
+ *   reuse across sessions.
+ * - **One-time** — secrets are collected as `pendingRuntimeEnv` for a
+ *   single execution, with no data persisted.
+ *
+ * State is managed by `useReducer(mcpServerSetupReducer)` — a per-server
+ * state machine with four phases:
+ * `loading → needsSetup → submitting → ready`.
+ *
+ * Composes {@link usePersonalEnvironment} for credential persistence and
+ * the Stigmer client for MCP server queries.
+ *
+ * Mirrors the architecture of {@link useAgentSetup} but adapted for
+ * multi-server orchestration (N independent entries vs. single agent).
+ *
+ * Pass `null` as `org` to disable all operations (stable no-op).
+ *
+ * @param org - Organization slug. Pass `null` to disable.
+ * @param poolKeys - Optional set of env-var keys already available
+ *   from the session env pool (manual secrets, one-time env vars from
+ *   other components). When provided, servers whose `env_spec` keys
+ *   are fully covered by `poolKeys` + personal env auto-resolve to
+ *   `ready` without prompting. Reactive — when `poolKeys` changes,
+ *   `needsSetup` entries are re-evaluated.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   entries,
+ *   addServer,
+ *   submitEnvVars,
+ *   setEnabledTools,
+ *   allReady,
+ *   usageInputs,
+ * } = useMcpServerSetup("acme", pool.availableKeys);
+ *
+ * // When user toggles a server ON in the picker:
+ * await addServer({ org: "acme", slug: "github", kind: ApiResourceKind.mcp_server });
+ *
+ * // If the entry resolves to "needsSetup":
+ * await submitEnvVars(ref, { GITHUB_TOKEN: { value: "ghp_...", isSecret: true } });
+ *
+ * // Customize tools for a ready server:
+ * setEnabledTools(ref, ["create_issue", "list_issues"]);
+ *
+ * // At session creation:
+ * const session = await createSession({ mcpServerUsages: usageInputs });
+ * ```
+ */
+export function useMcpServerSetup(org, poolKeys) {
+    const stigmer = useStigmer();
+    const personalEnv = usePersonalEnvironment(org);
+    const [entries, dispatch] = useReducer(mcpServerSetupReducer, INITIAL_MCP_SETUP_STATE);
+    const runtimeEnvRef = useRef({});
+    const entriesRef = useRef(entries);
+    entriesRef.current = entries;
+    // -------------------------------------------------------------------------
+    // addServer
+    // -------------------------------------------------------------------------
+    const addServer = useCallback(async (ref) => {
+        if (!org) {
+            throw new Error("useMcpServerSetup: cannot add server when org is null.");
+        }
+        const key = toServerKey(ref);
+        dispatch({ type: "ADD_SERVER", key });
+        try {
+            const mcpServer = await stigmer.mcpServer.getByReference(ref);
+            const discoveredTools = mcpServer.status?.discoveredCapabilities?.tools ?? [];
+            const toolApprovals = mcpServer.spec?.defaultToolApprovals ?? [];
+            const envSpecData = mcpServer.spec?.envSpec?.data;
+            if (!envSpecData || Object.keys(envSpecData).length === 0) {
+                dispatch({
+                    type: "RESOLVE_READY",
+                    key,
+                    mcpServer,
+                    discoveredTools,
+                    toolApprovals,
+                    enabledTools: computeDefaultEnabledTools(mcpServer, discoveredTools),
+                });
+                return;
+            }
+            const existingKeys = new Set(Object.keys(personalEnv.environment?.spec?.data ?? {}));
+            const missingVariables = diffEnvSpec(envSpecData, existingKeys, poolKeys);
+            if (missingVariables.length === 0) {
+                dispatch({
+                    type: "RESOLVE_READY",
+                    key,
+                    mcpServer,
+                    discoveredTools,
+                    toolApprovals,
+                    enabledTools: computeDefaultEnabledTools(mcpServer, discoveredTools),
+                });
+                return;
+            }
+            dispatch({
+                type: "RESOLVE_NEEDS_SETUP",
+                key,
+                mcpServer,
+                missingVariables,
+                discoveredTools,
+                toolApprovals,
+            });
+        }
+        catch (err) {
+            dispatch({ type: "SET_ERROR", key, error: toError(err) });
+        }
+    }, [org, stigmer, personalEnv, poolKeys]);
+    // -------------------------------------------------------------------------
+    // removeServer
+    // -------------------------------------------------------------------------
+    const removeServer = useCallback((ref) => {
+        dispatch({ type: "REMOVE_SERVER", key: toServerKey(ref) });
+    }, []);
+    // -------------------------------------------------------------------------
+    // submitEnvVars
+    // -------------------------------------------------------------------------
+    const submitEnvVars = useCallback(async (ref, values, options) => {
+        if (!org) {
+            throw new Error("useMcpServerSetup: cannot submit env vars when org is null.");
+        }
+        const key = toServerKey(ref);
+        const entry = entries[key];
+        if (!entry || entry.status !== "needsSetup") {
+            throw new Error("useMcpServerSetup: submitEnvVars requires the server to be in " +
+                `'needsSetup' status. Server '${key}' is ` +
+                `${entry ? `in '${entry.status}' status` : "not selected"}. ` +
+                "Call addServer() first and wait for it to resolve.");
+        }
+        const { mcpServer, discoveredTools } = entry;
+        const enabledTools = computeDefaultEnabledTools(mcpServer, discoveredTools);
+        const saveForFuture = options?.saveForFuture ?? true;
+        dispatch({ type: "SUBMIT_START", key });
+        if (!saveForFuture) {
+            Object.assign(runtimeEnvRef.current, values);
+            dispatch({ type: "SUBMIT_DONE", key, enabledTools });
+            return;
+        }
+        try {
+            await personalEnv.getOrCreate();
+            await personalEnv.addVariables(values);
+            dispatch({ type: "SUBMIT_DONE", key, enabledTools });
+        }
+        catch (err) {
+            dispatch({ type: "SUBMIT_FAIL", key, error: toError(err) });
+        }
+    }, [org, entries, personalEnv]);
+    // -------------------------------------------------------------------------
+    // setEnabledTools
+    // -------------------------------------------------------------------------
+    const setEnabledTools = useCallback((ref, tools) => {
+        dispatch({
+            type: "SET_ENABLED_TOOLS",
+            key: toServerKey(ref),
+            enabledTools: tools,
+        });
+    }, []);
+    // -------------------------------------------------------------------------
+    // clearError / reset
+    // -------------------------------------------------------------------------
+    const clearError = useCallback((ref) => {
+        dispatch({ type: "CLEAR_ERROR", key: toServerKey(ref) });
+    }, []);
+    const reset = useCallback(() => {
+        dispatch({ type: "RESET" });
+        runtimeEnvRef.current = {};
+    }, []);
+    // -------------------------------------------------------------------------
+    // Pool re-evaluation — auto-resolve needsSetup entries when pool changes
+    // -------------------------------------------------------------------------
+    useEffect(() => {
+        if (!poolKeys || poolKeys.size === 0)
+            return;
+        const personalKeys = new Set(Object.keys(personalEnv.environment?.spec?.data ?? {}));
+        for (const [key, entry] of Object.entries(entriesRef.current)) {
+            if (entry.status !== "needsSetup")
+                continue;
+            const envSpecData = entry.mcpServer.spec?.envSpec?.data;
+            if (!envSpecData)
+                continue;
+            const missingVariables = diffEnvSpec(envSpecData, personalKeys, poolKeys);
+            const enabledTools = computeDefaultEnabledTools(entry.mcpServer, entry.discoveredTools);
+            dispatch({ type: "POOL_RESOLVE", key, missingVariables, enabledTools });
+        }
+    }, [poolKeys, personalEnv.environment]);
+    // -------------------------------------------------------------------------
+    // Derived state
+    // -------------------------------------------------------------------------
+    const allReady = useMemo(() => {
+        const values = Object.values(entries);
+        return values.length === 0 || values.every(e => e.status === "ready");
+    }, [entries]);
+    const needsSetupCount = useMemo(() => Object.values(entries).filter(e => e.status === "needsSetup").length, [entries]);
+    const usageInputs = useMemo(() => {
+        const result = [];
+        for (const [serverKey, entry] of Object.entries(entries)) {
+            if (entry.status !== "ready")
+                continue;
+            const allNames = entry.discoveredTools.map(t => t.name);
+            const isAllEnabled = allNames.length === 0 ||
+                (entry.enabledTools.length === allNames.length &&
+                    entry.enabledTools.every(name => allNames.includes(name)));
+            const separatorIdx = serverKey.indexOf("/");
+            result.push({
+                mcpServerRef: {
+                    org: serverKey.slice(0, separatorIdx),
+                    slug: serverKey.slice(separatorIdx + 1),
+                    kind: ApiResourceKind.mcp_server,
+                },
+                enabledTools: isAllEnabled ? undefined : [...entry.enabledTools],
+            });
+        }
+        return result;
+    }, [entries]);
+    return {
+        entries,
+        addServer,
+        removeServer,
+        submitEnvVars,
+        setEnabledTools,
+        clearError,
+        reset,
+        allReady,
+        needsSetupCount,
+        pendingRuntimeEnv: runtimeEnvRef.current,
+        usageInputs,
+    };
+}
+//# sourceMappingURL=useMcpServerSetup.js.map

package/mcp-server/useMcpServerSetup.js.map

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

package/models/ModelSelector.d.ts

@@ -0,0 +1,22 @@
+export interface ModelSelectorProps {
+    readonly value?: string;
+    readonly onValueChange: (modelId: string) => void;
+    readonly className?: string;
+    /** When true, disables the selector. */
+    readonly disabled?: boolean;
+}
+/**
+ * Theme-able model picker built on `@base-ui/react` Select for
+ * accessible keyboard navigation and ARIA.
+ *
+ * Consumes {@link useModelRegistry} internally. Groups models by
+ * provider and shows a subtle cost-tier indicator.
+ *
+ * All visual properties flow through `--stgm-*` tokens — no
+ * hardcoded colors or sizes.
+ *
+ * Platform builders who need different rendering use
+ * `useModelRegistry()` directly.
+ */
+export declare function ModelSelector({ value, onValueChange, className, disabled, }: ModelSelectorProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ModelSelector.d.ts.map

package/models/ModelSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelSelector.d.ts","sourceRoot":"","sources":["../../src/models/ModelSelector.tsx"],"names":[],"mappings":"AAkBA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAa,EACb,SAAS,EACT,QAAQ,GACT,EAAE,kBAAkB,2CAsEpB"}

package/models/ModelSelector.js

@@ -0,0 +1,59 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Select } from "@base-ui/react/select";
+import { useModelRegistry } from "./useModelRegistry";
+const PROVIDER_LABELS = {
+    anthropic: "Anthropic",
+    openai: "OpenAI",
+    ollama: "Ollama",
+};
+const COST_TIER_INDICATOR = {
+    economy: "$",
+    standard: "$$",
+    premium: "$$$",
+};
+/**
+ * Theme-able model picker built on `@base-ui/react` Select for
+ * accessible keyboard navigation and ARIA.
+ *
+ * Consumes {@link useModelRegistry} internally. Groups models by
+ * provider and shows a subtle cost-tier indicator.
+ *
+ * All visual properties flow through `--stgm-*` tokens — no
+ * hardcoded colors or sizes.
+ *
+ * Platform builders who need different rendering use
+ * `useModelRegistry()` directly.
+ */
+export function ModelSelector({ value, onValueChange, className, disabled, }) {
+    const { byProvider, defaultModel, providers } = useModelRegistry();
+    return (_jsxs(Select.Root, { value: value ?? defaultModel.modelId, onValueChange: (v) => { if (v !== null)
+            onValueChange(v); }, disabled: disabled, children: [_jsxs(Select.Trigger, { className: [
+                    "inline-flex items-center gap-1.5 rounded-md border border-border",
+                    "bg-background px-2.5 py-1.5 text-xs text-foreground",
+                    "hover:bg-accent/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+                    "disabled:pointer-events-none disabled:opacity-50",
+                    "transition-colors",
+                    className,
+                ]
+                    .filter(Boolean)
+                    .join(" "), children: [_jsx(Select.Value, { placeholder: "Select model" }), _jsx(Select.Icon, { className: "text-muted-foreground", children: _jsx(ChevronIcon, {}) })] }), _jsx(Select.Portal, { children: _jsx(Select.Positioner, { sideOffset: 4, children: _jsx(Select.Popup, { className: [
+                            "z-popover max-h-72 min-w-[var(--anchor-width)] overflow-auto",
+                            "rounded-lg border border-border bg-popover p-1 shadow-md",
+                            "text-popover-foreground",
+                        ].join(" "), children: providers.map((provider) => {
+                            const models = byProvider.get(provider);
+                            if (!models?.length)
+                                return null;
+                            return (_jsxs(Select.Group, { children: [_jsx(Select.GroupLabel, { className: "px-2 py-1.5 text-[0.65rem] font-medium uppercase tracking-wider text-muted-foreground", children: PROVIDER_LABELS[provider] }), models.map((model) => (_jsxs(Select.Item, { value: model.modelId, className: [
+                                            "flex cursor-pointer items-center justify-between gap-2",
+                                            "rounded-md px-2 py-1.5 text-xs outline-none",
+                                            "data-[highlighted]:bg-accent data-[highlighted]:text-accent-foreground",
+                                            "data-[selected]:font-medium",
+                                        ].join(" "), children: [_jsx(Select.ItemText, { children: model.displayName }), _jsx("span", { className: "text-[0.6rem] text-muted-foreground", children: COST_TIER_INDICATOR[model.costTier] })] }, model.modelId)))] }, provider));
+                        }) }) }) })] }));
+}
+function ChevronIcon() {
+    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 10 10", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M2.5 3.75L5 6.25L7.5 3.75" }) }));
+}
+//# sourceMappingURL=ModelSelector.js.map

package/models/ModelSelector.js.map

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

package/models/index.d.ts

@@ -0,0 +1,7 @@
+export { MODEL_REGISTRY, DEFAULT_MODEL_ID } from "./registry";
+export type { ModelInfo, Provider, CostTier } from "./registry";
+export { useModelRegistry } from "./useModelRegistry";
+export type { UseModelRegistryReturn } from "./useModelRegistry";
+export { ModelSelector } from "./ModelSelector";
+export type { ModelSelectorProps } from "./ModelSelector";
+//# sourceMappingURL=index.d.ts.map