@stigmer/react 0.4.7 → 0.5.0

package/skill/SkillUploader.js

@@ -0,0 +1,141 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import Markdown from "react-markdown";
+import { cn } from "@stigmer/theme";
+import { MARKDOWN_COMPONENTS, REMARK_PLUGINS, stripFrontmatter } from "../internal/markdown-components";
+import { useSkillUpload } from "./useSkillUpload";
+import { usePushSkill } from "./usePushSkill";
+import { useSkillDuplicateCheck } from "./useSkillDuplicateCheck";
+// ---------------------------------------------------------------------------
+// Main component
+// ---------------------------------------------------------------------------
+/**
+ * Skill package upload component with validation and preview.
+ *
+ * Two-phase flow:
+ * 1. **Drop zone** — User drags/drops or clicks to select a .zip file
+ * 2. **Preview + confirm** — Validated package summary, file listing,
+ *    rendered SKILL.md preview, and push button
+ *
+ * Validates the uploaded ZIP against the Anthropic Agent Skills spec:
+ * must contain SKILL.md with valid YAML frontmatter (name, description).
+ *
+ * Zero Console dependencies — safe for platform builder embedding.
+ * All visual properties flow through `--stgm-*` design tokens.
+ *
+ * @example
+ * ```tsx
+ * <SkillUploader
+ *   org="acme"
+ *   onComplete={(skill) => router.push(`/library/skills/${skill.metadata?.org}/${skill.metadata?.slug}`)}
+ *   onCancel={() => router.back()}
+ * />
+ * ```
+ */
+export function SkillUploader({ org, tag, onComplete, onCancel, className, }) {
+    const upload = useSkillUpload();
+    const { push, isPushing, error: pushError, clearError } = usePushSkill();
+    const dupCheck = useSkillDuplicateCheck();
+    const handleFileProcessed = useCallback(async (file) => {
+        dupCheck.reset();
+        await upload.processFile(file);
+    }, [upload, dupCheck]);
+    useEffect(() => {
+        if (upload.preview && upload.artifact) {
+            const slug = normalizeToSlug(upload.preview.name);
+            dupCheck.check({ org, slug, artifactBytes: upload.artifact });
+        }
+    }, [upload.preview, upload.artifact, org]);
+    const handlePush = useCallback(async () => {
+        if (!upload.artifact)
+            return;
+        clearError();
+        try {
+            const skill = await push({ org, artifact: upload.artifact, tag });
+            onComplete?.(skill);
+        }
+        catch {
+            // Error captured in usePushSkill state
+        }
+    }, [upload.artifact, clearError, push, org, tag, onComplete]);
+    const handleReset = useCallback(() => {
+        upload.reset();
+        dupCheck.reset();
+    }, [upload, dupCheck]);
+    return (_jsx("div", { className: cn("flex flex-col gap-0 rounded-lg border border-border bg-card", className), children: upload.preview ? (_jsx(PreviewPhase, { preview: upload.preview, isPushing: isPushing, pushError: pushError, onPush: handlePush, onReset: handleReset, onCancel: onCancel, isDuplicate: dupCheck.isDuplicate, isCheckingDuplicate: dupCheck.isChecking })) : (_jsx(DropZonePhase, { onFile: handleFileProcessed, isProcessing: upload.isProcessing, validationError: upload.validationError, onCancel: onCancel })) }));
+}
+// ---------------------------------------------------------------------------
+// Phase 1: Drop Zone
+// ---------------------------------------------------------------------------
+function DropZonePhase({ onFile, isProcessing, validationError, onCancel, }) {
+    const [isDragOver, setIsDragOver] = useState(false);
+    const inputRef = useRef(null);
+    const handleDragOver = useCallback((e) => {
+        e.preventDefault();
+        e.stopPropagation();
+        setIsDragOver(true);
+    }, []);
+    const handleDragLeave = useCallback((e) => {
+        e.preventDefault();
+        e.stopPropagation();
+        setIsDragOver(false);
+    }, []);
+    const handleDrop = useCallback((e) => {
+        e.preventDefault();
+        e.stopPropagation();
+        setIsDragOver(false);
+        const file = e.dataTransfer.files[0];
+        if (file)
+            onFile(file);
+    }, [onFile]);
+    const handleClick = useCallback(() => {
+        inputRef.current?.click();
+    }, []);
+    const handleFileChange = useCallback((e) => {
+        const file = e.target.files?.[0];
+        if (file)
+            onFile(file);
+        if (inputRef.current)
+            inputRef.current.value = "";
+    }, [onFile]);
+    return (_jsxs("div", { className: "flex flex-col", children: [_jsxs("div", { role: "button", tabIndex: 0, "aria-label": "Upload skill package", onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, onClick: handleClick, onKeyDown: (e) => { if (e.key === "Enter" || e.key === " ")
+                    handleClick(); }, className: cn("flex flex-col items-center justify-center gap-3 rounded-lg border-2 border-dashed p-12 transition-colors cursor-pointer", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", isDragOver
+                    ? "border-primary bg-muted-subtle"
+                    : "border-border hover:border-muted-foreground hover:bg-muted-subtle", isProcessing && "pointer-events-none opacity-60"), children: [_jsx(UploadIcon, { className: cn("size-10 text-muted-foreground", isDragOver && "text-primary") }), isProcessing ? (_jsx("p", { className: "text-sm font-medium text-foreground", children: "Processing..." })) : (_jsxs(_Fragment, { children: [_jsx("p", { className: "text-sm font-medium text-foreground", children: "Drop your skill package here" }), _jsx("p", { className: "text-xs text-muted-foreground", children: "or click to browse" })] })), _jsx("p", { className: "mt-2 text-[10px] text-muted-foreground-subtle", children: "Accepts .zip files following the Anthropic Agent Skills format" }), _jsx("input", { ref: inputRef, type: "file", accept: ".zip", onChange: handleFileChange, className: "hidden", "aria-hidden": "true" })] }), validationError && (_jsx("div", { className: "px-4 py-3", children: _jsx("p", { className: "text-sm text-destructive", role: "alert", children: validationError }) })), onCancel && (_jsx("div", { className: "flex justify-end border-t border-border px-4 py-3", children: _jsx("button", { type: "button", onClick: onCancel, className: cn("rounded-md px-3 py-1.5 text-sm font-medium text-muted-foreground", "hover:text-foreground hover:bg-muted", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "transition-colors"), children: "Cancel" }) }))] }));
+}
+// ---------------------------------------------------------------------------
+// Phase 2: Preview + Confirm
+// ---------------------------------------------------------------------------
+function PreviewPhase({ preview, isPushing, pushError, onPush, onReset, onCancel, isDuplicate, isCheckingDuplicate, }) {
+    const strippedContent = stripFrontmatter(preview.skillMdContent);
+    return (_jsxs("div", { className: "flex flex-col", children: [_jsx("div", { className: "border-b border-border px-4 py-3", children: _jsx("h3", { className: "text-sm font-medium text-foreground", children: "Skill Package Preview" }) }), _jsxs("div", { className: "flex flex-col gap-2 border-b border-border px-4 py-3", children: [_jsxs("div", { className: "flex items-baseline gap-2", children: [_jsx("span", { className: "text-xs font-medium text-muted-foreground w-20 shrink-0", children: "Name" }), _jsx("span", { className: "text-sm font-medium text-foreground font-mono", children: preview.name })] }), preview.description && (_jsxs("div", { className: "flex items-baseline gap-2", children: [_jsx("span", { className: "text-xs font-medium text-muted-foreground w-20 shrink-0", children: "Description" }), _jsx("span", { className: "text-sm text-foreground", children: preview.description })] }))] }), _jsxs("div", { className: "border-b border-border px-4 py-3", children: [_jsxs("div", { className: "mb-2 flex items-baseline justify-between", children: [_jsxs("span", { className: "text-xs font-medium text-muted-foreground", children: ["Files (", preview.files.filter((f) => !f.isDirectory).length, ")"] }), _jsxs("span", { className: "text-[10px] text-muted-foreground-subtle", children: [formatBytes(preview.totalSize), " total"] })] }), _jsx("div", { className: "rounded-md border border-border overflow-hidden", children: _jsx("table", { className: "w-full text-xs", children: _jsx("tbody", { children: preview.files
+                                    .filter((f) => !f.isDirectory)
+                                    .map((file) => (_jsxs("tr", { className: "border-b border-border last:border-b-0", children: [_jsx("td", { className: "px-3 py-1.5 font-mono text-foreground", children: file.path }), _jsx("td", { className: "px-3 py-1.5 text-right text-muted-foreground tabular-nums", children: formatBytes(file.size) })] }, file.path))) }) }) })] }), strippedContent && (_jsxs("div", { className: "border-b border-border px-4 py-3", children: [_jsx("span", { className: "mb-2 block text-xs font-medium text-muted-foreground", children: "SKILL.md Preview" }), _jsx("div", { className: "max-h-[240px] overflow-y-auto rounded-md border border-border p-3", children: _jsx(Markdown, { remarkPlugins: REMARK_PLUGINS, components: MARKDOWN_COMPONENTS, children: strippedContent }) })] })), isDuplicate && (_jsxs("div", { className: "flex items-start gap-2.5 border-b border-amber-500/20 bg-amber-500/5 px-4 py-3", role: "alert", children: [_jsx(WarningIcon, { className: "mt-0.5 size-4 shrink-0 text-amber-600 dark:text-amber-400" }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "text-sm font-medium text-amber-700 dark:text-amber-300", children: "No changes detected" }), _jsx("p", { className: "mt-0.5 text-xs text-amber-600 dark:text-amber-400", children: "This skill's content is identical to the current version. Pushing will create a new version record with the same content." })] })] })), isCheckingDuplicate && (_jsxs("div", { className: "flex items-center gap-2 border-b border-border px-4 py-2", children: [_jsx(Spinner, {}), _jsx("span", { className: "text-xs text-muted-foreground", children: "Checking for changes..." })] })), pushError && (_jsx("div", { className: "px-4 py-2", children: _jsx("p", { className: "text-sm text-destructive", role: "alert", children: pushError.message }) })), _jsxs("div", { className: "flex items-center justify-between px-4 py-3", children: [_jsx("button", { type: "button", onClick: onReset, className: cn("rounded-md px-3 py-1.5 text-sm font-medium text-muted-foreground", "hover:text-foreground hover:bg-muted", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "transition-colors"), children: "Choose Different File" }), _jsxs("div", { className: "flex items-center gap-2", children: [onCancel && (_jsx("button", { type: "button", onClick: onCancel, className: cn("rounded-md px-3 py-1.5 text-sm font-medium text-muted-foreground", "hover:text-foreground hover:bg-muted", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "transition-colors"), children: "Cancel" })), _jsx("button", { type: "button", onClick: onPush, disabled: isPushing, className: cn("rounded-md bg-primary px-4 py-1.5 text-sm font-medium text-primary-foreground", "hover:bg-primary-hover", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "disabled:opacity-50 disabled:cursor-not-allowed", "transition-colors"), children: isPushing ? "Pushing..." : isDuplicate ? "Push Anyway" : "Push Skill" })] })] })] }));
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+function normalizeToSlug(name) {
+    return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+// ---------------------------------------------------------------------------
+// Icons
+// ---------------------------------------------------------------------------
+function WarningIcon({ 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 1.5 1 14h14L8 1.5Z" }), _jsx("path", { d: "M8 6v3.5" }), _jsx("circle", { cx: "8", cy: "11.5", r: "0.5", fill: "currentColor", stroke: "none" })] }));
+}
+function Spinner() {
+    return (_jsx("svg", { width: "14", height: "14", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", className: "animate-spin", "aria-hidden": "true", children: _jsx("path", { d: "M8 2a6 6 0 1 0 6 6" }) }));
+}
+function UploadIcon({ className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4" }), _jsx("polyline", { points: "17 8 12 3 7 8" }), _jsx("line", { x1: "12", y1: "3", x2: "12", y2: "15" })] }));
+}
+//# sourceMappingURL=SkillUploader.js.map

package/skill/SkillUploader.js.map

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

package/skill/index.d.ts

@@ -10,4 +10,22 @@ export { SkillPicker } from "./SkillPicker";
 export type { SkillPickerProps } from "./SkillPicker";
 export { SkillDetailView } from "./SkillDetailView";
 export type { SkillDetailViewProps } from "./SkillDetailView";
+export { usePushSkill } from "./usePushSkill";
+export type { PushSkillInput, UsePushSkillReturn } from "./usePushSkill";
+export { useSkillUpload } from "./useSkillUpload";
+export type { SkillUploadPreview, SkillFileEntry, UseSkillUploadReturn, } from "./useSkillUpload";
+export { useSkillArtifact } from "./useSkillArtifact";
+export type { UseSkillArtifactReturn } from "./useSkillArtifact";
+export { SkillUploader } from "./SkillUploader";
+export type { SkillUploaderProps } from "./SkillUploader";
+export { SkillFileBrowser } from "./SkillFileBrowser";
+export type { SkillFileBrowserProps } from "./SkillFileBrowser";
+export { useSkillVersions } from "./useSkillVersions";
+export type { UseSkillVersionsReturn } from "./useSkillVersions";
+export { useSkillDiff } from "./useSkillDiff";
+export type { UseSkillDiffReturn } from "./useSkillDiff";
+export { SkillDiffDialog } from "./SkillDiffDialog";
+export type { SkillDiffDialogProps, SkillDiffDialogState, } from "./SkillDiffDialog";
+export { useSkillDuplicateCheck } from "./useSkillDuplicateCheck";
+export type { UseSkillDuplicateCheckReturn } from "./useSkillDuplicateCheck";
 //# sourceMappingURL=index.d.ts.map

package/skill/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC"}

package/skill/index.js

@@ -4,4 +4,13 @@ export { useSkillSearch } from "./useSkillSearch";
 export { useSkill } from "./useSkill";
 export { SkillPicker } from "./SkillPicker";
 export { SkillDetailView } from "./SkillDetailView";
+export { usePushSkill } from "./usePushSkill";
+export { useSkillUpload } from "./useSkillUpload";
+export { useSkillArtifact } from "./useSkillArtifact";
+export { SkillUploader } from "./SkillUploader";
+export { SkillFileBrowser } from "./SkillFileBrowser";
+export { useSkillVersions } from "./useSkillVersions";
+export { useSkillDiff } from "./useSkillDiff";
+export { SkillDiffDialog } from "./SkillDiffDialog";
+export { useSkillDuplicateCheck } from "./useSkillDuplicateCheck";
 //# sourceMappingURL=index.js.map

package/skill/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/skill/internal/computeArtifactHash.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Computes a SHA-256 hex digest of the given bytes using Web Crypto.
+ *
+ * Returns the same 64-character lowercase hex string that the backend
+ * produces for `SkillStatus.versionHash`, enabling client-side
+ * duplicate detection before pushing.
+ */
+export declare function computeArtifactHash(bytes: Uint8Array): Promise<string>;
+//# sourceMappingURL=computeArtifactHash.d.ts.map

package/skill/internal/computeArtifactHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeArtifactHash.d.ts","sourceRoot":"","sources":["../../../src/skill/internal/computeArtifactHash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5E"}

package/skill/internal/computeArtifactHash.js

@@ -0,0 +1,14 @@
+/**
+ * Computes a SHA-256 hex digest of the given bytes using Web Crypto.
+ *
+ * Returns the same 64-character lowercase hex string that the backend
+ * produces for `SkillStatus.versionHash`, enabling client-side
+ * duplicate detection before pushing.
+ */
+export async function computeArtifactHash(bytes) {
+    const digest = await crypto.subtle.digest("SHA-256", bytes);
+    return Array.from(new Uint8Array(digest))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+//# sourceMappingURL=computeArtifactHash.js.map

package/skill/internal/computeArtifactHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeArtifactHash.js","sourceRoot":"","sources":["../../../src/skill/internal/computeArtifactHash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAiB;IACzD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAA+B,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/skill/internal/fetchAndUnpackArtifact.d.ts

@@ -0,0 +1,16 @@
+import type { Stigmer } from "@stigmer/sdk";
+import type { SkillFileEntry } from "../useSkillUpload";
+/** Unpacked artifact: file entries for browsing + content map for reading. */
+export interface UnpackedArtifact {
+    readonly files: SkillFileEntry[];
+    readonly contentMap: ReadonlyMap<string, string>;
+}
+/**
+ * Fetch a skill artifact by storage key, unzip it, and return the file listing
+ * with a content map. Shared by `useSkillArtifact` (single-version browser)
+ * and `useSkillDiff` (two-version comparison).
+ *
+ * Throws on network or decompression errors — callers handle error state.
+ */
+export declare function fetchAndUnpackArtifact(stigmer: Stigmer, artifactStorageKey: string): Promise<UnpackedArtifact>;
+//# sourceMappingURL=fetchAndUnpackArtifact.d.ts.map

package/skill/internal/fetchAndUnpackArtifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAndUnpackArtifact.d.ts","sourceRoot":"","sources":["../../../src/skill/internal/fetchAndUnpackArtifact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}

package/skill/internal/fetchAndUnpackArtifact.js

@@ -0,0 +1,34 @@
+import { create } from "@bufbuild/protobuf";
+import { GetArtifactRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
+/**
+ * Fetch a skill artifact by storage key, unzip it, and return the file listing
+ * with a content map. Shared by `useSkillArtifact` (single-version browser)
+ * and `useSkillDiff` (two-version comparison).
+ *
+ * Throws on network or decompression errors — callers handle error state.
+ */
+export async function fetchAndUnpackArtifact(stigmer, artifactStorageKey) {
+    const request = create(GetArtifactRequestSchema, { artifactStorageKey });
+    const response = await stigmer.skill.getArtifact(request);
+    const { unzipSync, strFromU8 } = await import("fflate");
+    const unzipped = unzipSync(response.artifact);
+    const entries = Object.entries(unzipped);
+    const files = entries.map(([path, data]) => ({
+        path,
+        size: data.length,
+        isDirectory: data.length === 0 && path.endsWith("/"),
+    }));
+    const contentMap = new Map();
+    for (const [path, data] of entries) {
+        if (!path.endsWith("/") && data.length > 0) {
+            try {
+                contentMap.set(path, strFromU8(data));
+            }
+            catch {
+                contentMap.set(path, "[Binary content]");
+            }
+        }
+    }
+    return { files, contentMap };
+}
+//# sourceMappingURL=fetchAndUnpackArtifact.js.map

package/skill/internal/fetchAndUnpackArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAndUnpackArtifact.js","sourceRoot":"","sources":["../../../src/skill/internal/fetchAndUnpackArtifact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAU7F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgB,EAChB,kBAA0B;IAE1B,MAAM,OAAO,GAAG,MAAM,CAAC,wBAAwB,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAE1D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,KAAK,GAAqB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI;QACJ,IAAI,EAAE,IAAI,CAAC,MAAM;QACjB,WAAW,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;KACrD,CAAC,CAAC,CAAC;IAEJ,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC/B,CAAC"}

package/skill/usePushSkill.d.ts

@@ -0,0 +1,53 @@
+import type { Skill } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/api_pb";
+/** Input for pushing a skill artifact (ZIP package). */
+export interface PushSkillInput {
+    /** Organization that will own the skill. */
+    readonly org: string;
+    /** Raw ZIP bytes of the skill package (must contain SKILL.md at root). */
+    readonly artifact: Uint8Array;
+    /** Optional version tag (e.g. "stable", "v1.0"). */
+    readonly tag?: string;
+}
+/** Return value of {@link usePushSkill}. */
+export interface UsePushSkillReturn {
+    /**
+     * Push a skill artifact ZIP to the server.
+     *
+     * The caller is responsible for providing a valid ZIP containing
+     * a SKILL.md with proper YAML frontmatter. Use {@link useSkillUpload}
+     * to validate the ZIP before pushing.
+     *
+     * Resolves with the server-persisted `Skill` resource including
+     * populated metadata (id, slug, version hash).
+     */
+    readonly push: (input: PushSkillInput) => Promise<Skill>;
+    /** `true` while the push request is in flight. */
+    readonly isPushing: boolean;
+    /** Error from the last failed push, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Mutation hook that pushes a skill artifact ZIP to the server.
+ *
+ * Accepts raw ZIP bytes and calls `stigmer.skill.push()` directly.
+ * The ZIP must contain a valid SKILL.md with YAML frontmatter — use
+ * {@link useSkillUpload} to validate before pushing.
+ *
+ * Follows the established SDK mutation hook pattern: `isPushing` flag,
+ * `error` state, `clearError` reset, result returned from the promise.
+ *
+ * @example
+ * ```tsx
+ * const { push, isPushing, error } = usePushSkill();
+ * const upload = useSkillUpload();
+ *
+ * // After upload.processFile(file) succeeds:
+ * if (upload.artifact) {
+ *   const skill = await push({ org: "acme", artifact: upload.artifact });
+ * }
+ * ```
+ */
+export declare function usePushSkill(): UsePushSkillReturn;
+//# sourceMappingURL=usePushSkill.d.ts.map

package/skill/usePushSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePushSkill.d.ts","sourceRoot":"","sources":["../../src/skill/usePushSkill.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAShF,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CA+BjD"}

package/skill/usePushSkill.js

@@ -0,0 +1,57 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { PushSkillRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+// ---------------------------------------------------------------------------
+// Hook implementation
+// ---------------------------------------------------------------------------
+/**
+ * Mutation hook that pushes a skill artifact ZIP to the server.
+ *
+ * Accepts raw ZIP bytes and calls `stigmer.skill.push()` directly.
+ * The ZIP must contain a valid SKILL.md with YAML frontmatter — use
+ * {@link useSkillUpload} to validate before pushing.
+ *
+ * Follows the established SDK mutation hook pattern: `isPushing` flag,
+ * `error` state, `clearError` reset, result returned from the promise.
+ *
+ * @example
+ * ```tsx
+ * const { push, isPushing, error } = usePushSkill();
+ * const upload = useSkillUpload();
+ *
+ * // After upload.processFile(file) succeeds:
+ * if (upload.artifact) {
+ *   const skill = await push({ org: "acme", artifact: upload.artifact });
+ * }
+ * ```
+ */
+export function usePushSkill() {
+    const stigmer = useStigmer();
+    const [isPushing, setIsPushing] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const push = useCallback(async (input) => {
+        setIsPushing(true);
+        setError(null);
+        try {
+            const request = create(PushSkillRequestSchema, {
+                org: input.org,
+                artifact: input.artifact,
+                tag: input.tag ?? "",
+            });
+            return await stigmer.skill.push(request);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsPushing(false);
+        }
+    }, [stigmer]);
+    return { push, isPushing, error, clearError };
+}
+//# sourceMappingURL=usePushSkill.js.map

package/skill/usePushSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePushSkill.js","sourceRoot":"","sources":["../../src/skill/usePushSkill.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAqC9C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,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,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,KAAqB,EAAkB,EAAE;QAC9C,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,sBAAsB,EAAE;gBAC7C,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;aACrB,CAAC,CAAC;YAEH,OAAO,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,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,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAChD,CAAC"}

package/skill/useSkillArtifact.d.ts

@@ -0,0 +1,37 @@
+import type { SkillFileEntry } from "./useSkillUpload";
+/** Return value of {@link useSkillArtifact}. */
+export interface UseSkillArtifactReturn {
+    /** File entries in the skill package, or `null` while loading/on error. */
+    readonly files: SkillFileEntry[] | null;
+    /** `true` while the artifact is being fetched and unpacked. */
+    readonly isLoading: boolean;
+    /** Error from the fetch/unpack, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Get the text content of a file by path, or `null` if not available. */
+    readonly getFileContent: (path: string) => string | null;
+    /** Re-fetch the artifact from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches and unpacks a skill's ZIP artifact for browsing.
+ *
+ * Uses `stigmer.skill.getArtifact()` with the skill's storage key,
+ * then decompresses the ZIP using `fflate` to expose a file listing
+ * and content retrieval.
+ *
+ * Pass `null` for `artifactStorageKey` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { skill } = useSkill(org, slug);
+ * const { files, getFileContent, isLoading } = useSkillArtifact(
+ *   skill?.status?.artifactStorageKey ?? null
+ * );
+ *
+ * if (files) {
+ *   const readme = getFileContent("SKILL.md");
+ * }
+ * ```
+ */
+export declare function useSkillArtifact(artifactStorageKey: string | null): UseSkillArtifactReturn;
+//# sourceMappingURL=useSkillArtifact.d.ts.map

package/skill/useSkillArtifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillArtifact.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillArtifact.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOvD,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAChC,sBAAsB,CAqDxB"}

package/skill/useSkillArtifact.js

@@ -0,0 +1,76 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+import { fetchAndUnpackArtifact } from "./internal/fetchAndUnpackArtifact";
+// ---------------------------------------------------------------------------
+// Hook implementation
+// ---------------------------------------------------------------------------
+/**
+ * Data hook that fetches and unpacks a skill's ZIP artifact for browsing.
+ *
+ * Uses `stigmer.skill.getArtifact()` with the skill's storage key,
+ * then decompresses the ZIP using `fflate` to expose a file listing
+ * and content retrieval.
+ *
+ * Pass `null` for `artifactStorageKey` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { skill } = useSkill(org, slug);
+ * const { files, getFileContent, isLoading } = useSkillArtifact(
+ *   skill?.status?.artifactStorageKey ?? null
+ * );
+ *
+ * if (files) {
+ *   const readme = getFileContent("SKILL.md");
+ * }
+ * ```
+ */
+export function useSkillArtifact(artifactStorageKey) {
+    const stigmer = useStigmer();
+    const [files, setFiles] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const contentMapRef = useRef(new Map());
+    const fetchIdRef = useRef(0);
+    const doFetch = useCallback(async () => {
+        if (!artifactStorageKey) {
+            setFiles(null);
+            setError(null);
+            return;
+        }
+        const fetchId = ++fetchIdRef.current;
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await fetchAndUnpackArtifact(stigmer, artifactStorageKey);
+            if (fetchIdRef.current !== fetchId)
+                return;
+            contentMapRef.current = new Map(result.contentMap);
+            setFiles(result.files);
+        }
+        catch (err) {
+            if (fetchIdRef.current !== fetchId)
+                return;
+            setError(toError(err));
+            setFiles(null);
+        }
+        finally {
+            if (fetchIdRef.current === fetchId) {
+                setIsLoading(false);
+            }
+        }
+    }, [artifactStorageKey, stigmer]);
+    useEffect(() => {
+        doFetch();
+    }, [doFetch]);
+    const getFileContent = useCallback((path) => {
+        return contentMapRef.current.get(path) ?? null;
+    }, []);
+    const refetch = useCallback(() => {
+        doFetch();
+    }, [doFetch]);
+    return useMemo(() => ({ files, isLoading, error, getFileContent, refetch }), [files, isLoading, error, getFileContent, refetch]);
+}
+//# sourceMappingURL=useSkillArtifact.js.map

package/skill/useSkillArtifact.js.map

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

package/skill/useSkillDiff.d.ts

@@ -0,0 +1,31 @@
+import type { MultiFileDiffResult } from "../version-history/types";
+/** Return value of {@link useSkillDiff}. */
+export interface UseSkillDiffReturn {
+    /** Multi-file diff result, or `null` while loading / on error / when disabled. */
+    readonly diff: MultiFileDiffResult | null;
+    /** `true` while both artifacts are being fetched, unpacked, and diffed. */
+    readonly isLoading: boolean;
+    /** Error from the fetch/unpack/diff, or `null` when healthy. */
+    readonly error: Error | null;
+}
+/**
+ * Data hook that fetches two skill version artifacts and computes a
+ * multi-file diff between them.
+ *
+ * Takes two artifact storage keys (obtained from `useSkillVersions.getArtifactKey()`).
+ * Fetches both ZIPs in parallel, unpacks them, and runs `computeMultiFileDiff`
+ * on the extracted text file maps.
+ *
+ * Pass `null` for either key to disable fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { getArtifactKey } = useSkillVersions(org, slug);
+ * const { diff, isLoading } = useSkillDiff(
+ *   getArtifactKey(fromHash),
+ *   getArtifactKey(toHash),
+ * );
+ * ```
+ */
+export declare function useSkillDiff(fromArtifactKey: string | null, toArtifactKey: string | null): UseSkillDiffReturn;
+//# sourceMappingURL=useSkillDiff.d.ts.map

package/skill/useSkillDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillDiff.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillDiff.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMpE,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AASD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,kBAAkB,CAyDpB"}