@stigmer/react 0.4.8 → 0.5.0

package/action-menu/ActionMenu.d.ts

@@ -0,0 +1,64 @@
+import type { ActionMenuProps, ActionMenuTriggerProps, ActionMenuContentProps, ActionMenuItemProps, ActionMenuSeparatorProps, ActionMenuGroupProps } from "./types";
+/**
+ * Compound menu component for resource item actions.
+ *
+ * Built on top of the SDK's internal Base UI menu primitives with
+ * opinionated conventions for resource management UX:
+ * - Icon + label + optional shortcut hint layout
+ * - Destructive variant for dangerous actions
+ * - Grouped sections with labels
+ * - Keyboard navigation (arrows, Enter, Esc) via Base UI
+ * - Portal rendering with theme inheritance
+ *
+ * @example
+ * ```tsx
+ * <ActionMenu>
+ *   <ActionMenu.Trigger>
+ *     <button aria-label="Agent actions">
+ *       <MoreHorizontal className="h-4 w-4" />
+ *     </button>
+ *   </ActionMenu.Trigger>
+ *   <ActionMenu.Content>
+ *     <ActionMenu.Item icon={<Edit />} onSelect={handleEdit}>
+ *       Edit
+ *     </ActionMenu.Item>
+ *     <ActionMenu.Item icon={<Copy />} onSelect={handleDuplicate}>
+ *       Duplicate
+ *     </ActionMenu.Item>
+ *     <ActionMenu.Separator />
+ *     <ActionMenu.Item
+ *       icon={<Trash2 />}
+ *       variant="destructive"
+ *       onSelect={handleDelete}
+ *     >
+ *       Delete
+ *     </ActionMenu.Item>
+ *   </ActionMenu.Content>
+ * </ActionMenu>
+ * ```
+ */
+declare function ActionMenuRoot({ children }: ActionMenuProps): import("react/jsx-runtime").JSX.Element;
+declare function Trigger({ children, className, "aria-label": ariaLabel, }: ActionMenuTriggerProps): import("react/jsx-runtime").JSX.Element;
+declare function Content({ children, align, className }: ActionMenuContentProps): import("react/jsx-runtime").JSX.Element;
+declare function Item({ children, onSelect, icon, shortcut, variant, disabled, className, }: ActionMenuItemProps): import("react/jsx-runtime").JSX.Element;
+declare function Separator({ className }: ActionMenuSeparatorProps): import("react/jsx-runtime").JSX.Element;
+declare function Group({ children, label, className }: ActionMenuGroupProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Public compound component for resource item action menus.
+ *
+ * Subcomponents:
+ * - `ActionMenu.Trigger` — the element that opens the menu
+ * - `ActionMenu.Content` — the menu panel container
+ * - `ActionMenu.Item` — a single action (with icon, shortcut, destructive variant)
+ * - `ActionMenu.Separator` — a visual divider between items/groups
+ * - `ActionMenu.Group` — a labeled section of items
+ */
+export declare const ActionMenu: typeof ActionMenuRoot & {
+    Trigger: typeof Trigger;
+    Content: typeof Content;
+    Item: typeof Item;
+    Separator: typeof Separator;
+    Group: typeof Group;
+};
+export {};
+//# sourceMappingURL=ActionMenu.d.ts.map

package/action-menu/ActionMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionMenu.d.ts","sourceRoot":"","sources":["../../src/action-menu/ActionMenu.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,iBAAS,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,eAAe,2CAEpD;AAED,iBAAS,OAAO,CAAC,EACf,QAAQ,EACR,SAAS,EACT,YAAY,EAAE,SAAqB,GACpC,EAAE,sBAAsB,2CAexB;AAED,iBAAS,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAa,EAAE,SAAS,EAAE,EAAE,sBAAsB,2CAM9E;AAED,iBAAS,IAAI,CAAC,EACZ,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,OAAmB,EACnB,QAAQ,EACR,SAAS,GACV,EAAE,mBAAmB,2CAmBrB;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,wBAAwB,2CAEzD;AAED,iBAAS,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CAOlE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU;;;;;;CAMrB,CAAC"}

package/action-menu/ActionMenu.js

@@ -0,0 +1,78 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { Menu, MenuTrigger, MenuContent as InternalMenuContent, MenuItem as InternalMenuItem, MenuSeparator as InternalMenuSeparator, MenuGroup as InternalMenuGroup, MenuLabel, } from "../internal/menu";
+/**
+ * Compound menu component for resource item actions.
+ *
+ * Built on top of the SDK's internal Base UI menu primitives with
+ * opinionated conventions for resource management UX:
+ * - Icon + label + optional shortcut hint layout
+ * - Destructive variant for dangerous actions
+ * - Grouped sections with labels
+ * - Keyboard navigation (arrows, Enter, Esc) via Base UI
+ * - Portal rendering with theme inheritance
+ *
+ * @example
+ * ```tsx
+ * <ActionMenu>
+ *   <ActionMenu.Trigger>
+ *     <button aria-label="Agent actions">
+ *       <MoreHorizontal className="h-4 w-4" />
+ *     </button>
+ *   </ActionMenu.Trigger>
+ *   <ActionMenu.Content>
+ *     <ActionMenu.Item icon={<Edit />} onSelect={handleEdit}>
+ *       Edit
+ *     </ActionMenu.Item>
+ *     <ActionMenu.Item icon={<Copy />} onSelect={handleDuplicate}>
+ *       Duplicate
+ *     </ActionMenu.Item>
+ *     <ActionMenu.Separator />
+ *     <ActionMenu.Item
+ *       icon={<Trash2 />}
+ *       variant="destructive"
+ *       onSelect={handleDelete}
+ *     >
+ *       Delete
+ *     </ActionMenu.Item>
+ *   </ActionMenu.Content>
+ * </ActionMenu>
+ * ```
+ */
+function ActionMenuRoot({ children }) {
+    return _jsx(Menu, { children: children });
+}
+function Trigger({ children, className, "aria-label": ariaLabel = "Actions", }) {
+    return (_jsx(MenuTrigger, { className: cn("inline-flex items-center justify-center rounded-md p-1", "text-muted-foreground hover:text-foreground hover:bg-accent", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "data-popup-open:bg-accent data-popup-open:text-foreground", className), "aria-label": ariaLabel, children: children }));
+}
+function Content({ children, align = "end", className }) {
+    return (_jsx(InternalMenuContent, { align: align, className: cn("min-w-44", className), children: children }));
+}
+function Item({ children, onSelect, icon, shortcut, variant = "default", disabled, className, }) {
+    return (_jsxs(InternalMenuItem, { variant: variant, disabled: disabled, onClick: onSelect, className: cn("justify-between", className), children: [_jsxs("span", { className: "flex items-center gap-2", children: [icon, _jsx("span", { children: children })] }), shortcut && (_jsx("kbd", { className: "ml-auto text-[11px] tracking-widest text-muted-foreground-subtle", children: shortcut }))] }));
+}
+function Separator({ className }) {
+    return _jsx(InternalMenuSeparator, { className: className });
+}
+function Group({ children, label, className }) {
+    return (_jsxs(InternalMenuGroup, { className: className, children: [label && _jsx(MenuLabel, { children: label }), children] }));
+}
+/**
+ * Public compound component for resource item action menus.
+ *
+ * Subcomponents:
+ * - `ActionMenu.Trigger` — the element that opens the menu
+ * - `ActionMenu.Content` — the menu panel container
+ * - `ActionMenu.Item` — a single action (with icon, shortcut, destructive variant)
+ * - `ActionMenu.Separator` — a visual divider between items/groups
+ * - `ActionMenu.Group` — a labeled section of items
+ */
+export const ActionMenu = Object.assign(ActionMenuRoot, {
+    Trigger,
+    Content,
+    Item,
+    Separator,
+    Group,
+});
+//# sourceMappingURL=ActionMenu.js.map

package/action-menu/ActionMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionMenu.js","sourceRoot":"","sources":["../../src/action-menu/ActionMenu.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACL,IAAI,EACJ,WAAW,EACX,WAAW,IAAI,mBAAmB,EAClC,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,IAAI,qBAAqB,EACtC,SAAS,IAAI,iBAAiB,EAC9B,SAAS,GACV,MAAM,kBAAkB,CAAC;AAU1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAS,cAAc,CAAC,EAAE,QAAQ,EAAmB;IACnD,OAAO,KAAC,IAAI,cAAE,QAAQ,GAAQ,CAAC;AACjC,CAAC;AAED,SAAS,OAAO,CAAC,EACf,QAAQ,EACR,SAAS,EACT,YAAY,EAAE,SAAS,GAAG,SAAS,GACZ;IACvB,OAAO,CACL,KAAC,WAAW,IACV,SAAS,EAAE,EAAE,CACX,wDAAwD,EACxD,6DAA6D,EAC7D,yEAAyE,EACzE,2DAA2D,EAC3D,SAAS,CACV,gBACW,SAAS,YAEpB,QAAQ,GACG,CACf,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,KAAK,EAAE,SAAS,EAA0B;IAC7E,OAAO,CACL,KAAC,mBAAmB,IAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,YACpE,QAAQ,GACW,CACvB,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,EACZ,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,OAAO,GAAG,SAAS,EACnB,QAAQ,EACR,SAAS,GACW;IACpB,OAAO,CACL,MAAC,gBAAgB,IACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,QAAQ,EACjB,SAAS,EAAE,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,aAE3C,gBAAM,SAAS,EAAC,yBAAyB,aACtC,IAAI,EACL,yBAAO,QAAQ,GAAQ,IAClB,EACN,QAAQ,IAAI,CACX,cAAK,SAAS,EAAC,kEAAkE,YAC9E,QAAQ,GACL,CACP,IACgB,CACpB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,EAAE,SAAS,EAA4B;IACxD,OAAO,KAAC,qBAAqB,IAAC,SAAS,EAAE,SAAS,GAAI,CAAC;AACzD,CAAC;AAED,SAAS,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAwB;IACjE,OAAO,CACL,MAAC,iBAAiB,IAAC,SAAS,EAAE,SAAS,aACpC,KAAK,IAAI,KAAC,SAAS,cAAE,KAAK,GAAa,EACvC,QAAQ,IACS,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE;IACtD,OAAO;IACP,OAAO;IACP,IAAI;IACJ,SAAS;IACT,KAAK;CACN,CAAC,CAAC"}

package/action-menu/index.d.ts

@@ -0,0 +1,3 @@
+export { ActionMenu } from "./ActionMenu";
+export type { ActionMenuProps, ActionMenuTriggerProps, ActionMenuContentProps, ActionMenuItemProps, ActionMenuSeparatorProps, ActionMenuGroupProps, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/action-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/action-menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/action-menu/index.js

@@ -0,0 +1,2 @@
+export { ActionMenu } from "./ActionMenu";
+//# sourceMappingURL=index.js.map

package/action-menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/action-menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/action-menu/types.d.ts

@@ -0,0 +1,65 @@
+import type { ReactNode } from "react";
+/** Props for the {@link ActionMenu} root. */
+export interface ActionMenuProps {
+    /** Menu content (Trigger + Content). */
+    readonly children: ReactNode;
+}
+/** Props for the `ActionMenu.Trigger` element. */
+export interface ActionMenuTriggerProps {
+    /** The trigger element (typically an icon button). */
+    readonly children: ReactNode;
+    /** Additional CSS classes for the trigger wrapper. */
+    readonly className?: string;
+    /** Accessible label for the trigger. @default "Actions" */
+    readonly "aria-label"?: string;
+}
+/** Props for the `ActionMenu.Content` panel. */
+export interface ActionMenuContentProps {
+    /** Menu items, groups, and separators. */
+    readonly children: ReactNode;
+    /**
+     * Horizontal alignment relative to the trigger.
+     * @default "end"
+     */
+    readonly align?: "start" | "center" | "end";
+    /** Additional CSS classes for the menu popup. */
+    readonly className?: string;
+}
+/** Props for the `ActionMenu.Item`. */
+export interface ActionMenuItemProps {
+    /** Item label text. */
+    readonly children: ReactNode;
+    /** Click handler. */
+    readonly onSelect?: () => void;
+    /** Optional icon rendered before the label. */
+    readonly icon?: ReactNode;
+    /** Optional keyboard shortcut hint rendered after the label. */
+    readonly shortcut?: string;
+    /**
+     * Visual variant.
+     * - `"default"` — standard item styling
+     * - `"destructive"` — red/danger styling for delete, remove, revoke actions
+     *
+     * @default "default"
+     */
+    readonly variant?: "default" | "destructive";
+    /** Whether the item is disabled. */
+    readonly disabled?: boolean;
+    /** Additional CSS classes. */
+    readonly className?: string;
+}
+/** Props for the `ActionMenu.Separator`. */
+export interface ActionMenuSeparatorProps {
+    /** Additional CSS classes. */
+    readonly className?: string;
+}
+/** Props for the `ActionMenu.Group`. */
+export interface ActionMenuGroupProps {
+    /** Group items. */
+    readonly children: ReactNode;
+    /** Optional label shown above the group. */
+    readonly label?: string;
+    /** Additional CSS classes. */
+    readonly className?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/action-menu/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/action-menu/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC5C,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IAC7C,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,4CAA4C;AAC5C,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/action-menu/types.js

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

package/action-menu/types.js.map

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

package/agent/AgentCreationWizard.d.ts

@@ -0,0 +1,55 @@
+import type { AgentWizardData } from "./steps/types";
+/** Result passed to `onComplete` after successful agent creation. */
+export interface AgentCreationResult {
+    /** Organization slug of the created agent. */
+    readonly org: string;
+    /** Agent slug (for URL construction). */
+    readonly slug: string;
+    /** Agent display name. */
+    readonly name: string;
+}
+/** Props for {@link AgentCreationWizard}. */
+export interface AgentCreationWizardProps {
+    /** Organization to create the agent in. */
+    readonly org: string;
+    /**
+     * Optional partial data to pre-fill the wizard with.
+     *
+     * Merged with defaults via `{ ...createInitialWizardData(), ...initialData }`.
+     * Use this for template-based creation, resource duplication, or any
+     * flow that starts the wizard with pre-populated fields.
+     */
+    readonly initialData?: Partial<AgentWizardData>;
+    /** Called after the agent is successfully created. */
+    readonly onComplete: (result: AgentCreationResult) => 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 agent blueprint.
+ *
+ * Three condensed steps:
+ * 1. **Identity & Instructions** — name, slug, description, visibility, system prompt
+ * 2. **Capabilities** — MCP servers + tools, skills, env var declarations (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
+ * <AgentCreationWizard
+ *   org="acme"
+ *   onComplete={({ org, slug }) => navigate(`/agents/${org}/${slug}`)}
+ *   onCancel={() => navigate("/agents")}
+ * />
+ * ```
+ */
+export declare function AgentCreationWizard({ org, initialData, onComplete, onCancel, className, }: AgentCreationWizardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AgentCreationWizard.d.ts.map

package/agent/AgentCreationWizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCreationWizard.d.ts","sourceRoot":"","sources":["../../src/agent/AgentCreationWizard.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAMrD,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC3D,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AA6BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,GAAG,EACH,WAAW,EACX,UAAU,EACV,QAAQ,EACR,SAAS,GACV,EAAE,wBAAwB,2CAgG1B"}

package/agent/AgentCreationWizard.js

@@ -0,0 +1,115 @@
+"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 { useCreateAgent } from "./useCreateAgent";
+import { IdentityStep } from "./steps/IdentityStep";
+import { CapabilitiesStep } from "./steps/CapabilitiesStep";
+import { ReviewStep, buildAgentInput } from "./steps/ReviewStep";
+import { createInitialWizardData } from "./steps/types";
+// ---------------------------------------------------------------------------
+// Step definitions
+// ---------------------------------------------------------------------------
+const STEPS = [
+    {
+        id: "identity",
+        label: "Identity & Instructions",
+        validate: (data) => {
+            if (!data.name.trim())
+                return "Name is required";
+            return null;
+        },
+    },
+    {
+        id: "capabilities",
+        label: "Capabilities",
+    },
+    {
+        id: "review",
+        label: "Review & Create",
+    },
+];
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+/**
+ * Multi-step wizard for creating a new agent blueprint.
+ *
+ * Three condensed steps:
+ * 1. **Identity & Instructions** — name, slug, description, visibility, system prompt
+ * 2. **Capabilities** — MCP servers + tools, skills, env var declarations (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
+ * <AgentCreationWizard
+ *   org="acme"
+ *   onComplete={({ org, slug }) => navigate(`/agents/${org}/${slug}`)}
+ *   onCancel={() => navigate("/agents")}
+ * />
+ * ```
+ */
+export function AgentCreationWizard({ org, initialData, onComplete, onCancel, className, }) {
+    const mergedInitialData = useMemo(() => ({ ...createInitialWizardData(), ...initialData }), 
+    // initialData is consumed once at mount — not reactive by design
+    [initialData]);
+    const wizard = useWizardState({
+        steps: STEPS,
+        initialData: mergedInitialData,
+    });
+    const { create, isCreating, error, clearError } = useCreateAgent();
+    const handleNext = useCallback(() => {
+        if (wizard.isLastStep) {
+            handleSubmit();
+        }
+        else {
+            clearError();
+            wizard.goNext();
+        }
+    }, [wizard.isLastStep, wizard.goNext, clearError]);
+    const handleSubmit = useCallback(async () => {
+        clearError();
+        const input = buildAgentInput(org, wizard.data);
+        try {
+            const agent = await create(input);
+            onComplete({
+                org: agent.metadata?.org ?? org,
+                slug: agent.metadata?.slug ?? input.slug ?? input.name,
+                name: agent.metadata?.name ?? input.name,
+            });
+        }
+        catch {
+            // Error is captured by useCreateAgent and displayed in ReviewStep
+        }
+    }, [org, wizard.data, create, clearError, onComplete]);
+    const currentStepContent = useMemo(() => {
+        switch (wizard.currentStep.id) {
+            case "identity":
+                return (_jsx(IdentityStep, { data: wizard.data, updateData: wizard.updateData, validationError: wizard.validationError }));
+            case "capabilities":
+                return (_jsx(CapabilitiesStep, { org: org, 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 agent", isSubmitting: isCreating, canGoNext: wizard.canGoNext, canGoBack: wizard.canGoBack, onNext: handleNext, onBack: wizard.goBack, onGoToStep: wizard.goToStep, onCancel: onCancel, className: className, children: currentStepContent }));
+}
+//# sourceMappingURL=AgentCreationWizard.js.map

package/agent/AgentCreationWizard.js.map

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

package/agent/AgentDetailView.d.ts

@@ -1,4 +1,5 @@
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import type { AdditionalTab, DetailAction } from "../resource-detail/types";
 /** Props for {@link AgentDetailView}. */
 export interface AgentDetailViewProps {
     /** Organization slug that owns the agent. */
@@ -44,17 +45,79 @@ export interface AgentDetailViewProps {
     readonly onVisibilityChange?: (v: ApiResourceVisibility) => void;
     /** `true` while a visibility update RPC is in flight. */
     readonly isVisibilityPending?: boolean;
+    /**
+     * Primary action rendered as a visible button in the header area.
+     * Typically "Edit" for agent detail pages.
+     */
+    readonly primaryAction?: DetailAction;
+    /**
+     * Secondary actions rendered in the kebab overflow menu.
+     * Typically: Copy ID, Copy slug, Export JSON, Duplicate, Delete.
+     */
+    readonly actions?: readonly DetailAction[];
+    /**
+     * Additional tabs to render alongside the built-in "Overview" tab.
+     * When provided (with at least one entry), a tab bar appears.
+     * When omitted or empty, no tab bar is shown (single-tab suppression).
+     *
+     * Each entry provides both the tab metadata and the content to render.
+     * The SDK manages the tab switching logic internally.
+     *
+     * @example
+     * ```tsx
+     * <AgentDetailView
+     *   org="acme"
+     *   slug="my-agent"
+     *   additionalTabs={[
+     *     { id: "dependencies", label: "Dependencies", content: <DependencyGraph /> },
+     *   ]}
+     * />
+     * ```
+     */
+    readonly additionalTabs?: readonly AdditionalTab[];
+    /**
+     * Controlled active tab ID. When provided together with `onTabChange`,
+     * the component operates in controlled mode — the consumer owns tab state.
+     * When omitted, the component manages its own internal tab state.
+     */
+    readonly activeTab?: string;
+    /**
+     * Controlled tab change handler. When provided together with `activeTab`,
+     * the component operates in controlled mode.
+     */
+    readonly onTabChange?: (tabId: string) => void;
+    /**
+     * Default active tab ID when in uncontrolled mode.
+     * @default "overview"
+     */
+    readonly defaultTab?: string;
+    /**
+     * When `true`, fields on the detail view become click-to-edit.
+     * Each field saves independently via `stigmer.agent.update()`.
+     * @default false
+     */
+    readonly editable?: boolean;
+    /**
+     * Called after a successful inline field save with the updated agent.
+     * Consumers can use this to refresh breadcrumbs, sync URL state, etc.
+     */
+    readonly onResourceUpdated?: (agent: import("@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb").Agent) => void;
     /** Additional CSS classes for the root container. */
     readonly className?: string;
 }
 /**
- * Read-only detail view for an Agent blueprint.
+ * Operational detail hub for an Agent blueprint.
  *
  * Fetches the agent via {@link useAgent} internally and renders its
- * full configuration in structured sections: header, instructions,
- * MCP server usages, skills, sub-agents, and environment variables.
- * Sections with no data are omitted entirely — reducing visual noise
- * per the aesthetic-minimalist design heuristic (Nielsen #8).
+ * full configuration inside a {@link ResourceDetailShell}: a
+ * standardized header with action bar, followed by structured content
+ * sections (instructions, MCP server usages, skills, sub-agents, and
+ * environment variables). Sections with no data are omitted entirely
+ * — reducing visual noise per Nielsen heuristic #8.
+ *
+ * The action bar transforms this from a read-only view into an
+ * operational hub. Actions are provided by the consumer via
+ * `primaryAction` and `actions` props.
  *
  * Handles loading, error, and not-found states automatically.
  * Zero Console dependencies — safe for platform builder embedding.
@@ -68,14 +131,19 @@ export interface AgentDetailViewProps {
  *
  * @example
  * ```tsx
- * // With cross-resource linking in a Console page
+ * // Operational hub with actions in a Console page
  * <AgentDetailView
  *   org={org}
  *   slug={slug}
- *   onMcpServerClick={({ org, slug }) => router.push(`/library/mcp-servers/${org}/${slug}`)}
- *   onSkillClick={({ org, slug }) => router.push(`/library/skills/${org}/${slug}`)}
+ *   primaryAction={{ id: "edit", label: "Edit", onAction: handleEdit }}
+ *   actions={[
+ *     { id: "copy-id", label: "Copy ID", onAction: () => copyId(id) },
+ *     { id: "delete", label: "Delete", variant: "destructive", onAction: handleDelete },
+ *   ]}
+ *   onMcpServerClick={({ org, slug }) => navigateToDetail("mcp-servers", org, slug)}
+ *   onSkillClick={({ org, slug }) => navigateToDetail("skills", org, slug)}
  * />
  * ```
  */
-export declare function AgentDetailView({ org, slug, onMcpServerClick, onSkillClick, onResourceLoad, onVisibilityChange, isVisibilityPending, className, }: AgentDetailViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AgentDetailView({ org, slug, onMcpServerClick, onSkillClick, onResourceLoad, onVisibilityChange, isVisibilityPending, primaryAction, actions, additionalTabs, activeTab, onTabChange, defaultTab, editable, onResourceUpdated, className, }: AgentDetailViewProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AgentDetailView.d.ts.map

package/agent/AgentDetailView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentDetailView.d.ts","sourceRoot":"","sources":["../../src/agent/AgentDetailView.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAO/F,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACzE;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACjE,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,IAAI,EACJ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,GACV,EAAE,oBAAoB,2CAgEtB"}
+{"version":3,"file":"AgentDetailView.d.ts","sourceRoot":"","sources":["../../src/agent/AgentDetailView.tsx"],"names":[],"mappings":"AAWA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAS/F,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAsB,MAAM,0BAA0B,CAAC;AAgBhG,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACzE;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrE;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACjE,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,oDAAoD,EAAE,KAAK,KAAK,IAAI,CAAC;IACjH,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,IAAI,EACJ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,OAAO,EACP,cAAc,EACd,SAAS,EACT,WAAW,EACX,UAAU,EACV,QAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,EAAE,oBAAoB,2CA2JtB"}