@stigmer/react 0.0.36 → 0.0.40

package/skill/SkillDetailView.js

@@ -0,0 +1,157 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import Markdown from "react-markdown";
+import { cn } from "@stigmer/theme";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { SkillState } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/status_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { useSkill } from "./useSkill";
+import { ErrorMessage } from "../error/ErrorMessage";
+import { VisibilityToggle } from "../library/VisibilityToggle";
+import { MARKDOWN_COMPONENTS, REMARK_PLUGINS } from "../internal/markdown-components";
+/**
+ * Read-only detail view for a Skill knowledge package.
+ *
+ * Fetches the skill via {@link useSkill} internally and renders its
+ * full content in structured sections: header, SKILL.md content
+ * (rendered as formatted markdown), and version/provenance info.
+ * Sections with no data are omitted entirely.
+ *
+ * The SKILL.md content is the primary value of this view — it IS the
+ * skill. The markdown is rendered using the same styled component
+ * overrides used across all SDK markdown surfaces.
+ *
+ * Handles loading, error, and not-found states automatically.
+ * Zero Console dependencies — safe for platform builder embedding.
+ * All visual properties flow through `--stgm-*` design tokens.
+ *
+ * @example
+ * ```tsx
+ * // Minimal — self-contained, fetches its own data
+ * <SkillDetailView org="acme" slug="code-style-guide" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Pinned to a specific version tag
+ * <SkillDetailView org="acme" slug="code-style-guide" version="stable" />
+ * ```
+ */
+export function SkillDetailView({ org, slug, version, onResourceLoad, onVisibilityChange, isVisibilityPending, className, }) {
+    const { skill, isLoading, error, refetch } = useSkill(org, slug, version);
+    const onResourceLoadRef = useRef(onResourceLoad);
+    onResourceLoadRef.current = onResourceLoad;
+    useEffect(() => {
+        if (skill?.metadata?.name) {
+            onResourceLoadRef.current?.({ name: skill.metadata.name, id: skill.metadata.id });
+        }
+    }, [skill]);
+    if (isLoading)
+        return _jsx(LoadingSkeleton, { className: className });
+    if (error)
+        return _jsx(ErrorMessage, { error: error, retry: refetch, className: className });
+    if (!skill)
+        return _jsx(NotFoundState, { className: className });
+    const spec = skill.spec;
+    const status = skill.status;
+    const specAudit = status?.audit?.specAudit;
+    return (_jsxs("div", { className: cn("flex flex-col gap-6", className), children: [_jsx(Header, { skill: skill, createdAt: specAudit?.createdAt ? timestampDate(specAudit.createdAt) : null, updatedAt: specAudit?.updatedAt ? timestampDate(specAudit.updatedAt) : null, onVisibilityChange: onVisibilityChange, isVisibilityPending: isVisibilityPending }), spec?.skillMd && (_jsx(SkillContentSection, { content: spec.skillMd })), status && (status.versionHash || status.gitProvenance) && (_jsx(VersionSection, { versionHash: status.versionHash, gitProvenance: status.gitProvenance }))] }));
+}
+// ---------------------------------------------------------------------------
+// Internal section components
+// ---------------------------------------------------------------------------
+function Header({ skill, createdAt, updatedAt, onVisibilityChange, isVisibilityPending, }) {
+    const meta = skill.metadata;
+    const spec = skill.spec;
+    const status = skill.status;
+    const displayName = meta?.name || meta?.slug || "Untitled";
+    const isPublic = meta?.visibility === ApiResourceVisibility.visibility_public;
+    return (_jsxs("div", { className: "flex items-start gap-3", children: [_jsx(SkillIcon, { className: "mt-1 size-6 shrink-0 text-muted-foreground" }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("h2", { className: "truncate text-lg font-semibold text-foreground", children: displayName }), onVisibilityChange && meta ? (_jsx(VisibilityToggle, { visibility: meta.visibility, onVisibilityChange: onVisibilityChange, isPending: isVisibilityPending })) : (isPublic && (_jsx("span", { className: "shrink-0 rounded-full bg-muted px-2 py-0.5 text-[10px] font-medium text-muted-foreground", children: "Public" })))] }), _jsxs("div", { className: "mt-0.5 flex flex-wrap items-center gap-x-1.5 text-xs text-muted-foreground", children: [meta?.org && _jsx("span", { children: meta.org }), spec?.tag && (_jsxs(_Fragment, { children: [_jsx(Dot, {}), _jsx("span", { className: "rounded bg-muted px-1.5 py-0.5 font-mono text-[10px] font-medium", children: spec.tag })] })), status && _jsx(SkillStateBadge, { state: status.state }), createdAt && (_jsxs(_Fragment, { children: [_jsx(Dot, {}), _jsxs("span", { children: ["Created ", formatDate(createdAt)] })] })), updatedAt && (_jsxs(_Fragment, { children: [_jsx(Dot, {}), _jsxs("span", { children: ["Updated ", formatDate(updatedAt)] })] }))] }), spec?.description && (_jsx("p", { className: "mt-2 text-sm text-muted-foreground", children: spec.description }))] })] }));
+}
+function SkillStateBadge({ state }) {
+    switch (state) {
+        case SkillState.READY:
+            return (_jsxs(_Fragment, { children: [_jsx(Dot, {}), _jsxs("span", { className: "inline-flex items-center gap-1 text-emerald-600 dark:text-emerald-400", children: [_jsx(CheckIcon, { className: "size-3" }), "Ready"] })] }));
+        case SkillState.FAILED:
+            return (_jsxs(_Fragment, { children: [_jsx(Dot, {}), _jsx("span", { className: "text-destructive", children: "Failed" })] }));
+        case SkillState.UPLOADING:
+            return (_jsxs(_Fragment, { children: [_jsx(Dot, {}), _jsx("span", { className: "text-amber-600 dark:text-amber-400", children: "Uploading" })] }));
+        default:
+            return null;
+    }
+}
+function SkillContentSection({ content }) {
+    return (_jsx(Section, { title: "Skill Content", children: _jsx("div", { className: "p-4", children: _jsx(Markdown, { remarkPlugins: REMARK_PLUGINS, components: MARKDOWN_COMPONENTS, children: content }) }) }));
+}
+function VersionSection({ versionHash, gitProvenance, }) {
+    const truncatedHash = versionHash ? versionHash.slice(0, 12) : null;
+    return (_jsx(Section, { title: "Version", children: _jsxs("div", { className: "flex flex-col gap-3 p-3", children: [truncatedHash && (_jsxs("div", { className: "flex items-baseline gap-2", children: [_jsx("span", { className: "text-xs font-medium text-muted-foreground", children: "Hash" }), _jsx("code", { className: "font-mono text-xs text-foreground", title: versionHash, children: truncatedHash })] })), gitProvenance && _jsx(GitProvenanceDisplay, { provenance: gitProvenance })] }) }));
+}
+function GitProvenanceDisplay({ provenance, }) {
+    const repoUrl = normalizeGitUrl(provenance.remoteUrl);
+    const truncatedCommit = provenance.commit
+        ? provenance.commit.slice(0, 7)
+        : null;
+    return (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsxs("div", { className: "flex items-baseline gap-2", children: [_jsx("span", { className: "text-xs font-medium text-muted-foreground", children: "Git" }), _jsxs("div", { className: "flex flex-wrap items-baseline gap-x-1.5 text-xs text-foreground", children: [repoUrl ? (_jsx("a", { href: repoUrl, className: "text-primary underline underline-offset-2 hover:text-primary/80", target: "_blank", rel: "noopener noreferrer", children: formatRepoName(repoUrl) })) : (_jsx("span", { className: "font-mono", children: provenance.remoteUrl })), provenance.ref && (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-muted-foreground", children: "@" }), _jsx("span", { children: provenance.ref })] })), truncatedCommit && (_jsx("code", { className: "rounded bg-muted px-1 py-0.5 font-mono text-[10px]", title: provenance.commit, children: truncatedCommit }))] })] }), provenance.subdir && (_jsxs("div", { className: "flex items-baseline gap-2", children: [_jsx("span", { className: "text-xs font-medium text-muted-foreground", children: "Path" }), _jsx("code", { className: "font-mono text-xs text-foreground", children: provenance.subdir })] }))] }));
+}
+// ---------------------------------------------------------------------------
+// Shared layout primitives
+// ---------------------------------------------------------------------------
+function Section({ title, children, }) {
+    return (_jsxs("section", { children: [_jsx("h3", { className: "mb-2 text-xs font-medium uppercase tracking-wider text-muted-foreground", children: title }), _jsx("div", { className: "overflow-hidden rounded-lg border border-border", children: children })] }));
+}
+function Dot() {
+    return (_jsx("span", { className: "shrink-0", "aria-hidden": "true", children: "\u00B7" }));
+}
+// ---------------------------------------------------------------------------
+// Non-happy states
+// ---------------------------------------------------------------------------
+function LoadingSkeleton({ className }) {
+    return (_jsxs("div", { className: cn("flex flex-col gap-6", className), "aria-busy": "true", "aria-label": "Loading skill details", children: [_jsxs("div", { className: "flex items-start gap-3", children: [_jsx("div", { className: "mt-1 size-6 shrink-0 animate-pulse rounded bg-muted" }), _jsxs("div", { className: "flex-1 space-y-2", children: [_jsx("div", { className: "h-5 w-48 animate-pulse rounded bg-muted" }), _jsx("div", { className: "h-3 w-64 animate-pulse rounded bg-muted" }), _jsx("div", { className: "h-4 w-full max-w-md animate-pulse rounded bg-muted" })] })] }), _jsxs("div", { className: "space-y-2", children: [_jsx("div", { className: "h-3 w-28 animate-pulse rounded bg-muted" }), _jsx("div", { className: "animate-pulse rounded-lg border border-border bg-muted/30", style: { height: "240px" } })] }), _jsxs("div", { className: "space-y-2", children: [_jsx("div", { className: "h-3 w-20 animate-pulse rounded bg-muted" }), _jsx("div", { className: "animate-pulse rounded-lg border border-border bg-muted/30", style: { height: "64px" } })] })] }));
+}
+function NotFoundState({ className }) {
+    return (_jsxs("div", { role: "status", className: cn("flex flex-col items-center gap-2 py-12 text-center", className), children: [_jsx(SkillIcon, { className: "size-10 text-muted-foreground/40" }), _jsx("p", { className: "text-sm font-medium text-muted-foreground", children: "Skill not found" }), _jsx("p", { className: "text-xs text-muted-foreground/60", children: "This skill doesn't exist or you don't have access to it." })] }));
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+function formatDate(date) {
+    return date.toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+        year: "numeric",
+    });
+}
+function normalizeGitUrl(url) {
+    if (!url)
+        return null;
+    const cleaned = url.replace(/\.git$/, "");
+    if (cleaned.startsWith("https://") || cleaned.startsWith("http://")) {
+        return cleaned;
+    }
+    const sshMatch = cleaned.match(/^(?:git@|ssh:\/\/)([^:/]+)[:/](.+)$/);
+    if (sshMatch) {
+        return `https://${sshMatch[1]}/${sshMatch[2]}`;
+    }
+    return null;
+}
+function formatRepoName(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.pathname.replace(/^\//, "").replace(/\.git$/, "");
+    }
+    catch {
+        return url;
+    }
+}
+// ---------------------------------------------------------------------------
+// Icons — inline SVGs following the SDK pattern (no icon library dependency)
+// ---------------------------------------------------------------------------
+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 CheckIcon({ className }) {
+    return (_jsx("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m3 8.5 3.5 3.5 6.5-8" }) }));
+}
+//# sourceMappingURL=SkillDetailView.js.map

package/skill/SkillDetailView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDetailView.js","sourceRoot":"","sources":["../../src/skill/SkillDetailView.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,uDAAuD,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AA+BtF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,GAAG,EACH,IAAI,EACJ,OAAO,EACP,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,GACY;IACrB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE1E,MAAM,iBAAiB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IACjD,iBAAiB,CAAC,OAAO,GAAG,cAAc,CAAC;IAE3C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC1B,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,IAAI,SAAS;QAAE,OAAO,KAAC,eAAe,IAAC,SAAS,EAAE,SAAS,GAAI,CAAC;IAChE,IAAI,KAAK;QACP,OAAO,KAAC,YAAY,IAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAI,CAAC;IAC9E,IAAI,CAAC,KAAK;QAAE,OAAO,KAAC,aAAa,IAAC,SAAS,EAAE,SAAS,GAAI,CAAC;IAE3D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,SAAS,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC;IAE3C,OAAO,CACL,eAAK,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,aAClD,KAAC,MAAM,IACL,KAAK,EAAE,KAAK,EACZ,SAAS,EACP,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAElE,SAAS,EACP,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAElE,kBAAkB,EAAE,kBAAkB,EACtC,mBAAmB,EAAE,mBAAmB,GACxC,EAED,IAAI,EAAE,OAAO,IAAI,CAChB,KAAC,mBAAmB,IAAC,OAAO,EAAE,IAAI,CAAC,OAAO,GAAI,CAC/C,EAEA,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CACzD,KAAC,cAAc,IACb,WAAW,EAAE,MAAM,CAAC,WAAW,EAC/B,aAAa,EAAE,MAAM,CAAC,aAAa,GACnC,CACH,IACG,CACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,SAAS,MAAM,CAAC,EACd,KAAK,EACL,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,mBAAmB,GAOpB;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,WAAW,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,UAAU,CAAC;IAC3D,MAAM,QAAQ,GACZ,IAAI,EAAE,UAAU,KAAK,qBAAqB,CAAC,iBAAiB,CAAC;IAE/D,OAAO,CACL,eAAK,SAAS,EAAC,wBAAwB,aACrC,KAAC,SAAS,IAAC,SAAS,EAAC,4CAA4C,GAAG,EACpE,eAAK,SAAS,EAAC,gBAAgB,aAC7B,eAAK,SAAS,EAAC,yBAAyB,aACtC,aAAI,SAAS,EAAC,gDAAgD,YAC3D,WAAW,GACT,EACJ,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,CAC5B,KAAC,gBAAgB,IACf,UAAU,EAAE,IAAI,CAAC,UAAU,EAC3B,kBAAkB,EAAE,kBAAkB,EACtC,SAAS,EAAE,mBAAmB,GAC9B,CACH,CAAC,CAAC,CAAC,CACF,QAAQ,IAAI,CACV,eAAM,SAAS,EAAC,0FAA0F,uBAEnG,CACR,CACF,IACG,EACN,eAAK,SAAS,EAAC,4EAA4E,aACxF,IAAI,EAAE,GAAG,IAAI,yBAAO,IAAI,CAAC,GAAG,GAAQ,EACpC,IAAI,EAAE,GAAG,IAAI,CACZ,8BACE,KAAC,GAAG,KAAG,EACP,eAAM,SAAS,EAAC,kEAAkE,YAC/E,IAAI,CAAC,GAAG,GACJ,IACN,CACJ,EACA,MAAM,IAAI,KAAC,eAAe,IAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAI,EAClD,SAAS,IAAI,CACZ,8BACE,KAAC,GAAG,KAAG,EACP,uCAAe,UAAU,CAAC,SAAS,CAAC,IAAQ,IAC3C,CACJ,EACA,SAAS,IAAI,CACZ,8BACE,KAAC,GAAG,KAAG,EACP,uCAAe,UAAU,CAAC,SAAS,CAAC,IAAQ,IAC3C,CACJ,IACG,EACL,IAAI,EAAE,WAAW,IAAI,CACpB,YAAG,SAAS,EAAC,oCAAoC,YAC9C,IAAI,CAAC,WAAW,GACf,CACL,IACG,IACF,CACP,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,EAAE,KAAK,EAAkC;IAChE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CACL,8BACE,KAAC,GAAG,KAAG,EACP,gBAAM,SAAS,EAAC,uEAAuE,aACrF,KAAC,SAAS,IAAC,SAAS,EAAC,QAAQ,GAAG,aAE3B,IACN,CACJ,CAAC;QACJ,KAAK,UAAU,CAAC,MAAM;YACpB,OAAO,CACL,8BACE,KAAC,GAAG,KAAG,EACP,eAAM,SAAS,EAAC,kBAAkB,uBAAc,IAC/C,CACJ,CAAC;QACJ,KAAK,UAAU,CAAC,SAAS;YACvB,OAAO,CACL,8BACE,KAAC,GAAG,KAAG,EACP,eAAM,SAAS,EAAC,oCAAoC,0BAAiB,IACpE,CACJ,CAAC;QACJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAE,OAAO,EAAgC;IACpE,OAAO,CACL,KAAC,OAAO,IAAC,KAAK,EAAC,eAAe,YAC5B,cAAK,SAAS,EAAC,KAAK,YAClB,KAAC,QAAQ,IACP,aAAa,EAAE,cAAc,EAC7B,UAAU,EAAE,mBAAmB,YAE9B,OAAO,GACC,GACP,GACE,CACX,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,EACtB,WAAW,EACX,aAAa,GAId;IACC,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpE,OAAO,CACL,KAAC,OAAO,IAAC,KAAK,EAAC,SAAS,YACtB,eAAK,SAAS,EAAC,yBAAyB,aACrC,aAAa,IAAI,CAChB,eAAK,SAAS,EAAC,2BAA2B,aACxC,eAAM,SAAS,EAAC,2CAA2C,qBAEpD,EACP,eACE,SAAS,EAAC,mCAAmC,EAC7C,KAAK,EAAE,WAAW,YAEjB,aAAa,GACT,IACH,CACP,EAEA,aAAa,IAAI,KAAC,oBAAoB,IAAC,UAAU,EAAE,aAAa,GAAI,IACjE,GACE,CACX,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,EAC5B,UAAU,GAGX;IACC,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM;QACvC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC;IAET,OAAO,CACL,eAAK,SAAS,EAAC,uBAAuB,aACpC,eAAK,SAAS,EAAC,2BAA2B,aACxC,eAAM,SAAS,EAAC,2CAA2C,oBAAW,EACtE,eAAK,SAAS,EAAC,iEAAiE,aAC7E,OAAO,CAAC,CAAC,CAAC,CACT,YACE,IAAI,EAAE,OAAO,EACb,SAAS,EAAC,iEAAiE,EAC3E,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,YAExB,cAAc,CAAC,OAAO,CAAC,GACtB,CACL,CAAC,CAAC,CAAC,CACF,eAAM,SAAS,EAAC,WAAW,YAAE,UAAU,CAAC,SAAS,GAAQ,CAC1D,EACA,UAAU,CAAC,GAAG,IAAI,CACjB,8BACE,eAAM,SAAS,EAAC,uBAAuB,kBAAS,EAChD,yBAAO,UAAU,CAAC,GAAG,GAAQ,IAC5B,CACJ,EACA,eAAe,IAAI,CAClB,eACE,SAAS,EAAC,oDAAoD,EAC9D,KAAK,EAAE,UAAU,CAAC,MAAM,YAEvB,eAAe,GACX,CACR,IACG,IACF,EACL,UAAU,CAAC,MAAM,IAAI,CACpB,eAAK,SAAS,EAAC,2BAA2B,aACxC,eAAM,SAAS,EAAC,2CAA2C,qBAEpD,EACP,eAAM,SAAS,EAAC,mCAAmC,YAChD,UAAU,CAAC,MAAM,GACb,IACH,CACP,IACG,CACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,OAAO,CAAC,EACf,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,CACL,8BACE,aAAI,SAAS,EAAC,yEAAyE,YACpF,KAAK,GACH,EACL,cAAK,SAAS,EAAC,iDAAiD,YAC7D,QAAQ,GACL,IACE,CACX,CAAC;AACJ,CAAC;AAED,SAAS,GAAG;IACV,OAAO,CACL,eAAM,SAAS,EAAC,UAAU,iBAAa,MAAM,YAC1C,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,eAAe,CAAC,EAAE,SAAS,EAAmC;IACrE,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,eACrC,MAAM,gBACL,uBAAuB,aAElC,eAAK,SAAS,EAAC,wBAAwB,aACrC,cAAK,SAAS,EAAC,qDAAqD,GAAG,EACvE,eAAK,SAAS,EAAC,kBAAkB,aAC/B,cAAK,SAAS,EAAC,yCAAyC,GAAG,EAC3D,cAAK,SAAS,EAAC,yCAAyC,GAAG,EAC3D,cAAK,SAAS,EAAC,oDAAoD,GAAG,IAClE,IACF,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,cAAK,SAAS,EAAC,yCAAyC,GAAG,EAC3D,cACE,SAAS,EAAC,2DAA2D,EACrE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAC1B,IACE,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,cAAK,SAAS,EAAC,yCAAyC,GAAG,EAC3D,cACE,SAAS,EAAC,2DAA2D,EACrE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GACzB,IACE,IACF,CACP,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,EAAE,SAAS,EAAmC;IACnE,OAAO,CACL,eACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,EAAE,CACX,oDAAoD,EACpD,SAAS,CACV,aAED,KAAC,SAAS,IAAC,SAAS,EAAC,kCAAkC,GAAG,EAC1D,YAAG,SAAS,EAAC,2CAA2C,gCAEpD,EACJ,YAAG,SAAS,EAAC,kCAAkC,yEAE3C,IACA,CACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,SAAS,UAAU,CAAC,IAAU;IAC5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACtC,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACtE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,WAAW,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAE9E,SAAS,SAAS,CAAC,EAAE,SAAS,EAAmC;IAC/D,OAAO,CACL,cACE,SAAS,EAAE,SAAS,EACpB,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,YAElB,eAAM,CAAC,EAAC,mCAAmC,GAAG,GAC1C,CACP,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,EAAE,SAAS,EAAmC;IAC/D,OAAO,CACL,cACE,SAAS,EAAE,SAAS,EACpB,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,GAAG,EACf,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACV,MAAM,YAElB,eAAM,CAAC,EAAC,sBAAsB,GAAG,GAC7B,CACP,CAAC;AACJ,CAAC"}

package/skill/SkillPicker.d.ts

@@ -0,0 +1,26 @@
+import type { ResourceRef } from "@stigmer/sdk";
+export interface SkillPickerProps {
+    /** Organization slug to scope the search. */
+    readonly org: string;
+    /** Currently selected skill references. */
+    readonly value: ResourceRef[];
+    /** Called when the selection changes. */
+    readonly onChange: (refs: ResourceRef[]) => void;
+    /** Called with the display name when an item is added (for chip rendering). */
+    readonly onDisplayNameResolved?: (key: string, name: string) => void;
+    readonly disabled?: boolean;
+    readonly className?: string;
+}
+/**
+ * Searchable picker for selecting skills from the platform.
+ *
+ * Renders a search input and scrollable list of available skills.
+ * Designed to be placed inside a popover container — this component
+ * renders the picker content, not the popover shell.
+ *
+ * Selected skills produce `ResourceRef[]` with `kind: skill`.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ */
+export declare function SkillPicker({ org, value, onChange, onDisplayNameResolved, disabled, className, }: SkillPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SkillPicker.d.ts.map

package/skill/SkillPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillPicker.d.ts","sourceRoot":"","sources":["../../src/skill/SkillPicker.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACjD,+EAA+E;IAC/E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,KAAK,EACL,QAAQ,EACR,qBAAqB,EACrB,QAAQ,EACR,SAAS,GACV,EAAE,gBAAgB,2CA8MlB"}

package/skill/SkillPicker.js

@@ -0,0 +1,102 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useCallback, useEffect, useRef, useMemo, } from "react";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { cn } from "@stigmer/theme";
+import { useSkillSearch } from "./useSkillSearch";
+import { useScrollShadows } from "../internal/useScrollShadows";
+import { ScrollFade } from "../internal/ScrollFade";
+function refKey(ref) {
+    return `${ref.org}/${ref.slug}`;
+}
+const LIST_ID = "stgm-skill-list";
+/**
+ * Searchable picker for selecting skills from the platform.
+ *
+ * Renders a search input and scrollable list of available skills.
+ * Designed to be placed inside a popover container — this component
+ * renders the picker content, not the popover shell.
+ *
+ * Selected skills produce `ResourceRef[]` with `kind: skill`.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ */
+export function SkillPicker({ org, value, onChange, onDisplayNameResolved, disabled, className, }) {
+    const { results, isLoading, error, query, setQuery } = useSkillSearch(org);
+    const [focusIndex, setFocusIndex] = useState(-1);
+    const searchRef = useRef(null);
+    const results_ = useScrollShadows();
+    const selected_ = useScrollShadows();
+    const selectedKeys = useMemo(() => new Set(value.map(refKey)), [value]);
+    const availableResults = useMemo(() => results.filter((r) => !selectedKeys.has(`${r.org}/${r.slug}`)), [results, selectedKeys]);
+    useEffect(() => {
+        setFocusIndex(-1);
+    }, [query]);
+    useEffect(() => {
+        if (focusIndex >= 0) {
+            results_.scrollRef.current
+                ?.querySelector(`[data-idx="${focusIndex}"]`)
+                ?.scrollIntoView({ block: "nearest" });
+        }
+    }, [focusIndex, results_.scrollRef]);
+    const handleSelect = useCallback((result) => {
+        const ref = {
+            org: result.org,
+            slug: result.slug,
+            kind: ApiResourceKind.skill,
+        };
+        onChange([...value, ref]);
+        onDisplayNameResolved?.(`${result.org}/${result.slug}`, result.name);
+    }, [value, onChange, onDisplayNameResolved]);
+    const handleRemove = useCallback((key) => {
+        onChange(value.filter((r) => refKey(r) !== key));
+    }, [value, onChange]);
+    const handleSearchKeyDown = useCallback((e) => {
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setFocusIndex((prev) => prev < availableResults.length - 1 ? prev + 1 : prev);
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setFocusIndex((prev) => (prev > 0 ? prev - 1 : -1));
+        }
+        else if (e.key === "Enter" &&
+            focusIndex >= 0 &&
+            focusIndex < availableResults.length) {
+            e.preventDefault();
+            handleSelect(availableResults[focusIndex]);
+        }
+        else if (e.key === "Enter") {
+            e.preventDefault();
+        }
+    }, [availableResults, focusIndex, handleSelect]);
+    return (_jsxs("div", { className: ["space-y-2 w-72", className].filter(Boolean).join(" "), children: [value.length > 0 && (_jsxs("div", { className: "space-y-1", children: [_jsx("div", { className: "text-[0.65rem] font-medium text-muted-foreground", children: "Selected" }), _jsxs("div", { className: "relative", children: [selected_.canScrollUp && _jsx(ScrollFade, { position: "top" }), _jsx("div", { ref: selected_.scrollRef, className: "max-h-28 space-y-1 overflow-y-auto", children: value.map((ref) => {
+                                    const key = refKey(ref);
+                                    return (_jsxs("div", { className: "flex items-center gap-2 rounded-md bg-muted/30 px-2 py-1 text-xs", children: [_jsx(SkillIcon, {}), _jsx("span", { className: "min-w-0 flex-1 truncate text-foreground", children: ref.slug }), _jsx("button", { type: "button", onClick: () => handleRemove(key), disabled: disabled, className: "shrink-0 text-muted-foreground hover:text-destructive disabled:pointer-events-none", "aria-label": `Remove ${ref.slug}`, children: _jsx(XIcon, {}) })] }, key));
+                                }) }), selected_.canScrollDown && _jsx(ScrollFade, { position: "bottom" })] })] })), _jsx("input", { ref: searchRef, type: "text", role: "combobox", "aria-expanded": true, "aria-controls": LIST_ID, "aria-activedescendant": focusIndex >= 0 ? `stgm-skill-${focusIndex}` : undefined, placeholder: "Search skills...", value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: handleSearchKeyDown, disabled: disabled, className: "w-full rounded-md border border-input bg-background px-2.5 py-1.5 text-xs text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50", autoFocus: true }), error && _jsx("p", { className: "text-xs text-destructive", children: error }), _jsxs("div", { className: "relative", children: [results_.canScrollUp && _jsx(ScrollFade, { position: "top" }), _jsx("div", { ref: results_.scrollRef, id: LIST_ID, role: "listbox", "aria-label": "Skills", className: "max-h-52 overflow-y-auto", children: isLoading ? (_jsx(LoadingSkeleton, {})) : availableResults.length === 0 ? (_jsx("div", { className: "py-4 text-center text-xs text-muted-foreground", children: query
+                                ? "No skills match your search"
+                                : value.length > 0
+                                    ? "All available skills selected"
+                                    : "No skills found" })) : (availableResults.map((result, idx) => (_jsxs("button", { id: `stgm-skill-${idx}`, type: "button", "data-idx": idx, onClick: () => handleSelect(result), disabled: disabled, className: cn("group flex w-full flex-col gap-0.5 rounded-md px-2 py-1.5 text-left text-xs transition-colors", "disabled:pointer-events-none disabled:opacity-50", idx === focusIndex
+                                ? "bg-accent text-foreground"
+                                : "text-foreground hover:bg-accent/50"), role: "option", "aria-selected": idx === focusIndex, children: [_jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx(SkillIcon, {}), _jsx("span", { className: "truncate font-medium", children: _jsx(HighlightMatch, { text: result.name, query: query }) }), _jsx("span", { className: "ml-auto shrink-0 text-[0.6rem] text-muted-foreground", children: result.org })] }), result.description && (_jsx("span", { className: cn("pl-5 text-[0.65rem] text-muted-foreground", idx !== focusIndex &&
+                                        "line-clamp-2 group-hover:line-clamp-none"), children: result.description }))] }, result.id)))) }), results_.canScrollDown && _jsx(ScrollFade, { position: "bottom" })] })] }));
+}
+function HighlightMatch({ text, query }) {
+    if (!query)
+        return _jsx(_Fragment, { children: text });
+    const idx = text.toLowerCase().indexOf(query.toLowerCase());
+    if (idx === -1)
+        return _jsx(_Fragment, { children: text });
+    return (_jsxs(_Fragment, { children: [text.slice(0, idx), _jsx("span", { className: "font-semibold", children: text.slice(idx, idx + query.length) }), text.slice(idx + query.length)] }));
+}
+function LoadingSkeleton() {
+    return (_jsx("div", { className: "space-y-1 py-1", children: [55, 70, 45, 62].map((w, i) => (_jsxs("div", { className: "flex flex-col gap-1 px-2 py-1.5", children: [_jsx("div", { className: "h-3 rounded bg-muted animate-pulse", style: { width: `${w}%` } }), _jsx("div", { className: "h-2 rounded bg-muted/60 animate-pulse", style: { width: `${Math.min(w + 15, 90)}%` } })] }, i))) }));
+}
+function SkillIcon() {
+    return (_jsx("svg", { width: "12", height: "12", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: _jsx("path", { d: "M2 3h12M2 7h8M2 11h10M2 15h6" }) }));
+}
+function XIcon() {
+    return (_jsx("svg", { width: "12", height: "12", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M4 4L10 10M10 4L4 10" }) }));
+}
+//# sourceMappingURL=SkillPicker.js.map

package/skill/SkillPicker.js.map

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

package/skill/index.d.ts

@@ -1,3 +1,13 @@
-export { useSkillSearch } from "./hooks/useSkillSearch";
-export type { UseSkillSearchOptions, UseSkillSearchReturn, } from "./hooks/useSkillSearch";
+export { useSkillList } from "./useSkillList";
+export type { UseSkillListOptions, UseSkillListReturn, } from "./useSkillList";
+export { useSkillCount } from "./useSkillCount";
+export type { UseSkillCountOptions, UseSkillCountReturn, } from "./useSkillCount";
+export { useSkillSearch } from "./useSkillSearch";
+export type { UseSkillSearchOptions, UseSkillSearchReturn, } from "./useSkillSearch";
+export { useSkill } from "./useSkill";
+export type { UseSkillReturn } from "./useSkill";
+export { SkillPicker } from "./SkillPicker";
+export type { SkillPickerProps } from "./SkillPicker";
+export { SkillDetailView } from "./SkillDetailView";
+export type { SkillDetailViewProps } from "./SkillDetailView";
 //# 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":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,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"}

package/skill/index.js

@@ -1,3 +1,7 @@
-// Hooks
-export { useSkillSearch } from "./hooks/useSkillSearch";
+export { useSkillList } from "./useSkillList";
+export { useSkillCount } from "./useSkillCount";
+export { useSkillSearch } from "./useSkillSearch";
+export { useSkill } from "./useSkill";
+export { SkillPicker } from "./SkillPicker";
+export { SkillDetailView } from "./SkillDetailView";
 //# 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,QAAQ;AACR,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,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"}

package/skill/useSkill.d.ts

@@ -0,0 +1,49 @@
+import type { Skill } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/api_pb";
+export interface UseSkillReturn {
+    /** The resolved skill, or `null` while loading, on error, or when not found. */
+    readonly skill: Skill | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    /** Re-fetch the skill with the same parameters. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single Skill by organization, slug, and
+ * optional version.
+ *
+ * Wraps `stigmer.skill.getByReference()` with loading, error, and
+ * not-found state management. When `org`, `slug`, or `version` change,
+ * the previous in-flight request is discarded and a fresh fetch begins.
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op). The `version` parameter is optional — omit it to fetch the
+ * latest version. Pass a tag (e.g. `"stable"`) or a content hash to
+ * pin to a specific version.
+ *
+ * **Not-found handling:** If the API returns a 404 (NOT_FOUND), the
+ * hook sets `skill` to `null` without raising an error. Consumers
+ * distinguish "not found" from "loading" by checking all three fields:
+ * `skill === null && !isLoading && !error` means the resource does
+ * not exist.
+ *
+ * @example
+ * ```tsx
+ * function SkillDetail({ org, slug }: { org: string; slug: string }) {
+ *   const { skill, isLoading, error } = useSkill(org, slug);
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!skill) return <NotFound />;
+ *
+ *   return <h1>{skill.metadata?.name}</h1>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Fetch a specific tagged version
+ * const { skill } = useSkill("acme", "code-style-guide", "stable");
+ * ```
+ */
+export declare function useSkill(org: string | null, slug: string | null, version?: string): UseSkillReturn;
+//# sourceMappingURL=useSkill.d.ts.map

package/skill/useSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkill.d.ts","sourceRoot":"","sources":["../../src/skill/useSkill.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAKhF,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CA6ChB"}

package/skill/useSkill.js

@@ -0,0 +1,83 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches a single Skill by organization, slug, and
+ * optional version.
+ *
+ * Wraps `stigmer.skill.getByReference()` with loading, error, and
+ * not-found state management. When `org`, `slug`, or `version` change,
+ * the previous in-flight request is discarded and a fresh fetch begins.
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op). The `version` parameter is optional — omit it to fetch the
+ * latest version. Pass a tag (e.g. `"stable"`) or a content hash to
+ * pin to a specific version.
+ *
+ * **Not-found handling:** If the API returns a 404 (NOT_FOUND), the
+ * hook sets `skill` to `null` without raising an error. Consumers
+ * distinguish "not found" from "loading" by checking all three fields:
+ * `skill === null && !isLoading && !error` means the resource does
+ * not exist.
+ *
+ * @example
+ * ```tsx
+ * function SkillDetail({ org, slug }: { org: string; slug: string }) {
+ *   const { skill, isLoading, error } = useSkill(org, slug);
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!skill) return <NotFound />;
+ *
+ *   return <h1>{skill.metadata?.name}</h1>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Fetch a specific tagged version
+ * const { skill } = useSkill("acme", "code-style-guide", "stable");
+ * ```
+ */
+export function useSkill(org, slug, version) {
+    const stigmer = useStigmer();
+    const [skill, setSkill] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!org || !slug) {
+            setSkill(null);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.skill.getByReference({ org, slug, version }).then((result) => {
+            if (cancelled.current)
+                return;
+            setSkill(result);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            if (isNotFound(err)) {
+                setSkill(null);
+                setIsLoading(false);
+                return;
+            }
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, slug, version, stigmer, fetchKey]);
+    return { skill, isLoading, error, refetch };
+}
+//# sourceMappingURL=useSkill.js.map

package/skill/useSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkill.js","sourceRoot":"","sources":["../../src/skill/useSkill.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAW9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAkB,EAClB,IAAmB,EACnB,OAAgB;IAEhB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,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;IACvD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CACvD,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE5C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/skill/useSkillCount.d.ts

@@ -0,0 +1,49 @@
+import { type ResourceListScope } from "../search";
+export interface UseSkillCountOptions {
+    /** Text query to filter skills before counting. */
+    readonly query?: string;
+    /**
+     * Controls which skills are counted.
+     *
+     * - `"org"` — only skills owned by the given organization.
+     * - `"all"` — includes public/platform skills.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+export interface UseSkillCountReturn {
+    /**
+     * Total number of skills matching the current filters. `undefined`
+     * until the first successful fetch completes.
+     */
+    readonly count: number | undefined;
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    /** Re-fetch the count with the same parameters. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the total count of skills.
+ *
+ * Issues a minimal `stigmer.skill.list()` call to retrieve only the
+ * total count — no skill entries are returned or stored. Useful for
+ * summary cards, badges, and dashboard widgets.
+ *
+ * For the full paginated skill list, use {@link useSkillList} instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useSkillCount("acme");
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Count all accessible skills including public/platform ones
+ * const { count } = useSkillCount("acme", { scope: "all" });
+ * ```
+ */
+export declare function useSkillCount(org: string | null, options?: UseSkillCountOptions): UseSkillCountReturn;
+//# sourceMappingURL=useSkillCount.d.ts.map

package/skill/useSkillCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillCount.d.ts","sourceRoot":"","sources":["../../src/skill/useSkillCount.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,mBAAmB,CAUrB"}

package/skill/useSkillCount.js

@@ -0,0 +1,32 @@
+"use client";
+import { useCallback } from "react";
+import { useStigmer } from "../hooks";
+import { useResourceCount } from "../search";
+/**
+ * Data hook that fetches the total count of skills.
+ *
+ * Issues a minimal `stigmer.skill.list()` call to retrieve only the
+ * total count — no skill entries are returned or stored. Useful for
+ * summary cards, badges, and dashboard widgets.
+ *
+ * For the full paginated skill list, use {@link useSkillList} instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useSkillCount("acme");
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Count all accessible skills including public/platform ones
+ * const { count } = useSkillCount("acme", { scope: "all" });
+ * ```
+ */
+export function useSkillCount(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useCallback((params) => stigmer.skill.list(params), [stigmer]);
+    return useResourceCount(listFn, org, options);
+}
+//# sourceMappingURL=useSkillCount.js.map

package/skill/useSkillCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillCount.js","sourceRoot":"","sources":["../../src/skill/useSkillCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAA0B,MAAM,WAAW,CAAC;AA4BrE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAkB,EAClB,OAA8B;IAE9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,MAAgD,EAAE,EAAE,CACnD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAC5B,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}