@stigmer/react 0.0.36 → 0.0.40

package/mcp-server/index.d.ts

@@ -1,3 +1,19 @@
-export { useMcpServerSearch } from "./hooks/useMcpServerSearch";
-export type { UseMcpServerSearchOptions, UseMcpServerSearchReturn, } from "./hooks/useMcpServerSearch";
+export { useMcpServerList } from "./useMcpServerList";
+export type { UseMcpServerListOptions, UseMcpServerListReturn, } from "./useMcpServerList";
+export { useMcpServerCount } from "./useMcpServerCount";
+export type { UseMcpServerCountOptions, UseMcpServerCountReturn, } from "./useMcpServerCount";
+export { useMcpServerSearch } from "./useMcpServerSearch";
+export type { UseMcpServerSearchOptions, UseMcpServerSearchReturn, } from "./useMcpServerSearch";
+export { useMcpServer } from "./useMcpServer";
+export type { UseMcpServerReturn } from "./useMcpServer";
+export { McpServerPicker } from "./McpServerPicker";
+export type { McpServerPickerProps, McpServerSetupIntegration, } from "./McpServerPicker";
+export { McpToolSelector } from "./McpToolSelector";
+export type { McpToolSelectorProps } from "./McpToolSelector";
+export { McpServerConfigPanel } from "./McpServerConfigPanel";
+export type { McpServerConfigPanelProps, McpServerCredentialsProps, } from "./McpServerConfigPanel";
+export { useMcpServerSetup, toServerKey } from "./useMcpServerSetup";
+export type { UseMcpServerSetupReturn, SubmitMcpEnvVarsOptions, McpServerSetupEntry, McpServerSetupPhase, McpServerSetupState, } from "./useMcpServerSetup";
+export { McpServerDetailView } from "./McpServerDetailView";
+export type { McpServerDetailViewProps } from "./McpServerDetailView";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/mcp-server/index.js

@@ -1,3 +1,10 @@
-// Hooks
-export { useMcpServerSearch } from "./hooks/useMcpServerSearch";
+export { useMcpServerList } from "./useMcpServerList";
+export { useMcpServerCount } from "./useMcpServerCount";
+export { useMcpServerSearch } from "./useMcpServerSearch";
+export { useMcpServer } from "./useMcpServer";
+export { McpServerPicker } from "./McpServerPicker";
+export { McpToolSelector } from "./McpToolSelector";
+export { McpServerConfigPanel } from "./McpServerConfigPanel";
+export { useMcpServerSetup, toServerKey } from "./useMcpServerSetup";
+export { McpServerDetailView } from "./McpServerDetailView";
 //# sourceMappingURL=index.js.map

package/mcp-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-server/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/mcp-server/mcpServerSetupReducer.d.ts

@@ -0,0 +1,138 @@
+import type { ResourceRef } from "@stigmer/sdk";
+import type { McpServer } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import type { DiscoveredTool } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/status_pb";
+import type { ToolApprovalPolicy } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/spec_pb";
+import type { EnvVarFormVariable } from "../environment/EnvVarForm";
+/**
+ * Builds the map key for an MCP server from its resource reference.
+ *
+ * Format: `"org/slug"`. Used as the entry key in
+ * {@link McpServerSetupState} and the `key` field on every per-entry
+ * {@link McpServerSetupAction}.
+ */
+export declare function toServerKey(ref: ResourceRef): string;
+/**
+ * Discriminated union representing the current phase of an individual
+ * MCP server's setup flow managed by the orchestration hook
+ * (`useMcpServerSetup`).
+ *
+ * The `status` field serves as the discriminant. Phase-specific data
+ * (server resource, missing variables, discovered tools, enabled tools)
+ * is only present on the variants where it is meaningful, enabling
+ * TypeScript narrowing in consumer code.
+ *
+ * Phases:
+ * - `"loading"` — Fetching the full `McpServer` resource (spec + status).
+ * - `"needsSetup"` — The server has an `env_spec` with variables missing
+ *   from the user's personal environment. The UI should present a
+ *   credential collection form.
+ * - `"submitting"` — Environment variables are being persisted (save path)
+ *   or collected (one-time path). The UI should show a loading indicator
+ *   on the submit button.
+ * - `"ready"` — The server is fully configured and ready for session
+ *   creation. Carries the effective `enabledTools` list. Covers both
+ *   the "no env_spec needed" and "env vars resolved" cases.
+ */
+export type McpServerSetupPhase = {
+    readonly status: "loading";
+} | {
+    readonly status: "needsSetup";
+    readonly mcpServer: McpServer;
+    readonly missingVariables: EnvVarFormVariable[];
+    readonly discoveredTools: DiscoveredTool[];
+    readonly toolApprovals: ToolApprovalPolicy[];
+} | {
+    readonly status: "submitting";
+    readonly mcpServer: McpServer;
+    readonly missingVariables: EnvVarFormVariable[];
+    readonly discoveredTools: DiscoveredTool[];
+    readonly toolApprovals: ToolApprovalPolicy[];
+} | {
+    readonly status: "ready";
+    readonly mcpServer: McpServer;
+    readonly discoveredTools: DiscoveredTool[];
+    readonly toolApprovals: ToolApprovalPolicy[];
+    readonly enabledTools: string[];
+};
+/**
+ * Full state of an individual MCP server setup entry: the current phase
+ * plus an orthogonal error slot.
+ *
+ * Errors can occur in any async transition (`loading`, `submitting`)
+ * and are surfaced alongside the phase so the UI can show inline
+ * error messages without losing the current phase context.
+ *
+ * Matches the pattern established by `AgentSetupState`.
+ */
+export type McpServerSetupEntry = McpServerSetupPhase & {
+    readonly error: Error | null;
+};
+/**
+ * The complete reducer state: an immutable record of server setup
+ * entries keyed by `"org/slug"` (see {@link toServerKey}).
+ *
+ * Each entry tracks one selected MCP server independently through the
+ * setup lifecycle. Entries are added when the user toggles a server on
+ * in the picker and removed when toggled off.
+ */
+export type McpServerSetupState = Readonly<Record<string, McpServerSetupEntry>>;
+/**
+ * Actions dispatched by the orchestration hook to drive per-server
+ * setup state transitions.
+ *
+ * Every per-entry action carries a `key` field (the `"org/slug"` string
+ * produced by {@link toServerKey}) identifying the target entry.
+ */
+export type McpServerSetupAction = {
+    readonly type: "ADD_SERVER";
+    readonly key: string;
+} | {
+    readonly type: "RESOLVE_NEEDS_SETUP";
+    readonly key: string;
+    readonly mcpServer: McpServer;
+    readonly missingVariables: EnvVarFormVariable[];
+    readonly discoveredTools: DiscoveredTool[];
+    readonly toolApprovals: ToolApprovalPolicy[];
+} | {
+    readonly type: "RESOLVE_READY";
+    readonly key: string;
+    readonly mcpServer: McpServer;
+    readonly discoveredTools: DiscoveredTool[];
+    readonly toolApprovals: ToolApprovalPolicy[];
+    readonly enabledTools: string[];
+} | {
+    readonly type: "POOL_RESOLVE";
+    readonly key: string;
+    readonly missingVariables: EnvVarFormVariable[];
+    readonly enabledTools: string[];
+} | {
+    readonly type: "SUBMIT_START";
+    readonly key: string;
+} | {
+    readonly type: "SUBMIT_DONE";
+    readonly key: string;
+    readonly enabledTools: string[];
+} | {
+    readonly type: "SET_ENABLED_TOOLS";
+    readonly key: string;
+    readonly enabledTools: string[];
+} | {
+    readonly type: "SUBMIT_FAIL";
+    readonly key: string;
+    readonly error: Error;
+} | {
+    readonly type: "SET_ERROR";
+    readonly key: string;
+    readonly error: Error;
+} | {
+    readonly type: "CLEAR_ERROR";
+    readonly key: string;
+} | {
+    readonly type: "REMOVE_SERVER";
+    readonly key: string;
+} | {
+    readonly type: "RESET";
+};
+export declare const INITIAL_MCP_SETUP_STATE: McpServerSetupState;
+export declare function mcpServerSetupReducer(state: McpServerSetupState, action: McpServerSetupAction): McpServerSetupState;
+//# sourceMappingURL=mcpServerSetupReducer.d.ts.map

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

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

package/mcp-server/mcpServerSetupReducer.js

@@ -0,0 +1,163 @@
+// ---------------------------------------------------------------------------
+// Key utility
+// ---------------------------------------------------------------------------
+/**
+ * Builds the map key for an MCP server from its resource reference.
+ *
+ * Format: `"org/slug"`. Used as the entry key in
+ * {@link McpServerSetupState} and the `key` field on every per-entry
+ * {@link McpServerSetupAction}.
+ */
+export function toServerKey(ref) {
+    return `${ref.org}/${ref.slug}`;
+}
+// ---------------------------------------------------------------------------
+// Initial state
+// ---------------------------------------------------------------------------
+export const INITIAL_MCP_SETUP_STATE = {};
+// ---------------------------------------------------------------------------
+// Reducer
+// ---------------------------------------------------------------------------
+export function mcpServerSetupReducer(state, action) {
+    switch (action.type) {
+        case "ADD_SERVER":
+            return { ...state, [action.key]: { status: "loading", error: null } };
+        case "RESOLVE_NEEDS_SETUP": {
+            const entry = state[action.key];
+            if (entry?.status !== "loading")
+                return state;
+            return {
+                ...state,
+                [action.key]: {
+                    status: "needsSetup",
+                    mcpServer: action.mcpServer,
+                    missingVariables: action.missingVariables,
+                    discoveredTools: action.discoveredTools,
+                    toolApprovals: action.toolApprovals,
+                    error: null,
+                },
+            };
+        }
+        case "RESOLVE_READY": {
+            const entry = state[action.key];
+            if (entry?.status !== "loading")
+                return state;
+            return {
+                ...state,
+                [action.key]: {
+                    status: "ready",
+                    mcpServer: action.mcpServer,
+                    discoveredTools: action.discoveredTools,
+                    toolApprovals: action.toolApprovals,
+                    enabledTools: action.enabledTools,
+                    error: null,
+                },
+            };
+        }
+        case "POOL_RESOLVE": {
+            const entry = state[action.key];
+            if (entry?.status !== "needsSetup")
+                return state;
+            if (action.missingVariables.length === 0) {
+                return {
+                    ...state,
+                    [action.key]: {
+                        status: "ready",
+                        mcpServer: entry.mcpServer,
+                        discoveredTools: entry.discoveredTools,
+                        toolApprovals: entry.toolApprovals,
+                        enabledTools: action.enabledTools,
+                        error: null,
+                    },
+                };
+            }
+            return {
+                ...state,
+                [action.key]: {
+                    ...entry,
+                    missingVariables: action.missingVariables,
+                },
+            };
+        }
+        case "SUBMIT_START": {
+            const entry = state[action.key];
+            if (entry?.status !== "needsSetup")
+                return state;
+            return {
+                ...state,
+                [action.key]: {
+                    status: "submitting",
+                    mcpServer: entry.mcpServer,
+                    missingVariables: entry.missingVariables,
+                    discoveredTools: entry.discoveredTools,
+                    toolApprovals: entry.toolApprovals,
+                    error: null,
+                },
+            };
+        }
+        case "SUBMIT_DONE": {
+            const entry = state[action.key];
+            if (entry?.status !== "submitting")
+                return state;
+            return {
+                ...state,
+                [action.key]: {
+                    status: "ready",
+                    mcpServer: entry.mcpServer,
+                    discoveredTools: entry.discoveredTools,
+                    toolApprovals: entry.toolApprovals,
+                    enabledTools: action.enabledTools,
+                    error: null,
+                },
+            };
+        }
+        case "SUBMIT_FAIL": {
+            const entry = state[action.key];
+            if (entry?.status !== "submitting")
+                return state;
+            return {
+                ...state,
+                [action.key]: {
+                    status: "needsSetup",
+                    mcpServer: entry.mcpServer,
+                    missingVariables: entry.missingVariables,
+                    discoveredTools: entry.discoveredTools,
+                    toolApprovals: entry.toolApprovals,
+                    error: action.error,
+                },
+            };
+        }
+        case "SET_ENABLED_TOOLS": {
+            const entry = state[action.key];
+            if (entry?.status !== "ready")
+                return state;
+            return {
+                ...state,
+                [action.key]: { ...entry, enabledTools: action.enabledTools },
+            };
+        }
+        case "SET_ERROR": {
+            const entry = state[action.key];
+            if (!entry)
+                return state;
+            return { ...state, [action.key]: { ...entry, error: action.error } };
+        }
+        case "CLEAR_ERROR": {
+            const entry = state[action.key];
+            if (!entry)
+                return state;
+            return { ...state, [action.key]: { ...entry, error: null } };
+        }
+        case "REMOVE_SERVER": {
+            if (!(action.key in state))
+                return state;
+            const { [action.key]: _, ...rest } = state;
+            return rest;
+        }
+        case "RESET":
+            return INITIAL_MCP_SETUP_STATE;
+        default:
+            return state;
+    }
+}
+//# sourceMappingURL=mcpServerSetupReducer.js.map

package/mcp-server/mcpServerSetupReducer.js.map

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

package/mcp-server/useMcpServer.d.ts

@@ -0,0 +1,48 @@
+import type { McpServer } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+export interface UseMcpServerReturn {
+    /** The resolved MCP server, or `null` while loading, on error, or when not found. */
+    readonly mcpServer: McpServer | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    /** Re-fetch the MCP server with the same org and slug. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single MCP Server by organization and slug.
+ *
+ * Wraps `stigmer.mcpServer.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 `mcpServer` to `null` without raising an error. Consumers
+ * distinguish "not found" from "loading" by checking all three fields:
+ * `mcpServer === null && !isLoading && !error` means the resource does
+ * not exist.
+ *
+ * @example
+ * ```tsx
+ * function McpServerDetail({ org, slug }: { org: string; slug: string }) {
+ *   const { mcpServer, isLoading, error } = useMcpServer(org, slug);
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!mcpServer) return <NotFound />;
+ *
+ *   return <h1>{mcpServer.metadata?.name}</h1>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Skip fetching until slug is known
+ * const { mcpServer } = useMcpServer(org, slug ?? null);
+ * ```
+ */
+export declare function useMcpServer(org: string | null, slug: string | null): UseMcpServerReturn;
+//# sourceMappingURL=useMcpServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServer.d.ts","sourceRoot":"","sources":["../../src/mcp-server/useMcpServer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wDAAwD,CAAC;AAKxF,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,kBAAkB,CA6CpB"}

package/mcp-server/useMcpServer.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 MCP Server by organization and slug.
+ *
+ * Wraps `stigmer.mcpServer.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 `mcpServer` to `null` without raising an error. Consumers
+ * distinguish "not found" from "loading" by checking all three fields:
+ * `mcpServer === null && !isLoading && !error` means the resource does
+ * not exist.
+ *
+ * @example
+ * ```tsx
+ * function McpServerDetail({ org, slug }: { org: string; slug: string }) {
+ *   const { mcpServer, isLoading, error } = useMcpServer(org, slug);
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!mcpServer) return <NotFound />;
+ *
+ *   return <h1>{mcpServer.metadata?.name}</h1>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Skip fetching until slug is known
+ * const { mcpServer } = useMcpServer(org, slug ?? null);
+ * ```
+ */
+export function useMcpServer(org, slug) {
+    const stigmer = useStigmer();
+    const [mcpServer, setMcpServer] = 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) {
+            setMcpServer(null);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.mcpServer.getByReference({ org, slug }).then((result) => {
+            if (cancelled.current)
+                return;
+            setMcpServer(result);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            if (isNotFound(err)) {
+                setMcpServer(null);
+                setIsLoading(false);
+                return;
+            }
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, slug, stigmer, fetchKey]);
+    return { mcpServer, isLoading, error, refetch };
+}
+//# sourceMappingURL=useMcpServer.js.map

package/mcp-server/useMcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServer.js","sourceRoot":"","sources":["../../src/mcp-server/useMcpServer.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,YAAY,CAC1B,GAAkB,EAClB,IAAmB;IAEnB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAmB,IAAI,CAAC,CAAC;IACnE,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,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,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,SAAS,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAClD,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,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,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnB,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,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/mcp-server/useMcpServerCount.d.ts

@@ -0,0 +1,49 @@
+import { type ResourceListScope } from "../search";
+export interface UseMcpServerCountOptions {
+    /** Text query to filter MCP servers before counting. */
+    readonly query?: string;
+    /**
+     * Controls which MCP servers are counted.
+     *
+     * - `"org"` — only MCP servers owned by the given organization.
+     * - `"all"` — includes public/platform MCP servers.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+export interface UseMcpServerCountReturn {
+    /**
+     * Total number of MCP servers matching the current filters. `undefined`
+     * until the first successful fetch completes.
+     */
+    readonly count: number | undefined;
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    /** Re-fetch the count with the same parameters. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the total count of MCP servers.
+ *
+ * Issues a minimal `stigmer.mcpServer.list()` call to retrieve only the
+ * total count — no MCP server entries are returned or stored. Useful for
+ * summary cards, badges, and dashboard widgets.
+ *
+ * For the full paginated MCP server list, use {@link useMcpServerList} instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useMcpServerCount("acme");
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Count all accessible MCP servers including public/platform ones
+ * const { count } = useMcpServerCount("acme", { scope: "all" });
+ * ```
+ */
+export declare function useMcpServerCount(org: string | null, options?: UseMcpServerCountOptions): UseMcpServerCountReturn;
+//# sourceMappingURL=useMcpServerCount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServerCount.d.ts","sourceRoot":"","sources":["../../src/mcp-server/useMcpServerCount.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAUzB"}

package/mcp-server/useMcpServerCount.js

@@ -0,0 +1,32 @@
+"use client";
+import { useCallback } from "react";
+import { useStigmer } from "../hooks";
+import { useResourceCount } from "../search";
+/**
+ * Data hook that fetches the total count of MCP servers.
+ *
+ * Issues a minimal `stigmer.mcpServer.list()` call to retrieve only the
+ * total count — no MCP server entries are returned or stored. Useful for
+ * summary cards, badges, and dashboard widgets.
+ *
+ * For the full paginated MCP server list, use {@link useMcpServerList} instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useMcpServerCount("acme");
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Count all accessible MCP servers including public/platform ones
+ * const { count } = useMcpServerCount("acme", { scope: "all" });
+ * ```
+ */
+export function useMcpServerCount(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useCallback((params) => stigmer.mcpServer.list(params), [stigmer]);
+    return useResourceCount(listFn, org, options);
+}
+//# sourceMappingURL=useMcpServerCount.js.map

package/mcp-server/useMcpServerCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMcpServerCount.js","sourceRoot":"","sources":["../../src/mcp-server/useMcpServerCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAA0B,MAAM,WAAW,CAAC;AA4BrE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAkB,EAClB,OAAkC;IAElC,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,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/mcp-server/useMcpServerList.d.ts

@@ -0,0 +1,62 @@
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { type ResourceListScope } from "../search";
+export interface UseMcpServerListOptions {
+    /** Maximum MCP servers per page. @default 20 */
+    readonly pageSize?: number;
+    /** Page number (1-indexed). @default 1 */
+    readonly page?: number;
+    /** Text query to filter MCP servers by name, description, or tags. */
+    readonly query?: string;
+    /**
+     * Controls which MCP servers are visible.
+     *
+     * - `"org"` — only MCP servers owned by the given organization.
+     * - `"all"` — includes public/platform MCP servers.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+export interface UseMcpServerListReturn {
+    /** Paginated MCP server entries for the current page. */
+    readonly mcpServers: readonly SearchResult[];
+    /** Total number of MCP servers matching the current filters. */
+    readonly totalCount: number;
+    /** Total pages available at the current page size. */
+    readonly totalPages: number;
+    /** The current page number (mirrors the `page` option). */
+    readonly currentPage: number;
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    /** Re-fetch the current page with the same parameters. */
+    readonly refetch: () => void;
+}
+/**
+ * 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 declare function useMcpServerList(org: string | null, options?: UseMcpServerListOptions): UseMcpServerListReturn;
+//# sourceMappingURL=useMcpServerList.d.ts.map