@stigmer/react 0.4.8 → 0.5.0

package/library/useExportResource.js

@@ -0,0 +1,137 @@
+"use client";
+import { useCallback, useMemo } from "react";
+import { parse as parseYaml } from "yaml";
+import { toast } from "../feedback/toast";
+import { serializeAgentYaml, serializeMcpServerYaml } from "./serialize-resource-yaml";
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Headless export hook for Stigmer resources (Agent, McpServer).
+ *
+ * Serializes the resource into YAML and JSON formats and provides
+ * stable callbacks for copying to clipboard or triggering a file
+ * download. All operations are client-side — no additional API calls.
+ *
+ * The serialized output uses the canonical Stigmer resource format
+ * (`apiVersion`, `kind`, `metadata`, `spec`) with snake_case field
+ * names, identical to what the CLI produces and what `parseResourceYaml`
+ * accepts — ensuring full round-trip compatibility.
+ *
+ * @param options - Resource kind and the proto resource object.
+ * @returns Stable callbacks and memoized serialized strings.
+ *
+ * @example
+ * ```tsx
+ * const { agent } = useAgent(org, slug);
+ * const { copyYaml, downloadYaml } = useExportResource({
+ *   kind: "Agent",
+ *   resource: agent,
+ * });
+ *
+ * <ActionMenu.Item onSelect={copyYaml}>Export YAML</ActionMenu.Item>
+ * <ActionMenu.Item onSelect={downloadYaml}>Download YAML</ActionMenu.Item>
+ * ```
+ *
+ * @see {@link serializeAgentYaml} for the underlying Agent serializer
+ * @see {@link serializeMcpServerYaml} for the underlying McpServer serializer
+ */
+export function useExportResource({ kind, resource, }) {
+    const yaml = useMemo(() => {
+        if (!resource)
+            return null;
+        if (kind === "Agent")
+            return serializeAgentYaml(resource);
+        return serializeMcpServerYaml(resource);
+    }, [kind, resource]);
+    const json = useMemo(() => {
+        if (!resource)
+            return null;
+        if (kind === "Agent")
+            return serializeResourceJson(resource, "Agent");
+        return serializeResourceJson(resource, "McpServer");
+    }, [kind, resource]);
+    const slug = useMemo(() => {
+        if (!resource)
+            return "resource";
+        return resource.metadata?.slug || resource.metadata?.name || "resource";
+    }, [resource]);
+    const copyYaml = useCallback(async () => {
+        if (!yaml)
+            return;
+        await copyToClipboard(yaml);
+        toast.success("YAML copied to clipboard");
+    }, [yaml]);
+    const copyJson = useCallback(async () => {
+        if (!json)
+            return;
+        await copyToClipboard(json);
+        toast.success("JSON copied to clipboard");
+    }, [json]);
+    const downloadYaml = useCallback(() => {
+        if (!yaml)
+            return;
+        downloadFile(yaml, `${slug}.yaml`, "text/yaml");
+    }, [yaml, slug]);
+    const downloadJson = useCallback(() => {
+        if (!json)
+            return;
+        downloadFile(json, `${slug}.json`, "application/json");
+    }, [json, slug]);
+    return useMemo(() => ({ copyYaml, copyJson, downloadYaml, downloadJson, yaml, json }), [copyYaml, copyJson, downloadYaml, downloadJson, yaml, json]);
+}
+// ---------------------------------------------------------------------------
+// JSON serialization
+// ---------------------------------------------------------------------------
+/**
+ * Produces a JSON representation of the resource using the same canonical
+ * structure as the YAML export (apiVersion, kind, metadata, spec).
+ *
+ * Internally parses the YAML output to get a clean plain object, then
+ * re-stringifies as JSON. This guarantees the JSON structure is identical
+ * to the YAML structure (snake_case fields, no status).
+ */
+function serializeResourceJson(resource, kind) {
+    const yamlStr = kind === "Agent"
+        ? serializeAgentYaml(resource)
+        : serializeMcpServerYaml(resource);
+    const doc = parseYaml(yamlStr);
+    return JSON.stringify(doc, null, 2);
+}
+// ---------------------------------------------------------------------------
+// Clipboard
+// ---------------------------------------------------------------------------
+async function copyToClipboard(text) {
+    try {
+        await navigator.clipboard.writeText(text);
+    }
+    catch {
+        fallbackCopy(text);
+    }
+}
+function fallbackCopy(text) {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.style.position = "fixed";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    document.execCommand("copy");
+    document.body.removeChild(textarea);
+}
+// ---------------------------------------------------------------------------
+// File download
+// ---------------------------------------------------------------------------
+function downloadFile(content, filename, mimeType) {
+    const blob = new Blob([content], { type: `${mimeType};charset=utf-8;` });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = filename;
+    link.style.display = "none";
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+}
+//# sourceMappingURL=useExportResource.js.map

package/library/useExportResource.js.map

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

package/library/useImportResource.d.ts

@@ -0,0 +1,84 @@
+import type { ApplyResourceResult } from "./useApplyResource";
+/** Detected format of the imported file content. */
+export type ImportFormat = "yaml" | "json";
+/**
+ * Validated preview of an imported resource, shown to the user before
+ * they confirm the apply operation.
+ */
+export interface ImportPreview {
+    /** The detected resource kind. */
+    readonly kind: "Agent" | "McpServer";
+    /** The resource name from `metadata.name`. */
+    readonly name: string;
+    /** The resource slug from `metadata.slug`, if present. */
+    readonly slug?: string;
+    /** The detected file format. */
+    readonly format: ImportFormat;
+    /** The raw file content (for potential display or debugging). */
+    readonly rawContent: string;
+}
+/** Return value of {@link useImportResource}. */
+export interface UseImportResourceReturn {
+    /**
+     * Read and validate a file selected by the user. On success, populates
+     * `preview`. On failure, populates `error`. In both cases, clears the
+     * previous state first.
+     */
+    readonly readFile: (file: File) => Promise<void>;
+    /** The validation preview, or `null` when no file has been validated. */
+    readonly preview: ImportPreview | null;
+    /** Validation or apply error message, or `null` when healthy. */
+    readonly error: string | null;
+    /** Clear all state (preview, error, internal content). */
+    readonly reset: () => void;
+    /**
+     * Apply the previewed resource to the given organization.
+     * Only callable when `preview` is non-null.
+     *
+     * @throws Re-throws the original error after setting `error` state.
+     */
+    readonly apply: (org: string) => Promise<ApplyResourceResult>;
+    /** `true` while the apply RPC is in-flight. */
+    readonly isApplying: boolean;
+}
+/**
+ * Headless import hook for Stigmer resources.
+ *
+ * Orchestrates the file import workflow:
+ * 1. User selects a `.yaml`, `.yml`, or `.json` file
+ * 2. `readFile` reads the content, detects the format, and validates
+ *    the structure via `parseResourceYaml`
+ * 3. On success, `preview` is populated with kind, name, slug, format
+ * 4. On validation error, `error` is populated with a user-facing message
+ * 5. User confirms → `apply(org)` calls the appropriate SDK `apply()` method
+ *
+ * Follows the established mutation-hook pattern: `isApplying` + `error` +
+ * `reset`. The `preview` state enables a confirmation step before committing
+ * (Nielsen heuristic #3: user control, #5: error prevention).
+ *
+ * @example
+ * ```tsx
+ * const { readFile, preview, error, reset, apply, isApplying } = useImportResource();
+ *
+ * const handleFileChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+ *   const file = e.target.files?.[0];
+ *   if (file) readFile(file);
+ * };
+ *
+ * if (preview) {
+ *   return (
+ *     <div>
+ *       <p>Import {preview.kind}: {preview.name}</p>
+ *       <button onClick={() => apply(org)} disabled={isApplying}>
+ *         Confirm
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link parseResourceYaml} for the validation logic
+ * @see {@link ImportResourceDialog} for the styled component that composes this hook
+ */
+export declare function useImportResource(): UseImportResourceReturn;
+//# sourceMappingURL=useImportResource.d.ts.map

package/library/useImportResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImportResource.d.ts","sourceRoot":"","sources":["../../src/library/useImportResource.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAM9D,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9D,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CA8H3D"}

package/library/useImportResource.js

@@ -0,0 +1,188 @@
+"use client";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { stringify as stringifyYaml } from "yaml";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+import { parseResourceYaml } from "./parse-resource-yaml";
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Headless import hook for Stigmer resources.
+ *
+ * Orchestrates the file import workflow:
+ * 1. User selects a `.yaml`, `.yml`, or `.json` file
+ * 2. `readFile` reads the content, detects the format, and validates
+ *    the structure via `parseResourceYaml`
+ * 3. On success, `preview` is populated with kind, name, slug, format
+ * 4. On validation error, `error` is populated with a user-facing message
+ * 5. User confirms → `apply(org)` calls the appropriate SDK `apply()` method
+ *
+ * Follows the established mutation-hook pattern: `isApplying` + `error` +
+ * `reset`. The `preview` state enables a confirmation step before committing
+ * (Nielsen heuristic #3: user control, #5: error prevention).
+ *
+ * @example
+ * ```tsx
+ * const { readFile, preview, error, reset, apply, isApplying } = useImportResource();
+ *
+ * const handleFileChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+ *   const file = e.target.files?.[0];
+ *   if (file) readFile(file);
+ * };
+ *
+ * if (preview) {
+ *   return (
+ *     <div>
+ *       <p>Import {preview.kind}: {preview.name}</p>
+ *       <button onClick={() => apply(org)} disabled={isApplying}>
+ *         Confirm
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link parseResourceYaml} for the validation logic
+ * @see {@link ImportResourceDialog} for the styled component that composes this hook
+ */
+export function useImportResource() {
+    const stigmer = useStigmer();
+    const [preview, setPreview] = useState(null);
+    const [error, setError] = useState(null);
+    const [isApplying, setIsApplying] = useState(false);
+    const contentRef = useRef(null);
+    const parsedRef = useRef(null);
+    const reset = useCallback(() => {
+        setPreview(null);
+        setError(null);
+        setIsApplying(false);
+        contentRef.current = null;
+        parsedRef.current = null;
+    }, []);
+    const readFile = useCallback(async (file) => {
+        setPreview(null);
+        setError(null);
+        contentRef.current = null;
+        parsedRef.current = null;
+        let text;
+        try {
+            text = await file.text();
+        }
+        catch {
+            setError("Failed to read the selected file.");
+            return;
+        }
+        if (!text.trim()) {
+            setError("The selected file is empty.");
+            return;
+        }
+        const format = detectFormat(file.name, text);
+        // For JSON files, convert to YAML-parseable content first.
+        // parseResourceYaml expects YAML, but since YAML is a superset of JSON,
+        // we can pass JSON directly. However for cleaner error messages, we
+        // normalize JSON → plain object → YAML string if needed.
+        let yamlContent;
+        if (format === "json") {
+            try {
+                const parsed = JSON.parse(text);
+                if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                    setError("JSON file must contain a single object (not an array or primitive).");
+                    return;
+                }
+                yamlContent = stringifyYaml(parsed);
+            }
+            catch {
+                setError("The file does not contain valid JSON.");
+                return;
+            }
+        }
+        else {
+            yamlContent = text;
+        }
+        // Validate structure using the existing parser. We use a dummy org
+        // here — the real org is provided at apply time.
+        let parsed;
+        try {
+            parsed = parseResourceYaml(yamlContent, "__preview__");
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Failed to validate resource file.");
+            return;
+        }
+        contentRef.current = yamlContent;
+        parsedRef.current = parsed;
+        setPreview({
+            kind: parsed.kind,
+            name: parsed.input.name,
+            slug: "slug" in parsed.input ? parsed.input.slug : undefined,
+            format,
+            rawContent: text,
+        });
+    }, []);
+    const apply = useCallback(async (org) => {
+        const content = contentRef.current;
+        if (!content) {
+            throw new Error("No file has been validated. Call readFile first.");
+        }
+        setIsApplying(true);
+        setError(null);
+        try {
+            const parsed = parseResourceYaml(content, org);
+            switch (parsed.kind) {
+                case "Agent": {
+                    const agent = await stigmer.agent.apply(parsed.input);
+                    return {
+                        kind: "Agent",
+                        name: agent.metadata?.name ?? parsed.input.name,
+                        org: agent.metadata?.org ?? org,
+                        slug: agent.metadata?.slug ?? parsed.input.name,
+                    };
+                }
+                case "McpServer": {
+                    const mcpServer = await stigmer.mcpServer.apply(parsed.input);
+                    return {
+                        kind: "McpServer",
+                        name: mcpServer.metadata?.name ?? parsed.input.name,
+                        org: mcpServer.metadata?.org ?? org,
+                        slug: mcpServer.metadata?.slug ?? parsed.input.name,
+                    };
+                }
+            }
+        }
+        catch (err) {
+            const message = toError(err).message;
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsApplying(false);
+        }
+    }, [stigmer]);
+    return useMemo(() => ({ readFile, preview, error, reset, apply, isApplying }), [readFile, preview, error, reset, apply, isApplying]);
+}
+// ---------------------------------------------------------------------------
+// Format detection
+// ---------------------------------------------------------------------------
+const JSON_EXTENSIONS = new Set([".json"]);
+const YAML_EXTENSIONS = new Set([".yaml", ".yml"]);
+function detectFormat(filename, content) {
+    const lowerName = filename.toLowerCase();
+    const dotIndex = lowerName.lastIndexOf(".");
+    if (dotIndex >= 0) {
+        const ext = lowerName.slice(dotIndex);
+        if (JSON_EXTENSIONS.has(ext))
+            return "json";
+        if (YAML_EXTENSIONS.has(ext))
+            return "yaml";
+    }
+    // Fallback: try parsing as JSON. If it parses, treat as JSON.
+    try {
+        JSON.parse(content);
+        return "json";
+    }
+    catch {
+        return "yaml";
+    }
+}
+//# sourceMappingURL=useImportResource.js.map

package/library/useImportResource.js.map

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

package/mcp-server/McpServerCreationWizard.d.ts

@@ -0,0 +1,55 @@
+import type { McpServerWizardData } from "./steps/types";
+/** Result passed to `onComplete` after successful MCP server creation. */
+export interface McpServerCreationResult {
+    /** Organization slug of the created MCP server. */
+    readonly org: string;
+    /** MCP server slug (for URL construction). */
+    readonly slug: string;
+    /** MCP server display name. */
+    readonly name: string;
+}
+/** Props for {@link McpServerCreationWizard}. */
+export interface McpServerCreationWizardProps {
+    /** Organization to create the MCP server in. */
+    readonly org: string;
+    /**
+     * Optional partial data to pre-fill the wizard with.
+     *
+     * Merged with defaults via `{ ...createInitialMcpServerWizardData(), ...initialData }`.
+     * Use this for template-based creation, resource duplication, or any
+     * flow that starts the wizard with pre-populated fields.
+     */
+    readonly initialData?: Partial<McpServerWizardData>;
+    /** Called after the MCP server is successfully created. */
+    readonly onComplete: (result: McpServerCreationResult) => void;
+    /** Called when the user cancels the wizard. */
+    readonly onCancel?: () => void;
+    /** Additional CSS classes for the root container. */
+    readonly className?: string;
+}
+/**
+ * Multi-step wizard for creating a new MCP server blueprint.
+ *
+ * Three steps:
+ * 1. **Identity & Transport** — name, slug, description, visibility, transport config
+ * 2. **Environment & Auth** — env var declarations, OAuth auth configuration (all optional)
+ * 3. **Review & Create** — YAML preview + submission
+ *
+ * Uses the shared `WizardShell` layout and `useWizardState` hook for
+ * navigation. Form data accumulates in the wizard state; on the final
+ * step the user reviews and confirms creation.
+ *
+ * This component is an SDK-first, embeddable wizard with zero Console
+ * dependencies. Platform builders can mount it anywhere.
+ *
+ * @example
+ * ```tsx
+ * <McpServerCreationWizard
+ *   org="acme"
+ *   onComplete={({ org, slug }) => navigate(`/mcp-servers/${org}/${slug}`)}
+ *   onCancel={() => navigate("/mcp-servers")}
+ * />
+ * ```
+ */
+export declare function McpServerCreationWizard({ org, initialData, onComplete, onCancel, className, }: McpServerCreationWizardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=McpServerCreationWizard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"McpServerCreationWizard.d.ts","sourceRoot":"","sources":["../../src/mcp-server/McpServerCreationWizard.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAMzD,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACpD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC/D,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAmCD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,GAAG,EACH,WAAW,EACX,UAAU,EACV,QAAQ,EACR,SAAS,GACV,EAAE,4BAA4B,2CA+F9B"}

package/mcp-server/McpServerCreationWizard.js

@@ -0,0 +1,121 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo } from "react";
+import { useWizardState } from "../resource-creation/useWizardState";
+import { WizardShell } from "../resource-creation/WizardShell";
+import { useCreateMcpServer } from "./useCreateMcpServer";
+import { IdentityTransportStep } from "./steps/IdentityTransportStep";
+import { EnvironmentAuthStep } from "./steps/EnvironmentAuthStep";
+import { ReviewStep, buildMcpServerInput } from "./steps/ReviewStep";
+import { createInitialMcpServerWizardData } from "./steps/types";
+// ---------------------------------------------------------------------------
+// Step definitions
+// ---------------------------------------------------------------------------
+const STEPS = [
+    {
+        id: "identity-transport",
+        label: "Identity & Transport",
+        validate: (data) => {
+            if (!data.name.trim())
+                return "Name is required";
+            if (data.transportType === "http" && !data.httpUrl.trim()) {
+                return "HTTP URL is required";
+            }
+            if (data.transportType === "stdio" && !data.stdioCommand.trim()) {
+                return "Stdio command is required";
+            }
+            return null;
+        },
+    },
+    {
+        id: "environment-auth",
+        label: "Environment & Auth",
+    },
+    {
+        id: "review",
+        label: "Review & Create",
+    },
+];
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+/**
+ * Multi-step wizard for creating a new MCP server blueprint.
+ *
+ * Three steps:
+ * 1. **Identity & Transport** — name, slug, description, visibility, transport config
+ * 2. **Environment & Auth** — env var declarations, OAuth auth configuration (all optional)
+ * 3. **Review & Create** — YAML preview + submission
+ *
+ * Uses the shared `WizardShell` layout and `useWizardState` hook for
+ * navigation. Form data accumulates in the wizard state; on the final
+ * step the user reviews and confirms creation.
+ *
+ * This component is an SDK-first, embeddable wizard with zero Console
+ * dependencies. Platform builders can mount it anywhere.
+ *
+ * @example
+ * ```tsx
+ * <McpServerCreationWizard
+ *   org="acme"
+ *   onComplete={({ org, slug }) => navigate(`/mcp-servers/${org}/${slug}`)}
+ *   onCancel={() => navigate("/mcp-servers")}
+ * />
+ * ```
+ */
+export function McpServerCreationWizard({ org, initialData, onComplete, onCancel, className, }) {
+    const mergedInitialData = useMemo(() => ({ ...createInitialMcpServerWizardData(), ...initialData }), 
+    // initialData is consumed once at mount — not reactive by design
+    [initialData]);
+    const wizard = useWizardState({
+        steps: STEPS,
+        initialData: mergedInitialData,
+    });
+    const { create, isCreating, error, clearError } = useCreateMcpServer();
+    const handleNext = useCallback(() => {
+        if (wizard.isLastStep) {
+            handleSubmit();
+        }
+        else {
+            clearError();
+            wizard.goNext();
+        }
+    }, [wizard.isLastStep, wizard.goNext, clearError]);
+    const handleSubmit = useCallback(async () => {
+        clearError();
+        const input = buildMcpServerInput(org, wizard.data);
+        try {
+            const server = await create(input);
+            onComplete({
+                org: server.metadata?.org ?? org,
+                slug: server.metadata?.slug ?? input.slug ?? input.name,
+                name: server.metadata?.name ?? input.name,
+            });
+        }
+        catch {
+            // Error is captured by useCreateMcpServer and displayed in ReviewStep
+        }
+    }, [org, wizard.data, create, clearError, onComplete]);
+    const currentStepContent = useMemo(() => {
+        switch (wizard.currentStep.id) {
+            case "identity-transport":
+                return (_jsx(IdentityTransportStep, { data: wizard.data, updateData: wizard.updateData, validationError: wizard.validationError }));
+            case "environment-auth":
+                return (_jsx(EnvironmentAuthStep, { data: wizard.data, updateData: wizard.updateData }));
+            case "review":
+                return (_jsx(ReviewStep, { org: org, data: wizard.data, isCreating: isCreating, error: error }));
+            default:
+                return null;
+        }
+    }, [
+        wizard.currentStep.id,
+        wizard.data,
+        wizard.updateData,
+        wizard.validationError,
+        org,
+        isCreating,
+        error,
+    ]);
+    return (_jsx(WizardShell, { steps: STEPS, currentStepIndex: wizard.currentStepIndex, submitLabel: "Create MCP server", isSubmitting: isCreating, canGoNext: wizard.canGoNext, canGoBack: wizard.canGoBack, onNext: handleNext, onBack: wizard.goBack, onGoToStep: wizard.goToStep, onCancel: onCancel, className: className, children: currentStepContent }));
+}
+//# sourceMappingURL=McpServerCreationWizard.js.map

package/mcp-server/McpServerCreationWizard.js.map

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

package/mcp-server/McpServerDetailView.d.ts

@@ -1,4 +1,6 @@
+import type { McpServer } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import type { DetailAction } from "../resource-detail/types";
 /** Tab identifier for the MCP server capability panel. */
 export type CapabilityTab = "tools" | "policies" | "resources";
 /** Props for {@link McpServerDetailView}. */
@@ -56,6 +58,24 @@ export interface McpServerDetailViewProps {
      * When omitted, falls back to the `org` prop (MCP server's org).
      */
     readonly activeOrg?: string;
+    /**
+     * Primary action rendered as a visible button in the header area.
+     */
+    readonly primaryAction?: DetailAction;
+    /**
+     * Secondary actions rendered in the kebab overflow menu.
+     */
+    readonly actions?: readonly DetailAction[];
+    /**
+     * When `true`, fields on the detail view become click-to-edit.
+     * Each field saves independently via `stigmer.mcpServer.update()`.
+     * @default false
+     */
+    readonly editable?: boolean;
+    /**
+     * Called after a successful inline field save with the updated server.
+     */
+    readonly onResourceUpdated?: (server: McpServer) => void;
     /** Additional CSS classes for the root container. */
     readonly className?: string;
 }
@@ -83,5 +103,5 @@ export interface McpServerDetailViewProps {
  * <McpServerDetailView org="acme" slug="github" />
  * ```
  */
-export declare function McpServerDetailView({ org, slug, onResourceLoad, onVisibilityChange, isVisibilityPending, defaultCapabilityTab, defaultShowCredentialForm, credentialPoolValues, activeOrg, className, }: McpServerDetailViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function McpServerDetailView({ org, slug, onResourceLoad, onVisibilityChange, isVisibilityPending, defaultCapabilityTab, defaultShowCredentialForm, credentialPoolValues, activeOrg, primaryAction, actions, editable, onResourceUpdated, className, }: McpServerDetailViewProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=McpServerDetailView.d.ts.map