@stigmer/react 0.4.8 → 0.5.0

package/agent/useUpdateAgent.js

@@ -0,0 +1,35 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Mutation hook that updates an existing Agent resource.
+ *
+ * Wraps `stigmer.agent.update(input)` with loading and error state.
+ * The caller must provide a **complete** `AgentInput` — the backend
+ * performs full spec replacement. Use `agentToInput()` to reconstruct
+ * the input from a fetched agent, modify the desired field, and pass
+ * the result here.
+ */
+export function useUpdateAgent() {
+    const stigmer = useStigmer();
+    const [isUpdating, setIsUpdating] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const update = useCallback(async (input) => {
+        setIsUpdating(true);
+        setError(null);
+        try {
+            return await stigmer.agent.update(input);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsUpdating(false);
+        }
+    }, [stigmer]);
+    return { update, isUpdating, error, clearError };
+}
+//# sourceMappingURL=useUpdateAgent.js.map

package/agent/useUpdateAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateAgent.js","sourceRoot":"","sources":["../../src/agent/useUpdateAgent.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAc9C;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAiB,EAAkB,EAAE;QAC1C,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/dependency-graph/DependencyGraph.d.ts

@@ -0,0 +1,37 @@
+import type { DependencyGraphProps } from "./types";
+/**
+ * Accessible CSS-based tree visualization of an agent's dependencies.
+ *
+ * Renders `MCP Servers`, `Skills`, and `Sub-Agents` (with recursive
+ * sub-agent children) as a nested tree with visual connector lines.
+ * The root node represents the agent itself.
+ *
+ * Implements the WAI-ARIA TreeView pattern:
+ * - `role="tree"` on the root list
+ * - `role="treeitem"` on each node (via {@link DependencyTreeNode})
+ * - Arrow-key navigation between visible nodes (roving tabindex)
+ * - `Home`/`End` to jump to first/last visible node
+ *
+ * All visual properties flow through `--stgm-*` design tokens.
+ * Zero Console dependencies — safe for platform builder embedding.
+ *
+ * @example
+ * ```tsx
+ * const { tree } = useDependencyGraph({
+ *   agentName: "pr-review-agent",
+ *   agentOrg: "acme",
+ *   spec: agent.spec,
+ * });
+ *
+ * {tree && (
+ *   <DependencyGraph
+ *     tree={tree}
+ *     onNodeClick={(node) => {
+ *       if (node.kind === "mcp-server") navigateTo(`/mcp-servers/${node.ref!.slug}`);
+ *     }}
+ *   />
+ * )}
+ * ```
+ */
+export declare function DependencyGraph({ tree, onNodeClick, defaultExpanded, className, }: DependencyGraphProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DependencyGraph.d.ts.map

package/dependency-graph/DependencyGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyGraph.d.ts","sourceRoot":"","sources":["../../src/dependency-graph/DependencyGraph.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,WAAW,EACX,eAAsB,EACtB,SAAS,GACV,EAAE,oBAAoB,2CAiFtB"}

package/dependency-graph/DependencyGraph.js

@@ -0,0 +1,88 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useRef } from "react";
+import { cn } from "@stigmer/theme";
+import { DependencyTreeNode } from "./DependencyTreeNode";
+/**
+ * Accessible CSS-based tree visualization of an agent's dependencies.
+ *
+ * Renders `MCP Servers`, `Skills`, and `Sub-Agents` (with recursive
+ * sub-agent children) as a nested tree with visual connector lines.
+ * The root node represents the agent itself.
+ *
+ * Implements the WAI-ARIA TreeView pattern:
+ * - `role="tree"` on the root list
+ * - `role="treeitem"` on each node (via {@link DependencyTreeNode})
+ * - Arrow-key navigation between visible nodes (roving tabindex)
+ * - `Home`/`End` to jump to first/last visible node
+ *
+ * All visual properties flow through `--stgm-*` design tokens.
+ * Zero Console dependencies — safe for platform builder embedding.
+ *
+ * @example
+ * ```tsx
+ * const { tree } = useDependencyGraph({
+ *   agentName: "pr-review-agent",
+ *   agentOrg: "acme",
+ *   spec: agent.spec,
+ * });
+ *
+ * {tree && (
+ *   <DependencyGraph
+ *     tree={tree}
+ *     onNodeClick={(node) => {
+ *       if (node.kind === "mcp-server") navigateTo(`/mcp-servers/${node.ref!.slug}`);
+ *     }}
+ *   />
+ * )}
+ * ```
+ */
+export function DependencyGraph({ tree, onNodeClick, defaultExpanded = true, className, }) {
+    const treeRef = useRef(null);
+    const handleKeyDown = useCallback((e) => {
+        const container = treeRef.current;
+        if (!container)
+            return;
+        const items = Array.from(container.querySelectorAll("[role='treeitem'] > button, [role='treeitem'] > div")).filter((el) => {
+            let parent = el.closest("[role='treeitem']")?.parentElement?.closest("[role='treeitem']");
+            while (parent) {
+                if (parent.getAttribute("aria-expanded") === "false")
+                    return false;
+                parent = parent.parentElement?.closest("[role='treeitem']");
+            }
+            return true;
+        });
+        if (items.length === 0)
+            return;
+        const activeEl = document.activeElement;
+        const currentIndex = activeEl ? items.indexOf(activeEl) : -1;
+        let nextIndex = null;
+        switch (e.key) {
+            case "ArrowDown":
+                nextIndex = currentIndex < items.length - 1 ? currentIndex + 1 : 0;
+                break;
+            case "ArrowUp":
+                nextIndex = currentIndex > 0 ? currentIndex - 1 : items.length - 1;
+                break;
+            case "Home":
+                nextIndex = 0;
+                break;
+            case "End":
+                nextIndex = items.length - 1;
+                break;
+            default:
+                return;
+        }
+        e.preventDefault();
+        items[nextIndex].focus();
+    }, []);
+    const { root } = tree;
+    return (_jsxs("div", { className: cn("py-2", className), children: [_jsxs("div", { className: "mb-3 flex items-center gap-2 px-2", children: [_jsx(TreeIcon, { className: "size-4 text-muted-foreground" }), _jsx("h3", { className: "text-xs font-medium uppercase tracking-wider text-muted-foreground", children: "Dependency Tree" }), _jsxs("span", { className: "text-xs text-muted-foreground", children: [tree.nodeCount, " ", tree.nodeCount === 1 ? "node" : "nodes"] })] }), _jsx("ul", { ref: treeRef, role: "tree", "aria-label": `Dependencies of ${root.label}`, onKeyDown: handleKeyDown, className: "rounded-lg border border-border p-2", children: _jsx(DependencyTreeNode, { node: root, depth: 0, onNodeClick: onNodeClick, defaultExpanded: defaultExpanded }) })] }));
+}
+// ---------------------------------------------------------------------------
+// Header icon
+// ---------------------------------------------------------------------------
+function TreeIcon({ className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M8 2v4M8 6 4 10M8 6l4 4" }), _jsx("circle", { cx: "8", cy: "2", r: "1", fill: "currentColor", stroke: "none" }), _jsx("circle", { cx: "4", cy: "11", r: "1.5" }), _jsx("circle", { cx: "8", cy: "11", r: "1.5" }), _jsx("circle", { cx: "12", cy: "11", r: "1.5" })] }));
+}
+//# sourceMappingURL=DependencyGraph.js.map

package/dependency-graph/DependencyGraph.js.map

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

package/dependency-graph/DependencyTreeNode.d.ts

@@ -0,0 +1,23 @@
+import type { DependencyNode } from "./types";
+interface DependencyTreeNodeProps {
+    readonly node: DependencyNode;
+    readonly depth: number;
+    readonly onNodeClick?: (node: DependencyNode) => void;
+    readonly defaultExpanded: boolean;
+}
+/**
+ * Renders a single node in the dependency tree: icon, kind badge,
+ * label, metadata, and (for expandable nodes) an expand/collapse
+ * chevron with nested children.
+ *
+ * Leaf nodes (MCP servers, skills) with a `ref` are clickable —
+ * firing `onNodeClick` for consumer-wired navigation.
+ *
+ * Sub-agent nodes are collapsible containers, and the root agent
+ * node always renders its children expanded. Both recurse using
+ * the same component, keeping the ARIA tree structure correct
+ * (`<li role="treeitem">` wrapping a nested `<ul role="group">`).
+ */
+export declare function DependencyTreeNode({ node, depth, onNodeClick, defaultExpanded, }: DependencyTreeNodeProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DependencyTreeNode.d.ts.map

package/dependency-graph/DependencyTreeNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyTreeNode.d.ts","sourceRoot":"","sources":["../../src/dependency-graph/DependencyTreeNode.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,SAAS,CAAC;AAExD,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,KAAK,EACL,WAAW,EACX,eAAe,GAChB,EAAE,uBAAuB,2CAmIzB"}

package/dependency-graph/DependencyTreeNode.js

@@ -0,0 +1,99 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { cn } from "@stigmer/theme";
+const KIND_LABELS = {
+    agent: "Agent",
+    "mcp-server": "MCP",
+    skill: "Skill",
+    "sub-agent": "Sub-Agent",
+};
+/**
+ * Renders a single node in the dependency tree: icon, kind badge,
+ * label, metadata, and (for expandable nodes) an expand/collapse
+ * chevron with nested children.
+ *
+ * Leaf nodes (MCP servers, skills) with a `ref` are clickable —
+ * firing `onNodeClick` for consumer-wired navigation.
+ *
+ * Sub-agent nodes are collapsible containers, and the root agent
+ * node always renders its children expanded. Both recurse using
+ * the same component, keeping the ARIA tree structure correct
+ * (`<li role="treeitem">` wrapping a nested `<ul role="group">`).
+ */
+export function DependencyTreeNode({ node, depth, onNodeClick, defaultExpanded, }) {
+    const hasChildren = node.children.length > 0;
+    const isRoot = node.kind === "agent";
+    const isCollapsible = node.kind === "sub-agent" && hasChildren;
+    const isAlwaysExpanded = isRoot && hasChildren;
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    const isNavigable = node.ref != null && onNodeClick != null;
+    const showChildren = isAlwaysExpanded || (isCollapsible && expanded);
+    const handleClick = useCallback(() => {
+        if (isCollapsible) {
+            setExpanded((v) => !v);
+        }
+        else if (isNavigable) {
+            onNodeClick(node);
+        }
+    }, [isCollapsible, isNavigable, onNodeClick, node]);
+    const handleKeyDown = useCallback((e) => {
+        if (!isCollapsible)
+            return;
+        if (e.key === "ArrowRight" && !expanded) {
+            e.preventDefault();
+            setExpanded(true);
+        }
+        else if (e.key === "ArrowLeft" && expanded) {
+            e.preventDefault();
+            setExpanded(false);
+        }
+    }, [isCollapsible, expanded]);
+    const content = (_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [isCollapsible && (_jsx(ChevronIcon, { className: cn("size-3.5 shrink-0 text-muted-foreground transition-transform", expanded && "rotate-90") })), _jsx(NodeIcon, { kind: node.kind, className: "size-4 shrink-0 text-muted-foreground" }), !isRoot && (_jsx("span", { className: cn("shrink-0 rounded px-1.5 py-px text-[10px] font-medium leading-tight", kindBadgeClasses(node.kind)), children: KIND_LABELS[node.kind] })), _jsx("span", { className: "min-w-0 truncate text-sm font-medium text-foreground", children: node.qualifiedLabel ?? node.label }), node.metadata &&
+                Object.entries(node.metadata).map(([key, value]) => (_jsx("span", { className: "shrink-0 text-xs text-muted-foreground", children: value }, key)))] }));
+    const isInteractive = isCollapsible || isNavigable;
+    const isChild = depth > 0;
+    return (_jsxs("li", { role: "treeitem", "aria-expanded": isCollapsible ? expanded : isAlwaysExpanded ? true : undefined, className: cn("list-none", isChild && "relative before:absolute before:left-[-12px] before:top-[14px] before:h-px before:w-3 before:bg-border before:content-['']"), children: [isInteractive ? (_jsx("button", { type: "button", onClick: handleClick, onKeyDown: handleKeyDown, tabIndex: -1, className: cn("flex w-full items-center rounded-md px-2 py-1.5 text-left transition-colors", "hover:bg-accent-hover", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring"), children: content })) : (_jsx("div", { className: "flex items-center px-2 py-1.5", children: content })), node.description && !isRoot && (_jsx("p", { className: cn("px-2 pb-1 text-xs text-muted-foreground", isCollapsible ? "ml-[calc(0.5rem+14px+0.5rem)]" : "ml-2"), children: node.description })), showChildren && (_jsx("ul", { role: "group", className: "relative ml-[11px] border-l border-border pl-3", children: node.children.map((child) => (_jsx(DependencyTreeNode, { node: child, depth: depth + 1, onNodeClick: onNodeClick, defaultExpanded: defaultExpanded }, child.id))) }))] }));
+}
+// ---------------------------------------------------------------------------
+// Kind badge styling — uses --stgm-* tokens, no hardcoded colors
+// ---------------------------------------------------------------------------
+function kindBadgeClasses(kind) {
+    switch (kind) {
+        case "mcp-server":
+            return "bg-[var(--stgm-status-running-subtle)] text-[var(--stgm-status-running)]";
+        case "skill":
+            return "bg-[var(--stgm-status-pending-subtle)] text-[var(--stgm-status-pending)]";
+        case "sub-agent":
+            return "bg-[var(--stgm-status-ready-subtle)] text-[var(--stgm-status-ready)]";
+        case "agent":
+            return "bg-muted text-muted-foreground";
+    }
+}
+// ---------------------------------------------------------------------------
+// Icons — inline SVGs, consistent with AgentDetailView pattern
+// ---------------------------------------------------------------------------
+function NodeIcon({ kind, className, }) {
+    switch (kind) {
+        case "agent":
+        case "sub-agent":
+            return _jsx(AgentIcon, { className: className });
+        case "mcp-server":
+            return _jsx(McpServerIcon, { className: className });
+        case "skill":
+            return _jsx(SkillIcon, { className: className });
+    }
+}
+function AgentIcon({ className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "3", y: "5", width: "10", height: "8", rx: "1.5" }), _jsx("path", { d: "M6 9h.01M10 9h.01", strokeWidth: "2" }), _jsx("path", { d: "M8 2v3" })] }));
+}
+function McpServerIcon({ className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "2", y: "2", width: "12", height: "5", rx: "1" }), _jsx("rect", { x: "2", y: "9", width: "12", height: "5", rx: "1" }), _jsx("circle", { cx: "5", cy: "4.5", r: "0.75", fill: "currentColor", stroke: "none" }), _jsx("circle", { cx: "5", cy: "11.5", r: "0.75", fill: "currentColor", stroke: "none" })] }));
+}
+function SkillIcon({ className }) {
+    return (_jsx("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M9 1.5 4 9h4l-1 5.5L12 7H8l1-5.5Z" }) }));
+}
+function ChevronIcon({ className }) {
+    return (_jsx("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m6 3 5 5-5 5" }) }));
+}
+//# sourceMappingURL=DependencyTreeNode.js.map

package/dependency-graph/DependencyTreeNode.js.map

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

package/dependency-graph/index.d.ts

@@ -0,0 +1,4 @@
+export type { NodeKind, DependencyNode, DependencyTree, DependencyGraphProps, UseDependencyGraphOptions, UseDependencyGraphReturn, } from "./types";
+export { useDependencyGraph } from "./useDependencyGraph";
+export { DependencyGraph } from "./DependencyGraph";
+//# sourceMappingURL=index.d.ts.map

package/dependency-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dependency-graph/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dependency-graph/index.js

@@ -0,0 +1,5 @@
+// Hooks
+export { useDependencyGraph } from "./useDependencyGraph";
+// Components
+export { DependencyGraph } from "./DependencyGraph";
+//# sourceMappingURL=index.js.map

package/dependency-graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dependency-graph/index.ts"],"names":[],"mappings":"AAUA,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dependency-graph/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Resource kind in a dependency tree.
+ *
+ * - `"agent"` — the root agent (always the tree root)
+ * - `"mcp-server"` — an MCP server referenced via `mcpServerUsages` or `mcpAccess`
+ * - `"skill"` — a skill referenced via `skillRefs`
+ * - `"sub-agent"` — an inline sub-agent definition with its own dependencies
+ */
+export type NodeKind = "agent" | "mcp-server" | "skill" | "sub-agent";
+/**
+ * A single node in the agent dependency tree.
+ *
+ * The tree is recursive: sub-agent nodes contain their own children
+ * (MCP servers and skills they access). Edges are implicit in the
+ * parent-child relationship — no separate edge type is needed.
+ *
+ * Nodes are navigable when `ref` is defined (MCP servers, skills).
+ * Sub-agent nodes have no `ref` because they are inline definitions
+ * within the agent spec, not standalone resources.
+ */
+export interface DependencyNode {
+    /**
+     * Deterministic identifier. Format: `{kind}:{slug}` for referenced
+     * resources, `sub-agent:{name}` for sub-agents, or `agent:{slug}`
+     * for the root.
+     */
+    readonly id: string;
+    /** What kind of resource this node represents. */
+    readonly kind: NodeKind;
+    /** Primary display label (slug for resources, name for sub-agents). */
+    readonly label: string;
+    /**
+     * Qualified label shown when the resource belongs to a different org
+     * than the agent (e.g., `"other-org/shared-server"`). Undefined when
+     * the resource is in the same org as the parent agent.
+     */
+    readonly qualifiedLabel?: string;
+    /** Short description (sub-agent description, if available). */
+    readonly description?: string;
+    /**
+     * Key-value metadata displayed as secondary info.
+     * Examples: `{ tools: "3 tools" }`, `{ model: "gpt-4" }`.
+     */
+    readonly metadata?: Readonly<Record<string, string>>;
+    /** Child nodes. Empty array for leaf nodes (MCP servers, skills). */
+    readonly children: readonly DependencyNode[];
+    /**
+     * Navigation reference for clickable nodes. Defined for MCP servers
+     * and skills (standalone resources). Undefined for sub-agents (inline
+     * definitions) and the root agent.
+     */
+    readonly ref?: {
+        readonly org: string;
+        readonly slug: string;
+    };
+}
+/**
+ * Complete dependency tree for an agent, rooted at the agent itself.
+ */
+export interface DependencyTree {
+    /** The agent node with all dependencies as descendants. */
+    readonly root: DependencyNode;
+    /** Total number of nodes in the tree (including root). */
+    readonly nodeCount: number;
+}
+/** Props for {@link DependencyGraph}. */
+export interface DependencyGraphProps {
+    /** The dependency tree to render. */
+    readonly tree: DependencyTree;
+    /**
+     * Called when a navigable node is clicked. The `node.ref` field
+     * contains the `org` and `slug` for routing. Only fired for nodes
+     * where `ref` is defined (MCP servers, skills).
+     */
+    readonly onNodeClick?: (node: DependencyNode) => void;
+    /**
+     * Whether sub-agent subtrees start expanded.
+     * @default true
+     */
+    readonly defaultExpanded?: boolean;
+    /** Additional CSS classes for the root container. */
+    readonly className?: string;
+}
+/** Options for {@link useDependencyGraph}. */
+export interface UseDependencyGraphOptions {
+    /** Display name of the agent (used as the root node label). */
+    readonly agentName: string;
+    /** Organization slug of the agent (used for cross-org label detection). */
+    readonly agentOrg: string;
+    /**
+     * The agent's spec containing dependency references.
+     * Pass `undefined` while the agent is loading — the hook returns
+     * `null` for `tree` and `true` for `isEmpty`.
+     */
+    readonly spec: {
+        readonly mcpServerUsages: readonly {
+            readonly mcpServerRef?: {
+                readonly org: string;
+                readonly slug: string;
+            };
+            readonly enabledTools: readonly string[];
+            readonly toolApprovalOverrides: readonly unknown[];
+        }[];
+        readonly skillRefs: readonly {
+            readonly org: string;
+            readonly slug: string;
+        }[];
+        readonly subAgents: readonly {
+            readonly name: string;
+            readonly description: string;
+            readonly mcpAccess: readonly {
+                readonly mcpServer: string;
+                readonly enabledTools: readonly string[];
+            }[];
+            readonly skillRefs: readonly {
+                readonly org: string;
+                readonly slug: string;
+            }[];
+            readonly modelOverride: string;
+        }[];
+    } | undefined;
+}
+/** Return value of {@link useDependencyGraph}. */
+export interface UseDependencyGraphReturn {
+    /** The computed tree, or `null` when spec is undefined. */
+    readonly tree: DependencyTree | null;
+    /** `true` when the agent has zero dependencies (or spec is undefined). */
+    readonly isEmpty: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dependency-graph/types.d.ts.map

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

package/dependency-graph/types.js

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

package/dependency-graph/types.js.map

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

package/dependency-graph/useDependencyGraph.d.ts

@@ -0,0 +1,27 @@
+import type { UseDependencyGraphOptions, UseDependencyGraphReturn } from "./types";
+/**
+ * Pure transformation hook that converts an `AgentSpec` into a
+ * {@link DependencyTree} for rendering.
+ *
+ * No data fetching, no side effects — the tree is computed entirely
+ * from the spec fields already available via {@link useAgent}. The
+ * result is memoized and only recomputes when the spec reference
+ * changes.
+ *
+ * Returns `null` for `tree` when `spec` is `undefined` (loading state).
+ *
+ * @example
+ * ```tsx
+ * const { tree, isEmpty } = useDependencyGraph({
+ *   agentName: agent.metadata.name,
+ *   agentOrg: agent.metadata.org,
+ *   spec: agent.spec,
+ * });
+ *
+ * if (!isEmpty && tree) {
+ *   return <DependencyGraph tree={tree} onNodeClick={handleClick} />;
+ * }
+ * ```
+ */
+export declare function useDependencyGraph({ agentName, agentOrg, spec, }: UseDependencyGraphOptions): UseDependencyGraphReturn;
+//# sourceMappingURL=useDependencyGraph.d.ts.map

package/dependency-graph/useDependencyGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDependencyGraph.d.ts","sourceRoot":"","sources":["../../src/dependency-graph/useDependencyGraph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,SAAS,EACT,QAAQ,EACR,IAAI,GACL,EAAE,yBAAyB,GAAG,wBAAwB,CAuHtD"}

package/dependency-graph/useDependencyGraph.js

@@ -0,0 +1,129 @@
+"use client";
+import { useMemo } from "react";
+/**
+ * Pure transformation hook that converts an `AgentSpec` into a
+ * {@link DependencyTree} for rendering.
+ *
+ * No data fetching, no side effects — the tree is computed entirely
+ * from the spec fields already available via {@link useAgent}. The
+ * result is memoized and only recomputes when the spec reference
+ * changes.
+ *
+ * Returns `null` for `tree` when `spec` is `undefined` (loading state).
+ *
+ * @example
+ * ```tsx
+ * const { tree, isEmpty } = useDependencyGraph({
+ *   agentName: agent.metadata.name,
+ *   agentOrg: agent.metadata.org,
+ *   spec: agent.spec,
+ * });
+ *
+ * if (!isEmpty && tree) {
+ *   return <DependencyGraph tree={tree} onNodeClick={handleClick} />;
+ * }
+ * ```
+ */
+export function useDependencyGraph({ agentName, agentOrg, spec, }) {
+    return useMemo(() => {
+        if (!spec)
+            return { tree: null, isEmpty: true };
+        const { mcpServerUsages, skillRefs, subAgents } = spec;
+        const hasDeps = mcpServerUsages.length > 0 ||
+            skillRefs.length > 0 ||
+            subAgents.length > 0;
+        if (!hasDeps)
+            return { tree: null, isEmpty: true };
+        let nodeCount = 1; // root
+        const mcpNodes = mcpServerUsages
+            .filter((u) => u.mcpServerRef)
+            .map((usage) => {
+            nodeCount++;
+            const ref = usage.mcpServerRef;
+            const toolCount = usage.enabledTools.length;
+            return {
+                id: `mcp-server:${ref.slug}`,
+                kind: "mcp-server",
+                label: ref.slug,
+                qualifiedLabel: ref.org && ref.org !== agentOrg
+                    ? `${ref.org}/${ref.slug}`
+                    : undefined,
+                metadata: {
+                    tools: toolCount > 0
+                        ? `${toolCount} ${toolCount === 1 ? "tool" : "tools"}`
+                        : "all tools",
+                },
+                children: [],
+                ref: { org: ref.org || agentOrg, slug: ref.slug },
+            };
+        });
+        const skillNodes = skillRefs.map((ref) => {
+            nodeCount++;
+            return {
+                id: `skill:${ref.slug}`,
+                kind: "skill",
+                label: ref.slug,
+                qualifiedLabel: ref.org && ref.org !== agentOrg
+                    ? `${ref.org}/${ref.slug}`
+                    : undefined,
+                children: [],
+                ref: { org: ref.org || agentOrg, slug: ref.slug },
+            };
+        });
+        const subAgentNodes = subAgents.map((sa) => {
+            nodeCount++;
+            const saMcpNodes = sa.mcpAccess.map((access) => {
+                nodeCount++;
+                const toolCount = access.enabledTools.length;
+                return {
+                    id: `sub-agent:${sa.name}:mcp-server:${access.mcpServer}`,
+                    kind: "mcp-server",
+                    label: access.mcpServer,
+                    metadata: {
+                        tools: toolCount > 0
+                            ? `${toolCount} ${toolCount === 1 ? "tool" : "tools"}`
+                            : "all tools",
+                    },
+                    children: [],
+                    ref: { org: agentOrg, slug: access.mcpServer },
+                };
+            });
+            const saSkillNodes = sa.skillRefs.map((ref) => {
+                nodeCount++;
+                return {
+                    id: `sub-agent:${sa.name}:skill:${ref.slug}`,
+                    kind: "skill",
+                    label: ref.slug,
+                    qualifiedLabel: ref.org && ref.org !== agentOrg
+                        ? `${ref.org}/${ref.slug}`
+                        : undefined,
+                    children: [],
+                    ref: { org: ref.org || agentOrg, slug: ref.slug },
+                };
+            });
+            const metadata = {};
+            if (sa.modelOverride) {
+                metadata.model = sa.modelOverride;
+            }
+            return {
+                id: `sub-agent:${sa.name}`,
+                kind: "sub-agent",
+                label: sa.name,
+                description: sa.description || undefined,
+                metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+                children: [...saMcpNodes, ...saSkillNodes],
+            };
+        });
+        const root = {
+            id: `agent:${agentName}`,
+            kind: "agent",
+            label: agentName,
+            children: [...mcpNodes, ...skillNodes, ...subAgentNodes],
+        };
+        return {
+            tree: { root, nodeCount },
+            isEmpty: false,
+        };
+    }, [agentName, agentOrg, spec]);
+}
+//# sourceMappingURL=useDependencyGraph.js.map