@stigmer/react 0.4.8 → 0.5.1

package/resource-creation/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resource-creation/templates/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/resource-creation/templates/index.js

@@ -0,0 +1,5 @@
+export { TEMPLATE_CATEGORY_LABELS } from "./types";
+// Static template data
+export { AGENT_TEMPLATES } from "./agent-templates";
+export { MCP_SERVER_TEMPLATES } from "./mcp-server-templates";
+//# sourceMappingURL=index.js.map

package/resource-creation/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resource-creation/templates/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEnD,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/resource-creation/templates/mcp-server-templates.d.ts

@@ -0,0 +1,15 @@
+import type { McpServerWizardData } from "../../mcp-server/steps/types";
+import type { ResourceTemplate } from "./types";
+/**
+ * Built-in MCP server templates shipped with the SDK.
+ *
+ * Each template pre-fills the MCP server creation wizard with a
+ * curated transport configuration, environment variable declarations,
+ * and descriptive metadata. Users can customize every field after
+ * selection.
+ *
+ * Platform builders can pass their own template arrays to the
+ * gallery; these built-in templates are a convenience default.
+ */
+export declare const MCP_SERVER_TEMPLATES: readonly ResourceTemplate<McpServerWizardData>[];
+//# sourceMappingURL=mcp-server-templates.d.ts.map

package/resource-creation/templates/mcp-server-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-templates.d.ts","sourceRoot":"","sources":["../../../src/resource-creation/templates/mcp-server-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,gBAAgB,CAAC,mBAAmB,CAAC,EA2F9E,CAAC"}

package/resource-creation/templates/mcp-server-templates.js

@@ -0,0 +1,92 @@
+/**
+ * Built-in MCP server templates shipped with the SDK.
+ *
+ * Each template pre-fills the MCP server creation wizard with a
+ * curated transport configuration, environment variable declarations,
+ * and descriptive metadata. Users can customize every field after
+ * selection.
+ *
+ * Platform builders can pass their own template arrays to the
+ * gallery; these built-in templates are a convenience default.
+ */
+export const MCP_SERVER_TEMPLATES = [
+    {
+        id: "github",
+        name: "GitHub",
+        description: "Connect to the GitHub API for repository management, issue tracking, pull requests, and code search.",
+        category: "integration",
+        tags: ["github", "git", "repository", "api", "code"],
+        data: {
+            name: "GitHub",
+            description: "GitHub API integration for repository management, issues, pull requests, and code search.",
+            transportType: "http",
+            httpUrl: "https://api.githubcopilot.com",
+            env: [
+                {
+                    key: "GITHUB_TOKEN",
+                    description: "GitHub personal access token with appropriate scopes.",
+                    isSecret: true,
+                    optional: false,
+                },
+            ],
+        },
+    },
+    {
+        id: "slack",
+        name: "Slack",
+        description: "Connect to the Slack API for sending messages, managing channels, and reading conversation history.",
+        category: "integration",
+        tags: ["slack", "messaging", "chat", "communication"],
+        data: {
+            name: "Slack",
+            description: "Slack API integration for messaging, channel management, and conversation history.",
+            transportType: "http",
+            httpUrl: "https://slack.com/api/mcp",
+            env: [
+                {
+                    key: "SLACK_BOT_TOKEN",
+                    description: "Slack Bot User OAuth token (xoxb-...).",
+                    isSecret: true,
+                    optional: false,
+                },
+            ],
+        },
+    },
+    {
+        id: "postgresql",
+        name: "PostgreSQL",
+        description: "Connect to a PostgreSQL database for querying, schema inspection, and data management.",
+        category: "integration",
+        tags: ["postgres", "postgresql", "database", "sql", "data"],
+        data: {
+            name: "PostgreSQL",
+            description: "PostgreSQL database connection for querying, schema inspection, and data management.",
+            transportType: "stdio",
+            stdioCommand: "npx",
+            stdioArgs: "-y @modelcontextprotocol/server-postgres",
+            env: [
+                {
+                    key: "DATABASE_URL",
+                    description: "PostgreSQL connection string (e.g. postgresql://user:pass@host:5432/db).",
+                    isSecret: true,
+                    optional: false,
+                },
+            ],
+        },
+    },
+    {
+        id: "filesystem",
+        name: "Filesystem",
+        description: "Provide read and write access to a local directory for file management and content operations.",
+        category: "general",
+        tags: ["filesystem", "files", "local", "directory"],
+        data: {
+            name: "Filesystem",
+            description: "Local filesystem access for reading, writing, and managing files within a directory.",
+            transportType: "stdio",
+            stdioCommand: "npx",
+            stdioArgs: "-y @modelcontextprotocol/server-filesystem /path/to/directory",
+        },
+    },
+];
+//# sourceMappingURL=mcp-server-templates.js.map

package/resource-creation/templates/mcp-server-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-templates.js","sourceRoot":"","sources":["../../../src/resource-creation/templates/mcp-server-templates.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B;IACE;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,sGAAsG;QACxG,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC;QACpD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2FAA2F;YAC7F,aAAa,EAAE,MAAM;YACrB,OAAO,EAAE,+BAA+B;YACxC,GAAG,EAAE;gBACH;oBACE,GAAG,EAAE,cAAc;oBACnB,WAAW,EACT,uDAAuD;oBACzD,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,KAAK;iBAChB;aACF;SACF;KACF;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EACT,qGAAqG;QACvG,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC;QACrD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,WAAW,EACT,oFAAoF;YACtF,aAAa,EAAE,MAAM;YACrB,OAAO,EAAE,2BAA2B;YACpC,GAAG,EAAE;gBACH;oBACE,GAAG,EAAE,iBAAiB;oBACtB,WAAW,EAAE,wCAAwC;oBACrD,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,KAAK;iBAChB;aACF;SACF;KACF;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,wFAAwF;QAC1F,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC;QAC3D,IAAI,EAAE;YACJ,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,sFAAsF;YACxF,aAAa,EAAE,OAAO;YACtB,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,0CAA0C;YACrD,GAAG,EAAE;gBACH;oBACE,GAAG,EAAE,cAAc;oBACnB,WAAW,EACT,0EAA0E;oBAC5E,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,KAAK;iBAChB;aACF;SACF;KACF;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,gGAAgG;QAClG,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC;QACnD,IAAI,EAAE;YACJ,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,sFAAsF;YACxF,aAAa,EAAE,OAAO;YACtB,YAAY,EAAE,KAAK;YACnB,SAAS,EACP,+DAA+D;SAClE;KACF;CACF,CAAC"}

package/resource-creation/templates/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Template categories for grouping resource templates in the gallery.
+ *
+ * Each category maps to a common use-case domain. The gallery renders
+ * these as filterable tabs. Platform builders can use the same
+ * categories or extend with custom values if they define their own
+ * template arrays.
+ */
+export type TemplateCategory = "customer-support" | "code-review" | "data-analysis" | "devops" | "content" | "integration" | "general";
+/**
+ * Human-readable labels for template categories.
+ *
+ * Used by the gallery UI for tab labels and screen readers.
+ * Exported so platform builders can reuse or extend them.
+ */
+export declare const TEMPLATE_CATEGORY_LABELS: Record<TemplateCategory, string>;
+/**
+ * A pre-built resource configuration that seeds a creation wizard.
+ *
+ * Generic over `TData` — the wizard's accumulated form state type.
+ * For agents, `TData` is `AgentWizardData`; for MCP servers,
+ * `TData` is `McpServerWizardData`.
+ *
+ * `data` is `Partial<TData>`: only the fields the template wants to
+ * pre-fill. The wizard merges this with its default empty state via
+ * `{ ...createInitialWizardData(), ...template.data }`.
+ *
+ * @typeParam TData - The wizard's accumulated form data shape.
+ */
+export interface ResourceTemplate<TData> {
+    /** Stable template identifier (unique within a resource kind). */
+    readonly id: string;
+    /** Human-readable template name displayed in the gallery card. */
+    readonly name: string;
+    /** Short description of what this template sets up. */
+    readonly description: string;
+    /** Category for gallery filtering. */
+    readonly category: TemplateCategory;
+    /** Searchable tags for the gallery's text search. */
+    readonly tags?: readonly string[];
+    /**
+     * Partial wizard data to merge with defaults when the user
+     * selects this template. Only fields that the template wants
+     * to pre-fill are included.
+     */
+    readonly data: Partial<TData>;
+}
+//# sourceMappingURL=types.d.ts.map

package/resource-creation/templates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/resource-creation/templates/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,QAAQ,GACR,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEd;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAQrE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CAC/B"}

package/resource-creation/templates/types.js

@@ -0,0 +1,16 @@
+/**
+ * Human-readable labels for template categories.
+ *
+ * Used by the gallery UI for tab labels and screen readers.
+ * Exported so platform builders can reuse or extend them.
+ */
+export const TEMPLATE_CATEGORY_LABELS = {
+    "customer-support": "Customer Support",
+    "code-review": "Code Review",
+    "data-analysis": "Data Analysis",
+    devops: "DevOps",
+    content: "Content",
+    integration: "Integration",
+    general: "General",
+};
+//# sourceMappingURL=types.js.map

package/resource-creation/templates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/resource-creation/templates/types.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,kBAAkB,EAAE,kBAAkB;IACtC,aAAa,EAAE,aAAa;IAC5B,eAAe,EAAE,eAAe;IAChC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;CACnB,CAAC"}

package/resource-creation/types.d.ts

@@ -0,0 +1,88 @@
+import type { ReactNode } from "react";
+/** A single env var declaration entry in a wizard form. */
+export interface EnvVarEntry {
+    /** Environment variable name (e.g. GITHUB_TOKEN). */
+    readonly key: string;
+    /** Human-readable description. */
+    readonly description: string;
+    /** Whether this variable holds a secret value. */
+    readonly isSecret: boolean;
+    /** Whether the variable is optional. */
+    readonly optional: boolean;
+}
+/** A generic key-value pair entry for wizard forms (e.g. HTTP headers). */
+export interface KeyValueEntry {
+    /** The key (e.g. header name). */
+    readonly key: string;
+    /** The value (e.g. header value). */
+    readonly value: string;
+}
+/**
+ * Defines a wizard step's metadata and validation logic.
+ *
+ * Generic over `TData` — the accumulated form state type that flows
+ * through all steps. Each step's `validate` function receives the full
+ * accumulated state and returns an error message or `null` if valid.
+ *
+ * @typeParam TData - Shape of the wizard's accumulated form data.
+ */
+export interface WizardStepDef<TData> {
+    /** Stable step identifier (used as key and for navigation). */
+    readonly id: string;
+    /** Human-readable step label displayed in the step indicator. */
+    readonly label: string;
+    /**
+     * Validates the current data before allowing navigation to the next step.
+     * Returns a descriptive error string if invalid, or `null` if the step
+     * passes validation.
+     *
+     * When omitted, the step is always considered valid.
+     */
+    readonly validate?: (data: TData) => string | null;
+}
+/** Internal state shape for the wizard reducer. */
+export interface WizardState<TData> {
+    /** Zero-based index of the currently active step. */
+    readonly currentStepIndex: number;
+    /** Accumulated form data across all steps. */
+    readonly data: TData;
+    /** Validation error for the current step, or `null` when valid. */
+    readonly validationError: string | null;
+}
+/**
+ * Props for {@link WizardShell} — the resource-agnostic wizard layout.
+ *
+ * Renders a step indicator, content area, and navigation footer.
+ * The content for each step is provided via `children` — the wizard
+ * shell does not know about step-specific rendering.
+ */
+export interface WizardShellProps {
+    /** Step definitions for the progress indicator (only `id` and `label` are used for rendering). */
+    readonly steps: readonly {
+        readonly id: string;
+        readonly label: string;
+    }[];
+    /** Zero-based index of the currently active step. */
+    readonly currentStepIndex: number;
+    /** Content to render in the main area (the active step's UI). */
+    readonly children: ReactNode;
+    /** Label for the final step's action button (e.g. "Create agent"). */
+    readonly submitLabel: string;
+    /** Whether the submit action is currently in progress. */
+    readonly isSubmitting?: boolean;
+    /** Whether the "Next" / submit button should be disabled. */
+    readonly canGoNext?: boolean;
+    /** Whether the "Back" button should be shown. */
+    readonly canGoBack?: boolean;
+    /** Called when the user clicks "Next" or the submit button. */
+    readonly onNext: () => void;
+    /** Called when the user clicks "Back". */
+    readonly onBack: () => void;
+    /** Called when a completed step is clicked in the indicator (backward jump). */
+    readonly onGoToStep?: (index: number) => void;
+    /** Called when the user cancels the wizard entirely. */
+    readonly onCancel?: () => void;
+    /** Additional CSS classes for the root container. */
+    readonly className?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/resource-creation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resource-creation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,IAAI,CAAC;CACpD;AAMD,mDAAmD;AACnD,MAAM,WAAW,WAAW,CAAC,KAAK;IAChC,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kGAAkG;IAClG,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3E,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/resource-creation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/resource-creation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resource-creation/types.ts"],"names":[],"mappings":""}

package/resource-creation/useTemplateFilter.d.ts

@@ -0,0 +1,43 @@
+import type { ResourceTemplate, TemplateCategory } from "./templates/types";
+/** Options for {@link useTemplateFilter}. */
+export interface UseTemplateFilterOptions<TData> {
+    /** The full set of templates to filter. */
+    readonly templates: readonly ResourceTemplate<TData>[];
+}
+/** Return value of {@link useTemplateFilter}. */
+export interface UseTemplateFilterReturn<TData> {
+    /** Templates matching the current search query and active category. */
+    readonly filtered: readonly ResourceTemplate<TData>[];
+    /** Current search query string. */
+    readonly query: string;
+    /** Update the search query. */
+    readonly setQuery: (query: string) => void;
+    /** Currently active category filter, or `null` for "All". */
+    readonly activeCategory: TemplateCategory | null;
+    /** Set the active category filter. Pass `null` to show all. */
+    readonly setActiveCategory: (category: TemplateCategory | null) => void;
+    /** Deduplicated, sorted list of categories present in the template set. */
+    readonly availableCategories: readonly TemplateCategory[];
+}
+/**
+ * Headless hook for filtering and searching a set of resource templates.
+ *
+ * Provides category tab state, text search across name/description/tags,
+ * and the filtered result set. Fully memoized — only recalculates when
+ * inputs change.
+ *
+ * Platform builders can use this hook with their own rendering; the
+ * styled `TemplateGallery` component uses it internally.
+ *
+ * @typeParam TData - The wizard data shape (e.g. `AgentWizardData`).
+ *
+ * @example
+ * ```tsx
+ * const { filtered, query, setQuery, activeCategory, setActiveCategory, availableCategories } =
+ *   useTemplateFilter({ templates: AGENT_TEMPLATES });
+ *
+ * // Render your own gallery UI using `filtered`
+ * ```
+ */
+export declare function useTemplateFilter<TData>(options: UseTemplateFilterOptions<TData>): UseTemplateFilterReturn<TData>;
+//# sourceMappingURL=useTemplateFilter.d.ts.map

package/resource-creation/useTemplateFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTemplateFilter.d.ts","sourceRoot":"","sources":["../../src/resource-creation/useTemplateFilter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM5E,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB,CAAC,KAAK;IAC7C,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;CACxD;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB,CAAC,KAAK;IAC5C,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;IACtD,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjD,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;IACxE,2EAA2E;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC3D;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EACrC,OAAO,EAAE,wBAAwB,CAAC,KAAK,CAAC,GACvC,uBAAuB,CAAC,KAAK,CAAC,CA2DhC"}

package/resource-creation/useTemplateFilter.js

@@ -0,0 +1,73 @@
+"use client";
+import { useCallback, useMemo, useState } from "react";
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Headless hook for filtering and searching a set of resource templates.
+ *
+ * Provides category tab state, text search across name/description/tags,
+ * and the filtered result set. Fully memoized — only recalculates when
+ * inputs change.
+ *
+ * Platform builders can use this hook with their own rendering; the
+ * styled `TemplateGallery` component uses it internally.
+ *
+ * @typeParam TData - The wizard data shape (e.g. `AgentWizardData`).
+ *
+ * @example
+ * ```tsx
+ * const { filtered, query, setQuery, activeCategory, setActiveCategory, availableCategories } =
+ *   useTemplateFilter({ templates: AGENT_TEMPLATES });
+ *
+ * // Render your own gallery UI using `filtered`
+ * ```
+ */
+export function useTemplateFilter(options) {
+    const { templates } = options;
+    const [query, setQueryRaw] = useState("");
+    const [activeCategory, setActiveCategory] = useState(null);
+    const setQuery = useCallback((q) => {
+        setQueryRaw(q);
+    }, []);
+    const availableCategories = useMemo(() => {
+        const seen = new Set();
+        for (const t of templates) {
+            seen.add(t.category);
+        }
+        const sorted = [...seen].sort();
+        return sorted;
+    }, [templates]);
+    const filtered = useMemo(() => {
+        let result = templates;
+        if (activeCategory) {
+            result = result.filter((t) => t.category === activeCategory);
+        }
+        const trimmed = query.trim().toLowerCase();
+        if (trimmed) {
+            result = result.filter((t) => {
+                const haystack = [t.name, t.description, ...(t.tags ?? [])]
+                    .join(" ")
+                    .toLowerCase();
+                return haystack.includes(trimmed);
+            });
+        }
+        return result;
+    }, [templates, activeCategory, query]);
+    return useMemo(() => ({
+        filtered,
+        query,
+        setQuery,
+        activeCategory,
+        setActiveCategory,
+        availableCategories,
+    }), [
+        filtered,
+        query,
+        setQuery,
+        activeCategory,
+        setActiveCategory,
+        availableCategories,
+    ]);
+}
+//# sourceMappingURL=useTemplateFilter.js.map

package/resource-creation/useTemplateFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTemplateFilter.js","sourceRoot":"","sources":["../../src/resource-creation/useTemplateFilter.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA6BvD,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAwC;IAExC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAClD,IAAI,CACL,CAAC;IAEF,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAS,EAAE,EAAE;QACzC,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,EAAE;QACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,IAAI,MAAM,GAAuC,SAAS,CAAC;QAE3D,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,cAAc,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;qBACxD,IAAI,CAAC,GAAG,CAAC;qBACT,WAAW,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC;IAEvC,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,cAAc;QACd,iBAAiB;QACjB,mBAAmB;KACpB,CAAC,EACF;QACE,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,cAAc;QACd,iBAAiB;QACjB,mBAAmB;KACpB,CACF,CAAC;AACJ,CAAC"}

package/resource-creation/useWizardState.d.ts

@@ -0,0 +1,67 @@
+import type { WizardStepDef } from "./types";
+/** Options for {@link useWizardState}. */
+export interface UseWizardStateOptions<TData> {
+    /** Ordered step definitions — determines wizard length and validation. */
+    readonly steps: readonly WizardStepDef<TData>[];
+    /** Initial form data (empty/default values for all fields). */
+    readonly initialData: TData;
+}
+/** Return value of {@link useWizardState}. */
+export interface UseWizardStateReturn<TData> {
+    /** Zero-based index of the current step. */
+    readonly currentStepIndex: number;
+    /** Definition of the current step. */
+    readonly currentStep: WizardStepDef<TData>;
+    /** Accumulated form data across all steps. */
+    readonly data: TData;
+    /** Merges a partial update into the accumulated data. */
+    readonly updateData: (partial: Partial<TData>) => void;
+    /** Whether navigation forward is allowed (current step is valid). */
+    readonly canGoNext: boolean;
+    /** Whether navigation backward is possible (not on first step). */
+    readonly canGoBack: boolean;
+    /** Advance to the next step (validates current step first). */
+    readonly goNext: () => void;
+    /** Return to the previous step. */
+    readonly goBack: () => void;
+    /** Jump directly to a specific step (only allows going backward). */
+    readonly goToStep: (index: number) => void;
+    /** Validation error for the current step, or `null`. */
+    readonly validationError: string | null;
+    /** `true` when on the first step. */
+    readonly isFirstStep: boolean;
+    /** `true` when on the last step. */
+    readonly isLastStep: boolean;
+}
+/**
+ * Headless state machine for multi-step wizard flows.
+ *
+ * Manages step navigation, per-step validation gating, and accumulated
+ * form data. Generic over the data shape — each wizard defines its own
+ * `TData` type with fields for all steps.
+ *
+ * Navigation forward is gated by the current step's `validate` function.
+ * Navigation backward is always allowed. Direct step jumps only go backward
+ * (prevents skipping required steps).
+ *
+ * Follows the `useReducer` + discriminated union pattern established
+ * by `agentSetupReducer` — pure state transitions, imperative API on top.
+ *
+ * @typeParam TData - Accumulated form data shape.
+ *
+ * @example
+ * ```tsx
+ * const wizard = useWizardState({
+ *   steps: [
+ *     { id: "basics", label: "Basics", validate: (d) => d.name ? null : "Name is required" },
+ *     { id: "review", label: "Review" },
+ *   ],
+ *   initialData: { name: "", description: "" },
+ * });
+ *
+ * // wizard.data.name, wizard.updateData({ name: "My Agent" })
+ * // wizard.goNext(), wizard.goBack()
+ * ```
+ */
+export declare function useWizardState<TData>(options: UseWizardStateOptions<TData>): UseWizardStateReturn<TData>;
+//# sourceMappingURL=useWizardState.d.ts.map

package/resource-creation/useWizardState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWizardState.d.ts","sourceRoot":"","sources":["../../src/resource-creation/useWizardState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,SAAS,CAAC;AAM1D,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB,CAAC,KAAK;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB,CAAC,KAAK;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3C,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACvD,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wDAAwD;IACxD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AA+ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAClC,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,GACpC,oBAAoB,CAAC,KAAK,CAAC,CAoE7B"}

package/resource-creation/useWizardState.js

@@ -0,0 +1,143 @@
+"use client";
+import { useCallback, useMemo, useReducer } from "react";
+// ---------------------------------------------------------------------------
+// Reducer
+// ---------------------------------------------------------------------------
+function createReducer(steps) {
+    return function wizardReducer(state, action) {
+        switch (action.type) {
+            case "GO_NEXT": {
+                const step = steps[state.currentStepIndex];
+                const error = step?.validate?.(state.data) ?? null;
+                if (error) {
+                    return { ...state, validationError: error };
+                }
+                const nextIndex = Math.min(state.currentStepIndex + 1, steps.length - 1);
+                return {
+                    ...state,
+                    currentStepIndex: nextIndex,
+                    validationError: null,
+                };
+            }
+            case "GO_BACK": {
+                const prevIndex = Math.max(state.currentStepIndex - 1, 0);
+                return {
+                    ...state,
+                    currentStepIndex: prevIndex,
+                    validationError: null,
+                };
+            }
+            case "GO_TO_STEP": {
+                if (action.index < 0 || action.index >= steps.length)
+                    return state;
+                if (action.index >= state.currentStepIndex)
+                    return state;
+                return {
+                    ...state,
+                    currentStepIndex: action.index,
+                    validationError: null,
+                };
+            }
+            case "UPDATE_DATA":
+                return {
+                    ...state,
+                    data: { ...state.data, ...action.partial },
+                    validationError: null,
+                };
+            case "SET_VALIDATION_ERROR":
+                return { ...state, validationError: action.error };
+            default:
+                return state;
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Headless state machine for multi-step wizard flows.
+ *
+ * Manages step navigation, per-step validation gating, and accumulated
+ * form data. Generic over the data shape — each wizard defines its own
+ * `TData` type with fields for all steps.
+ *
+ * Navigation forward is gated by the current step's `validate` function.
+ * Navigation backward is always allowed. Direct step jumps only go backward
+ * (prevents skipping required steps).
+ *
+ * Follows the `useReducer` + discriminated union pattern established
+ * by `agentSetupReducer` — pure state transitions, imperative API on top.
+ *
+ * @typeParam TData - Accumulated form data shape.
+ *
+ * @example
+ * ```tsx
+ * const wizard = useWizardState({
+ *   steps: [
+ *     { id: "basics", label: "Basics", validate: (d) => d.name ? null : "Name is required" },
+ *     { id: "review", label: "Review" },
+ *   ],
+ *   initialData: { name: "", description: "" },
+ * });
+ *
+ * // wizard.data.name, wizard.updateData({ name: "My Agent" })
+ * // wizard.goNext(), wizard.goBack()
+ * ```
+ */
+export function useWizardState(options) {
+    const { steps, initialData } = options;
+    const reducer = useMemo(() => createReducer(steps), [steps]);
+    const [state, dispatch] = useReducer(reducer, {
+        currentStepIndex: 0,
+        data: initialData,
+        validationError: null,
+    });
+    const currentStep = steps[state.currentStepIndex];
+    const isFirstStep = state.currentStepIndex === 0;
+    const isLastStep = state.currentStepIndex === steps.length - 1;
+    const canGoNext = useMemo(() => {
+        const error = currentStep.validate?.(state.data) ?? null;
+        return error === null;
+    }, [currentStep, state.data]);
+    const canGoBack = !isFirstStep;
+    const goNext = useCallback(() => {
+        dispatch({ type: "GO_NEXT" });
+    }, []);
+    const goBack = useCallback(() => {
+        dispatch({ type: "GO_BACK" });
+    }, []);
+    const goToStep = useCallback((index) => {
+        dispatch({ type: "GO_TO_STEP", index });
+    }, []);
+    const updateData = useCallback((partial) => {
+        dispatch({ type: "UPDATE_DATA", partial });
+    }, []);
+    return useMemo(() => ({
+        currentStepIndex: state.currentStepIndex,
+        currentStep,
+        data: state.data,
+        updateData,
+        canGoNext,
+        canGoBack,
+        goNext,
+        goBack,
+        goToStep,
+        validationError: state.validationError,
+        isFirstStep,
+        isLastStep,
+    }), [
+        state.currentStepIndex,
+        state.data,
+        state.validationError,
+        currentStep,
+        canGoNext,
+        canGoBack,
+        isFirstStep,
+        isLastStep,
+        updateData,
+        goNext,
+        goBack,
+        goToStep,
+    ]);
+}
+//# sourceMappingURL=useWizardState.js.map