@stigmer/react 3.2.2 → 3.3.0

package/manifest/YamlEditor.js

@@ -0,0 +1,216 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useRef, useEffect, memo, } from "react";
+import { cn } from "@stigmer/theme";
+import { EditorState, Compartment } from "@codemirror/state";
+import { EditorView, keymap, lineNumbers, highlightActiveLine, drawSelection, highlightSpecialChars } from "@codemirror/view";
+import { yaml } from "@codemirror/lang-yaml";
+import { syntaxHighlighting, HighlightStyle, bracketMatching, indentOnInput, foldGutter } from "@codemirror/language";
+import { tags } from "@lezer/highlight";
+import { lintGutter, setDiagnostics } from "@codemirror/lint";
+import { defaultKeymap, indentWithTab, history, historyKeymap } from "@codemirror/commands";
+import { autocompletion } from "@codemirror/autocomplete";
+/**
+ * YAML editor built on CodeMirror 6, shared by every YAML surface in the
+ * SDK (workflow editor tab, resource manifest dialogs).
+ *
+ * Provides syntax highlighting, line numbers, bracket matching,
+ * code folding, undo/redo, and inline diagnostic markers driven by
+ * external validation (via the `diagnostics` prop).
+ *
+ * Themed via `--stgm-*` CSS custom properties to respect the host
+ * application's design tokens.
+ *
+ * This is an optional SDK component — it requires CodeMirror peer
+ * dependencies. Consumers that render it conditionally should load it
+ * via `React.lazy` so the CodeMirror bundle stays out of paths that
+ * never open an editor (DD-013).
+ *
+ * @example
+ * ```tsx
+ * <YamlEditor
+ *   value={yaml}
+ *   onChange={setYaml}
+ *   diagnostics={diagnostics}
+ * />
+ * ```
+ */
+export const YamlEditor = memo(function YamlEditor({ value, onChange, diagnostics, readOnly = false, className, style, }) {
+    const containerRef = useRef(null);
+    const viewRef = useRef(null);
+    const readOnlyCompartment = useRef(new Compartment());
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+    const isInternalUpdate = useRef(false);
+    useEffect(() => {
+        if (!containerRef.current)
+            return;
+        const updateListener = EditorView.updateListener.of((update) => {
+            if (update.docChanged) {
+                isInternalUpdate.current = true;
+                onChangeRef.current?.(update.state.doc.toString());
+            }
+        });
+        const state = EditorState.create({
+            doc: value,
+            extensions: [
+                lineNumbers(),
+                highlightActiveLine(),
+                highlightSpecialChars(),
+                drawSelection(),
+                bracketMatching(),
+                indentOnInput(),
+                foldGutter(),
+                history(),
+                yaml(),
+                syntaxHighlighting(stigmerHighlightStyle, { fallback: true }),
+                autocompletion(),
+                lintGutter(),
+                keymap.of([...defaultKeymap, ...historyKeymap, indentWithTab]),
+                readOnlyCompartment.current.of(EditorState.readOnly.of(readOnly)),
+                stigmerTheme,
+                updateListener,
+            ],
+        });
+        const view = new EditorView({
+            state,
+            parent: containerRef.current,
+        });
+        viewRef.current = view;
+        return () => {
+            view.destroy();
+            viewRef.current = null;
+        };
+    }, []);
+    // Sync external value changes into the editor
+    useEffect(() => {
+        const view = viewRef.current;
+        if (!view)
+            return;
+        if (isInternalUpdate.current) {
+            isInternalUpdate.current = false;
+            return;
+        }
+        const currentDoc = view.state.doc.toString();
+        if (currentDoc !== value) {
+            view.dispatch({
+                changes: {
+                    from: 0,
+                    to: currentDoc.length,
+                    insert: value,
+                },
+            });
+        }
+    }, [value]);
+    useEffect(() => {
+        const view = viewRef.current;
+        if (!view)
+            return;
+        view.dispatch({
+            effects: readOnlyCompartment.current.reconfigure(EditorState.readOnly.of(readOnly)),
+        });
+    }, [readOnly]);
+    // Sync diagnostics into CodeMirror's lint system
+    useEffect(() => {
+        const view = viewRef.current;
+        if (!view)
+            return;
+        const cmDiags = diagnostics
+            ? diagnostics.map((d) => ({
+                ...d,
+                from: Math.min(d.from, view.state.doc.length),
+                to: Math.min(d.to, view.state.doc.length),
+            }))
+            : [];
+        view.dispatch(setDiagnostics(view.state, cmDiags));
+    }, [diagnostics]);
+    return (_jsx("div", { ref: containerRef, className: cn("stgm-yaml-editor overflow-auto rounded-md border border-border bg-background font-mono text-sm", className), style: style }));
+});
+// ---------------------------------------------------------------------------
+// Syntax highlighting: maps lezer tags to --stgm-syntax-* CSS variables
+// ---------------------------------------------------------------------------
+const stigmerHighlightStyle = HighlightStyle.define([
+    { tag: tags.propertyName, color: "var(--stgm-syntax-property, #0550ae)" },
+    { tag: tags.tagName, color: "var(--stgm-syntax-tag, #cf222e)" },
+    { tag: tags.keyword, color: "var(--stgm-syntax-keyword, #8250df)", fontWeight: "bold" },
+    { tag: tags.string, color: "var(--stgm-syntax-string, #0a3069)" },
+    { tag: tags.number, color: "var(--stgm-syntax-number, #953800)" },
+    { tag: [tags.bool, tags.null], color: "var(--stgm-syntax-bool, #8250df)" },
+    { tag: tags.atom, color: "var(--stgm-syntax-atom, #cf222e)" },
+    { tag: tags.comment, color: "var(--stgm-syntax-comment, #6e7781)", fontStyle: "italic" },
+    { tag: tags.meta, color: "var(--stgm-syntax-meta, #8250df)" },
+    { tag: tags.name, color: "var(--stgm-foreground, #1a1a2e)" },
+    { tag: tags.definition(tags.name), color: "var(--stgm-syntax-property, #0550ae)" },
+    { tag: tags.separator, color: "var(--stgm-muted-foreground, #737373)" },
+    { tag: tags.punctuation, color: "var(--stgm-muted-foreground, #737373)" },
+]);
+// ---------------------------------------------------------------------------
+// CodeMirror theme bridge: maps --stgm-* tokens to editor styles
+// ---------------------------------------------------------------------------
+const stigmerTheme = EditorView.theme({
+    "&": {
+        height: "100%",
+        backgroundColor: "var(--stgm-background, #fff)",
+        color: "var(--stgm-foreground, #1a1a2e)",
+        fontSize: "13px",
+    },
+    ".cm-content": {
+        caretColor: "var(--stgm-foreground, #1a1a2e)",
+        fontFamily: "var(--stgm-font-mono, ui-monospace, monospace)",
+        padding: "8px 0",
+    },
+    ".cm-cursor, .cm-dropCursor": {
+        borderLeftColor: "var(--stgm-foreground, #1a1a2e)",
+    },
+    "&.cm-focused .cm-selectionBackground, .cm-selectionBackground, .cm-content ::selection": {
+        backgroundColor: "var(--stgm-accent, #e0e7ff)",
+    },
+    ".cm-gutters": {
+        backgroundColor: "var(--stgm-muted, #f5f5f5)",
+        color: "var(--stgm-muted-foreground, #737373)",
+        border: "none",
+        borderRight: "1px solid var(--stgm-border, #e5e5e5)",
+    },
+    ".cm-activeLineGutter": {
+        backgroundColor: "var(--stgm-accent, #e0e7ff)",
+    },
+    ".cm-activeLine": {
+        backgroundColor: "color-mix(in srgb, var(--stgm-accent, #e0e7ff) 30%, transparent)",
+    },
+    ".cm-foldPlaceholder": {
+        backgroundColor: "var(--stgm-muted, #f5f5f5)",
+        border: "1px solid var(--stgm-border, #e5e5e5)",
+        color: "var(--stgm-muted-foreground, #737373)",
+    },
+    ".cm-tooltip": {
+        backgroundColor: "var(--stgm-popover, #fff)",
+        color: "var(--stgm-popover-foreground, #1a1a2e)",
+        border: "1px solid var(--stgm-border, #e5e5e5)",
+        borderRadius: "6px",
+        boxShadow: "0 2px 8px rgba(0,0,0,0.08)",
+    },
+    ".cm-tooltip-autocomplete": {
+        "& > ul > li[aria-selected]": {
+            backgroundColor: "var(--stgm-accent, #e0e7ff)",
+            color: "var(--stgm-accent-foreground, #1a1a2e)",
+        },
+    },
+    ".cm-diagnostic-error": {
+        borderLeft: "3px solid var(--stgm-destructive, #ef4444)",
+    },
+    ".cm-diagnostic-warning": {
+        borderLeft: "3px solid var(--stgm-warning, #f59e0b)",
+    },
+    ".cm-diagnostic-info": {
+        borderLeft: "3px solid var(--stgm-primary, #6366f1)",
+    },
+    ".cm-lint-marker-error": {
+        content: "'●'",
+        color: "var(--stgm-destructive, #ef4444)",
+    },
+    ".cm-lint-marker-warning": {
+        content: "'●'",
+        color: "var(--stgm-warning, #f59e0b)",
+    },
+});
+//# sourceMappingURL=YamlEditor.js.map

package/manifest/YamlEditor.js.map

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

package/manifest/index.d.ts

@@ -0,0 +1,13 @@
+export { YamlEditor } from "./YamlEditor.js";
+export type { YamlEditorProps } from "./YamlEditor.js";
+export { useEditResourceYaml } from "./useEditResourceYaml.js";
+export type { EditYamlTarget, EditYamlValidation, UseEditResourceYamlOptions, UseEditResourceYamlReturn, } from "./useEditResourceYaml.js";
+export { useApplyManifest } from "./useApplyManifest.js";
+export type { ManifestEntryStatus, ManifestPreviewEntry, UseApplyManifestReturn, } from "./useApplyManifest.js";
+export { EditResourceYamlDialog } from "./EditResourceYamlDialog.js";
+export type { EditResourceYamlDialogProps } from "./EditResourceYamlDialog.js";
+export { ApplyManifestDialog } from "./ApplyManifestDialog.js";
+export type { ApplyManifestDialogProps } from "./ApplyManifestDialog.js";
+export { RedactedSecretsNotice } from "./RedactedSecretsNotice.js";
+export type { RedactedSecretsNoticeProps } from "./RedactedSecretsNotice.js";
+//# sourceMappingURL=index.d.ts.map

package/manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC"}

package/manifest/index.js

@@ -0,0 +1,13 @@
+// Manifest domain: the console-facing YAML edit/apply experience for every
+// registry-supported resource kind, built on the @stigmer/sdk manifest
+// engine (parseManifest / serializeManifest / stigmer.manifest).
+//
+// Headless-first (DD-003): the hooks are independently importable; the
+// dialogs compose them with the shared YamlEditor.
+export { YamlEditor } from "./YamlEditor.js";
+export { useEditResourceYaml } from "./useEditResourceYaml.js";
+export { useApplyManifest } from "./useApplyManifest.js";
+export { EditResourceYamlDialog } from "./EditResourceYamlDialog.js";
+export { ApplyManifestDialog } from "./ApplyManifestDialog.js";
+export { RedactedSecretsNotice } from "./RedactedSecretsNotice.js";
+//# sourceMappingURL=index.js.map

package/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,uEAAuE;AACvE,iEAAiE;AACjE,EAAE;AACF,uEAAuE;AACvE,mDAAmD;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQ/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/manifest/useApplyManifest.d.ts

@@ -0,0 +1,82 @@
+import { type AppliedManifest, type ManifestDocument } from "@stigmer/sdk";
+/** Per-document apply lifecycle within one manifest. */
+export type ManifestEntryStatus = "pending" | "applying" | "applied" | "failed"
+/** A prior document failed; this one was not attempted. */
+ | "skipped";
+/** One document of the manifest, with its preview and apply state. */
+export interface ManifestPreviewEntry {
+    /** The parsed document (kind handler, message, name/slug/org). */
+    readonly document: ManifestDocument;
+    /** What applying will do, resolved against live server state. */
+    readonly action: "create" | "update" | "unknown";
+    /** Apply lifecycle status. */
+    readonly status: ManifestEntryStatus;
+    /** The applied resource, present when `status` is `"applied"`. */
+    readonly result?: AppliedManifest;
+    /** User-facing failure message, present when `status` is `"failed"`. */
+    readonly errorMessage?: string;
+}
+/** Return value of {@link useApplyManifest}. */
+export interface UseApplyManifestReturn {
+    /** Current manifest text (paste target). */
+    readonly content: string;
+    /** Update the manifest text. Re-validates (debounced). */
+    readonly setContent: (value: string) => void;
+    /** Read a `.yaml`/`.yml`/`.json` file into `content`. */
+    readonly readFile: (file: File) => Promise<void>;
+    /**
+     * Validated per-document preview in dependency apply order, or `null`
+     * while the content is empty or invalid.
+     */
+    readonly entries: readonly ManifestPreviewEntry[] | null;
+    /** Validation error for the current content, or `null` when valid. */
+    readonly validationError: string | null;
+    /** `true` while the (debounced) validation + existence checks run. */
+    readonly isValidating: boolean;
+    /** `true` when the content contains `***REDACTED***` secret markers. */
+    readonly hasRedactedSecrets: boolean;
+    /**
+     * Apply all documents sequentially in dependency order. Entries update
+     * live. Stops at the first failure (later entries become `"skipped"`).
+     * Resolves `true` when every document applied.
+     */
+    readonly applyAll: () => Promise<boolean>;
+    /** `true` while applies are in flight. */
+    readonly isApplying: boolean;
+    /** Clear all state (content, preview, errors). */
+    readonly reset: () => void;
+}
+/**
+ * Headless "apply a YAML manifest" flow for any registry-supported kind —
+ * the console counterpart of `stigmer apply -f`.
+ *
+ * Orchestrates: paste or upload → strict parse against generated proto
+ * schemas ({@link parseManifest}) → per-document create-vs-update preview
+ * (server existence check) → sequential apply in dependency order with
+ * live per-document status.
+ *
+ * Accepts multi-document manifests (`---` separators) and JSON content
+ * (YAML is a superset). The target `org` is injected into documents that
+ * omit `metadata.org`; documents naming a *different* org are honored and
+ * apply there (matching `stigmer apply` semantics — the org-mismatch
+ * warning surfaces on the parsed document).
+ *
+ * @param org - Target organization slug for `metadata.org` injection.
+ *
+ * @example
+ * ```tsx
+ * const manifest = useApplyManifest(activeOrg);
+ *
+ * <textarea value={manifest.content}
+ *           onChange={(e) => manifest.setContent(e.target.value)} />
+ * {manifest.entries?.map((e) => (
+ *   <PreviewRow key={e.document.slug} entry={e} />
+ * ))}
+ * <button onClick={manifest.applyAll} disabled={!manifest.entries}>Apply</button>
+ * ```
+ *
+ * @see {@link ApplyManifestDialog} for the styled component composing this hook
+ * @see {@link useEditResourceYaml} for the edit-in-place counterpart
+ */
+export declare function useApplyManifest(org: string): UseApplyManifestReturn;
+//# sourceMappingURL=useApplyManifest.d.ts.map

package/manifest/useApplyManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplyManifest.d.ts","sourceRoot":"","sources":["../../src/manifest/useApplyManifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAItB,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ;AACV,2DAA2D;GACzD,SAAS,CAAC;AAEd,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACjD,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI,CAAC;IACzD,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAwKpE"}

package/manifest/useApplyManifest.js

@@ -0,0 +1,180 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { containsRedactedSecrets, parseManifest, } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+// Validation parses + resolves existence server-side; wait for a typing pause.
+const VALIDATE_DEBOUNCE_MS = 500;
+/**
+ * Headless "apply a YAML manifest" flow for any registry-supported kind —
+ * the console counterpart of `stigmer apply -f`.
+ *
+ * Orchestrates: paste or upload → strict parse against generated proto
+ * schemas ({@link parseManifest}) → per-document create-vs-update preview
+ * (server existence check) → sequential apply in dependency order with
+ * live per-document status.
+ *
+ * Accepts multi-document manifests (`---` separators) and JSON content
+ * (YAML is a superset). The target `org` is injected into documents that
+ * omit `metadata.org`; documents naming a *different* org are honored and
+ * apply there (matching `stigmer apply` semantics — the org-mismatch
+ * warning surfaces on the parsed document).
+ *
+ * @param org - Target organization slug for `metadata.org` injection.
+ *
+ * @example
+ * ```tsx
+ * const manifest = useApplyManifest(activeOrg);
+ *
+ * <textarea value={manifest.content}
+ *           onChange={(e) => manifest.setContent(e.target.value)} />
+ * {manifest.entries?.map((e) => (
+ *   <PreviewRow key={e.document.slug} entry={e} />
+ * ))}
+ * <button onClick={manifest.applyAll} disabled={!manifest.entries}>Apply</button>
+ * ```
+ *
+ * @see {@link ApplyManifestDialog} for the styled component composing this hook
+ * @see {@link useEditResourceYaml} for the edit-in-place counterpart
+ */
+export function useApplyManifest(org) {
+    const stigmer = useStigmer();
+    const [content, setContentState] = useState("");
+    const [entries, setEntries] = useState(null);
+    const [validationError, setValidationError] = useState(null);
+    const [isValidating, setIsValidating] = useState(false);
+    const [isApplying, setIsApplying] = useState(false);
+    const orgRef = useRef(org);
+    orgRef.current = org;
+    const setContent = useCallback((value) => {
+        setContentState(value);
+    }, []);
+    const readFile = useCallback(async (file) => {
+        let text;
+        try {
+            text = await file.text();
+        }
+        catch {
+            setContentState("");
+            setEntries(null);
+            setValidationError(`Failed to read ${file.name}.`);
+            return;
+        }
+        setContentState(text);
+    }, []);
+    const reset = useCallback(() => {
+        setContentState("");
+        setEntries(null);
+        setValidationError(null);
+        setIsValidating(false);
+        setIsApplying(false);
+    }, []);
+    // Debounced validation + existence resolution, cancellation-safe. Applies
+    // freeze the preview: entries carry live statuses the validator must not
+    // clobber mid-run.
+    const validateSeq = useRef(0);
+    useEffect(() => {
+        if (isApplying)
+            return;
+        const seq = ++validateSeq.current;
+        if (!content.trim()) {
+            setEntries(null);
+            setValidationError(null);
+            setIsValidating(false);
+            return;
+        }
+        setIsValidating(true);
+        const timer = setTimeout(async () => {
+            let documents;
+            try {
+                documents = parseManifest(content, { org: orgRef.current });
+            }
+            catch (err) {
+                if (validateSeq.current === seq) {
+                    setEntries(null);
+                    setValidationError(toError(err).message);
+                    setIsValidating(false);
+                }
+                return;
+            }
+            const resolved = await Promise.all(documents.map(async (document) => {
+                let action;
+                try {
+                    const existing = await stigmer.manifest.getByReference(document.handler.yamlKind, document.org, document.slug);
+                    action = existing !== null ? "update" : "create";
+                }
+                catch {
+                    action = "unknown";
+                }
+                return { document, action, status: "pending" };
+            }));
+            if (validateSeq.current === seq) {
+                setEntries(resolved);
+                setValidationError(null);
+                setIsValidating(false);
+            }
+        }, VALIDATE_DEBOUNCE_MS);
+        return () => clearTimeout(timer);
+    }, [content, stigmer, isApplying]);
+    const applyAll = useCallback(async () => {
+        if (!entries || entries.length === 0)
+            return false;
+        // Invalidate any in-flight validation so it cannot clobber apply statuses.
+        validateSeq.current++;
+        setIsApplying(true);
+        // Local working copy — React state is updated per transition so the
+        // dialog renders progress live.
+        const working = entries.map((entry) => ({ ...entry, status: "pending" }));
+        const commit = () => setEntries([...working]);
+        let allApplied = true;
+        for (let i = 0; i < working.length; i++) {
+            if (!allApplied) {
+                working[i] = { ...working[i], status: "skipped" };
+                continue;
+            }
+            working[i] = { ...working[i], status: "applying" };
+            commit();
+            try {
+                const result = await stigmer.manifest.apply(working[i].document);
+                working[i] = { ...working[i], status: "applied", result };
+            }
+            catch (err) {
+                working[i] = {
+                    ...working[i],
+                    status: "failed",
+                    errorMessage: toError(err).message,
+                };
+                allApplied = false;
+            }
+            commit();
+        }
+        commit();
+        setIsApplying(false);
+        return allApplied;
+    }, [entries, stigmer]);
+    const hasRedactedSecrets = useMemo(() => containsRedactedSecrets(content), [content]);
+    return useMemo(() => ({
+        content,
+        setContent,
+        readFile,
+        entries,
+        validationError,
+        isValidating,
+        hasRedactedSecrets,
+        applyAll,
+        isApplying,
+        reset,
+    }), [
+        content,
+        setContent,
+        readFile,
+        entries,
+        validationError,
+        isValidating,
+        hasRedactedSecrets,
+        applyAll,
+        isApplying,
+        reset,
+    ]);
+}
+//# sourceMappingURL=useApplyManifest.js.map

package/manifest/useApplyManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplyManifest.js","sourceRoot":"","sources":["../../src/manifest/useApplyManifest.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EACL,uBAAuB,EACvB,aAAa,GAGd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAwDjD,+EAA+E;AAC/E,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAyC,IAAI,CAAC,CAAC;IACrF,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAErB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,KAAa,EAAE,EAAE;QAC/C,eAAe,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,IAAU,EAAE,EAAE;QAChD,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,eAAe,CAAC,EAAE,CAAC,CAAC;YACpB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,kBAAkB,CAAC,kBAAkB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,eAAe,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,eAAe,CAAC,EAAE,CAAC,CAAC;QACpB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzB,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,aAAa,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,0EAA0E;IAC1E,yEAAyE;IACzE,mBAAmB;IACnB,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,UAAU;YAAE,OAAO;QAEvB,MAAM,GAAG,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC;QAElC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACzB,eAAe,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QAED,eAAe,CAAC,IAAI,CAAC,CAAC;QAEtB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAClC,IAAI,SAA6B,CAAC;YAClC,IAAI,CAAC;gBACH,SAAS,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,WAAW,CAAC,OAAO,KAAK,GAAG,EAAE,CAAC;oBAChC,UAAU,CAAC,IAAI,CAAC,CAAC;oBACjB,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;oBACzC,eAAe,CAAC,KAAK,CAAC,CAAC;gBACzB,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAiC,EAAE;gBAC9D,IAAI,MAAsC,CAAC;gBAC3C,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CACpD,QAAQ,CAAC,OAAO,CAAC,QAAQ,EACzB,QAAQ,CAAC,GAAG,EACZ,QAAQ,CAAC,IAAI,CACd,CAAC;oBACF,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,SAAS,CAAC;gBACrB,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACjD,CAAC,CAAC,CACH,CAAC;YAEF,IAAI,WAAW,CAAC,OAAO,KAAK,GAAG,EAAE,CAAC;gBAChC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrB,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACzB,eAAe,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAEzB,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAEnC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAsB,EAAE;QACxD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAEnD,2EAA2E;QAC3E,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,aAAa,CAAC,IAAI,CAAC,CAAC;QAEpB,oEAAoE;QACpE,gCAAgC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAwB,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;QAE9C,IAAI,UAAU,GAAG,IAAI,CAAC;QAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YAED,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YACnD,MAAM,EAAE,CAAC;YAET,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;gBACjE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;YAC5D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,CAAC,CAAC,GAAG;oBACX,GAAG,OAAO,CAAC,CAAC,CAAC;oBACb,MAAM,EAAE,QAAQ;oBAChB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO;iBACnC,CAAC;gBACF,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;YACD,MAAM,EAAE,CAAC;QACX,CAAC;QAED,MAAM,EAAE,CAAC;QACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,UAAU,CAAC;IACpB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvB,MAAM,kBAAkB,GAAG,OAAO,CAChC,GAAG,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,EACtC,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,OAAO;QACP,UAAU;QACV,QAAQ;QACR,OAAO;QACP,eAAe;QACf,YAAY;QACZ,kBAAkB;QAClB,QAAQ;QACR,UAAU;QACV,KAAK;KACN,CAAC,EACF;QACE,OAAO;QACP,UAAU;QACV,QAAQ;QACR,OAAO;QACP,eAAe;QACf,YAAY;QACZ,kBAAkB;QAClB,QAAQ;QACR,UAAU;QACV,KAAK;KACN,CACF,CAAC;AACJ,CAAC"}

package/manifest/useEditResourceYaml.d.ts

@@ -0,0 +1,106 @@
+import type { Message } from "@bufbuild/protobuf";
+import { type AppliedManifest, type ManifestDocument } from "@stigmer/sdk";
+/**
+ * Result of validating the edited YAML against the source resource.
+ *
+ * Discriminated on `status` so consumers can render exactly one of:
+ * a disabled state (`empty`), an inline error (`invalid`), or the
+ * apply affordance (`valid`).
+ */
+export type EditYamlValidation = {
+    readonly status: "empty";
+} | {
+    readonly status: "invalid";
+    readonly message: string;
+} | {
+    readonly status: "valid";
+    readonly document: ManifestDocument;
+};
+/**
+ * What applying the current content will do — resolved against live
+ * server state so renames surface as "create" before the user commits.
+ */
+export type EditYamlTarget = {
+    readonly action: "update";
+    readonly slug: string;
+} | {
+    readonly action: "create";
+    readonly slug: string;
+}
+/** Existence lookup failed (offline, permissions) — wording degrades. */
+ | {
+    readonly action: "unknown";
+    readonly slug: string;
+};
+/** Options for {@link useEditResourceYaml}. */
+export interface UseEditResourceYamlOptions {
+    /**
+     * The resource to edit, as returned by the server (e.g. from `useAgent`
+     * or a list panel row). `null` while the resource is loading — the hook
+     * seeds the editor when it arrives.
+     */
+    readonly resource: Message | null;
+}
+/** Return value of {@link useEditResourceYaml}. */
+export interface UseEditResourceYamlReturn {
+    /** Current editor content. */
+    readonly yaml: string;
+    /** Update the editor content (wire to the YAML editor's `onChange`). */
+    readonly setYaml: (value: string) => void;
+    /** `true` when the content differs from the seeded serialization. */
+    readonly isDirty: boolean;
+    /** Live validation of the current content. */
+    readonly validation: EditYamlValidation;
+    /**
+     * Create-vs-update preview for the current content, or `null` while
+     * validation fails or the existence check is in flight.
+     */
+    readonly target: EditYamlTarget | null;
+    /** `true` when the content contains `***REDACTED***` secret markers. */
+    readonly hasRedactedSecrets: boolean;
+    /**
+     * Apply the edited YAML. Resolves with the applied resource, or `null`
+     * when the content is not currently valid (check `validation`).
+     */
+    readonly apply: () => Promise<AppliedManifest | null>;
+    /** `true` while the apply RPC is in flight. */
+    readonly isApplying: boolean;
+    /** Error from the last failed apply, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Clear the apply error (e.g. when the user edits again). */
+    readonly clearError: () => void;
+    /** Discard edits and reseed from the resource. */
+    readonly reset: () => void;
+}
+/**
+ * Behavior hook for editing an existing resource as YAML and applying the
+ * result — the console's kind-agnostic "Edit YAML" flow.
+ *
+ * Seeds the editor from {@link serializeManifest} (full fidelity minus
+ * system-managed state), validates every edit against the kind's generated
+ * proto schema via {@link parseManifest} (strict — unknown fields fail
+ * loudly), previews create-vs-update by resolving the edited document's
+ * reference against the server, and applies through
+ * `stigmer.manifest.apply()`.
+ *
+ * Guardrails beyond the raw engine:
+ * - the edited document must stay the same kind as the source resource
+ *   (pasting an Environment into an Agent editor is an error, not an apply)
+ * - the edited manifest must contain exactly one document
+ *
+ * @example
+ * ```tsx
+ * const edit = useEditResourceYaml({ resource: agent });
+ *
+ * <YamlEditor value={edit.yaml} onChange={edit.setYaml} />
+ * {edit.validation.status === "invalid" && <p>{edit.validation.message}</p>}
+ * <button disabled={edit.validation.status !== "valid"} onClick={edit.apply}>
+ *   {edit.target?.action === "create" ? "Create" : "Apply changes"}
+ * </button>
+ * ```
+ *
+ * @see {@link EditResourceYamlDialog} for the styled component composing this hook
+ * @see {@link useApplyManifest} for the paste/upload counterpart
+ */
+export declare function useEditResourceYaml({ resource, }: UseEditResourceYamlOptions): UseEditResourceYamlReturn;
+//# sourceMappingURL=useEditResourceYaml.d.ts.map

package/manifest/useEditResourceYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditResourceYaml.d.ts","sourceRoot":"","sources":["../../src/manifest/useEditResourceYaml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAItB;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACtD,yEAAyE;GACvE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACtD,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,GACT,EAAE,0BAA0B,GAAG,yBAAyB,CA+JxD"}