@stigmer/react 0.0.36 → 0.0.40

package/execution/ApprovalCard.js

@@ -0,0 +1,192 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { cn } from "@stigmer/theme";
+import { resolveToolCategory, extractPrimaryArgFromPreview, } from "./tool-categories";
+import { FilePathLink } from "./FilePathLink";
+const TRUNCATION_LINE_LIMIT = 8;
+/**
+ * Renders a pending tool-call approval request as a prominent card
+ * with Approve, Skip, and Reject action buttons.
+ *
+ * Tool-type-aware: shell tools render the command in a terminal-style
+ * block, file tools show the path prominently, and destructive tools
+ * (delete) use warning styling. Falls back to generic JSON args
+ * display for unrecognized tools.
+ *
+ * @example
+ * ```tsx
+ * <ApprovalCard
+ *   pendingApproval={approval}
+ *   onSubmit={(action) => submitApproval(executionId, approval.toolCallId, action)}
+ *   isSubmitting={submittingIds.has(approval.toolCallId)}
+ * />
+ * ```
+ */
+export function ApprovalCard({ pendingApproval, onSubmit, isSubmitting = false, className, }) {
+    const [activeAction, setActiveAction] = useState(null);
+    const handleAction = useCallback((action) => {
+        setActiveAction(action);
+        onSubmit(action);
+    }, [onSubmit]);
+    useEffect(() => {
+        if (!isSubmitting) {
+            setActiveAction(null);
+        }
+    }, [isSubmitting]);
+    const categoryInfo = resolveToolCategory(pendingApproval.toolName);
+    const primaryArg = extractPrimaryArgFromPreview(pendingApproval.toolName, pendingApproval.argsPreview);
+    const { header, headerIcon, borderClass } = getApprovalHeader(categoryInfo.category, pendingApproval.fromSubAgent);
+    return (_jsxs("div", { role: "alert", "aria-label": `Approval required for ${pendingApproval.toolName}`, className: cn("rounded-lg border px-4 py-3", borderClass, className), children: [_jsxs("div", { className: "flex items-center gap-2 text-sm font-medium text-warning", children: [headerIcon, _jsx("span", { children: header })] }), pendingApproval.fromSubAgent && pendingApproval.subAgentName && (_jsxs("p", { className: "mt-1.5 text-xs text-muted-foreground", children: ["Sub-agent", " ", _jsx("span", { className: "font-medium text-foreground", children: pendingApproval.subAgentName }), " ", "wants to execute a tool"] })), _jsxs("div", { className: "mt-2 flex items-center gap-2", children: [_jsx("span", { className: "rounded bg-muted px-1.5 py-0.5 font-mono text-xs text-foreground", children: categoryInfo.label }), _jsx(WaitingDuration, { requestedAt: pendingApproval.requestedAt })] }), pendingApproval.message && (_jsx("p", { className: "mt-2 text-sm text-foreground", children: pendingApproval.message })), _jsx("div", { className: "mt-2", children: _jsx(CategoryArgsPreview, { category: categoryInfo.category, primaryArg: primaryArg, argsPreview: pendingApproval.argsPreview }) }), _jsxs("div", { className: "mt-3 flex items-center gap-2", children: [_jsx(ActionButton, { label: "Approve", action: ApprovalAction.APPROVE, activeAction: activeAction, isSubmitting: isSubmitting, onClick: handleAction, variant: "approve" }), _jsx(ActionButton, { label: "Skip", action: ApprovalAction.SKIP, activeAction: activeAction, isSubmitting: isSubmitting, onClick: handleAction, variant: "skip" }), _jsx(ActionButton, { label: "Reject", action: ApprovalAction.REJECT, activeAction: activeAction, isSubmitting: isSubmitting, onClick: handleAction, variant: "reject" })] })] }));
+}
+// ---------------------------------------------------------------------------
+// Category-aware header
+// ---------------------------------------------------------------------------
+function getApprovalHeader(category, fromSubAgent) {
+    if (fromSubAgent) {
+        return {
+            header: "Sub-agent approval required",
+            headerIcon: _jsx(ShieldIcon, {}),
+            borderClass: "border-warning/30 bg-warning/5",
+        };
+    }
+    switch (category) {
+        case "shell":
+            return {
+                header: "Execute command",
+                headerIcon: _jsx(TerminalApprovalIcon, {}),
+                borderClass: "border-warning/30 bg-warning/5",
+            };
+        case "delete":
+            return {
+                header: "Delete file",
+                headerIcon: _jsx(ShieldIcon, {}),
+                borderClass: "border-destructive/30 bg-destructive/5",
+            };
+        default:
+            return {
+                header: "Approval required",
+                headerIcon: _jsx(ShieldIcon, {}),
+                borderClass: "border-warning/30 bg-warning/5",
+            };
+    }
+}
+// ---------------------------------------------------------------------------
+// Category-specific args preview
+// ---------------------------------------------------------------------------
+function CategoryArgsPreview({ category, primaryArg, argsPreview, }) {
+    if (category === "shell" && primaryArg) {
+        return _jsx(ShellArgsPreview, { command: primaryArg });
+    }
+    if ((category === "read" || category === "write" || category === "edit" || category === "delete") && primaryArg) {
+        return _jsx(FileArgsPreview, { path: primaryArg, argsPreview: argsPreview });
+    }
+    if ((category === "search" || category === "list") && primaryArg) {
+        return _jsx(SearchArgsPreview, { pattern: primaryArg });
+    }
+    if (!argsPreview)
+        return null;
+    return _jsx(GenericArgsPreview, { content: argsPreview });
+}
+function ShellArgsPreview({ command }) {
+    return (_jsx("div", { className: "rounded-md border border-border bg-[var(--stgm-terminal-bg,#1a1a2e)] p-2.5", children: _jsxs("pre", { className: "whitespace-pre-wrap break-words font-mono text-xs text-[var(--stgm-terminal-fg,#e0e0e0)]", children: [_jsx("span", { className: "select-none text-[var(--stgm-terminal-prompt,#6b7280)]", children: "$ " }), command] }) }));
+}
+function FileArgsPreview({ path, argsPreview, }) {
+    return (_jsxs("div", { className: "space-y-1.5", children: [_jsxs("div", { className: "flex items-center gap-1.5 text-xs", children: [_jsx(FilePathIcon, {}), _jsx(FilePathLink, { path: path, className: "text-xs" })] }), argsPreview && _jsx(GenericArgsPreview, { content: argsPreview })] }));
+}
+function SearchArgsPreview({ pattern }) {
+    return (_jsxs("div", { className: "flex items-center gap-1.5 text-xs", children: [_jsx("span", { className: "text-muted-foreground", children: "Pattern:" }), _jsx("code", { className: "rounded bg-muted px-1.5 py-0.5 font-mono text-foreground", children: pattern })] }));
+}
+function GenericArgsPreview({ content }) {
+    const formatted = useMemo(() => {
+        try {
+            const parsed = JSON.parse(content);
+            return JSON.stringify(parsed, null, 2);
+        }
+        catch {
+            return content;
+        }
+    }, [content]);
+    const lines = formatted.split("\n");
+    const needsTruncation = lines.length > TRUNCATION_LINE_LIMIT;
+    const [isExpanded, setIsExpanded] = useState(false);
+    const displayContent = needsTruncation && !isExpanded
+        ? lines.slice(0, TRUNCATION_LINE_LIMIT).join("\n") + "\n\u2026"
+        : formatted;
+    return (_jsxs("div", { className: "space-y-1", children: [_jsx("span", { className: "text-xs font-medium text-muted-foreground", children: "Arguments" }), _jsx("pre", { className: "max-h-48 overflow-auto whitespace-pre-wrap break-words rounded-md border border-border bg-muted/40 p-2 font-mono text-xs text-foreground", children: displayContent }), needsTruncation && (_jsx("button", { type: "button", onClick: () => setIsExpanded((v) => !v), className: "text-xs font-medium text-primary transition-colors hover:text-primary/80", children: isExpanded ? "Show less" : `Show all ${lines.length} lines` }))] }));
+}
+// ---------------------------------------------------------------------------
+// Internal sub-components
+// ---------------------------------------------------------------------------
+function ActionButton({ label, action, activeAction, isSubmitting, onClick, variant, }) {
+    const isActive = activeAction === action;
+    const disabled = isSubmitting;
+    const variantClasses = {
+        approve: cn("bg-success text-success-foreground hover:bg-success/90", "disabled:bg-success/50 disabled:text-success-foreground/70"),
+        skip: cn("border border-border bg-background text-muted-foreground hover:bg-muted hover:text-foreground", "disabled:bg-muted/30 disabled:text-muted-foreground/50"),
+        reject: cn("bg-destructive text-destructive-foreground hover:bg-destructive/90", "disabled:bg-destructive/50 disabled:text-destructive-foreground/70"),
+    };
+    return (_jsxs("button", { type: "button", disabled: disabled, onClick: () => onClick(action), "aria-label": label, className: cn("inline-flex items-center justify-center gap-1.5 rounded-md px-3 py-1.5 text-xs font-medium transition-colors", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", "disabled:cursor-not-allowed", variantClasses[variant]), children: [isActive && isSubmitting ? _jsx(SpinnerIcon, {}) : null, label] }));
+}
+/**
+ * Live-ticking elapsed time since the approval was requested.
+ */
+function WaitingDuration({ requestedAt }) {
+    const startMs = useMemo(() => {
+        if (!requestedAt)
+            return null;
+        const t = new Date(requestedAt).getTime();
+        return Number.isNaN(t) ? null : t;
+    }, [requestedAt]);
+    const [elapsed, setElapsed] = useState(null);
+    useEffect(() => {
+        if (startMs === null) {
+            setElapsed(null);
+            return;
+        }
+        setElapsed(Math.max(0, Date.now() - startMs));
+        const id = setInterval(() => {
+            setElapsed(Math.max(0, Date.now() - startMs));
+        }, 1000);
+        return () => clearInterval(id);
+    }, [startMs]);
+    if (elapsed === null)
+        return null;
+    return (_jsxs("span", { className: "text-xs text-muted-foreground", children: ["waiting ", formatElapsed(elapsed)] }));
+}
+function formatElapsed(ms) {
+    if (ms < 1000)
+        return "just now";
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60) {
+        return remainingSeconds > 0
+            ? `${minutes}m ${remainingSeconds}s`
+            : `${minutes}m`;
+    }
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    return remainingMinutes > 0
+        ? `${hours}h ${remainingMinutes}m`
+        : `${hours}h`;
+}
+// ---------------------------------------------------------------------------
+// Inline SVG icons
+// ---------------------------------------------------------------------------
+function ShieldIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M7 1L2 3.5V6.5C2 9.75 4.1 12.35 7 13C9.9 12.35 12 9.75 12 6.5V3.5L7 1Z" }), _jsx("path", { d: "M7 5V8" }), _jsx("circle", { cx: "7", cy: "10", r: "0.5", fill: "currentColor", stroke: "none" })] }));
+}
+function TerminalApprovalIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "1", y: "2", width: "12", height: "10", rx: "2" }), _jsx("path", { d: "M4 5.5L6 7.5L4 9.5" }), _jsx("path", { d: "M7.5 9.5H10" })] }));
+}
+function FilePathIcon() {
+    return (_jsxs("svg", { width: "10", height: "10", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: [_jsx("path", { d: "M7 1H3C2.45 1 2 1.45 2 2V10C2 10.55 2.45 11 3 11H9C9.55 11 10 10.55 10 10V4L7 1Z" }), _jsx("path", { d: "M7 1V4H10" })] }));
+}
+function SpinnerIcon() {
+    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.5", className: "animate-spin", "aria-hidden": "true", children: _jsx("path", { d: "M6 1.5A4.5 4.5 0 1 1 1.5 6", strokeLinecap: "round" }) }));
+}
+//# sourceMappingURL=ApprovalCard.js.map

package/execution/ApprovalCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovalCard.js","sourceRoot":"","sources":["../../src/execution/ApprovalCard.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgB9C,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,eAAe,EACf,QAAQ,EACR,YAAY,GAAG,KAAK,EACpB,SAAS,GACS;IAClB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAC;IAE9E,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,MAAsB,EAAE,EAAE;QACzB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,eAAe,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,MAAM,YAAY,GAAG,mBAAmB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,4BAA4B,CAC7C,eAAe,CAAC,QAAQ,EACxB,eAAe,CAAC,WAAW,CAC5B,CAAC;IAEF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAC3D,YAAY,CAAC,QAAQ,EACrB,eAAe,CAAC,YAAY,CAC7B,CAAC;IAEF,OAAO,CACL,eACE,IAAI,EAAC,OAAO,gBACA,yBAAyB,eAAe,CAAC,QAAQ,EAAE,EAC/D,SAAS,EAAE,EAAE,CACX,6BAA6B,EAC7B,WAAW,EACX,SAAS,CACV,aAGD,eAAK,SAAS,EAAC,0DAA0D,aACtE,UAAU,EACX,yBAAO,MAAM,GAAQ,IACjB,EAGL,eAAe,CAAC,YAAY,IAAI,eAAe,CAAC,YAAY,IAAI,CAC/D,aAAG,SAAS,EAAC,sCAAsC,0BACvC,GAAG,EACb,eAAM,SAAS,EAAC,6BAA6B,YAC1C,eAAe,CAAC,YAAY,GACxB,EAAC,GAAG,+BAET,CACL,EAGD,eAAK,SAAS,EAAC,8BAA8B,aAC3C,eAAM,SAAS,EAAC,kEAAkE,YAC/E,YAAY,CAAC,KAAK,GACd,EACP,KAAC,eAAe,IAAC,WAAW,EAAE,eAAe,CAAC,WAAW,GAAI,IACzD,EAGL,eAAe,CAAC,OAAO,IAAI,CAC1B,YAAG,SAAS,EAAC,8BAA8B,YACxC,eAAe,CAAC,OAAO,GACtB,CACL,EAGD,cAAK,SAAS,EAAC,MAAM,YACnB,KAAC,mBAAmB,IAClB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAC/B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,eAAe,CAAC,WAAW,GACxC,GACE,EAGN,eAAK,SAAS,EAAC,8BAA8B,aAC3C,KAAC,YAAY,IACX,KAAK,EAAC,SAAS,EACf,MAAM,EAAE,cAAc,CAAC,OAAO,EAC9B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAC,SAAS,GACjB,EACF,KAAC,YAAY,IACX,KAAK,EAAC,MAAM,EACZ,MAAM,EAAE,cAAc,CAAC,IAAI,EAC3B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAC,MAAM,GACd,EACF,KAAC,YAAY,IACX,KAAK,EAAC,QAAQ,EACd,MAAM,EAAE,cAAc,CAAC,MAAM,EAC7B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAC,QAAQ,GAChB,IACE,IACF,CACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,SAAS,iBAAiB,CACxB,QAAgB,EAChB,YAAqB;IAMrB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,MAAM,EAAE,6BAA6B;YACrC,UAAU,EAAE,KAAC,UAAU,KAAG;YAC1B,WAAW,EAAE,gCAAgC;SAC9C,CAAC;IACJ,CAAC;IAED,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO;gBACL,MAAM,EAAE,iBAAiB;gBACzB,UAAU,EAAE,KAAC,oBAAoB,KAAG;gBACpC,WAAW,EAAE,gCAAgC;aAC9C,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,MAAM,EAAE,aAAa;gBACrB,UAAU,EAAE,KAAC,UAAU,KAAG;gBAC1B,WAAW,EAAE,wCAAwC;aACtD,CAAC;QACJ;YACE,OAAO;gBACL,MAAM,EAAE,mBAAmB;gBAC3B,UAAU,EAAE,KAAC,UAAU,KAAG;gBAC1B,WAAW,EAAE,gCAAgC;aAC9C,CAAC;IACN,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,SAAS,mBAAmB,CAAC,EAC3B,QAAQ,EACR,UAAU,EACV,WAAW,GAKZ;IACC,IAAI,QAAQ,KAAK,OAAO,IAAI,UAAU,EAAE,CAAC;QACvC,OAAO,KAAC,gBAAgB,IAAC,OAAO,EAAE,UAAU,GAAI,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI,UAAU,EAAE,CAAC;QAChH,OAAO,KAAC,eAAe,IAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAI,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACjE,OAAO,KAAC,iBAAiB,IAAC,OAAO,EAAE,UAAU,GAAI,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,KAAC,kBAAkB,IAAC,OAAO,EAAE,WAAW,GAAI,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAE,OAAO,EAAuB;IACxD,OAAO,CACL,cAAK,SAAS,EAAC,4EAA4E,YACzF,eAAK,SAAS,EAAC,0FAA0F,aACvG,eAAM,SAAS,EAAC,wDAAwD,mBAAU,EACjF,OAAO,IACJ,GACF,CACP,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,EACvB,IAAI,EACJ,WAAW,GAIZ;IACC,OAAO,CACL,eAAK,SAAS,EAAC,aAAa,aAC1B,eAAK,SAAS,EAAC,mCAAmC,aAChD,KAAC,YAAY,KAAG,EAChB,KAAC,YAAY,IAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAC,SAAS,GAAG,IAC5C,EACL,WAAW,IAAI,KAAC,kBAAkB,IAAC,OAAO,EAAE,WAAW,GAAI,IACxD,CACP,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAE,OAAO,EAAuB;IACzD,OAAO,CACL,eAAK,SAAS,EAAC,mCAAmC,aAChD,eAAM,SAAS,EAAC,uBAAuB,yBAAgB,EACvD,eAAM,SAAS,EAAC,0DAA0D,YACvE,OAAO,GACH,IACH,CACP,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAE,OAAO,EAAuB;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,GAAG,qBAAqB,CAAC;IAC7D,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,cAAc,GAClB,eAAe,IAAI,CAAC,UAAU;QAC5B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU;QAC/D,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,CACL,eAAK,SAAS,EAAC,WAAW,aACxB,eAAM,SAAS,EAAC,2CAA2C,0BAEpD,EACP,cAAK,SAAS,EAAC,0IAA0I,YACtJ,cAAc,GACX,EACL,eAAe,IAAI,CAClB,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EACvC,SAAS,EAAC,0EAA0E,YAEnF,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,MAAM,QAAQ,GACrD,CACV,IACG,CACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,SAAS,YAAY,CAAC,EACpB,KAAK,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,OAAO,GAQR;IACC,MAAM,QAAQ,GAAG,YAAY,KAAK,MAAM,CAAC;IACzC,MAAM,QAAQ,GAAG,YAAY,CAAC;IAE9B,MAAM,cAAc,GAAmC;QACrD,OAAO,EAAE,EAAE,CACT,wDAAwD,EACxD,4DAA4D,CAC7D;QACD,IAAI,EAAE,EAAE,CACN,+FAA+F,EAC/F,wDAAwD,CACzD;QACD,MAAM,EAAE,EAAE,CACR,oEAAoE,EACpE,oEAAoE,CACrE;KACF,CAAC;IAEF,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,gBAClB,KAAK,EACjB,SAAS,EAAE,EAAE,CACX,8GAA8G,EAC9G,qGAAqG,EACrG,6BAA6B,EAC7B,cAAc,CAAC,OAAO,CAAC,CACxB,aAEA,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,KAAC,WAAW,KAAG,CAAC,CAAC,CAAC,IAAI,EACjD,KAAK,IACC,CACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,EAAE,WAAW,EAA2B;IAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC,EAAE,IAAI,CAAC,CAAC;QACT,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAElC,OAAO,CACL,gBAAM,SAAS,EAAC,+BAA+B,yBACpC,aAAa,CAAC,OAAO,CAAC,IAC1B,CACR,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,EAAU;IAC/B,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,UAAU,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,gBAAgB,GAAG,CAAC;YACzB,CAAC,CAAC,GAAG,OAAO,KAAK,gBAAgB,GAAG;YACpC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IACtC,OAAO,gBAAgB,GAAG,CAAC;QACzB,CAAC,CAAC,GAAG,KAAK,KAAK,gBAAgB,GAAG;QAClC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,UAAU;IACjB,OAAO,CACL,eACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACV,MAAM,aAElB,eAAM,CAAC,EAAC,wEAAwE,GAAG,EACnF,eAAM,CAAC,EAAC,QAAQ,GAAG,EACnB,iBAAQ,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,IAAI,EAAC,CAAC,EAAC,KAAK,EAAC,IAAI,EAAC,cAAc,EAAC,MAAM,EAAC,MAAM,GAAG,IAC/D,CACP,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO,CACL,eACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACV,MAAM,aAElB,eAAM,CAAC,EAAC,GAAG,EAAC,CAAC,EAAC,GAAG,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,EAAE,EAAC,GAAG,GAAG,EAClD,eAAM,CAAC,EAAC,oBAAoB,GAAG,EAC/B,eAAM,CAAC,EAAC,aAAa,GAAG,IACpB,CACP,CAAC;AACJ,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,CACL,eACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,EACtB,SAAS,EAAC,gCAAgC,iBAC9B,MAAM,aAElB,eAAM,CAAC,EAAC,kFAAkF,GAAG,EAC7F,eAAM,CAAC,EAAC,WAAW,GAAG,IAClB,CACP,CAAC;AACJ,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,CACL,cACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,SAAS,EAAC,cAAc,iBACZ,MAAM,YAElB,eAAM,CAAC,EAAC,4BAA4B,EAAC,aAAa,EAAC,OAAO,GAAG,GACzD,CACP,CAAC;AACJ,CAAC"}

package/execution/ArtifactCard.d.ts

@@ -0,0 +1,70 @@
+import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
+export interface ArtifactCardProps {
+    /** The execution artifact to render. */
+    readonly artifact: ExecutionArtifact;
+    /** ID of the execution that produced this artifact — used for content fetching. */
+    readonly executionId: string;
+    /**
+     * Organization slug — used for skill package detection which fetches
+     * `SKILL.md` frontmatter via the artifact content RPC.
+     */
+    readonly org: string;
+    /**
+     * Called when the user clicks "Preview". The consumer is responsible
+     * for rendering a preview UI (e.g., {@link ArtifactPreviewModal}).
+     *
+     * When omitted, the Preview action is not rendered.
+     */
+    readonly onPreview?: (artifact: ExecutionArtifact) => void;
+    /** Additional CSS classes for the root element. */
+    readonly className?: string;
+}
+/**
+ * Renders a single execution artifact as a compact summary card with
+ * automatic Stigmer resource detection and a download link.
+ *
+ * The card's role is **signal and navigate**: it tells the user what
+ * the artifact is (file/directory, size, detected resource type) and
+ * provides two actions — Preview and Download. The Apply/Push CTA
+ * lives exclusively in {@link ArtifactPreviewModal} so the user must
+ * review content before acting (review-before-apply pattern).
+ *
+ * Internally orchestrates the detection pipeline:
+ *
+ * - **FILE artifacts**: Fetches text content via {@link useArtifactContent},
+ *   then detects Agent/McpServer YAML via {@link useDetectStigmerResource}.
+ *   Only text files under 256 KB are fetched for detection.
+ *
+ * - **DIRECTORY artifacts**: Detects skill packages via
+ *   {@link useDetectSkillPackage} (checks for `SKILL.md` in the ZIP
+ *   archive entries).
+ *
+ * Detection results are surfaced as a type badge ("Agent detected",
+ * "Skill · N files"). Non-Stigmer artifacts render with file info
+ * and a download link only — no error messages or "not detected"
+ * indicators (detection is silent).
+ *
+ * @example
+ * ```tsx
+ * const { artifacts } = useExecutionArtifacts(execution);
+ *
+ * {artifacts.map((artifact) => (
+ *   <ArtifactCard
+ *     key={artifact.storageKey}
+ *     artifact={artifact}
+ *     executionId={execution.metadata!.id}
+ *     org={activeOrg}
+ *     onPreview={(a) => setPreviewArtifact(a)}
+ *   />
+ * ))}
+ * ```
+ *
+ * @see {@link ArtifactPreviewModal} — full preview with Apply/Push CTA
+ * @see {@link ArtifactsWidget} — container that composes cards + modal
+ * @see {@link useExecutionArtifacts} — extracts artifact metadata from an execution
+ * @see {@link useArtifactContent} — content-fetching hook (headless alternative)
+ * @see {@link useDetectStigmerResource} — YAML resource detection (headless)
+ * @see {@link useDetectSkillPackage} — skill package detection (headless)
+ */
+export declare function ArtifactCard({ artifact, executionId, org, onPreview, className, }: ArtifactCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ArtifactCard.d.ts.map

package/execution/ArtifactCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactCard.d.ts","sourceRoot":"","sources":["../../src/execution/ArtifactCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAgB1G,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC3D,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,WAAW,EACX,GAAG,EACH,SAAS,EACT,SAAS,GACV,EAAE,iBAAiB,2CAgHnB"}

package/execution/ArtifactCard.js

@@ -0,0 +1,109 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { cn } from "@stigmer/theme";
+import { useArtifactContent } from "./useArtifactContent";
+import { isTextArtifact, formatArtifactSize } from "./artifact-utils";
+import { useDetectStigmerResource } from "../library/useDetectStigmerResource";
+import { useDetectSkillPackage } from "../library/useDetectSkillPackage";
+/**
+ * Artifacts larger than this threshold skip the content fetch used for
+ * resource detection. Stigmer resource YAML files are typically under
+ * 10 KB — 256 KB is generous without risking large payloads for log
+ * files or binary-adjacent text content.
+ */
+const MAX_DETECTION_SIZE = 256 * 1024;
+/**
+ * Renders a single execution artifact as a compact summary card with
+ * automatic Stigmer resource detection and a download link.
+ *
+ * The card's role is **signal and navigate**: it tells the user what
+ * the artifact is (file/directory, size, detected resource type) and
+ * provides two actions — Preview and Download. The Apply/Push CTA
+ * lives exclusively in {@link ArtifactPreviewModal} so the user must
+ * review content before acting (review-before-apply pattern).
+ *
+ * Internally orchestrates the detection pipeline:
+ *
+ * - **FILE artifacts**: Fetches text content via {@link useArtifactContent},
+ *   then detects Agent/McpServer YAML via {@link useDetectStigmerResource}.
+ *   Only text files under 256 KB are fetched for detection.
+ *
+ * - **DIRECTORY artifacts**: Detects skill packages via
+ *   {@link useDetectSkillPackage} (checks for `SKILL.md` in the ZIP
+ *   archive entries).
+ *
+ * Detection results are surfaced as a type badge ("Agent detected",
+ * "Skill · N files"). Non-Stigmer artifacts render with file info
+ * and a download link only — no error messages or "not detected"
+ * indicators (detection is silent).
+ *
+ * @example
+ * ```tsx
+ * const { artifacts } = useExecutionArtifacts(execution);
+ *
+ * {artifacts.map((artifact) => (
+ *   <ArtifactCard
+ *     key={artifact.storageKey}
+ *     artifact={artifact}
+ *     executionId={execution.metadata!.id}
+ *     org={activeOrg}
+ *     onPreview={(a) => setPreviewArtifact(a)}
+ *   />
+ * ))}
+ * ```
+ *
+ * @see {@link ArtifactPreviewModal} — full preview with Apply/Push CTA
+ * @see {@link ArtifactsWidget} — container that composes cards + modal
+ * @see {@link useExecutionArtifacts} — extracts artifact metadata from an execution
+ * @see {@link useArtifactContent} — content-fetching hook (headless alternative)
+ * @see {@link useDetectStigmerResource} — YAML resource detection (headless)
+ * @see {@link useDetectSkillPackage} — skill package detection (headless)
+ */
+export function ArtifactCard({ artifact, executionId, org, onPreview, className, }) {
+    // ---------------------------------------------------------------------------
+    // Detection orchestration
+    // ---------------------------------------------------------------------------
+    const isDirectory = artifact.kind === ExecutionArtifactKind.DIRECTORY;
+    const canDetectYaml = !isDirectory &&
+        isTextArtifact(artifact) &&
+        Number(artifact.sizeBytes) < MAX_DETECTION_SIZE;
+    const { content, isLoading: isContentLoading } = useArtifactContent(canDetectYaml ? executionId : null, canDetectYaml ? artifact.storageKey : null);
+    const yamlDetection = useDetectStigmerResource(canDetectYaml ? content : null);
+    const { detection: skillDetection, isLoading: isSkillLoading } = useDetectSkillPackage(isDirectory ? artifact : null, isDirectory ? executionId : null);
+    // ---------------------------------------------------------------------------
+    // Derived detection state
+    // ---------------------------------------------------------------------------
+    const isDetected = yamlDetection.detected || skillDetection.detected;
+    const isDetecting = (canDetectYaml && isContentLoading) || (isDirectory && isSkillLoading);
+    let detectionLabel = null;
+    if (yamlDetection.detected) {
+        detectionLabel = `${yamlDetection.displayName} detected`;
+    }
+    else if (skillDetection.detected) {
+        const count = skillDetection.fileCount;
+        detectionLabel = `Skill \u00B7 ${count} ${count === 1 ? "file" : "files"}`;
+    }
+    const canPreview = !!onPreview && (isTextArtifact(artifact) || isDirectory);
+    // ---------------------------------------------------------------------------
+    // Render
+    // ---------------------------------------------------------------------------
+    return (_jsxs("div", { role: "article", "aria-label": artifact.name, className: cn("rounded-md border border-border p-3", className), children: [_jsxs("div", { className: "flex items-start gap-2", children: [_jsx("span", { className: "mt-0.5 shrink-0 text-muted-foreground", children: isDirectory ? _jsx(FolderIcon, {}) : _jsx(FileIcon, {}) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "truncate text-sm font-medium text-foreground", children: [artifact.name, isDirectory && "/"] }), _jsx("div", { className: "text-xs tabular-nums text-muted-foreground", children: formatArtifactSize(artifact.sizeBytes) })] })] }), isDetecting && !isDetected && (_jsx("div", { className: "mt-1.5 h-5 w-28 animate-pulse rounded-full bg-muted", "aria-hidden": "true" })), detectionLabel && (_jsx("span", { className: "mt-1.5 inline-flex items-center rounded-full bg-primary/10 px-2 py-0.5 text-xs font-medium text-primary", children: detectionLabel })), _jsxs("div", { className: "mt-2 flex flex-wrap items-center gap-x-3 gap-y-1", children: [canPreview && (_jsx("button", { type: "button", onClick: () => onPreview(artifact), className: cn("text-xs font-medium text-primary transition-colors hover:text-primary/80", FOCUS_RING_CLASSES), children: "Preview" })), _jsxs("a", { href: artifact.downloadUrl, download: true, className: cn("inline-flex items-center gap-1 text-xs font-medium text-muted-foreground transition-colors hover:text-foreground", FOCUS_RING_CLASSES), children: [_jsx(DownloadIcon, {}), isDirectory ? "Download ZIP" : "Download"] })] })] }));
+}
+// ---------------------------------------------------------------------------
+// Shared style constants
+// ---------------------------------------------------------------------------
+const FOCUS_RING_CLASSES = "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded-sm";
+// ---------------------------------------------------------------------------
+// Inline SVG icons
+// ---------------------------------------------------------------------------
+function FileIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M8 1H4C3.45 1 3 1.45 3 2V12C3 12.55 3.45 13 4 13H10C10.55 13 11 12.55 11 12V4L8 1Z" }), _jsx("path", { d: "M8 1V4H11" })] }));
+}
+function FolderIcon() {
+    return (_jsx("svg", { width: "14", height: "14", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M13 11C13 11.55 12.55 12 12 12H2C1.45 12 1 11.55 1 11V3C1 2.45 1.45 2 2 2H5L7 4H12C12.55 4 13 4.45 13 5V11Z" }) }));
+}
+function DownloadIcon() {
+    return (_jsxs("svg", { width: "10", height: "10", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0", "aria-hidden": "true", children: [_jsx("path", { d: "M6 1.5V8.5" }), _jsx("path", { d: "M3 6L6 9L9 6" }), _jsx("path", { d: "M2 10.5H10" })] }));
+}
+//# sourceMappingURL=ArtifactCard.js.map

package/execution/ArtifactCard.js.map

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

package/execution/ArtifactPreviewModal.d.ts

@@ -0,0 +1,77 @@
+import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
+import { type ApplyResourceResult } from "../library/useApplyResource";
+export interface ArtifactPreviewModalProps {
+    /** The execution artifact to preview. */
+    readonly artifact: ExecutionArtifact;
+    /** ID of the execution that produced this artifact. */
+    readonly executionId: string;
+    /** Organization slug for the "Apply to [org]" / "Push Skill to [org]" CTA. */
+    readonly org: string;
+    /**
+     * Whether the execution is in a terminal phase (completed, failed,
+     * cancelled, terminated). Controls Apply/Push CTA availability:
+     *
+     * - `true` — CTA renders as an enabled primary button
+     * - `false` — CTA renders as a disabled secondary button
+     */
+    readonly isTerminal: boolean;
+    /** Controls modal visibility. `true` opens the dialog via `showModal()`. */
+    readonly open: boolean;
+    /** Called when the modal should close (Escape key or close button). */
+    readonly onClose: () => void;
+    /**
+     * Called after a resource is successfully applied or a skill package
+     * is pushed. The consumer can use this for post-apply behavior such
+     * as showing a toast or navigating to the Library.
+     */
+    readonly onApplied?: (result: ApplyResourceResult) => void;
+    /** Additional CSS classes for the dialog element. */
+    readonly className?: string;
+}
+/**
+ * Full preview modal for execution artifacts with content display,
+ * Stigmer resource detection, and Apply/Push CTA.
+ *
+ * Uses the native `<dialog>` element for zero-dependency modal behavior:
+ * focus trap via `showModal()`, top-layer promotion, Escape key handling,
+ * and `::backdrop` overlay — with no dependency on `@base-ui/react`.
+ *
+ * Internally orchestrates the same detection pipeline as {@link ArtifactCard}:
+ *
+ * - **FILE artifacts**: Fetches text content via {@link useArtifactContent},
+ *   displays with CSS-only YAML highlighting, and detects Agent/McpServer
+ *   resources via {@link useDetectStigmerResource}.
+ *
+ * - **DIRECTORY artifacts**: Shows the file listing from
+ *   `artifact.entries` and detects skill packages via
+ *   {@link useDetectSkillPackage}.
+ *
+ * Actions: Copy content to clipboard (file artifacts only), Download
+ * artifact, and Apply/Push (when a Stigmer resource is detected).
+ *
+ * @example
+ * ```tsx
+ * const [previewArtifact, setPreviewArtifact] =
+ *   useState<ExecutionArtifact | null>(null);
+ *
+ * {previewArtifact && (
+ *   <ArtifactPreviewModal
+ *     artifact={previewArtifact}
+ *     executionId={execution.id}
+ *     org={activeOrg}
+ *     isTerminal={isTerminalPhase(execution.status?.phase)}
+ *     open
+ *     onClose={() => setPreviewArtifact(null)}
+ *     onApplied={(result) => toast(`${result.kind} applied`)}
+ *   />
+ * )}
+ * ```
+ *
+ * @see {@link ArtifactCard} — compact card that triggers preview via `onPreview`
+ * @see {@link useArtifactContent} — content-fetching hook (headless alternative)
+ * @see {@link useDetectStigmerResource} — YAML resource detection (headless)
+ * @see {@link useDetectSkillPackage} — skill package detection (headless)
+ * @see {@link useApplyResource} — apply/push behavior hook (headless)
+ */
+export declare function ArtifactPreviewModal({ artifact, executionId, org, isTerminal, open, onClose, onApplied, className, }: ArtifactPreviewModalProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ArtifactPreviewModal.d.ts.map

package/execution/ArtifactPreviewModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactPreviewModal.d.ts","sourceRoot":"","sources":["../../src/execution/ArtifactPreviewModal.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAY1G,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,WAAW,yBAAyB;IACxC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC3D,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,WAAW,EACX,GAAG,EACH,UAAU,EACV,IAAI,EACJ,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE,yBAAyB,2CAkO3B"}