@tai42/studio-sdk 30.0.1 → 31.0.0

package/dist/components/field.d.ts

@@ -24,6 +24,12 @@ export interface FieldControlProps {
  * expose its invalid state.
  */
 export declare function useFieldControl(): FieldControlProps;
+/**
+ * The id of the enclosing Field's label while it names one control, else `undefined`.
+ * A control whose popup holds a second labelled surface (a listbox, a dialog) points
+ * that surface's `aria-labelledby` at it, so the popup carries the field's name.
+ */
+export declare function useFieldLabelId(): string | undefined;
 export interface FieldProps {
     readonly label: string;
     readonly description?: string;

package/dist/components/field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/components/field.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAatD,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,IAAI,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAUnD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,KAAa,EACb,SAAiB,GAClB,EAAE,UAAU,+BA0EZ"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/components/field.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAetD,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,IAAI,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAUnD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,KAAa,EACb,SAAiB,GAClB,EAAE,UAAU,+BA+EZ"}

package/dist/components/field.js

@@ -23,6 +23,14 @@ export function useFieldControl() {
         'aria-invalid': ctx.invalid ? true : undefined,
     };
 }
+/**
+ * The id of the enclosing Field's label while it names one control, else `undefined`.
+ * A control whose popup holds a second labelled surface (a listbox, a dialog) points
+ * that surface's `aria-labelledby` at it, so the popup carries the field's name.
+ */
+export function useFieldLabelId() {
+    return useContext(FieldContext)?.labelId;
+}
 export function Field({ label, description, error, children, style, className, group = false, hideLabel = false, }) {
     const controlId = useId();
     const labelId = `${controlId}-label`;
@@ -41,8 +49,13 @@ export function Field({ label, description, error, children, style, className, g
     // if the group Field withheld it too, a group Field carrying an `error` would
     // expose its invalid state NOWHERE in the accessibility tree.
     const value = group
-        ? { controlId: undefined, describedBy: undefined, invalid: error !== undefined }
-        : { controlId, describedBy, invalid: error !== undefined };
+        ? {
+            controlId: undefined,
+            labelId: undefined,
+            describedBy: undefined,
+            invalid: error !== undefined,
+        }
+        : { controlId, labelId, describedBy, invalid: error !== undefined };
     // The label keeps its `htmlFor`/`id` wiring either way — `hideLabel` only drops
     // its PAINT, so the accessible name it gives the control is unchanged.
     const labelClassName = hideLabel ? 'tai-field-label tai-visually-hidden' : 'tai-field-label';

package/dist/components/field.js.map

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

package/dist/components/folder-actions.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The folder WRITES of the tool-organization tree — create, rename, move and delete —
+ * shared by every screen that shows the tree, so each offers the same actions over
+ * the same client doors (`createFolder` / `renameFolder` / `moveFolder` /
+ * `deleteFolder`).
+ *
+ * The SDK owns no query cache, so every write takes the screen's
+ * `onFoldersChanged`: the screen re-reads the overlay under its own key, and the
+ * write resolves only after that refresh, so the tree on screen is never stale when
+ * a dialog closes. Each dialog owns its own pending and error state, so a failure on
+ * one folder never bleeds onto another, and every failure is shown in its dialog.
+ *
+ * Move offers every folder EXCEPT the folder itself and its descendants (a folder
+ * cannot become its own ancestor), with inline create. Delete asks first and lets the
+ * server enforce that only an empty folder can go; a refusal is shown in the dialog.
+ *
+ * Each action is offered only where the caller may make that write
+ * ({@link useToolMetaWriteAccess}): its own route, and the tool_meta store not known
+ * off. A not-configured refusal is reported, so every screen withdraws its overlay
+ * writes; the open dialog stays to show the server's off note.
+ */
+import { type ReactNode } from 'react';
+import { type Folder } from './folder-nav';
+/** Re-read the folder tree after a write; the write resolves once this settles. */
+export type FoldersChanged = () => Promise<void>;
+/** Create a folder under `parentId` and resolve with its id. */
+export type CreateFolder = (name: string, parentId: string | null) => Promise<string>;
+/**
+ * Create a folder through the folder door and refresh the screen's tree, resolving
+ * with the new folder's id — the shape {@link FolderPicker}'s `onCreateFolder`
+ * takes. `undefined` when the caller may not create a folder, so the picker offers
+ * no create. A rejection propagates to the picker, which shows it; a not-configured
+ * refusal is also reported, withdrawing every overlay write.
+ */
+export declare function useCreateFolder(onFoldersChanged: FoldersChanged): CreateFolder | undefined;
+/** Props of {@link FolderActionsMenu}. */
+export interface FolderActionsMenuProps {
+    /** The folder the actions act on. */
+    readonly folder: Folder;
+    /** The FULL folder tree, offered as move destinations. */
+    readonly folders: readonly Folder[];
+    /** The screen's refresh of its overlay read, awaited after every write. */
+    readonly onFoldersChanged: FoldersChanged;
+}
+/** The Rename, Move and Delete buttons for one folder row/card, each owning its
+ *  dialog — for an explorer's `renderFolderActions` slot. Each button shows only
+ *  where the caller may make that write; a dialog already open stays open after its
+ *  button is withdrawn, so its outcome is still shown. Renders nothing for a caller
+ *  who may make none of the three writes. */
+export declare function FolderActionsMenu({ folder, folders, onFoldersChanged, }: FolderActionsMenuProps): ReactNode;
+//# sourceMappingURL=folder-actions.d.ts.map

package/dist/components/folder-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-actions.d.ts","sourceRoot":"","sources":["../../src/components/folder-actions.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAC;AAQ9D,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,cAAc,CAAC;AASzD,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,cAAc,GAAG,YAAY,GAAG,SAAS,CAmB1F;AA+LD,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC;CAC3C;AAED;;;;6CAI6C;AAC7C,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,OAAO,EACP,gBAAgB,GACjB,EAAE,sBAAsB,GAAG,SAAS,CA4DpC"}

package/dist/components/folder-actions.js

@@ -0,0 +1,173 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The folder WRITES of the tool-organization tree — create, rename, move and delete —
+ * shared by every screen that shows the tree, so each offers the same actions over
+ * the same client doors (`createFolder` / `renameFolder` / `moveFolder` /
+ * `deleteFolder`).
+ *
+ * The SDK owns no query cache, so every write takes the screen's
+ * `onFoldersChanged`: the screen re-reads the overlay under its own key, and the
+ * write resolves only after that refresh, so the tree on screen is never stale when
+ * a dialog closes. Each dialog owns its own pending and error state, so a failure on
+ * one folder never bleeds onto another, and every failure is shown in its dialog.
+ *
+ * Move offers every folder EXCEPT the folder itself and its descendants (a folder
+ * cannot become its own ancestor), with inline create. Delete asks first and lets the
+ * server enforce that only an empty folder can go; a refusal is shown in the dialog.
+ *
+ * Each action is offered only where the caller may make that write
+ * ({@link useToolMetaWriteAccess}): its own route, and the tool_meta store not known
+ * off. A not-configured refusal is reported, so every screen withdraws its overlay
+ * writes; the open dialog stays to show the server's off note.
+ */
+import { useCallback, useState } from 'react';
+import { errorMessage } from '../errors';
+import { FeatureDisabled, featureDisabledMessage, isFeatureDisabled } from '../feature-disabled';
+import { useApi } from '../hooks/useApi';
+import { ConfirmDialog } from './confirm-dialog';
+import { Dialog } from './dialog';
+import { Field } from './field';
+import { FolderPicker } from './folder-nav';
+import { TextInput } from './inputs';
+import { Button, Spinner } from './primitives';
+import { ToolMetaWriteError, useReportToolMetaRefusal, useToolMetaWriteAccess, } from './tool-meta-access';
+/**
+ * Create a folder through the folder door and refresh the screen's tree, resolving
+ * with the new folder's id — the shape {@link FolderPicker}'s `onCreateFolder`
+ * takes. `undefined` when the caller may not create a folder, so the picker offers
+ * no create. A rejection propagates to the picker, which shows it; a not-configured
+ * refusal is also reported, withdrawing every overlay write.
+ */
+export function useCreateFolder(onFoldersChanged) {
+    const api = useApi();
+    const { createFolder: allowed } = useToolMetaWriteAccess();
+    const reportRefusal = useReportToolMetaRefusal();
+    const create = useCallback(async (name, parentId) => {
+        let created;
+        try {
+            created = await api.createFolder(name, parentId);
+        }
+        catch (error) {
+            reportRefusal(error);
+            throw error;
+        }
+        await onFoldersChanged();
+        return created.id;
+    }, [api, onFoldersChanged, reportRefusal]);
+    return allowed ? create : undefined;
+}
+/** One write's pending + error state: `run` clears the last error, awaits the write
+ *  and keeps a rejection for the dialog to show, reporting a not-configured one. */
+function useFolderWrite(write) {
+    const reportRefusal = useReportToolMetaRefusal();
+    const [pending, setPending] = useState(false);
+    const [error, setError] = useState(null);
+    const run = () => {
+        if (pending)
+            return;
+        setPending(true);
+        setError(null);
+        write().then(() => {
+            setPending(false);
+        }, (failure) => {
+            setError(failure);
+            setPending(false);
+            reportRefusal(failure);
+        });
+    };
+    return { run, pending, error };
+}
+/** The ids of `folder` and every folder nested beneath it — linear in the folder
+ *  count and safe on a cyclic parent chain. */
+function subtreeIds(folder, folders) {
+    const childrenByParent = new Map();
+    for (const candidate of folders) {
+        if (candidate.parentId === null)
+            continue;
+        const siblings = childrenByParent.get(candidate.parentId) ?? [];
+        siblings.push(candidate.id);
+        childrenByParent.set(candidate.parentId, siblings);
+    }
+    const ids = new Set([folder.id]);
+    const queue = [folder.id];
+    for (let next = queue.pop(); next !== undefined; next = queue.pop()) {
+        for (const childId of childrenByParent.get(next) ?? []) {
+            if (ids.has(childId))
+                continue;
+            ids.add(childId);
+            queue.push(childId);
+        }
+    }
+    return ids;
+}
+function RenameFolderDialog({ folder, onFoldersChanged, onClose }) {
+    const api = useApi();
+    const [name, setName] = useState(folder.name);
+    const trimmed = name.trim();
+    const rename = useFolderWrite(async () => {
+        await api.renameFolder(folder.id, trimmed);
+        await onFoldersChanged();
+        onClose();
+    });
+    const blocked = trimmed === '' || trimmed === folder.name || rename.pending;
+    return (_jsxs(Dialog, { title: "Rename folder", open: true, onOpenChange: (next) => {
+            if (!next)
+                onClose();
+        }, children: [_jsx(Field, { label: "Folder name", children: _jsx(TextInput, { value: name, autoComplete: "off", onChange: (event) => {
+                        setName(event.target.value);
+                    }, onKeyDown: (event) => {
+                        if (event.key === 'Enter' && !blocked) {
+                            event.preventDefault();
+                            rename.run();
+                        }
+                    } }) }), _jsx(ToolMetaWriteError, { error: rename.error }), _jsxs("div", { className: "tai-dialog-actions", children: [_jsx(Button, { type: "button", onClick: onClose, children: "Cancel" }), _jsxs(Button, { type: "button", variant: "primary", disabled: blocked, onClick: rename.run, children: [rename.pending ? _jsx(Spinner, { label: "Renaming folder" }) : null, "Rename"] })] })] }));
+}
+function MoveFolderDialog({ folder, folders, onFoldersChanged, onClose, }) {
+    const api = useApi();
+    const [parentId, setParentId] = useState(folder.parentId);
+    const createFolder = useCreateFolder(onFoldersChanged);
+    const move = useFolderWrite(async () => {
+        await api.moveFolder(folder.id, parentId);
+        await onFoldersChanged();
+        onClose();
+    });
+    const forbidden = subtreeIds(folder, folders);
+    const targets = folders.filter((candidate) => !forbidden.has(candidate.id));
+    return (_jsxs(Dialog, { title: `Move ${folder.name}`, open: true, onOpenChange: (next) => {
+            if (!next)
+                onClose();
+        }, children: [_jsx(Field, { label: "Destination folder", description: "Choose a new parent, or the root.", group: true, children: _jsx(FolderPicker, { value: parentId, onChange: setParentId, folders: targets, onCreateFolder: createFolder, unfiledLabel: "Root (no folder)" }) }), _jsx(ToolMetaWriteError, { error: move.error }), _jsxs("div", { className: "tai-dialog-actions", children: [_jsx(Button, { type: "button", onClick: onClose, children: "Cancel" }), _jsxs(Button, { type: "button", variant: "primary", disabled: parentId === folder.parentId || move.pending, onClick: move.run, children: [move.pending ? _jsx(Spinner, { label: "Moving folder" }) : null, "Move"] })] })] }));
+}
+function DeleteFolderDialog({ folder, onFoldersChanged, onClose }) {
+    const api = useApi();
+    const remove = useFolderWrite(async () => {
+        await api.deleteFolder(folder.id);
+        await onFoldersChanged();
+        onClose();
+    });
+    const off = isFeatureDisabled(remove.error);
+    return (_jsx(ConfirmDialog, { title: `Delete ${folder.name}?`, confirmLabel: "Delete folder", pendingLabel: "Deleting folder", onConfirm: remove.run, onClose: onClose, isPending: remove.pending, error: remove.error !== null && !off ? errorMessage(remove.error) : null, disabledNote: off ? (_jsx(FeatureDisabled, { feature: "Tool metadata", message: featureDisabledMessage(remove.error) })) : undefined, children: _jsx("p", { children: "Only an empty folder can be deleted \u2014 one that still holds tools (hidden ones count) or subfolders cannot be." }) }));
+}
+/** The Rename, Move and Delete buttons for one folder row/card, each owning its
+ *  dialog — for an explorer's `renderFolderActions` slot. Each button shows only
+ *  where the caller may make that write; a dialog already open stays open after its
+ *  button is withdrawn, so its outcome is still shown. Renders nothing for a caller
+ *  who may make none of the three writes. */
+export function FolderActionsMenu({ folder, folders, onFoldersChanged, }) {
+    const access = useToolMetaWriteAccess();
+    const [action, setAction] = useState(null);
+    const close = () => {
+        setAction(null);
+    };
+    if (!access.renameFolder && !access.moveFolder && !access.deleteFolder && action === null) {
+        return null;
+    }
+    return (_jsxs("div", { className: "tai-row", children: [access.renameFolder ? (_jsx(Button, { variant: "ghost", "aria-label": `Rename folder ${folder.name}`, onClick: () => {
+                    setAction('rename');
+                }, children: "Rename" })) : null, access.moveFolder ? (_jsx(Button, { variant: "ghost", "aria-label": `Move folder ${folder.name}`, onClick: () => {
+                    setAction('move');
+                }, children: "Move" })) : null, access.deleteFolder ? (_jsx(Button, { variant: "ghost", "aria-label": `Delete folder ${folder.name}`, onClick: () => {
+                    setAction('delete');
+                }, children: "Delete" })) : null, action === 'rename' ? (_jsx(RenameFolderDialog, { folder: folder, onFoldersChanged: onFoldersChanged, onClose: close })) : null, action === 'move' ? (_jsx(MoveFolderDialog, { folder: folder, folders: folders, onFoldersChanged: onFoldersChanged, onClose: close })) : null, action === 'delete' ? (_jsx(DeleteFolderDialog, { folder: folder, onFoldersChanged: onFoldersChanged, onClose: close })) : null] }));
+}
+//# sourceMappingURL=folder-actions.js.map

package/dist/components/folder-actions.js.map

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

package/dist/components/folder-filing.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Filing ONE tool into a folder of the tool-organization tree — for a screen whose
+ * rows have no edit dialog of their own to carry a folder field. The folder is part
+ * of the tool's overlay row, so the write is a single `upsertToolMeta` merge-patch of
+ * `folder_id`; the tool's display name, tags and visibility are left untouched.
+ *
+ * The picker offers the FULL tree with inline create. The write resolves only after
+ * the screen's `onFoldersChanged` refresh, and a failure is shown in the dialog — a
+ * not-configured refusal as the server's off note, reported so every screen withdraws
+ * its overlay writes.
+ */
+import { type ReactNode } from 'react';
+import { type FoldersChanged } from './folder-actions';
+import { type Folder } from './folder-nav';
+/** Props of {@link MoveToFolderDialog}. */
+export interface MoveToFolderDialogProps {
+    /** The tool whose overlay row is filed (its registered tool name). */
+    readonly toolName: string;
+    /** What the dialog title calls the item (e.g. the agent's name). */
+    readonly label: string;
+    /** The tool's current folder (`null` = unfiled). */
+    readonly currentFolderId: string | null;
+    /** The FULL folder tree, offered as destinations. */
+    readonly folders: readonly Folder[];
+    /** The screen's refresh of its overlay read, awaited after the write. */
+    readonly onFoldersChanged: FoldersChanged;
+    /** Close the dialog (Cancel, dismiss, or after a successful move). */
+    readonly onClose: () => void;
+}
+/** A dialog that files one tool into a folder (or unfiles it). Mount while open. */
+export declare function MoveToFolderDialog({ toolName, label, currentFolderId, folders, onFoldersChanged, onClose, }: MoveToFolderDialogProps): ReactNode;
+//# sourceMappingURL=folder-filing.d.ts.map

package/dist/components/folder-filing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-filing.d.ts","sourceRoot":"","sources":["../../src/components/folder-filing.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAKjD,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,cAAc,CAAC;AAIzD,2CAA2C;AAC3C,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,KAAK,EACL,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,OAAO,GACR,EAAE,uBAAuB,GAAG,SAAS,CA+DrC"}

package/dist/components/folder-filing.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Filing ONE tool into a folder of the tool-organization tree — for a screen whose
+ * rows have no edit dialog of their own to carry a folder field. The folder is part
+ * of the tool's overlay row, so the write is a single `upsertToolMeta` merge-patch of
+ * `folder_id`; the tool's display name, tags and visibility are left untouched.
+ *
+ * The picker offers the FULL tree with inline create. The write resolves only after
+ * the screen's `onFoldersChanged` refresh, and a failure is shown in the dialog — a
+ * not-configured refusal as the server's off note, reported so every screen withdraws
+ * its overlay writes.
+ */
+import { useState } from 'react';
+import { useApi } from '../hooks/useApi';
+import { Dialog } from './dialog';
+import { Field } from './field';
+import { useCreateFolder } from './folder-actions';
+import { FolderPicker } from './folder-nav';
+import { Button, Spinner } from './primitives';
+import { ToolMetaWriteError, useReportToolMetaRefusal } from './tool-meta-access';
+/** A dialog that files one tool into a folder (or unfiles it). Mount while open. */
+export function MoveToFolderDialog({ toolName, label, currentFolderId, folders, onFoldersChanged, onClose, }) {
+    const api = useApi();
+    const createFolder = useCreateFolder(onFoldersChanged);
+    const reportRefusal = useReportToolMetaRefusal();
+    const [folderId, setFolderId] = useState(currentFolderId);
+    const [pending, setPending] = useState(false);
+    const [error, setError] = useState(null);
+    const save = () => {
+        if (pending)
+            return;
+        setPending(true);
+        setError(null);
+        api
+            .upsertToolMeta(toolName, { folder_id: folderId })
+            .then(() => onFoldersChanged())
+            .then(() => {
+            setPending(false);
+            onClose();
+        }, (failure) => {
+            setError(failure);
+            setPending(false);
+            reportRefusal(failure);
+        });
+    };
+    return (_jsxs(Dialog, { title: `Move ${label} to a folder`, open: true, onOpenChange: (next) => {
+            if (!next)
+                onClose();
+        }, children: [_jsx(Field, { label: "Destination folder", description: "Choose a folder, or no folder.", group: true, children: _jsx(FolderPicker, { value: folderId, onChange: setFolderId, folders: folders, onCreateFolder: createFolder, unfiledLabel: "No folder", disabled: pending }) }), _jsx(ToolMetaWriteError, { error: error }), _jsxs("div", { className: "tai-dialog-actions", children: [_jsx(Button, { type: "button", onClick: onClose, children: "Cancel" }), _jsxs(Button, { type: "button", variant: "primary", disabled: folderId === currentFolderId || pending, onClick: save, children: [pending ? _jsx(Spinner, { label: "Moving" }) : null, "Move"] })] })] }));
+}
+//# sourceMappingURL=folder-filing.js.map

package/dist/components/folder-filing.js.map

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

package/dist/components/folder-nav.d.ts

@@ -11,8 +11,10 @@
  *
  * `FolderPicker` carries inline new-folder creation, so a folder can be created from
  * EVERY consuming screen through this one component — never one screen's own
- * affordance.
+ * affordance. A failed creation is shown loudly under the draft by the picker
+ * itself, so every screen that files through it surfaces the failure the same way.
  */
+import type { FolderRecord } from '@tai42/api-client';
 import { type ReactNode } from 'react';
 /** A folder in the tree, in the SDK's camelCase UI shape (`parentId`, `null` = root). */
 export interface Folder {
@@ -20,6 +22,8 @@ export interface Folder {
     readonly name: string;
     readonly parentId: string | null;
 }
+/** Map the overlay's wire folder records into the UI {@link Folder} shape. */
+export declare function toFolders(records: readonly FolderRecord[]): Folder[];
 /** The subfolders directly under `parentId` (`null` = the root directory), name-sorted. */
 export declare function childFolders(folders: readonly Folder[], parentId: string | null): Folder[];
 /**
@@ -50,10 +54,11 @@ export interface FolderPickerProps {
     readonly folders: readonly Folder[];
     /**
      * Create a folder under `parentId` (the current selection) and resolve with its
-     * id; the picker selects it. Rejection is the caller's to surface — the picker
-     * leaves the draft in place so the operator can retry.
+     * id; the picker selects it. On a rejection the picker shows the error and keeps
+     * the draft in place so the operator can retry. Without it the picker offers no
+     * create — the caller may not create folders.
      */
-    readonly onCreateFolder: (name: string, parentId: string | null) => Promise<string>;
+    readonly onCreateFolder?: (name: string, parentId: string | null) => Promise<string>;
     readonly disabled?: boolean;
     /** The unfiled option's label (e.g. "No folder"). */
     readonly unfiledLabel: string;

package/dist/components/folder-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"folder-nav.d.ts","sourceRoot":"","sources":["../../src/components/folder-nav.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAOjD,yFAAyF;AACzF,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAI1F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAc1F;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,eAAe,EACf,UAAU,EACV,SAAS,GACV,EAAE,qBAAqB,GAAG,SAAS,CA6BnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,cAAc,GAAG,SAAS,CAYvE;AAkBD,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,cAAc,EACd,QAAQ,EACR,YAAY,GACb,EAAE,iBAAiB,GAAG,SAAS,CA4F/B"}
+{"version":3,"file":"folder-nav.d.ts","sourceRoot":"","sources":["../../src/components/folder-nav.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAQjD,yFAAyF;AACzF,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAMpE;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAI1F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAc1F;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,eAAe,EACf,UAAU,EACV,SAAS,GACV,EAAE,qBAAqB,GAAG,SAAS,CA6BnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,cAAc,GAAG,SAAS,CAYvE;AAkBD,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,cAAc,EACd,QAAQ,EACR,YAAY,GACb,EAAE,iBAAiB,GAAG,SAAS,CA+F/B"}

package/dist/components/folder-nav.js

@@ -1,24 +1,18 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * Folder navigation primitives for the tool-organization tree — shared by the tools
- * screen and any plugin screen that shows the same tree, so all explore, breadcrumb, and
- * re-file against one identical set of controls.
- *
- * The tree is passed FLAT (a {@link Folder} list keyed by `id`, each naming its
- * `parentId`); these helpers derive the current directory, the breadcrumb path, and
- * the indented picker options from it. Every derivation is cycle-SAFE: a malformed
- * parent chain (a loop, a dangling parent) is bounded by the folder count rather than
- * looping forever — bad data degrades to a truncated path, never a hang.
- *
- * `FolderPicker` carries inline new-folder creation, so a folder can be created from
- * EVERY consuming screen through this one component — never one screen's own
- * affordance.
- */
 import { useState } from 'react';
 import { ChevronRightIcon, FolderIcon } from './icons';
 import { TextInput } from './inputs';
 import { Button } from './primitives';
 import { Select } from './select';
+import { ToolMetaWriteError } from './tool-meta-access';
+/** Map the overlay's wire folder records into the UI {@link Folder} shape. */
+export function toFolders(records) {
+    return records.map((record) => ({
+        id: record.id,
+        name: record.name,
+        parentId: record.parent_id,
+    }));
+}
 /** The subfolders directly under `parentId` (`null` = the root directory), name-sorted. */
 export function childFolders(folders, parentId) {
     return folders
@@ -81,22 +75,23 @@ export function FolderPicker({ value, onChange, folders, onCreateFolder, disable
     const [creating, setCreating] = useState(false);
     const [draft, setDraft] = useState('');
     const [busy, setBusy] = useState(false);
+    const [createError, setCreateError] = useState(null);
     const options = [{ value: UNFILED_VALUE, label: unfiledLabel }, ...folderOptions(folders)];
     const create = async () => {
         const name = draft.trim();
-        if (name === '' || busy)
+        if (name === '' || busy || onCreateFolder === undefined)
             return;
         setBusy(true);
+        setCreateError(null);
         try {
             const id = await onCreateFolder(name, value);
             onChange(id);
             setDraft('');
             setCreating(false);
         }
-        catch {
-            // The caller owns surfacing the failure (its `onCreateFolder` is the loud
-            // surface); the picker's part is to keep the draft OPEN with its text so the
-            // operator can retry — never to clear it or select nothing.
+        catch (error) {
+            // Shown under the draft, which stays OPEN with its text for a retry.
+            setCreateError(error);
         }
         finally {
             setBusy(false);
@@ -104,7 +99,7 @@ export function FolderPicker({ value, onChange, folders, onCreateFolder, disable
     };
     return (_jsxs("div", { className: "tai-stack tai-stack-2", children: [_jsx(Select, { "aria-label": "Folder", options: options, value: value ?? UNFILED_VALUE, onValueChange: (next) => {
                     onChange(next === UNFILED_VALUE ? null : next);
-                }, disabled: disabled ?? busy }), creating ? (_jsxs("div", { className: "tai-row", children: [_jsx("div", { style: { flex: 1 }, children: _jsx(TextInput, { value: draft, onChange: (event) => {
+                }, disabled: disabled ?? busy }), onCreateFolder === undefined ? null : creating ? (_jsxs("div", { className: "tai-row", children: [_jsx("div", { style: { flex: 1 }, children: _jsx(TextInput, { value: draft, onChange: (event) => {
                                 setDraft(event.target.value);
                             }, onKeyDown: (event) => {
                                 if (event.key === 'Enter') {
@@ -116,8 +111,9 @@ export function FolderPicker({ value, onChange, folders, onCreateFolder, disable
                         }, disabled: busy || draft.trim() === '', children: "Create" }), _jsx(Button, { type: "button", variant: "ghost", onClick: () => {
                             setCreating(false);
                             setDraft('');
+                            setCreateError(null);
                         }, disabled: busy, children: "Cancel" })] })) : (_jsxs(Button, { type: "button", variant: "ghost", onClick: () => {
                     setCreating(true);
-                }, disabled: disabled, children: [_jsx(FolderIcon, {}), _jsx("span", { children: "New folder" })] }))] }));
+                }, disabled: disabled, children: [_jsx(FolderIcon, {}), _jsx("span", { children: "New folder" })] })), _jsx(ToolMetaWriteError, { error: createError })] }));
 }
 //# sourceMappingURL=folder-nav.js.map

package/dist/components/folder-nav.js.map

@@ -1 +1 @@
-{"version":3,"file":"folder-nav.js","sourceRoot":"","sources":["../../src/components/folder-nav.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAkB,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASlC,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAAC,OAA0B,EAAE,QAAuB;IAC9E,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;SAChD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAA0B,EAAE,QAAuB;IAC9E,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,OAAO,GAAkB,QAAQ,CAAC;IACtC,OAAO,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAUD,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,EAC/B,OAAO,EACP,eAAe,EACf,UAAU,EACV,SAAS,GACa;IACtB,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACpD,OAAO,CACL,eAAK,SAAS,EAAC,SAAS,gBAAY,aAAa,aAC/C,KAAC,MAAM,IACL,OAAO,EAAC,OAAO,EACf,OAAO,EAAE,GAAG,EAAE;oBACZ,UAAU,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC,kBACa,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YAE1D,SAAS,GACH,EACR,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACpB,gBAAsB,SAAS,EAAC,SAAS,aACvC,KAAC,gBAAgB,KAAG,EACpB,KAAC,MAAM,IACL,OAAO,EAAC,OAAO,EACf,OAAO,EAAE,GAAG,EAAE;4BACZ,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;wBACxB,CAAC,kBACa,MAAM,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YAE/D,MAAM,CAAC,IAAI,GACL,KAVA,MAAM,CAAC,EAAE,CAWb,CACR,CAAC,IACE,CACP,CAAC;AACJ,CAAC;AAOD,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAkB;IAC1D,OAAO,CACL,MAAC,MAAM,IACL,OAAO,EAAC,OAAO,EACf,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC,aAED,KAAC,UAAU,KAAG,EACd,yBAAO,MAAM,CAAC,IAAI,GAAQ,IACnB,CACV,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC,gFAAgF;AAChF,SAAS,aAAa,CAAC,OAA0B;IAC/C,MAAM,OAAO,GAAuC,EAAE,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,QAAuB,EAAE,KAAa,EAAQ,EAAE;QAC5D,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,OAAO,OAAO,CAAC;AACjB,CAAC;AAkBD,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,cAAc,EACd,QAAQ,EACR,YAAY,GACM;IAClB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3F,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI;YAAE,OAAO;QAChC,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7C,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,6EAA6E;YAC7E,4DAA4D;QAC9D,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,eAAK,SAAS,EAAC,uBAAuB,aACpC,KAAC,MAAM,kBACM,QAAQ,EACnB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,IAAI,aAAa,EAC7B,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE;oBACtB,QAAQ,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACjD,CAAC,EACD,QAAQ,EAAE,QAAQ,IAAI,IAAI,GAC1B,EACD,QAAQ,CAAC,CAAC,CAAC,CACV,eAAK,SAAS,EAAC,SAAS,aACtB,cAAK,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,YACrB,KAAC,SAAS,IACR,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gCAClB,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BAC/B,CAAC,EACD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;gCACnB,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;oCAC1B,KAAK,CAAC,cAAc,EAAE,CAAC;oCACvB,KAAK,MAAM,EAAE,CAAC;gCAChB,CAAC;4BACH,CAAC,EACD,WAAW,EAAC,uBAAkB,gBACnB,iBAAiB,EAC5B,QAAQ,EAAE,IAAI,GACd,GACE,EACN,KAAC,MAAM,IACL,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,SAAS,EACjB,OAAO,EAAE,GAAG,EAAE;4BACZ,KAAK,MAAM,EAAE,CAAC;wBAChB,CAAC,EACD,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,uBAG9B,EACT,KAAC,MAAM,IACL,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,OAAO,EACf,OAAO,EAAE,GAAG,EAAE;4BACZ,WAAW,CAAC,KAAK,CAAC,CAAC;4BACnB,QAAQ,CAAC,EAAE,CAAC,CAAC;wBACf,CAAC,EACD,QAAQ,EAAE,IAAI,uBAGP,IACL,CACP,CAAC,CAAC,CAAC,CACF,MAAC,MAAM,IACL,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,OAAO,EACf,OAAO,EAAE,GAAG,EAAE;oBACZ,WAAW,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC,EACD,QAAQ,EAAE,QAAQ,aAElB,KAAC,UAAU,KAAG,EACd,wCAAuB,IAChB,CACV,IACG,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"folder-nav.js","sourceRoot":"","sources":["../../src/components/folder-nav.tsx"],"names":[],"mappings":"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"}

package/dist/components/folder-occupancy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Which folders of the ONE tool-organization tree a screen draws. Every tool has one
+ * folder; a screen lists only its own population (a subset of the tools), so it draws
+ * only the part of the tree that concerns that population:
+ *
+ *  - a folder whose subtree holds at least one of the screen's items is drawn;
+ *  - a folder whose subtree holds no tool at all is drawn (a fresh folder belongs to
+ *    every screen until something is filed in it);
+ *  - a folder whose subtree holds only other tools is not drawn;
+ *  - the ancestors of a drawn folder are drawn, so every drawn folder stays reachable
+ *    from the root.
+ *
+ * Occupancy counts EVERY overlay row with a `folder_id` — hidden tools and rows of
+ * tools no longer registered included — so a folder never reads as empty while it
+ * still holds something. A screen whose population is every tool draws the whole tree.
+ */
+import type { ToolMetaRecord } from '@tai42/api-client';
+import type { Folder } from './folder-nav';
+/**
+ * The folders a screen draws, in the input order.
+ *
+ * `rows` are the overlay rows (each tool's `folder_id`), `population` the tool names
+ * the screen lists. Linear in folders + rows; the subtree walk is cycle-guarded, so a
+ * malformed parent chain yields a bounded result rather than looping.
+ */
+export declare function foldersForView(folders: readonly Folder[], rows: readonly Pick<ToolMetaRecord, 'tool_name' | 'folder_id'>[], population: ReadonlySet<string>): Folder[];
+//# sourceMappingURL=folder-occupancy.d.ts.map

package/dist/components/folder-occupancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-occupancy.d.ts","sourceRoot":"","sources":["../../src/components/folder-occupancy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAW3C;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,SAAS,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,EAAE,EAChE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,MAAM,EAAE,CA0CV"}