@flanksource/clicky-ui 0.3.44 → 0.3.46

package/dist/layout/Workspace.cjs

@@ -61,6 +61,7 @@ function Workspace({
   onValueChange,
   storageKey,
   slots,
+  collapsedSides,
   className
 }) {
   Workspace_model.validateWorkspacePanes(panes);
@@ -131,6 +132,14 @@ function Workspace({
     if (storageKey && value === void 0)
       Workspace_model.writeWorkspaceLayoutState(storageKey, internal);
   }, [internal, storageKey, value]);
+  const held = (location) => (collapsedSides == null ? void 0 : collapsedSides.includes(location)) ?? false;
+  const shown = (collapsedSides == null ? void 0 : collapsedSides.length) ? {
+    ...state,
+    sideCollapsed: {
+      left: held("left") || state.sideCollapsed.left,
+      right: held("right") || state.sideCollapsed.right
+    }
+  } : state;
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
@@ -142,8 +151,8 @@ function Workspace({
         /* @__PURE__ */ jsxRuntime.jsx(
           WorkspaceTopRight,
           {
-            hasLeft: groups.left.length > 0,
-            hasRight: groups.right.length > 0,
+            hasLeft: groups.left.length > 0 && !held("left"),
+            hasRight: groups.right.length > 0 && !held("right"),
             ...slots ? { slots } : {},
             state,
             update
@@ -154,7 +163,7 @@ function Workspace({
           {
             location: "left",
             panes: groups.left,
-            state,
+            state: shown,
             update
           }
         ),
@@ -171,7 +180,7 @@ function Workspace({
           {
             location: "right",
             panes: groups.right,
-            state,
+            state: shown,
             update
           }
         ),

package/dist/layout/Workspace.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Workspace.cjs","sources":["../../src/layout/Workspace.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { UiSidebar } from \"../icons\";\nimport { cn } from \"../lib/utils\";\nimport {\n  createWorkspaceLayoutState,\n  readWorkspaceLayoutState,\n  validateWorkspacePanes,\n  writeWorkspaceLayoutState,\n  type WorkspaceLayoutDefaults,\n  type WorkspaceLayoutState,\n  type WorkspacePaneSpec,\n} from \"./Workspace.model\";\nimport {\n  WorkspaceSideRegion,\n  WorkspaceSingleRegion,\n  type WorkspaceUpdate,\n} from \"./Workspace.regions\";\n\nexport type {\n  WorkspaceLayoutDefaults,\n  WorkspaceLayoutState,\n  WorkspacePaneLocation,\n  WorkspacePaneSlots,\n  WorkspacePaneSpec,\n  WorkspaceSideLocation,\n} from \"./Workspace.model\";\n\nexport type WorkspaceSlots = {\n  topRightActions?: ReactNode;\n};\n\nexport type WorkspaceProps = {\n  panes: WorkspacePaneSpec[];\n  value?: WorkspaceLayoutState;\n  defaultValue?: WorkspaceLayoutDefaults;\n  onValueChange?: (value: WorkspaceLayoutState) => void;\n  storageKey?: string;\n  slots?: WorkspaceSlots;\n  className?: string;\n};\n\ntype WorkspaceTopRightProps = {\n  hasLeft: boolean;\n  hasRight: boolean;\n  slots?: WorkspaceSlots;\n  state: WorkspaceLayoutState;\n  update: WorkspaceUpdate;\n};\n\nfunction WorkspaceTopRight({\n  hasLeft,\n  hasRight,\n  slots,\n  state,\n  update,\n}: WorkspaceTopRightProps) {\n  if (!hasLeft && !hasRight && !slots?.topRightActions) return null;\n  const toggleSide = (location: \"left\" | \"right\") =>\n    update((current) => ({\n      ...current,\n      sideCollapsed: {\n        ...current.sideCollapsed,\n        [location]: !current.sideCollapsed[location],\n      },\n    }));\n  return (\n    <div\n      data-testid=\"workspace-top-right\"\n      className=\"absolute right-1 top-1 z-30 flex h-7 items-center gap-1 rounded bg-muted/90 px-1 shadow-sm backdrop-blur\"\n    >\n      {slots?.topRightActions}\n      {hasLeft && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.left}\n          aria-label={`${state.sideCollapsed.left ? \"Expand\" : \"Collapse\"} left side`}\n          onClick={() => toggleSide(\"left\")}\n        >\n          <UiSidebar className=\"size-4\" />\n        </button>\n      )}\n      {hasRight && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.right}\n          aria-label={`${state.sideCollapsed.right ? \"Expand\" : \"Collapse\"} right side`}\n          onClick={() => toggleSide(\"right\")}\n        >\n          <UiSidebar className=\"size-4 -scale-x-100\" />\n        </button>\n      )}\n    </div>\n  );\n}\n\nexport function Workspace({\n  panes,\n  value,\n  defaultValue = {},\n  onValueChange,\n  storageKey,\n  slots,\n  className,\n}: WorkspaceProps) {\n  validateWorkspacePanes(panes);\n  if (value !== undefined && storageKey !== undefined) {\n    throw new Error(\"Workspace cannot combine value with storageKey\");\n  }\n  const [internal, setInternal] = useState(() =>\n    storageKey\n      ? readWorkspaceLayoutState(storageKey, panes, defaultValue)\n      : createWorkspaceLayoutState(panes, defaultValue),\n  );\n  const seenLocations = useRef(new Set(panes.map((pane) => pane.location)));\n  const seenPaneIds = useRef(new Set(panes.map((pane) => pane.id)));\n  const state = value ?? internal;\n  const groups = useMemo(\n    () => ({\n      left: panes.filter((pane) => pane.location === \"left\"),\n      center: panes.find(\n        (pane) => pane.location === \"center\",\n      ) as WorkspacePaneSpec,\n      right: panes.filter((pane) => pane.location === \"right\"),\n      bottom: panes.find((pane) => pane.location === \"bottom\"),\n    }),\n    [panes],\n  );\n\n  useLayoutEffect(() => {\n    const addedLocations = new Set(\n      panes\n        .map((pane) => pane.location)\n        .filter((location) => !seenLocations.current.has(location)),\n    );\n    const addedPanes = panes.filter(\n      (pane) => !seenPaneIds.current.has(pane.id),\n    );\n    panes.forEach((pane) => {\n      seenLocations.current.add(pane.location);\n      seenPaneIds.current.add(pane.id);\n    });\n    if (\n      value !== undefined ||\n      (addedLocations.size === 0 && addedPanes.length === 0)\n    )\n      return;\n    const defaults = createWorkspaceLayoutState(panes, defaultValue);\n    const addedStackHeights = addedPanes.reduce<Record<string, number>>(\n      (heights, pane) => {\n        if (pane.height !== undefined) heights[pane.id] = pane.height;\n        return heights;\n      },\n      {},\n    );\n    setInternal((current) => ({\n      ...current,\n      ...(addedLocations.has(\"left\") ? { leftWidth: defaults.leftWidth } : {}),\n      ...(addedLocations.has(\"right\")\n        ? { rightWidth: defaults.rightWidth }\n        : {}),\n      ...(addedLocations.has(\"bottom\")\n        ? { bottomHeight: defaults.bottomHeight }\n        : {}),\n      stackHeights: { ...current.stackHeights, ...addedStackHeights },\n      collapsed: {\n        ...current.collapsed,\n        ...Object.fromEntries(\n          addedPanes.map((pane) => [pane.id, pane.defaultCollapsed ?? false]),\n        ),\n      },\n    }));\n  }, [defaultValue, panes, value]);\n\n  const update = useCallback<WorkspaceUpdate>(\n    (change) => {\n      const next = change(state);\n      if (value === undefined) setInternal(next);\n      onValueChange?.(next);\n    },\n    [onValueChange, state, value],\n  );\n\n  useEffect(() => {\n    if (storageKey && value === undefined)\n      writeWorkspaceLayoutState(storageKey, internal);\n  }, [internal, storageKey, value]);\n\n  return (\n    <div\n      className={cn(\n        \"relative grid min-h-0 w-full grid-cols-1 overflow-auto bg-background md:h-full md:grid-cols-[auto_minmax(0,1fr)_auto] md:grid-rows-[minmax(0,1fr)_auto] md:overflow-hidden\",\n        className,\n      )}\n    >\n      <WorkspaceTopRight\n        hasLeft={groups.left.length > 0}\n        hasRight={groups.right.length > 0}\n        {...(slots ? { slots } : {})}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"left\"\n        panes={groups.left}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSingleRegion\n        pane={groups.center}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"right\"\n        panes={groups.right}\n        state={state}\n        update={update}\n      />\n      {groups.bottom && (\n        <WorkspaceSingleRegion\n          pane={groups.bottom}\n          state={state}\n          update={update}\n        />\n      )}\n    </div>\n  );\n}\n"],"names":["jsxs","jsx","UiSidebar","validateWorkspacePanes","useState","readWorkspaceLayoutState","createWorkspaceLayoutState","useRef","useMemo","useLayoutEffect","useCallback","useEffect","writeWorkspaceLayoutState","cn","WorkspaceSideRegion","WorkspaceSingleRegion"],"mappings":"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"}
+{"version":3,"file":"Workspace.cjs","sources":["../../src/layout/Workspace.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { UiSidebar } from \"../icons\";\nimport { cn } from \"../lib/utils\";\nimport {\n  createWorkspaceLayoutState,\n  readWorkspaceLayoutState,\n  validateWorkspacePanes,\n  writeWorkspaceLayoutState,\n  type WorkspaceLayoutDefaults,\n  type WorkspaceLayoutState,\n  type WorkspacePaneSpec,\n  type WorkspaceSideLocation,\n} from \"./Workspace.model\";\nimport {\n  WorkspaceSideRegion,\n  WorkspaceSingleRegion,\n  type WorkspaceUpdate,\n} from \"./Workspace.regions\";\n\nexport type {\n  WorkspaceLayoutDefaults,\n  WorkspaceLayoutState,\n  WorkspacePaneLocation,\n  WorkspacePaneSlots,\n  WorkspacePaneSpec,\n  WorkspaceSideLocation,\n} from \"./Workspace.model\";\n\nexport type WorkspaceSlots = {\n  topRightActions?: ReactNode;\n};\n\nexport type WorkspaceProps = {\n  panes: WorkspacePaneSpec[];\n  value?: WorkspaceLayoutState;\n  defaultValue?: WorkspaceLayoutDefaults;\n  onValueChange?: (value: WorkspaceLayoutState) => void;\n  storageKey?: string;\n  slots?: WorkspaceSlots;\n  /**\n   * Sides the host holds collapsed for now, such as while the center shows something that needs the\n   * full width: they render collapsed and lose their toggle, and the layout state keeps how they were.\n   */\n  collapsedSides?: WorkspaceSideLocation[];\n  className?: string;\n};\n\ntype WorkspaceTopRightProps = {\n  hasLeft: boolean;\n  hasRight: boolean;\n  slots?: WorkspaceSlots;\n  state: WorkspaceLayoutState;\n  update: WorkspaceUpdate;\n};\n\nfunction WorkspaceTopRight({\n  hasLeft,\n  hasRight,\n  slots,\n  state,\n  update,\n}: WorkspaceTopRightProps) {\n  if (!hasLeft && !hasRight && !slots?.topRightActions) return null;\n  const toggleSide = (location: \"left\" | \"right\") =>\n    update((current) => ({\n      ...current,\n      sideCollapsed: {\n        ...current.sideCollapsed,\n        [location]: !current.sideCollapsed[location],\n      },\n    }));\n  return (\n    <div\n      data-testid=\"workspace-top-right\"\n      className=\"absolute right-1 top-1 z-30 flex h-7 items-center gap-1 rounded bg-muted/90 px-1 shadow-sm backdrop-blur\"\n    >\n      {slots?.topRightActions}\n      {hasLeft && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.left}\n          aria-label={`${state.sideCollapsed.left ? \"Expand\" : \"Collapse\"} left side`}\n          onClick={() => toggleSide(\"left\")}\n        >\n          <UiSidebar className=\"size-4\" />\n        </button>\n      )}\n      {hasRight && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.right}\n          aria-label={`${state.sideCollapsed.right ? \"Expand\" : \"Collapse\"} right side`}\n          onClick={() => toggleSide(\"right\")}\n        >\n          <UiSidebar className=\"size-4 -scale-x-100\" />\n        </button>\n      )}\n    </div>\n  );\n}\n\nexport function Workspace({\n  panes,\n  value,\n  defaultValue = {},\n  onValueChange,\n  storageKey,\n  slots,\n  collapsedSides,\n  className,\n}: WorkspaceProps) {\n  validateWorkspacePanes(panes);\n  if (value !== undefined && storageKey !== undefined) {\n    throw new Error(\"Workspace cannot combine value with storageKey\");\n  }\n  const [internal, setInternal] = useState(() =>\n    storageKey\n      ? readWorkspaceLayoutState(storageKey, panes, defaultValue)\n      : createWorkspaceLayoutState(panes, defaultValue),\n  );\n  const seenLocations = useRef(new Set(panes.map((pane) => pane.location)));\n  const seenPaneIds = useRef(new Set(panes.map((pane) => pane.id)));\n  const state = value ?? internal;\n  const groups = useMemo(\n    () => ({\n      left: panes.filter((pane) => pane.location === \"left\"),\n      center: panes.find(\n        (pane) => pane.location === \"center\",\n      ) as WorkspacePaneSpec,\n      right: panes.filter((pane) => pane.location === \"right\"),\n      bottom: panes.find((pane) => pane.location === \"bottom\"),\n    }),\n    [panes],\n  );\n\n  useLayoutEffect(() => {\n    const addedLocations = new Set(\n      panes\n        .map((pane) => pane.location)\n        .filter((location) => !seenLocations.current.has(location)),\n    );\n    const addedPanes = panes.filter(\n      (pane) => !seenPaneIds.current.has(pane.id),\n    );\n    panes.forEach((pane) => {\n      seenLocations.current.add(pane.location);\n      seenPaneIds.current.add(pane.id);\n    });\n    if (\n      value !== undefined ||\n      (addedLocations.size === 0 && addedPanes.length === 0)\n    )\n      return;\n    const defaults = createWorkspaceLayoutState(panes, defaultValue);\n    const addedStackHeights = addedPanes.reduce<Record<string, number>>(\n      (heights, pane) => {\n        if (pane.height !== undefined) heights[pane.id] = pane.height;\n        return heights;\n      },\n      {},\n    );\n    setInternal((current) => ({\n      ...current,\n      ...(addedLocations.has(\"left\") ? { leftWidth: defaults.leftWidth } : {}),\n      ...(addedLocations.has(\"right\")\n        ? { rightWidth: defaults.rightWidth }\n        : {}),\n      ...(addedLocations.has(\"bottom\")\n        ? { bottomHeight: defaults.bottomHeight }\n        : {}),\n      stackHeights: { ...current.stackHeights, ...addedStackHeights },\n      collapsed: {\n        ...current.collapsed,\n        ...Object.fromEntries(\n          addedPanes.map((pane) => [pane.id, pane.defaultCollapsed ?? false]),\n        ),\n      },\n    }));\n  }, [defaultValue, panes, value]);\n\n  const update = useCallback<WorkspaceUpdate>(\n    (change) => {\n      const next = change(state);\n      if (value === undefined) setInternal(next);\n      onValueChange?.(next);\n    },\n    [onValueChange, state, value],\n  );\n\n  useEffect(() => {\n    if (storageKey && value === undefined)\n      writeWorkspaceLayoutState(storageKey, internal);\n  }, [internal, storageKey, value]);\n\n  const held = (location: WorkspaceSideLocation) =>\n    collapsedSides?.includes(location) ?? false;\n  const shown: WorkspaceLayoutState = collapsedSides?.length\n    ? {\n        ...state,\n        sideCollapsed: {\n          left: held(\"left\") || state.sideCollapsed.left,\n          right: held(\"right\") || state.sideCollapsed.right,\n        },\n      }\n    : state;\n\n  return (\n    <div\n      className={cn(\n        \"relative grid min-h-0 w-full grid-cols-1 overflow-auto bg-background md:h-full md:grid-cols-[auto_minmax(0,1fr)_auto] md:grid-rows-[minmax(0,1fr)_auto] md:overflow-hidden\",\n        className,\n      )}\n    >\n      <WorkspaceTopRight\n        hasLeft={groups.left.length > 0 && !held(\"left\")}\n        hasRight={groups.right.length > 0 && !held(\"right\")}\n        {...(slots ? { slots } : {})}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"left\"\n        panes={groups.left}\n        state={shown}\n        update={update}\n      />\n      <WorkspaceSingleRegion\n        pane={groups.center}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"right\"\n        panes={groups.right}\n        state={shown}\n        update={update}\n      />\n      {groups.bottom && (\n        <WorkspaceSingleRegion\n          pane={groups.bottom}\n          state={state}\n          update={update}\n        />\n      )}\n    </div>\n  );\n}\n"],"names":["jsxs","jsx","UiSidebar","validateWorkspacePanes","useState","readWorkspaceLayoutState","createWorkspaceLayoutState","useRef","useMemo","useLayoutEffect","useCallback","useEffect","writeWorkspaceLayoutState","cn","WorkspaceSideRegion","WorkspaceSingleRegion"],"mappings":"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"}

package/dist/layout/Workspace.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { WorkspaceLayoutDefaults, WorkspaceLayoutState, WorkspacePaneSpec } from './Workspace.model.js';
+import { WorkspaceLayoutDefaults, WorkspaceLayoutState, WorkspacePaneSpec, WorkspaceSideLocation } from './Workspace.model.js';
 export type { WorkspaceLayoutDefaults, WorkspaceLayoutState, WorkspacePaneLocation, WorkspacePaneSlots, WorkspacePaneSpec, WorkspaceSideLocation, } from './Workspace.model.js';
 export type WorkspaceSlots = {
     topRightActions?: ReactNode;
@@ -11,7 +11,12 @@ export type WorkspaceProps = {
     onValueChange?: (value: WorkspaceLayoutState) => void;
     storageKey?: string;
     slots?: WorkspaceSlots;
+    /**
+     * Sides the host holds collapsed for now, such as while the center shows something that needs the
+     * full width: they render collapsed and lose their toggle, and the layout state keeps how they were.
+     */
+    collapsedSides?: WorkspaceSideLocation[];
     className?: string;
 };
-export declare function Workspace({ panes, value, defaultValue, onValueChange, storageKey, slots, className, }: WorkspaceProps): import("react").JSX.Element;
+export declare function Workspace({ panes, value, defaultValue, onValueChange, storageKey, slots, collapsedSides, className, }: WorkspaceProps): import("react").JSX.Element;
 //# sourceMappingURL=Workspace.d.ts.map

package/dist/layout/Workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../../src/layout/Workspace.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAO3B,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA0DF,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,KAAK,EACL,YAAiB,EACjB,aAAa,EACb,UAAU,EACV,KAAK,EACL,SAAS,GACV,EAAE,cAAc,+BA4HhB"}
+{"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../../src/layout/Workspace.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAO3B,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA0DF,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,KAAK,EACL,YAAiB,EACjB,aAAa,EACb,UAAU,EACV,KAAK,EACL,cAAc,EACd,SAAS,GACV,EAAE,cAAc,+BAwIhB"}

package/dist/layout/Workspace.js

@@ -59,6 +59,7 @@ function Workspace({
   onValueChange,
   storageKey,
   slots,
+  collapsedSides,
   className
 }) {
   validateWorkspacePanes(panes);
@@ -129,6 +130,14 @@ function Workspace({
     if (storageKey && value === void 0)
       writeWorkspaceLayoutState(storageKey, internal);
   }, [internal, storageKey, value]);
+  const held = (location) => (collapsedSides == null ? void 0 : collapsedSides.includes(location)) ?? false;
+  const shown = (collapsedSides == null ? void 0 : collapsedSides.length) ? {
+    ...state,
+    sideCollapsed: {
+      left: held("left") || state.sideCollapsed.left,
+      right: held("right") || state.sideCollapsed.right
+    }
+  } : state;
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -140,8 +149,8 @@ function Workspace({
         /* @__PURE__ */ jsx(
           WorkspaceTopRight,
           {
-            hasLeft: groups.left.length > 0,
-            hasRight: groups.right.length > 0,
+            hasLeft: groups.left.length > 0 && !held("left"),
+            hasRight: groups.right.length > 0 && !held("right"),
             ...slots ? { slots } : {},
             state,
             update
@@ -152,7 +161,7 @@ function Workspace({
           {
             location: "left",
             panes: groups.left,
-            state,
+            state: shown,
             update
           }
         ),
@@ -169,7 +178,7 @@ function Workspace({
           {
             location: "right",
             panes: groups.right,
-            state,
+            state: shown,
             update
           }
         ),

package/dist/layout/Workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"Workspace.js","sources":["../../src/layout/Workspace.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { UiSidebar } from \"../icons\";\nimport { cn } from \"../lib/utils\";\nimport {\n  createWorkspaceLayoutState,\n  readWorkspaceLayoutState,\n  validateWorkspacePanes,\n  writeWorkspaceLayoutState,\n  type WorkspaceLayoutDefaults,\n  type WorkspaceLayoutState,\n  type WorkspacePaneSpec,\n} from \"./Workspace.model\";\nimport {\n  WorkspaceSideRegion,\n  WorkspaceSingleRegion,\n  type WorkspaceUpdate,\n} from \"./Workspace.regions\";\n\nexport type {\n  WorkspaceLayoutDefaults,\n  WorkspaceLayoutState,\n  WorkspacePaneLocation,\n  WorkspacePaneSlots,\n  WorkspacePaneSpec,\n  WorkspaceSideLocation,\n} from \"./Workspace.model\";\n\nexport type WorkspaceSlots = {\n  topRightActions?: ReactNode;\n};\n\nexport type WorkspaceProps = {\n  panes: WorkspacePaneSpec[];\n  value?: WorkspaceLayoutState;\n  defaultValue?: WorkspaceLayoutDefaults;\n  onValueChange?: (value: WorkspaceLayoutState) => void;\n  storageKey?: string;\n  slots?: WorkspaceSlots;\n  className?: string;\n};\n\ntype WorkspaceTopRightProps = {\n  hasLeft: boolean;\n  hasRight: boolean;\n  slots?: WorkspaceSlots;\n  state: WorkspaceLayoutState;\n  update: WorkspaceUpdate;\n};\n\nfunction WorkspaceTopRight({\n  hasLeft,\n  hasRight,\n  slots,\n  state,\n  update,\n}: WorkspaceTopRightProps) {\n  if (!hasLeft && !hasRight && !slots?.topRightActions) return null;\n  const toggleSide = (location: \"left\" | \"right\") =>\n    update((current) => ({\n      ...current,\n      sideCollapsed: {\n        ...current.sideCollapsed,\n        [location]: !current.sideCollapsed[location],\n      },\n    }));\n  return (\n    <div\n      data-testid=\"workspace-top-right\"\n      className=\"absolute right-1 top-1 z-30 flex h-7 items-center gap-1 rounded bg-muted/90 px-1 shadow-sm backdrop-blur\"\n    >\n      {slots?.topRightActions}\n      {hasLeft && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.left}\n          aria-label={`${state.sideCollapsed.left ? \"Expand\" : \"Collapse\"} left side`}\n          onClick={() => toggleSide(\"left\")}\n        >\n          <UiSidebar className=\"size-4\" />\n        </button>\n      )}\n      {hasRight && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.right}\n          aria-label={`${state.sideCollapsed.right ? \"Expand\" : \"Collapse\"} right side`}\n          onClick={() => toggleSide(\"right\")}\n        >\n          <UiSidebar className=\"size-4 -scale-x-100\" />\n        </button>\n      )}\n    </div>\n  );\n}\n\nexport function Workspace({\n  panes,\n  value,\n  defaultValue = {},\n  onValueChange,\n  storageKey,\n  slots,\n  className,\n}: WorkspaceProps) {\n  validateWorkspacePanes(panes);\n  if (value !== undefined && storageKey !== undefined) {\n    throw new Error(\"Workspace cannot combine value with storageKey\");\n  }\n  const [internal, setInternal] = useState(() =>\n    storageKey\n      ? readWorkspaceLayoutState(storageKey, panes, defaultValue)\n      : createWorkspaceLayoutState(panes, defaultValue),\n  );\n  const seenLocations = useRef(new Set(panes.map((pane) => pane.location)));\n  const seenPaneIds = useRef(new Set(panes.map((pane) => pane.id)));\n  const state = value ?? internal;\n  const groups = useMemo(\n    () => ({\n      left: panes.filter((pane) => pane.location === \"left\"),\n      center: panes.find(\n        (pane) => pane.location === \"center\",\n      ) as WorkspacePaneSpec,\n      right: panes.filter((pane) => pane.location === \"right\"),\n      bottom: panes.find((pane) => pane.location === \"bottom\"),\n    }),\n    [panes],\n  );\n\n  useLayoutEffect(() => {\n    const addedLocations = new Set(\n      panes\n        .map((pane) => pane.location)\n        .filter((location) => !seenLocations.current.has(location)),\n    );\n    const addedPanes = panes.filter(\n      (pane) => !seenPaneIds.current.has(pane.id),\n    );\n    panes.forEach((pane) => {\n      seenLocations.current.add(pane.location);\n      seenPaneIds.current.add(pane.id);\n    });\n    if (\n      value !== undefined ||\n      (addedLocations.size === 0 && addedPanes.length === 0)\n    )\n      return;\n    const defaults = createWorkspaceLayoutState(panes, defaultValue);\n    const addedStackHeights = addedPanes.reduce<Record<string, number>>(\n      (heights, pane) => {\n        if (pane.height !== undefined) heights[pane.id] = pane.height;\n        return heights;\n      },\n      {},\n    );\n    setInternal((current) => ({\n      ...current,\n      ...(addedLocations.has(\"left\") ? { leftWidth: defaults.leftWidth } : {}),\n      ...(addedLocations.has(\"right\")\n        ? { rightWidth: defaults.rightWidth }\n        : {}),\n      ...(addedLocations.has(\"bottom\")\n        ? { bottomHeight: defaults.bottomHeight }\n        : {}),\n      stackHeights: { ...current.stackHeights, ...addedStackHeights },\n      collapsed: {\n        ...current.collapsed,\n        ...Object.fromEntries(\n          addedPanes.map((pane) => [pane.id, pane.defaultCollapsed ?? false]),\n        ),\n      },\n    }));\n  }, [defaultValue, panes, value]);\n\n  const update = useCallback<WorkspaceUpdate>(\n    (change) => {\n      const next = change(state);\n      if (value === undefined) setInternal(next);\n      onValueChange?.(next);\n    },\n    [onValueChange, state, value],\n  );\n\n  useEffect(() => {\n    if (storageKey && value === undefined)\n      writeWorkspaceLayoutState(storageKey, internal);\n  }, [internal, storageKey, value]);\n\n  return (\n    <div\n      className={cn(\n        \"relative grid min-h-0 w-full grid-cols-1 overflow-auto bg-background md:h-full md:grid-cols-[auto_minmax(0,1fr)_auto] md:grid-rows-[minmax(0,1fr)_auto] md:overflow-hidden\",\n        className,\n      )}\n    >\n      <WorkspaceTopRight\n        hasLeft={groups.left.length > 0}\n        hasRight={groups.right.length > 0}\n        {...(slots ? { slots } : {})}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"left\"\n        panes={groups.left}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSingleRegion\n        pane={groups.center}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"right\"\n        panes={groups.right}\n        state={state}\n        update={update}\n      />\n      {groups.bottom && (\n        <WorkspaceSingleRegion\n          pane={groups.bottom}\n          state={state}\n          update={update}\n        />\n      )}\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Workspace.js","sources":["../../src/layout/Workspace.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { UiSidebar } from \"../icons\";\nimport { cn } from \"../lib/utils\";\nimport {\n  createWorkspaceLayoutState,\n  readWorkspaceLayoutState,\n  validateWorkspacePanes,\n  writeWorkspaceLayoutState,\n  type WorkspaceLayoutDefaults,\n  type WorkspaceLayoutState,\n  type WorkspacePaneSpec,\n  type WorkspaceSideLocation,\n} from \"./Workspace.model\";\nimport {\n  WorkspaceSideRegion,\n  WorkspaceSingleRegion,\n  type WorkspaceUpdate,\n} from \"./Workspace.regions\";\n\nexport type {\n  WorkspaceLayoutDefaults,\n  WorkspaceLayoutState,\n  WorkspacePaneLocation,\n  WorkspacePaneSlots,\n  WorkspacePaneSpec,\n  WorkspaceSideLocation,\n} from \"./Workspace.model\";\n\nexport type WorkspaceSlots = {\n  topRightActions?: ReactNode;\n};\n\nexport type WorkspaceProps = {\n  panes: WorkspacePaneSpec[];\n  value?: WorkspaceLayoutState;\n  defaultValue?: WorkspaceLayoutDefaults;\n  onValueChange?: (value: WorkspaceLayoutState) => void;\n  storageKey?: string;\n  slots?: WorkspaceSlots;\n  /**\n   * Sides the host holds collapsed for now, such as while the center shows something that needs the\n   * full width: they render collapsed and lose their toggle, and the layout state keeps how they were.\n   */\n  collapsedSides?: WorkspaceSideLocation[];\n  className?: string;\n};\n\ntype WorkspaceTopRightProps = {\n  hasLeft: boolean;\n  hasRight: boolean;\n  slots?: WorkspaceSlots;\n  state: WorkspaceLayoutState;\n  update: WorkspaceUpdate;\n};\n\nfunction WorkspaceTopRight({\n  hasLeft,\n  hasRight,\n  slots,\n  state,\n  update,\n}: WorkspaceTopRightProps) {\n  if (!hasLeft && !hasRight && !slots?.topRightActions) return null;\n  const toggleSide = (location: \"left\" | \"right\") =>\n    update((current) => ({\n      ...current,\n      sideCollapsed: {\n        ...current.sideCollapsed,\n        [location]: !current.sideCollapsed[location],\n      },\n    }));\n  return (\n    <div\n      data-testid=\"workspace-top-right\"\n      className=\"absolute right-1 top-1 z-30 flex h-7 items-center gap-1 rounded bg-muted/90 px-1 shadow-sm backdrop-blur\"\n    >\n      {slots?.topRightActions}\n      {hasLeft && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.left}\n          aria-label={`${state.sideCollapsed.left ? \"Expand\" : \"Collapse\"} left side`}\n          onClick={() => toggleSide(\"left\")}\n        >\n          <UiSidebar className=\"size-4\" />\n        </button>\n      )}\n      {hasRight && (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-6 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n          aria-expanded={!state.sideCollapsed.right}\n          aria-label={`${state.sideCollapsed.right ? \"Expand\" : \"Collapse\"} right side`}\n          onClick={() => toggleSide(\"right\")}\n        >\n          <UiSidebar className=\"size-4 -scale-x-100\" />\n        </button>\n      )}\n    </div>\n  );\n}\n\nexport function Workspace({\n  panes,\n  value,\n  defaultValue = {},\n  onValueChange,\n  storageKey,\n  slots,\n  collapsedSides,\n  className,\n}: WorkspaceProps) {\n  validateWorkspacePanes(panes);\n  if (value !== undefined && storageKey !== undefined) {\n    throw new Error(\"Workspace cannot combine value with storageKey\");\n  }\n  const [internal, setInternal] = useState(() =>\n    storageKey\n      ? readWorkspaceLayoutState(storageKey, panes, defaultValue)\n      : createWorkspaceLayoutState(panes, defaultValue),\n  );\n  const seenLocations = useRef(new Set(panes.map((pane) => pane.location)));\n  const seenPaneIds = useRef(new Set(panes.map((pane) => pane.id)));\n  const state = value ?? internal;\n  const groups = useMemo(\n    () => ({\n      left: panes.filter((pane) => pane.location === \"left\"),\n      center: panes.find(\n        (pane) => pane.location === \"center\",\n      ) as WorkspacePaneSpec,\n      right: panes.filter((pane) => pane.location === \"right\"),\n      bottom: panes.find((pane) => pane.location === \"bottom\"),\n    }),\n    [panes],\n  );\n\n  useLayoutEffect(() => {\n    const addedLocations = new Set(\n      panes\n        .map((pane) => pane.location)\n        .filter((location) => !seenLocations.current.has(location)),\n    );\n    const addedPanes = panes.filter(\n      (pane) => !seenPaneIds.current.has(pane.id),\n    );\n    panes.forEach((pane) => {\n      seenLocations.current.add(pane.location);\n      seenPaneIds.current.add(pane.id);\n    });\n    if (\n      value !== undefined ||\n      (addedLocations.size === 0 && addedPanes.length === 0)\n    )\n      return;\n    const defaults = createWorkspaceLayoutState(panes, defaultValue);\n    const addedStackHeights = addedPanes.reduce<Record<string, number>>(\n      (heights, pane) => {\n        if (pane.height !== undefined) heights[pane.id] = pane.height;\n        return heights;\n      },\n      {},\n    );\n    setInternal((current) => ({\n      ...current,\n      ...(addedLocations.has(\"left\") ? { leftWidth: defaults.leftWidth } : {}),\n      ...(addedLocations.has(\"right\")\n        ? { rightWidth: defaults.rightWidth }\n        : {}),\n      ...(addedLocations.has(\"bottom\")\n        ? { bottomHeight: defaults.bottomHeight }\n        : {}),\n      stackHeights: { ...current.stackHeights, ...addedStackHeights },\n      collapsed: {\n        ...current.collapsed,\n        ...Object.fromEntries(\n          addedPanes.map((pane) => [pane.id, pane.defaultCollapsed ?? false]),\n        ),\n      },\n    }));\n  }, [defaultValue, panes, value]);\n\n  const update = useCallback<WorkspaceUpdate>(\n    (change) => {\n      const next = change(state);\n      if (value === undefined) setInternal(next);\n      onValueChange?.(next);\n    },\n    [onValueChange, state, value],\n  );\n\n  useEffect(() => {\n    if (storageKey && value === undefined)\n      writeWorkspaceLayoutState(storageKey, internal);\n  }, [internal, storageKey, value]);\n\n  const held = (location: WorkspaceSideLocation) =>\n    collapsedSides?.includes(location) ?? false;\n  const shown: WorkspaceLayoutState = collapsedSides?.length\n    ? {\n        ...state,\n        sideCollapsed: {\n          left: held(\"left\") || state.sideCollapsed.left,\n          right: held(\"right\") || state.sideCollapsed.right,\n        },\n      }\n    : state;\n\n  return (\n    <div\n      className={cn(\n        \"relative grid min-h-0 w-full grid-cols-1 overflow-auto bg-background md:h-full md:grid-cols-[auto_minmax(0,1fr)_auto] md:grid-rows-[minmax(0,1fr)_auto] md:overflow-hidden\",\n        className,\n      )}\n    >\n      <WorkspaceTopRight\n        hasLeft={groups.left.length > 0 && !held(\"left\")}\n        hasRight={groups.right.length > 0 && !held(\"right\")}\n        {...(slots ? { slots } : {})}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"left\"\n        panes={groups.left}\n        state={shown}\n        update={update}\n      />\n      <WorkspaceSingleRegion\n        pane={groups.center}\n        state={state}\n        update={update}\n      />\n      <WorkspaceSideRegion\n        location=\"right\"\n        panes={groups.right}\n        state={shown}\n        update={update}\n      />\n      {groups.bottom && (\n        <WorkspaceSingleRegion\n          pane={groups.bottom}\n          state={state}\n          update={update}\n        />\n      )}\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/lib/permission-strategies.cjs

@@ -41,18 +41,77 @@ const STRATEGY_PRESETS = [
   }
 ];
 const MATCH_FIELD_OPTIONS = [
-  { value: "name", label: "Tool name" },
-  { value: "group", label: "Group" },
-  { value: "parent", label: "Parent" },
-  { value: "entity", label: "Entity" },
-  { value: "action", label: "Action" },
-  { value: "verb", label: "Verb" },
-  { value: "method", label: "HTTP method" },
-  { value: "scope", label: "Scope" },
-  { value: "readOnly", label: "Read only" },
-  { value: "destructive", label: "Destructive" },
-  { value: "idempotent", label: "Idempotent" }
+  {
+    value: "name",
+    label: "Tool name",
+    description: "The operation's unique id, e.g. todo_create."
+  },
+  {
+    value: "group",
+    label: "Group",
+    description: "The permission category a tool is filed under."
+  },
+  {
+    value: "parent",
+    label: "Parent",
+    description: "The surface a tool belongs to, e.g. Contacts."
+  },
+  {
+    value: "entity",
+    label: "Entity",
+    description: "The resource type the operation acts on."
+  },
+  {
+    value: "action",
+    label: "Action",
+    description: "The operation's action name within its entity."
+  },
+  {
+    value: "verb",
+    label: "Verb",
+    description: "What the operation does: get, list, create, delete…"
+  },
+  {
+    value: "method",
+    label: "HTTP method",
+    description: "GET, POST, PATCH or DELETE for HTTP-backed tools."
+  },
+  {
+    value: "scope",
+    label: "Scope",
+    description: "Whether it acts on one item or a whole collection."
+  },
+  {
+    value: "readOnly",
+    label: "Read only",
+    description: "Tools that declare they never change anything."
+  },
+  {
+    value: "destructive",
+    label: "Destructive",
+    description: "Tools that declare they may delete or overwrite data."
+  },
+  {
+    value: "idempotent",
+    label: "Idempotent",
+    description: "Tools that declare repeating a call is safe."
+  }
 ];
+function strategySummary(rule) {
+  const preset = strategyPreset(rule);
+  if (preset !== "custom") {
+    return STRATEGY_PRESETS.find((option) => option.value === preset).label;
+  }
+  return activeMatchFields(rule).map((field) => {
+    var _a;
+    const label = ((_a = MATCH_FIELD_OPTIONS.find((option) => option.value === field)) == null ? void 0 : _a.label) ?? field;
+    if (isHintField(field)) {
+      return `${label} is ${rule[field] ? "Yes" : "No"}`;
+    }
+    const values = patternValues(rule[field]);
+    return `${label} ${values.length > 1 ? "in" : "is"} ${values.join(", ")}`;
+  }).join(" · ");
+}
 function strategyPreset(rule) {
   const fields = activeMatchFields(rule);
   if (fields.length !== 1) return "custom";
@@ -149,6 +208,7 @@ exports.patternsText = patternsText;
 exports.removeCondition = removeCondition;
 exports.replaceMatchField = replaceMatchField;
 exports.strategyPreset = strategyPreset;
+exports.strategySummary = strategySummary;
 exports.toolFieldSuggestions = toolFieldSuggestions;
 exports.updateCondition = updateCondition;
 exports.updatePatternCondition = updatePatternCondition;

package/dist/lib/permission-strategies.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"permission-strategies.cjs","sources":["../../src/lib/permission-strategies.ts"],"sourcesContent":["import {\n  matchesTool,\n  type MatchPatterns,\n  type PermissionRule,\n} from \"../data/chat/tool-policy\";\nimport type { ToolMeta } from \"../data/chat/types\";\n\nexport const PATTERN_FIELDS = [\n  \"name\",\n  \"group\",\n  \"parent\",\n  \"entity\",\n  \"action\",\n  \"verb\",\n  \"method\",\n  \"scope\",\n] as const;\nexport const HINT_FIELDS = [\"readOnly\", \"destructive\", \"idempotent\"] as const;\nexport const MATCH_FIELDS = [...PATTERN_FIELDS, ...HINT_FIELDS] as const;\n\nexport type MatchField = (typeof MATCH_FIELDS)[number];\nexport type StrategyPreset =\n  | \"all\"\n  | \"read-only\"\n  | \"destructive\"\n  | \"idempotent\"\n  | \"custom\";\n\nexport const STRATEGY_PRESETS: Array<{\n  value: StrategyPreset;\n  label: string;\n  description: string;\n}> = [\n  {\n    value: \"all\",\n    label: \"All tools\",\n    description: \"Match every tool in the catalog.\",\n  },\n  {\n    value: \"read-only\",\n    label: \"Read-only tools\",\n    description: \"Match tools explicitly marked read-only.\",\n  },\n  {\n    value: \"destructive\",\n    label: \"Destructive tools\",\n    description: \"Match tools explicitly marked destructive.\",\n  },\n  {\n    value: \"idempotent\",\n    label: \"Idempotent tools\",\n    description: \"Match tools safe to repeat.\",\n  },\n  {\n    value: \"custom\",\n    label: \"Custom conditions\",\n    description: \"Combine tool metadata and safety annotations.\",\n  },\n];\n\nexport const MATCH_FIELD_OPTIONS: Array<{ value: MatchField; label: string }> =\n  [\n    { value: \"name\", label: \"Tool name\" },\n    { value: \"group\", label: \"Group\" },\n    { value: \"parent\", label: \"Parent\" },\n    { value: \"entity\", label: \"Entity\" },\n    { value: \"action\", label: \"Action\" },\n    { value: \"verb\", label: \"Verb\" },\n    { value: \"method\", label: \"HTTP method\" },\n    { value: \"scope\", label: \"Scope\" },\n    { value: \"readOnly\", label: \"Read only\" },\n    { value: \"destructive\", label: \"Destructive\" },\n    { value: \"idempotent\", label: \"Idempotent\" },\n  ];\n\nexport function strategyPreset(rule: PermissionRule): StrategyPreset {\n  const fields = activeMatchFields(rule);\n  if (fields.length !== 1) return \"custom\";\n  if (fields[0] === \"name\" && patternsText(rule.name) === \"*\") return \"all\";\n  if (fields[0] === \"readOnly\" && rule.readOnly === true) return \"read-only\";\n  if (fields[0] === \"destructive\" && rule.destructive === true) {\n    return \"destructive\";\n  }\n  if (fields[0] === \"idempotent\" && rule.idempotent === true) {\n    return \"idempotent\";\n  }\n  return \"custom\";\n}\n\nexport function applyStrategyPreset(\n  rule: PermissionRule,\n  preset: Exclude<StrategyPreset, \"custom\">,\n): PermissionRule {\n  if (preset === \"all\") return { name: \"*\", policy: rule.policy };\n  if (preset === \"read-only\") return { readOnly: true, policy: rule.policy };\n  if (preset === \"destructive\")\n    return { destructive: true, policy: rule.policy };\n  return { idempotent: true, policy: rule.policy };\n}\n\nexport function activeMatchFields(rule: PermissionRule): MatchField[] {\n  return MATCH_FIELDS.filter((field) => rule[field] !== undefined);\n}\n\nexport function patternsText(value: MatchPatterns | undefined): string {\n  return typeof value === \"string\" ? value : (value ?? []).join(\", \");\n}\n\nexport function patternValues(value: MatchPatterns | undefined): string[] {\n  return typeof value === \"string\" ? (value ? [value] : []) : (value ?? []);\n}\n\nexport function updatePatternCondition({\n  rule,\n  field,\n  value,\n}: {\n  rule: PermissionRule;\n  field: (typeof PATTERN_FIELDS)[number];\n  value: MatchPatterns;\n}): PermissionRule {\n  return { ...rule, [field]: value };\n}\n\nexport function conditionText(rule: PermissionRule, field: MatchField): string {\n  if (isHintField(field)) return String(rule[field]);\n  return patternsText(rule[field]);\n}\n\nexport function replaceMatchField(\n  rule: PermissionRule,\n  current: MatchField,\n  next: MatchField,\n): PermissionRule {\n  if (current === next) return rule;\n  const match = { ...rule } as Record<string, unknown>;\n  const previous = match[current];\n  delete match[current];\n  match[next] = isHintField(next)\n    ? typeof previous === \"boolean\"\n      ? previous\n      : true\n    : typeof previous === \"string\" || Array.isArray(previous)\n      ? previous\n      : \"*\";\n  return match as PermissionRule;\n}\n\nexport function updateCondition(\n  rule: PermissionRule,\n  field: MatchField,\n  value: string,\n): PermissionRule {\n  if (isHintField(field)) return { ...rule, [field]: value === \"true\" };\n  const patterns = value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return {\n    ...rule,\n    [field]: patterns.length <= 1 ? (patterns[0] ?? \"\") : patterns,\n  };\n}\n\nexport function removeCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  const next = { ...rule } as Record<string, unknown>;\n  delete next[field];\n  if (activeMatchFields(next as PermissionRule).length === 0) next.name = \"*\";\n  return next as PermissionRule;\n}\n\nexport function addCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  if (rule[field] !== undefined) return rule;\n  return { ...rule, [field]: isHintField(field) ? true : \"*\" };\n}\n\nexport function isHintField(\n  field: MatchField,\n): field is (typeof HINT_FIELDS)[number] {\n  return (HINT_FIELDS as readonly MatchField[]).includes(field);\n}\n\nexport function matchingTools(rule: PermissionRule, tools: ToolMeta[]) {\n  return tools.filter((tool) => matchesTool(rule, tool));\n}\n\nexport function toolFieldSuggestions(\n  tools: ToolMeta[],\n  field: Exclude<MatchField, (typeof HINT_FIELDS)[number]>,\n) {\n  const values = new Set<string>();\n  for (const tool of tools) {\n    const value = tool[field === \"name\" ? \"name\" : field];\n    if (typeof value === \"string\" && value.trim()) values.add(value);\n  }\n  return Array.from(values).sort((left, right) => left.localeCompare(right));\n}\n"],"names":["matchesTool"],"mappings":"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"}
+{"version":3,"file":"permission-strategies.cjs","sources":["../../src/lib/permission-strategies.ts"],"sourcesContent":["import {\n  matchesTool,\n  type MatchPatterns,\n  type PermissionRule,\n} from \"../data/chat/tool-policy\";\nimport type { ToolMeta } from \"../data/chat/types\";\n\nexport const PATTERN_FIELDS = [\n  \"name\",\n  \"group\",\n  \"parent\",\n  \"entity\",\n  \"action\",\n  \"verb\",\n  \"method\",\n  \"scope\",\n] as const;\nexport const HINT_FIELDS = [\"readOnly\", \"destructive\", \"idempotent\"] as const;\nexport const MATCH_FIELDS = [...PATTERN_FIELDS, ...HINT_FIELDS] as const;\n\nexport type MatchField = (typeof MATCH_FIELDS)[number];\nexport type StrategyPreset =\n  | \"all\"\n  | \"read-only\"\n  | \"destructive\"\n  | \"idempotent\"\n  | \"custom\";\n\nexport const STRATEGY_PRESETS: Array<{\n  value: StrategyPreset;\n  label: string;\n  description: string;\n}> = [\n  {\n    value: \"all\",\n    label: \"All tools\",\n    description: \"Match every tool in the catalog.\",\n  },\n  {\n    value: \"read-only\",\n    label: \"Read-only tools\",\n    description: \"Match tools explicitly marked read-only.\",\n  },\n  {\n    value: \"destructive\",\n    label: \"Destructive tools\",\n    description: \"Match tools explicitly marked destructive.\",\n  },\n  {\n    value: \"idempotent\",\n    label: \"Idempotent tools\",\n    description: \"Match tools safe to repeat.\",\n  },\n  {\n    value: \"custom\",\n    label: \"Custom conditions\",\n    description: \"Combine tool metadata and safety annotations.\",\n  },\n];\n\nexport const MATCH_FIELD_OPTIONS: Array<{\n  value: MatchField;\n  label: string;\n  description: string;\n}> = [\n  {\n    value: \"name\",\n    label: \"Tool name\",\n    description: \"The operation's unique id, e.g. todo_create.\",\n  },\n  {\n    value: \"group\",\n    label: \"Group\",\n    description: \"The permission category a tool is filed under.\",\n  },\n  {\n    value: \"parent\",\n    label: \"Parent\",\n    description: \"The surface a tool belongs to, e.g. Contacts.\",\n  },\n  {\n    value: \"entity\",\n    label: \"Entity\",\n    description: \"The resource type the operation acts on.\",\n  },\n  {\n    value: \"action\",\n    label: \"Action\",\n    description: \"The operation's action name within its entity.\",\n  },\n  {\n    value: \"verb\",\n    label: \"Verb\",\n    description: \"What the operation does: get, list, create, delete…\",\n  },\n  {\n    value: \"method\",\n    label: \"HTTP method\",\n    description: \"GET, POST, PATCH or DELETE for HTTP-backed tools.\",\n  },\n  {\n    value: \"scope\",\n    label: \"Scope\",\n    description: \"Whether it acts on one item or a whole collection.\",\n  },\n  {\n    value: \"readOnly\",\n    label: \"Read only\",\n    description: \"Tools that declare they never change anything.\",\n  },\n  {\n    value: \"destructive\",\n    label: \"Destructive\",\n    description: \"Tools that declare they may delete or overwrite data.\",\n  },\n  {\n    value: \"idempotent\",\n    label: \"Idempotent\",\n    description: \"Tools that declare repeating a call is safe.\",\n  },\n];\n\n/** A strategy's actual match, e.g. \"Tool name in a, b · Destructive is No\". */\nexport function strategySummary(rule: PermissionRule): string {\n  const preset = strategyPreset(rule);\n  if (preset !== \"custom\") {\n    return STRATEGY_PRESETS.find((option) => option.value === preset)!.label;\n  }\n  return activeMatchFields(rule)\n    .map((field) => {\n      const label =\n        MATCH_FIELD_OPTIONS.find((option) => option.value === field)?.label ??\n        field;\n      if (isHintField(field)) {\n        return `${label} is ${rule[field] ? \"Yes\" : \"No\"}`;\n      }\n      const values = patternValues(rule[field]);\n      return `${label} ${values.length > 1 ? \"in\" : \"is\"} ${values.join(\", \")}`;\n    })\n    .join(\" · \");\n}\n\nexport function strategyPreset(rule: PermissionRule): StrategyPreset {\n  const fields = activeMatchFields(rule);\n  if (fields.length !== 1) return \"custom\";\n  if (fields[0] === \"name\" && patternsText(rule.name) === \"*\") return \"all\";\n  if (fields[0] === \"readOnly\" && rule.readOnly === true) return \"read-only\";\n  if (fields[0] === \"destructive\" && rule.destructive === true) {\n    return \"destructive\";\n  }\n  if (fields[0] === \"idempotent\" && rule.idempotent === true) {\n    return \"idempotent\";\n  }\n  return \"custom\";\n}\n\nexport function applyStrategyPreset(\n  rule: PermissionRule,\n  preset: Exclude<StrategyPreset, \"custom\">,\n): PermissionRule {\n  if (preset === \"all\") return { name: \"*\", policy: rule.policy };\n  if (preset === \"read-only\") return { readOnly: true, policy: rule.policy };\n  if (preset === \"destructive\")\n    return { destructive: true, policy: rule.policy };\n  return { idempotent: true, policy: rule.policy };\n}\n\nexport function activeMatchFields(rule: PermissionRule): MatchField[] {\n  return MATCH_FIELDS.filter((field) => rule[field] !== undefined);\n}\n\nexport function patternsText(value: MatchPatterns | undefined): string {\n  return typeof value === \"string\" ? value : (value ?? []).join(\", \");\n}\n\nexport function patternValues(value: MatchPatterns | undefined): string[] {\n  return typeof value === \"string\" ? (value ? [value] : []) : (value ?? []);\n}\n\nexport function updatePatternCondition({\n  rule,\n  field,\n  value,\n}: {\n  rule: PermissionRule;\n  field: (typeof PATTERN_FIELDS)[number];\n  value: MatchPatterns;\n}): PermissionRule {\n  return { ...rule, [field]: value };\n}\n\nexport function conditionText(rule: PermissionRule, field: MatchField): string {\n  if (isHintField(field)) return String(rule[field]);\n  return patternsText(rule[field]);\n}\n\nexport function replaceMatchField(\n  rule: PermissionRule,\n  current: MatchField,\n  next: MatchField,\n): PermissionRule {\n  if (current === next) return rule;\n  const match = { ...rule } as Record<string, unknown>;\n  const previous = match[current];\n  delete match[current];\n  match[next] = isHintField(next)\n    ? typeof previous === \"boolean\"\n      ? previous\n      : true\n    : typeof previous === \"string\" || Array.isArray(previous)\n      ? previous\n      : \"*\";\n  return match as PermissionRule;\n}\n\nexport function updateCondition(\n  rule: PermissionRule,\n  field: MatchField,\n  value: string,\n): PermissionRule {\n  if (isHintField(field)) return { ...rule, [field]: value === \"true\" };\n  const patterns = value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return {\n    ...rule,\n    [field]: patterns.length <= 1 ? (patterns[0] ?? \"\") : patterns,\n  };\n}\n\nexport function removeCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  const next = { ...rule } as Record<string, unknown>;\n  delete next[field];\n  if (activeMatchFields(next as PermissionRule).length === 0) next.name = \"*\";\n  return next as PermissionRule;\n}\n\nexport function addCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  if (rule[field] !== undefined) return rule;\n  return { ...rule, [field]: isHintField(field) ? true : \"*\" };\n}\n\nexport function isHintField(\n  field: MatchField,\n): field is (typeof HINT_FIELDS)[number] {\n  return (HINT_FIELDS as readonly MatchField[]).includes(field);\n}\n\nexport function matchingTools(rule: PermissionRule, tools: ToolMeta[]) {\n  return tools.filter((tool) => matchesTool(rule, tool));\n}\n\nexport function toolFieldSuggestions(\n  tools: ToolMeta[],\n  field: Exclude<MatchField, (typeof HINT_FIELDS)[number]>,\n) {\n  const values = new Set<string>();\n  for (const tool of tools) {\n    const value = tool[field === \"name\" ? \"name\" : field];\n    if (typeof value === \"string\" && value.trim()) values.add(value);\n  }\n  return Array.from(values).sort((left, right) => left.localeCompare(right));\n}\n"],"names":["matchesTool"],"mappings":"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"}

package/dist/lib/permission-strategies.d.ts

@@ -13,7 +13,10 @@ export declare const STRATEGY_PRESETS: Array<{
 export declare const MATCH_FIELD_OPTIONS: Array<{
     value: MatchField;
     label: string;
+    description: string;
 }>;
+/** A strategy's actual match, e.g. "Tool name in a, b · Destructive is No". */
+export declare function strategySummary(rule: PermissionRule): string;
 export declare function strategyPreset(rule: PermissionRule): StrategyPreset;
 export declare function applyStrategyPreset(rule: PermissionRule, preset: Exclude<StrategyPreset, "custom">): PermissionRule;
 export declare function activeMatchFields(rule: PermissionRule): MatchField[];

package/dist/lib/permission-strategies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permission-strategies.d.ts","sourceRoot":"","sources":["../../src/lib/permission-strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,cAAc,qFASjB,CAAC;AACX,eAAO,MAAM,WAAW,oDAAqD,CAAC;AAC9E,eAAO,MAAM,YAAY,8HAA+C,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,WAAW,GACX,aAAa,GACb,YAAY,GACZ,QAAQ,CAAC;AAEb,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CA0BA,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAazE,CAAC;AAEJ,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAYnE;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,GACxC,cAAc,CAMhB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAEpE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAErE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,EAAE,CAExE;AAED,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,KAAK,EACL,KAAK,GACN,EAAE;IACD,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,cAAc,CAEjB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAG7E;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,UAAU,GACf,cAAc,CAahB;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,GACZ,cAAc,CAUhB;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,cAAc,CAKhB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,cAAc,CAGhB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,GAChB,KAAK,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAEvC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,cAEpE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,YAQzD"}
+{"version":3,"file":"permission-strategies.d.ts","sourceRoot":"","sources":["../../src/lib/permission-strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,cAAc,qFASjB,CAAC;AACX,eAAO,MAAM,WAAW,oDAAqD,CAAC;AAC9E,eAAO,MAAM,YAAY,8HAA+C,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,WAAW,GACX,aAAa,GACb,YAAY,GACZ,QAAQ,CAAC;AAEb,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CA0BA,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAwDA,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAiB5D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAYnE;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,GACxC,cAAc,CAMhB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAEpE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAErE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,EAAE,CAExE;AAED,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,KAAK,EACL,KAAK,GACN,EAAE;IACD,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,cAAc,CAEjB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAG7E;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,UAAU,GACf,cAAc,CAahB;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,GACZ,cAAc,CAUhB;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,cAAc,CAKhB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,GAChB,cAAc,CAGhB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,GAChB,KAAK,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAEvC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,cAEpE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,YAQzD"}

package/dist/lib/permission-strategies.js

@@ -39,18 +39,77 @@ const STRATEGY_PRESETS = [
   }
 ];
 const MATCH_FIELD_OPTIONS = [
-  { value: "name", label: "Tool name" },
-  { value: "group", label: "Group" },
-  { value: "parent", label: "Parent" },
-  { value: "entity", label: "Entity" },
-  { value: "action", label: "Action" },
-  { value: "verb", label: "Verb" },
-  { value: "method", label: "HTTP method" },
-  { value: "scope", label: "Scope" },
-  { value: "readOnly", label: "Read only" },
-  { value: "destructive", label: "Destructive" },
-  { value: "idempotent", label: "Idempotent" }
+  {
+    value: "name",
+    label: "Tool name",
+    description: "The operation's unique id, e.g. todo_create."
+  },
+  {
+    value: "group",
+    label: "Group",
+    description: "The permission category a tool is filed under."
+  },
+  {
+    value: "parent",
+    label: "Parent",
+    description: "The surface a tool belongs to, e.g. Contacts."
+  },
+  {
+    value: "entity",
+    label: "Entity",
+    description: "The resource type the operation acts on."
+  },
+  {
+    value: "action",
+    label: "Action",
+    description: "The operation's action name within its entity."
+  },
+  {
+    value: "verb",
+    label: "Verb",
+    description: "What the operation does: get, list, create, delete…"
+  },
+  {
+    value: "method",
+    label: "HTTP method",
+    description: "GET, POST, PATCH or DELETE for HTTP-backed tools."
+  },
+  {
+    value: "scope",
+    label: "Scope",
+    description: "Whether it acts on one item or a whole collection."
+  },
+  {
+    value: "readOnly",
+    label: "Read only",
+    description: "Tools that declare they never change anything."
+  },
+  {
+    value: "destructive",
+    label: "Destructive",
+    description: "Tools that declare they may delete or overwrite data."
+  },
+  {
+    value: "idempotent",
+    label: "Idempotent",
+    description: "Tools that declare repeating a call is safe."
+  }
 ];
+function strategySummary(rule) {
+  const preset = strategyPreset(rule);
+  if (preset !== "custom") {
+    return STRATEGY_PRESETS.find((option) => option.value === preset).label;
+  }
+  return activeMatchFields(rule).map((field) => {
+    var _a;
+    const label = ((_a = MATCH_FIELD_OPTIONS.find((option) => option.value === field)) == null ? void 0 : _a.label) ?? field;
+    if (isHintField(field)) {
+      return `${label} is ${rule[field] ? "Yes" : "No"}`;
+    }
+    const values = patternValues(rule[field]);
+    return `${label} ${values.length > 1 ? "in" : "is"} ${values.join(", ")}`;
+  }).join(" · ");
+}
 function strategyPreset(rule) {
   const fields = activeMatchFields(rule);
   if (fields.length !== 1) return "custom";
@@ -148,6 +207,7 @@ export {
   removeCondition,
   replaceMatchField,
   strategyPreset,
+  strategySummary,
   toolFieldSuggestions,
   updateCondition,
   updatePatternCondition

package/dist/lib/permission-strategies.js.map

@@ -1 +1 @@
-{"version":3,"file":"permission-strategies.js","sources":["../../src/lib/permission-strategies.ts"],"sourcesContent":["import {\n  matchesTool,\n  type MatchPatterns,\n  type PermissionRule,\n} from \"../data/chat/tool-policy\";\nimport type { ToolMeta } from \"../data/chat/types\";\n\nexport const PATTERN_FIELDS = [\n  \"name\",\n  \"group\",\n  \"parent\",\n  \"entity\",\n  \"action\",\n  \"verb\",\n  \"method\",\n  \"scope\",\n] as const;\nexport const HINT_FIELDS = [\"readOnly\", \"destructive\", \"idempotent\"] as const;\nexport const MATCH_FIELDS = [...PATTERN_FIELDS, ...HINT_FIELDS] as const;\n\nexport type MatchField = (typeof MATCH_FIELDS)[number];\nexport type StrategyPreset =\n  | \"all\"\n  | \"read-only\"\n  | \"destructive\"\n  | \"idempotent\"\n  | \"custom\";\n\nexport const STRATEGY_PRESETS: Array<{\n  value: StrategyPreset;\n  label: string;\n  description: string;\n}> = [\n  {\n    value: \"all\",\n    label: \"All tools\",\n    description: \"Match every tool in the catalog.\",\n  },\n  {\n    value: \"read-only\",\n    label: \"Read-only tools\",\n    description: \"Match tools explicitly marked read-only.\",\n  },\n  {\n    value: \"destructive\",\n    label: \"Destructive tools\",\n    description: \"Match tools explicitly marked destructive.\",\n  },\n  {\n    value: \"idempotent\",\n    label: \"Idempotent tools\",\n    description: \"Match tools safe to repeat.\",\n  },\n  {\n    value: \"custom\",\n    label: \"Custom conditions\",\n    description: \"Combine tool metadata and safety annotations.\",\n  },\n];\n\nexport const MATCH_FIELD_OPTIONS: Array<{ value: MatchField; label: string }> =\n  [\n    { value: \"name\", label: \"Tool name\" },\n    { value: \"group\", label: \"Group\" },\n    { value: \"parent\", label: \"Parent\" },\n    { value: \"entity\", label: \"Entity\" },\n    { value: \"action\", label: \"Action\" },\n    { value: \"verb\", label: \"Verb\" },\n    { value: \"method\", label: \"HTTP method\" },\n    { value: \"scope\", label: \"Scope\" },\n    { value: \"readOnly\", label: \"Read only\" },\n    { value: \"destructive\", label: \"Destructive\" },\n    { value: \"idempotent\", label: \"Idempotent\" },\n  ];\n\nexport function strategyPreset(rule: PermissionRule): StrategyPreset {\n  const fields = activeMatchFields(rule);\n  if (fields.length !== 1) return \"custom\";\n  if (fields[0] === \"name\" && patternsText(rule.name) === \"*\") return \"all\";\n  if (fields[0] === \"readOnly\" && rule.readOnly === true) return \"read-only\";\n  if (fields[0] === \"destructive\" && rule.destructive === true) {\n    return \"destructive\";\n  }\n  if (fields[0] === \"idempotent\" && rule.idempotent === true) {\n    return \"idempotent\";\n  }\n  return \"custom\";\n}\n\nexport function applyStrategyPreset(\n  rule: PermissionRule,\n  preset: Exclude<StrategyPreset, \"custom\">,\n): PermissionRule {\n  if (preset === \"all\") return { name: \"*\", policy: rule.policy };\n  if (preset === \"read-only\") return { readOnly: true, policy: rule.policy };\n  if (preset === \"destructive\")\n    return { destructive: true, policy: rule.policy };\n  return { idempotent: true, policy: rule.policy };\n}\n\nexport function activeMatchFields(rule: PermissionRule): MatchField[] {\n  return MATCH_FIELDS.filter((field) => rule[field] !== undefined);\n}\n\nexport function patternsText(value: MatchPatterns | undefined): string {\n  return typeof value === \"string\" ? value : (value ?? []).join(\", \");\n}\n\nexport function patternValues(value: MatchPatterns | undefined): string[] {\n  return typeof value === \"string\" ? (value ? [value] : []) : (value ?? []);\n}\n\nexport function updatePatternCondition({\n  rule,\n  field,\n  value,\n}: {\n  rule: PermissionRule;\n  field: (typeof PATTERN_FIELDS)[number];\n  value: MatchPatterns;\n}): PermissionRule {\n  return { ...rule, [field]: value };\n}\n\nexport function conditionText(rule: PermissionRule, field: MatchField): string {\n  if (isHintField(field)) return String(rule[field]);\n  return patternsText(rule[field]);\n}\n\nexport function replaceMatchField(\n  rule: PermissionRule,\n  current: MatchField,\n  next: MatchField,\n): PermissionRule {\n  if (current === next) return rule;\n  const match = { ...rule } as Record<string, unknown>;\n  const previous = match[current];\n  delete match[current];\n  match[next] = isHintField(next)\n    ? typeof previous === \"boolean\"\n      ? previous\n      : true\n    : typeof previous === \"string\" || Array.isArray(previous)\n      ? previous\n      : \"*\";\n  return match as PermissionRule;\n}\n\nexport function updateCondition(\n  rule: PermissionRule,\n  field: MatchField,\n  value: string,\n): PermissionRule {\n  if (isHintField(field)) return { ...rule, [field]: value === \"true\" };\n  const patterns = value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return {\n    ...rule,\n    [field]: patterns.length <= 1 ? (patterns[0] ?? \"\") : patterns,\n  };\n}\n\nexport function removeCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  const next = { ...rule } as Record<string, unknown>;\n  delete next[field];\n  if (activeMatchFields(next as PermissionRule).length === 0) next.name = \"*\";\n  return next as PermissionRule;\n}\n\nexport function addCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  if (rule[field] !== undefined) return rule;\n  return { ...rule, [field]: isHintField(field) ? true : \"*\" };\n}\n\nexport function isHintField(\n  field: MatchField,\n): field is (typeof HINT_FIELDS)[number] {\n  return (HINT_FIELDS as readonly MatchField[]).includes(field);\n}\n\nexport function matchingTools(rule: PermissionRule, tools: ToolMeta[]) {\n  return tools.filter((tool) => matchesTool(rule, tool));\n}\n\nexport function toolFieldSuggestions(\n  tools: ToolMeta[],\n  field: Exclude<MatchField, (typeof HINT_FIELDS)[number]>,\n) {\n  const values = new Set<string>();\n  for (const tool of tools) {\n    const value = tool[field === \"name\" ? \"name\" : field];\n    if (typeof value === \"string\" && value.trim()) values.add(value);\n  }\n  return Array.from(values).sort((left, right) => left.localeCompare(right));\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"permission-strategies.js","sources":["../../src/lib/permission-strategies.ts"],"sourcesContent":["import {\n  matchesTool,\n  type MatchPatterns,\n  type PermissionRule,\n} from \"../data/chat/tool-policy\";\nimport type { ToolMeta } from \"../data/chat/types\";\n\nexport const PATTERN_FIELDS = [\n  \"name\",\n  \"group\",\n  \"parent\",\n  \"entity\",\n  \"action\",\n  \"verb\",\n  \"method\",\n  \"scope\",\n] as const;\nexport const HINT_FIELDS = [\"readOnly\", \"destructive\", \"idempotent\"] as const;\nexport const MATCH_FIELDS = [...PATTERN_FIELDS, ...HINT_FIELDS] as const;\n\nexport type MatchField = (typeof MATCH_FIELDS)[number];\nexport type StrategyPreset =\n  | \"all\"\n  | \"read-only\"\n  | \"destructive\"\n  | \"idempotent\"\n  | \"custom\";\n\nexport const STRATEGY_PRESETS: Array<{\n  value: StrategyPreset;\n  label: string;\n  description: string;\n}> = [\n  {\n    value: \"all\",\n    label: \"All tools\",\n    description: \"Match every tool in the catalog.\",\n  },\n  {\n    value: \"read-only\",\n    label: \"Read-only tools\",\n    description: \"Match tools explicitly marked read-only.\",\n  },\n  {\n    value: \"destructive\",\n    label: \"Destructive tools\",\n    description: \"Match tools explicitly marked destructive.\",\n  },\n  {\n    value: \"idempotent\",\n    label: \"Idempotent tools\",\n    description: \"Match tools safe to repeat.\",\n  },\n  {\n    value: \"custom\",\n    label: \"Custom conditions\",\n    description: \"Combine tool metadata and safety annotations.\",\n  },\n];\n\nexport const MATCH_FIELD_OPTIONS: Array<{\n  value: MatchField;\n  label: string;\n  description: string;\n}> = [\n  {\n    value: \"name\",\n    label: \"Tool name\",\n    description: \"The operation's unique id, e.g. todo_create.\",\n  },\n  {\n    value: \"group\",\n    label: \"Group\",\n    description: \"The permission category a tool is filed under.\",\n  },\n  {\n    value: \"parent\",\n    label: \"Parent\",\n    description: \"The surface a tool belongs to, e.g. Contacts.\",\n  },\n  {\n    value: \"entity\",\n    label: \"Entity\",\n    description: \"The resource type the operation acts on.\",\n  },\n  {\n    value: \"action\",\n    label: \"Action\",\n    description: \"The operation's action name within its entity.\",\n  },\n  {\n    value: \"verb\",\n    label: \"Verb\",\n    description: \"What the operation does: get, list, create, delete…\",\n  },\n  {\n    value: \"method\",\n    label: \"HTTP method\",\n    description: \"GET, POST, PATCH or DELETE for HTTP-backed tools.\",\n  },\n  {\n    value: \"scope\",\n    label: \"Scope\",\n    description: \"Whether it acts on one item or a whole collection.\",\n  },\n  {\n    value: \"readOnly\",\n    label: \"Read only\",\n    description: \"Tools that declare they never change anything.\",\n  },\n  {\n    value: \"destructive\",\n    label: \"Destructive\",\n    description: \"Tools that declare they may delete or overwrite data.\",\n  },\n  {\n    value: \"idempotent\",\n    label: \"Idempotent\",\n    description: \"Tools that declare repeating a call is safe.\",\n  },\n];\n\n/** A strategy's actual match, e.g. \"Tool name in a, b · Destructive is No\". */\nexport function strategySummary(rule: PermissionRule): string {\n  const preset = strategyPreset(rule);\n  if (preset !== \"custom\") {\n    return STRATEGY_PRESETS.find((option) => option.value === preset)!.label;\n  }\n  return activeMatchFields(rule)\n    .map((field) => {\n      const label =\n        MATCH_FIELD_OPTIONS.find((option) => option.value === field)?.label ??\n        field;\n      if (isHintField(field)) {\n        return `${label} is ${rule[field] ? \"Yes\" : \"No\"}`;\n      }\n      const values = patternValues(rule[field]);\n      return `${label} ${values.length > 1 ? \"in\" : \"is\"} ${values.join(\", \")}`;\n    })\n    .join(\" · \");\n}\n\nexport function strategyPreset(rule: PermissionRule): StrategyPreset {\n  const fields = activeMatchFields(rule);\n  if (fields.length !== 1) return \"custom\";\n  if (fields[0] === \"name\" && patternsText(rule.name) === \"*\") return \"all\";\n  if (fields[0] === \"readOnly\" && rule.readOnly === true) return \"read-only\";\n  if (fields[0] === \"destructive\" && rule.destructive === true) {\n    return \"destructive\";\n  }\n  if (fields[0] === \"idempotent\" && rule.idempotent === true) {\n    return \"idempotent\";\n  }\n  return \"custom\";\n}\n\nexport function applyStrategyPreset(\n  rule: PermissionRule,\n  preset: Exclude<StrategyPreset, \"custom\">,\n): PermissionRule {\n  if (preset === \"all\") return { name: \"*\", policy: rule.policy };\n  if (preset === \"read-only\") return { readOnly: true, policy: rule.policy };\n  if (preset === \"destructive\")\n    return { destructive: true, policy: rule.policy };\n  return { idempotent: true, policy: rule.policy };\n}\n\nexport function activeMatchFields(rule: PermissionRule): MatchField[] {\n  return MATCH_FIELDS.filter((field) => rule[field] !== undefined);\n}\n\nexport function patternsText(value: MatchPatterns | undefined): string {\n  return typeof value === \"string\" ? value : (value ?? []).join(\", \");\n}\n\nexport function patternValues(value: MatchPatterns | undefined): string[] {\n  return typeof value === \"string\" ? (value ? [value] : []) : (value ?? []);\n}\n\nexport function updatePatternCondition({\n  rule,\n  field,\n  value,\n}: {\n  rule: PermissionRule;\n  field: (typeof PATTERN_FIELDS)[number];\n  value: MatchPatterns;\n}): PermissionRule {\n  return { ...rule, [field]: value };\n}\n\nexport function conditionText(rule: PermissionRule, field: MatchField): string {\n  if (isHintField(field)) return String(rule[field]);\n  return patternsText(rule[field]);\n}\n\nexport function replaceMatchField(\n  rule: PermissionRule,\n  current: MatchField,\n  next: MatchField,\n): PermissionRule {\n  if (current === next) return rule;\n  const match = { ...rule } as Record<string, unknown>;\n  const previous = match[current];\n  delete match[current];\n  match[next] = isHintField(next)\n    ? typeof previous === \"boolean\"\n      ? previous\n      : true\n    : typeof previous === \"string\" || Array.isArray(previous)\n      ? previous\n      : \"*\";\n  return match as PermissionRule;\n}\n\nexport function updateCondition(\n  rule: PermissionRule,\n  field: MatchField,\n  value: string,\n): PermissionRule {\n  if (isHintField(field)) return { ...rule, [field]: value === \"true\" };\n  const patterns = value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return {\n    ...rule,\n    [field]: patterns.length <= 1 ? (patterns[0] ?? \"\") : patterns,\n  };\n}\n\nexport function removeCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  const next = { ...rule } as Record<string, unknown>;\n  delete next[field];\n  if (activeMatchFields(next as PermissionRule).length === 0) next.name = \"*\";\n  return next as PermissionRule;\n}\n\nexport function addCondition(\n  rule: PermissionRule,\n  field: MatchField,\n): PermissionRule {\n  if (rule[field] !== undefined) return rule;\n  return { ...rule, [field]: isHintField(field) ? true : \"*\" };\n}\n\nexport function isHintField(\n  field: MatchField,\n): field is (typeof HINT_FIELDS)[number] {\n  return (HINT_FIELDS as readonly MatchField[]).includes(field);\n}\n\nexport function matchingTools(rule: PermissionRule, tools: ToolMeta[]) {\n  return tools.filter((tool) => matchesTool(rule, tool));\n}\n\nexport function toolFieldSuggestions(\n  tools: ToolMeta[],\n  field: Exclude<MatchField, (typeof HINT_FIELDS)[number]>,\n) {\n  const values = new Set<string>();\n  for (const tool of tools) {\n    const value = tool[field === \"name\" ? \"name\" : field];\n    if (typeof value === \"string\" && value.trim()) values.add(value);\n  }\n  return Array.from(values).sort((left, right) => left.localeCompare(right));\n}\n"],"names":[],"mappings":"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"}

package/dist/overlay/modalStack.cjs

@@ -23,11 +23,12 @@ function onEscapeKeyDown(event) {
   if (event.defaultPrevented || event.key !== "Escape" || event.isComposing || event.keyCode === 229) {
     return;
   }
-  const top = escapeStack[escapeStack.length - 1];
+  const top = escapeStack.findLast((entry) => !entry.dismissed);
   if (!top) return;
   event.preventDefault();
   event.stopPropagation();
   event.stopImmediatePropagation();
+  top.dismissed = true;
   top.onEscape();
 }
 function ensureEscapeListener() {
@@ -66,14 +67,20 @@ function useEscapeLayer(open, onEscape, enabled = true) {
   const id = react.useId();
   const onEscapeRef = react.useRef(onEscape);
   onEscapeRef.current = onEscape;
+  const entryRef = react.useRef(null);
+  react.useEffect(() => {
+    if (entryRef.current) entryRef.current.dismissed = false;
+  });
   react.useEffect(() => {
     if (!open || !enabled) return;
     ensureEscapeListener();
-    escapeStack.push({
-      id,
-      onEscape: () => onEscapeRef.current()
-    });
-    return () => removeEscapeLayer(id);
+    const entry = { id, dismissed: false, onEscape: () => onEscapeRef.current() };
+    entryRef.current = entry;
+    escapeStack.push(entry);
+    return () => {
+      entryRef.current = null;
+      removeEscapeLayer(id);
+    };
   }, [enabled, id, open]);
 }
 function useTourLayer(active) {