@stigmer/react 0.0.36 → 0.0.40

package/library/serialize-resource-yaml.js

@@ -0,0 +1,294 @@
+import { stringify as stringifyYaml } from "yaml";
+/**
+ * Serializes a proto `Agent` into the canonical Stigmer YAML format.
+ *
+ * This is the inverse of {@link parseResourceYaml} — the serialized YAML
+ * is round-trip compatible and can be fed back through `parseResourceYaml`
+ * to produce a valid `AgentInput`.
+ *
+ * Only emits `apiVersion`, `kind`, `metadata`, and `spec`. The `status`
+ * field is system-managed and never included in the YAML output.
+ *
+ * Uses snake_case field names in the YAML to match the proto canonical form,
+ * which is the format expected by both the backend and `parseResourceYaml`.
+ *
+ * @param agent - The proto `Agent` resource to serialize.
+ * @returns A YAML string suitable for editing and re-applying.
+ *
+ * @example
+ * ```ts
+ * import { serializeAgentYaml } from "@stigmer/react";
+ *
+ * const yaml = serializeAgentYaml(agent);
+ * const file = new File([yaml], "my-agent.yaml", { type: "text/yaml" });
+ * ```
+ *
+ * @see {@link parseResourceYaml} for the inverse operation
+ */
+export function serializeAgentYaml(agent) {
+    const doc = {
+        apiVersion: agent.apiVersion || "agentic.stigmer.ai/v1",
+        kind: agent.kind || "Agent",
+        metadata: buildMetadata(agent.metadata),
+        spec: buildAgentSpec(agent.spec),
+    };
+    return stringifyYaml(doc, { lineWidth: 0, blockQuote: "literal" });
+}
+/**
+ * Serializes a proto `McpServer` into the canonical Stigmer YAML format.
+ *
+ * This is the inverse of {@link parseResourceYaml} for McpServer resources.
+ * Same round-trip guarantee and snake_case convention as {@link serializeAgentYaml}.
+ *
+ * @param mcpServer - The proto `McpServer` resource to serialize.
+ * @returns A YAML string suitable for editing and re-applying.
+ *
+ * @example
+ * ```ts
+ * import { serializeMcpServerYaml } from "@stigmer/react";
+ *
+ * const yaml = serializeMcpServerYaml(mcpServer);
+ * const file = new File([yaml], "my-server.yaml", { type: "text/yaml" });
+ * ```
+ *
+ * @see {@link parseResourceYaml} for the inverse operation
+ */
+export function serializeMcpServerYaml(mcpServer) {
+    const doc = {
+        apiVersion: mcpServer.apiVersion || "agentic.stigmer.ai/v1",
+        kind: mcpServer.kind || "McpServer",
+        metadata: buildMetadata(mcpServer.metadata),
+        spec: buildMcpServerSpec(mcpServer.spec),
+    };
+    return stringifyYaml(doc, { lineWidth: 0, blockQuote: "literal" });
+}
+// ---------------------------------------------------------------------------
+// Metadata
+// ---------------------------------------------------------------------------
+function buildMetadata(metadata) {
+    if (!metadata)
+        return {};
+    const result = {
+        name: metadata.name,
+    };
+    if (metadata.org) {
+        result.org = metadata.org;
+    }
+    if (metadata.slug && metadata.slug !== metadata.name) {
+        result.slug = metadata.slug;
+    }
+    if (hasEntries(metadata.labels)) {
+        result.labels = { ...metadata.labels };
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Agent spec
+// ---------------------------------------------------------------------------
+function buildAgentSpec(spec) {
+    if (!spec)
+        return {};
+    const result = {};
+    if (spec.description) {
+        result.description = spec.description;
+    }
+    if (spec.iconUrl) {
+        result.icon_url = spec.iconUrl;
+    }
+    if (spec.instructions) {
+        result.instructions = spec.instructions;
+    }
+    if (spec.mcpServerUsages.length > 0) {
+        result.mcp_server_usages = spec.mcpServerUsages.map(serializeMcpServerUsage);
+    }
+    if (spec.skillRefs.length > 0) {
+        result.skill_refs = spec.skillRefs.map(serializeResourceRef);
+    }
+    if (spec.subAgents.length > 0) {
+        result.sub_agents = spec.subAgents.map(serializeSubAgent);
+    }
+    if (spec.envSpec) {
+        const envSpec = serializeEnvSpec(spec.envSpec);
+        if (envSpec) {
+            result.env_spec = envSpec;
+        }
+    }
+    return result;
+}
+function serializeMcpServerUsage(usage) {
+    const result = {};
+    if (usage.mcpServerRef) {
+        result.mcp_server_ref = serializeResourceRef(usage.mcpServerRef);
+    }
+    if (usage.enabledTools.length > 0) {
+        result.enabled_tools = [...usage.enabledTools];
+    }
+    if (usage.toolApprovalOverrides.length > 0) {
+        result.tool_approval_overrides =
+            usage.toolApprovalOverrides.map(serializeToolApprovalOverride);
+    }
+    return result;
+}
+function serializeToolApprovalOverride(override) {
+    const result = {
+        tool_name: override.toolName,
+        requires_approval: override.requiresApproval,
+    };
+    if (override.message) {
+        result.message = override.message;
+    }
+    return result;
+}
+function serializeSubAgent(sub) {
+    const result = {
+        name: sub.name,
+    };
+    if (sub.description) {
+        result.description = sub.description;
+    }
+    if (sub.instructions) {
+        result.instructions = sub.instructions;
+    }
+    if (sub.modelOverride) {
+        result.model_override = sub.modelOverride;
+    }
+    if (sub.mcpAccess.length > 0) {
+        result.mcp_access = sub.mcpAccess.map(serializeMcpAccess);
+    }
+    if (sub.skillRefs.length > 0) {
+        result.skill_refs = sub.skillRefs.map(serializeResourceRef);
+    }
+    return result;
+}
+function serializeMcpAccess(access) {
+    const result = {
+        mcp_server: access.mcpServer,
+    };
+    if (access.enabledTools.length > 0) {
+        result.enabled_tools = [...access.enabledTools];
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// McpServer spec
+// ---------------------------------------------------------------------------
+function buildMcpServerSpec(spec) {
+    if (!spec)
+        return {};
+    const result = {};
+    if (spec.description) {
+        result.description = spec.description;
+    }
+    if (spec.iconUrl) {
+        result.icon_url = spec.iconUrl;
+    }
+    if (spec.tags.length > 0) {
+        result.tags = [...spec.tags];
+    }
+    if (spec.serverType.case === "stdio") {
+        result.stdio = serializeStdioConfig(spec.serverType.value);
+    }
+    else if (spec.serverType.case === "http") {
+        result.http = serializeHttpConfig(spec.serverType.value);
+    }
+    if (spec.defaultEnabledTools.length > 0) {
+        result.default_enabled_tools = [...spec.defaultEnabledTools];
+    }
+    if (spec.defaultToolApprovals.length > 0) {
+        result.default_tool_approvals =
+            spec.defaultToolApprovals.map(serializeToolApprovalPolicy);
+    }
+    if (spec.envSpec) {
+        const envSpec = serializeEnvSpec(spec.envSpec);
+        if (envSpec) {
+            result.env_spec = envSpec;
+        }
+    }
+    return result;
+}
+function serializeStdioConfig(config) {
+    const result = {
+        command: config.command,
+    };
+    if (config.args.length > 0) {
+        result.args = [...config.args];
+    }
+    if (config.workingDir) {
+        result.working_dir = config.workingDir;
+    }
+    return result;
+}
+function serializeHttpConfig(config) {
+    const result = {
+        url: config.url,
+    };
+    if (hasEntries(config.headers)) {
+        result.headers = { ...config.headers };
+    }
+    if (hasEntries(config.queryParams)) {
+        result.query_params = { ...config.queryParams };
+    }
+    if (config.timeoutSeconds > 0) {
+        result.timeout_seconds = config.timeoutSeconds;
+    }
+    return result;
+}
+function serializeToolApprovalPolicy(policy) {
+    const result = {
+        tool_name: policy.toolName,
+    };
+    if (policy.message) {
+        result.message = policy.message;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Shared serializers
+// ---------------------------------------------------------------------------
+function serializeResourceRef(ref) {
+    const result = {};
+    if (ref.org) {
+        result.org = ref.org;
+    }
+    if (ref.kind) {
+        result.kind = ref.kind;
+    }
+    result.slug = ref.slug;
+    if (ref.version) {
+        result.version = ref.version;
+    }
+    return result;
+}
+function serializeEnvSpec(envSpec) {
+    if (!hasEntries(envSpec.data))
+        return undefined;
+    const data = {};
+    for (const [key, val] of Object.entries(envSpec.data)) {
+        const entry = {};
+        if (val.value) {
+            entry.value = val.value;
+        }
+        if (val.isSecret) {
+            entry.is_secret = val.isSecret;
+        }
+        if (val.description) {
+            entry.description = val.description;
+        }
+        data[key] = entry;
+    }
+    const result = {};
+    if (envSpec.description) {
+        result.description = envSpec.description;
+    }
+    result.data = data;
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+function hasEntries(obj) {
+    if (!obj)
+        return false;
+    return Object.keys(obj).length > 0;
+}
+//# sourceMappingURL=serialize-resource-yaml.js.map

package/library/serialize-resource-yaml.js.map

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

package/library/useApplyResource.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Result returned after successfully applying a resource to an organization.
+ *
+ * Contains the minimum metadata needed to display a success message and
+ * link to the resource in the Library (e.g., `/library/agents`).
+ */
+export interface ApplyResourceResult {
+    /** The resource kind that was applied. */
+    readonly kind: "Agent" | "McpServer" | "Skill";
+    /** The resource name (from response metadata). */
+    readonly name: string;
+    /** The organization the resource was applied to. */
+    readonly org: string;
+    /** The URL-friendly slug (from response metadata). */
+    readonly slug: string;
+}
+/**
+ * Parameters for pushing a skill package from an execution artifact.
+ *
+ * The server reads the directory artifact (ZIP) from execution storage
+ * and pushes it as a skill — no ZIP download reaches the browser.
+ */
+export interface PushSkillParams {
+    /** Organization that will own the skill. */
+    readonly org: string;
+    /** ID of the execution that produced the artifact (format: `aex_{ulid}`). */
+    readonly executionId: string;
+    /** Storage key of the directory artifact. Must start with `artifacts/{executionId}/`. */
+    readonly storageKey: string;
+    /** Optional version tag (e.g., `"stable"`, `"v1.0"`). */
+    readonly tag?: string;
+}
+export interface UseApplyResourceReturn {
+    /**
+     * Apply a Stigmer resource YAML (Agent or McpServer) to an organization.
+     *
+     * Parses the YAML content, converts it to the appropriate SDK input type,
+     * and calls `stigmer.agent.apply()` or `stigmer.mcpServer.apply()` based
+     * on the detected `kind`.
+     *
+     * The `org` parameter overrides `metadata.org` in the YAML — matching
+     * the "Apply to [my-org]" UX intent.
+     *
+     * @throws Re-throws the original error after setting `error` state, so
+     *   callers can optionally catch for flow control.
+     */
+    readonly applyYamlResource: (content: string, org: string) => Promise<ApplyResourceResult>;
+    /**
+     * Push a skill package from an execution artifact to an organization.
+     *
+     * Uses the server-side `pushFromExecutionArtifact` RPC — the server reads
+     * the ZIP from execution storage and pushes it as a skill. No ZIP download
+     * reaches the browser.
+     *
+     * @throws Re-throws the original error after setting `error` state.
+     */
+    readonly pushSkillPackage: (params: PushSkillParams) => Promise<ApplyResourceResult>;
+    /** `true` while an apply or push operation is in-flight. */
+    readonly isApplying: boolean;
+    /** Error from the last failed operation, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Clear the error state (e.g., when the user dismisses an error message). */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook for applying detected Stigmer resources to an organization.
+ *
+ * Bridges the detection layer ({@link detectStigmerResource},
+ * {@link useDetectSkillPackage}) to the apply action — the user clicks
+ * "Apply to [org]" and the resource is created or updated.
+ *
+ * Handles two parallel apply paths:
+ *
+ * 1. **YAML resources** (Agent, McpServer): `applyYamlResource(content, org)`
+ *    parses the YAML, converts snake_case fields to SDK input types, and
+ *    calls the appropriate `apply()` method.
+ *
+ * 2. **Skill packages** (directory artifacts): `pushSkillPackage(params)`
+ *    delegates to the server-side `pushFromExecutionArtifact` RPC.
+ *
+ * Follows the established mutation hook pattern: `isApplying` + `error` +
+ * `clearError`. The result is returned from the promise (not stored in
+ * hook state) — consistent with {@link useCreateOrganization} and other
+ * SDK mutation hooks.
+ *
+ * @example
+ * ```tsx
+ * const { applyYamlResource, pushSkillPackage, isApplying, error, clearError } =
+ *   useApplyResource();
+ * const [result, setResult] = useState<ApplyResourceResult | null>(null);
+ *
+ * const handleApply = async () => {
+ *   clearError();
+ *   try {
+ *     if (yamlDetection.detected) {
+ *       setResult(await applyYamlResource(content!, activeOrg));
+ *     } else if (skillDetection.detected) {
+ *       setResult(await pushSkillPackage({
+ *         org: activeOrg,
+ *         executionId,
+ *         storageKey: artifact.storageKey,
+ *       }));
+ *     }
+ *   } catch {
+ *     // error state is set by the hook
+ *   }
+ * };
+ * ```
+ *
+ * @see {@link parseResourceYaml} for the pure YAML-to-input conversion
+ * @see {@link detectStigmerResource} for YAML resource detection
+ * @see {@link useDetectSkillPackage} for skill package detection
+ */
+export declare function useApplyResource(): UseApplyResourceReturn;
+//# sourceMappingURL=useApplyResource.d.ts.map

package/library/useApplyResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplyResource.d.ts","sourceRoot":"","sources":["../../src/library/useApplyResource.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;IAC/C,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAElC;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CACzB,MAAM,EAAE,eAAe,KACpB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAElC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE7B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA4EzD"}

package/library/useApplyResource.js

@@ -0,0 +1,124 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { PushSkillFromExecutionArtifactRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+import { parseResourceYaml } from "./parse-resource-yaml";
+/**
+ * Behavior hook for applying detected Stigmer resources to an organization.
+ *
+ * Bridges the detection layer ({@link detectStigmerResource},
+ * {@link useDetectSkillPackage}) to the apply action — the user clicks
+ * "Apply to [org]" and the resource is created or updated.
+ *
+ * Handles two parallel apply paths:
+ *
+ * 1. **YAML resources** (Agent, McpServer): `applyYamlResource(content, org)`
+ *    parses the YAML, converts snake_case fields to SDK input types, and
+ *    calls the appropriate `apply()` method.
+ *
+ * 2. **Skill packages** (directory artifacts): `pushSkillPackage(params)`
+ *    delegates to the server-side `pushFromExecutionArtifact` RPC.
+ *
+ * Follows the established mutation hook pattern: `isApplying` + `error` +
+ * `clearError`. The result is returned from the promise (not stored in
+ * hook state) — consistent with {@link useCreateOrganization} and other
+ * SDK mutation hooks.
+ *
+ * @example
+ * ```tsx
+ * const { applyYamlResource, pushSkillPackage, isApplying, error, clearError } =
+ *   useApplyResource();
+ * const [result, setResult] = useState<ApplyResourceResult | null>(null);
+ *
+ * const handleApply = async () => {
+ *   clearError();
+ *   try {
+ *     if (yamlDetection.detected) {
+ *       setResult(await applyYamlResource(content!, activeOrg));
+ *     } else if (skillDetection.detected) {
+ *       setResult(await pushSkillPackage({
+ *         org: activeOrg,
+ *         executionId,
+ *         storageKey: artifact.storageKey,
+ *       }));
+ *     }
+ *   } catch {
+ *     // error state is set by the hook
+ *   }
+ * };
+ * ```
+ *
+ * @see {@link parseResourceYaml} for the pure YAML-to-input conversion
+ * @see {@link detectStigmerResource} for YAML resource detection
+ * @see {@link useDetectSkillPackage} for skill package detection
+ */
+export function useApplyResource() {
+    const stigmer = useStigmer();
+    const [isApplying, setIsApplying] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const applyYamlResource = useCallback(async (content, org) => {
+        setIsApplying(true);
+        setError(null);
+        try {
+            const parsed = parseResourceYaml(content, org);
+            switch (parsed.kind) {
+                case "Agent": {
+                    const agent = await stigmer.agent.apply(parsed.input);
+                    return {
+                        kind: "Agent",
+                        name: agent.metadata?.name ?? parsed.input.name,
+                        org: agent.metadata?.org ?? org,
+                        slug: agent.metadata?.slug ?? parsed.input.name,
+                    };
+                }
+                case "McpServer": {
+                    const mcpServer = await stigmer.mcpServer.apply(parsed.input);
+                    return {
+                        kind: "McpServer",
+                        name: mcpServer.metadata?.name ?? parsed.input.name,
+                        org: mcpServer.metadata?.org ?? org,
+                        slug: mcpServer.metadata?.slug ?? parsed.input.name,
+                    };
+                }
+            }
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsApplying(false);
+        }
+    }, [stigmer]);
+    const pushSkillPackage = useCallback(async (params) => {
+        setIsApplying(true);
+        setError(null);
+        try {
+            const request = create(PushSkillFromExecutionArtifactRequestSchema, {
+                org: params.org,
+                executionId: params.executionId,
+                storageKey: params.storageKey,
+                tag: params.tag ?? "",
+            });
+            const skill = await stigmer.skill.pushFromExecutionArtifact(request);
+            return {
+                kind: "Skill",
+                name: skill.metadata?.name ?? "",
+                org: skill.metadata?.org ?? params.org,
+                slug: skill.metadata?.slug ?? "",
+            };
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsApplying(false);
+        }
+    }, [stigmer]);
+    return { applyYamlResource, pushSkillPackage, isApplying, error, clearError };
+}
+//# sourceMappingURL=useApplyResource.js.map

package/library/useApplyResource.js.map

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

package/library/useDetectSkillPackage.d.ts

@@ -0,0 +1,54 @@
+import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
+import { type SkillPackageDetection } from "./detect-skill-package";
+export interface UseDetectSkillPackageReturn {
+    /** The detection result — check `detection.detected` to narrow the type. */
+    readonly detection: SkillPackageDetection;
+    /**
+     * `true` while the SKILL.md content is being fetched from the archive.
+     * Only relevant when the artifact is a skill package — `false` immediately
+     * for non-skill artifacts.
+     */
+    readonly isLoading: boolean;
+    /** Error message from the SKILL.md fetch, or `null` when healthy. */
+    readonly error: string | null;
+}
+/**
+ * Detects whether an execution artifact is a skill package and extracts
+ * its metadata from SKILL.md.
+ *
+ * Combines the synchronous `isSkillPackage()` check (via `entries`) with
+ * a lazy content fetch of the SKILL.md file from the ZIP archive. The
+ * SKILL.md content is fetched via the `getArtifactContent` RPC with
+ * `entry_path`, so no ZIP download reaches the browser.
+ *
+ * Pass `null` for either parameter to skip detection entirely.
+ *
+ * Detection only triggers a network call when the artifact looks like a
+ * skill package (`kind === DIRECTORY` with `SKILL.md` in `entries`).
+ * For all other artifacts, returns `{ detected: false }` immediately.
+ *
+ * @param artifact - The execution artifact to inspect, or `null` to skip.
+ * @param executionId - Execution that produced the artifact, or `null` to skip.
+ *
+ * @example
+ * ```tsx
+ * const { detection, isLoading } = useDetectSkillPackage(artifact, executionId);
+ *
+ * if (isLoading) return <Spinner />;
+ *
+ * if (detection.detected) {
+ *   return (
+ *     <div>
+ *       <Badge>Skill Package</Badge>
+ *       <span>{detection.skillName}</span>
+ *       <span>{detection.fileCount} files</span>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link isSkillPackage} for the synchronous check (no content needed)
+ * @see {@link detectSkillPackage} for the pure function (non-React usage)
+ */
+export declare function useDetectSkillPackage(artifact: ExecutionArtifact | null, executionId: string | null): UseDetectSkillPackageReturn;
+//# sourceMappingURL=useDetectSkillPackage.d.ts.map

package/library/useDetectSkillPackage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDetectSkillPackage.d.ts","sourceRoot":"","sources":["../../src/library/useDetectSkillPackage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAE1G,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,2BAA2B;IAC1C,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAClC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,2BAA2B,CAqB7B"}

package/library/useDetectSkillPackage.js

@@ -0,0 +1,59 @@
+"use client";
+import { useMemo } from "react";
+import { useArtifactContent } from "../execution/useArtifactContent";
+import { detectSkillPackage, isSkillPackage, } from "./detect-skill-package";
+const NOT_DETECTED = { detected: false };
+/**
+ * Detects whether an execution artifact is a skill package and extracts
+ * its metadata from SKILL.md.
+ *
+ * Combines the synchronous `isSkillPackage()` check (via `entries`) with
+ * a lazy content fetch of the SKILL.md file from the ZIP archive. The
+ * SKILL.md content is fetched via the `getArtifactContent` RPC with
+ * `entry_path`, so no ZIP download reaches the browser.
+ *
+ * Pass `null` for either parameter to skip detection entirely.
+ *
+ * Detection only triggers a network call when the artifact looks like a
+ * skill package (`kind === DIRECTORY` with `SKILL.md` in `entries`).
+ * For all other artifacts, returns `{ detected: false }` immediately.
+ *
+ * @param artifact - The execution artifact to inspect, or `null` to skip.
+ * @param executionId - Execution that produced the artifact, or `null` to skip.
+ *
+ * @example
+ * ```tsx
+ * const { detection, isLoading } = useDetectSkillPackage(artifact, executionId);
+ *
+ * if (isLoading) return <Spinner />;
+ *
+ * if (detection.detected) {
+ *   return (
+ *     <div>
+ *       <Badge>Skill Package</Badge>
+ *       <span>{detection.skillName}</span>
+ *       <span>{detection.fileCount} files</span>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link isSkillPackage} for the synchronous check (no content needed)
+ * @see {@link detectSkillPackage} for the pure function (non-React usage)
+ */
+export function useDetectSkillPackage(artifact, executionId) {
+    const isPackage = artifact ? isSkillPackage(artifact) : false;
+    const { content, isLoading, error } = useArtifactContent(isPackage && executionId ? executionId : null, isPackage && artifact ? artifact.storageKey : null, isPackage ? "SKILL.md" : null);
+    const detection = useMemo(() => {
+        if (!artifact || !isPackage || !content) {
+            return NOT_DETECTED;
+        }
+        return detectSkillPackage(artifact, content);
+    }, [artifact, isPackage, content]);
+    return {
+        detection,
+        isLoading: isPackage && isLoading,
+        error: isPackage ? error : null,
+    };
+}
+//# sourceMappingURL=useDetectSkillPackage.js.map