@arbidocs/react 0.5.110 → 0.5.112

package/dist/shell/index.cjs

@@ -1,156 +1,156 @@
 'use strict';
 
-var chunkZ3W4XFWB_cjs = require('../chunk-Z3W4XFWB.cjs');
+var chunkC72FSQUE_cjs = require('../chunk-C72FSQUE.cjs');
 var chunkRLSBRZ6Z_cjs = require('../chunk-RLSBRZ6Z.cjs');
 require('../chunk-N73IMVFF.cjs');
 require('../chunk-NDIKMOBJ.cjs');
 require('../chunk-VOFNX4P6.cjs');
 require('../chunk-KC474WVG.cjs');
-require('../chunk-HJDR5HEO.cjs');
 var chunk5NOZDH3F_cjs = require('../chunk-5NOZDH3F.cjs');
+require('../chunk-HJDR5HEO.cjs');
 require('../chunk-S6A6FSG7.cjs');
 
 
 
 Object.defineProperty(exports, "ArbiHost", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.ArbiHost; }
+  get: function () { return chunkC72FSQUE_cjs.ArbiHost; }
 });
 Object.defineProperty(exports, "DEFAULT_ASSISTANT_NAME", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.DEFAULT_ASSISTANT_NAME; }
+  get: function () { return chunkC72FSQUE_cjs.DEFAULT_ASSISTANT_NAME; }
 });
 Object.defineProperty(exports, "LEGACY_THREAD_DOCUMENTS_KEY", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.LEGACY_THREAD_DOCUMENTS_KEY; }
+  get: function () { return chunkC72FSQUE_cjs.LEGACY_THREAD_DOCUMENTS_KEY; }
 });
 Object.defineProperty(exports, "MENTION_HREF_PREFIX", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.MENTION_HREF_PREFIX; }
+  get: function () { return chunkC72FSQUE_cjs.MENTION_HREF_PREFIX; }
 });
 Object.defineProperty(exports, "NotificationBell", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.NotificationBell; }
+  get: function () { return chunkC72FSQUE_cjs.NotificationBell; }
 });
 Object.defineProperty(exports, "Toaster", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.Toaster; }
+  get: function () { return chunkC72FSQUE_cjs.Toaster; }
 });
 Object.defineProperty(exports, "UNBOUND", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.UNBOUND; }
+  get: function () { return chunkC72FSQUE_cjs.UNBOUND; }
 });
 Object.defineProperty(exports, "assistantCopy", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.assistantCopy; }
+  get: function () { return chunkC72FSQUE_cjs.assistantCopy; }
 });
 Object.defineProperty(exports, "bindingOfRow", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.bindingOfRow; }
+  get: function () { return chunkC72FSQUE_cjs.bindingOfRow; }
 });
 Object.defineProperty(exports, "clearSearchSession", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.clearSearchSession; }
+  get: function () { return chunkC72FSQUE_cjs.clearSearchSession; }
 });
 Object.defineProperty(exports, "createSearchSession", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.createSearchSession; }
+  get: function () { return chunkC72FSQUE_cjs.createSearchSession; }
 });
 Object.defineProperty(exports, "extractMentions", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.extractMentions; }
+  get: function () { return chunkC72FSQUE_cjs.extractMentions; }
 });
 Object.defineProperty(exports, "filterMentionCandidates", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.filterMentionCandidates; }
+  get: function () { return chunkC72FSQUE_cjs.filterMentionCandidates; }
 });
 Object.defineProperty(exports, "findMentionQuery", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.findMentionQuery; }
+  get: function () { return chunkC72FSQUE_cjs.findMentionQuery; }
 });
 Object.defineProperty(exports, "forgetLegacyThreadDocuments", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.forgetLegacyThreadDocuments; }
+  get: function () { return chunkC72FSQUE_cjs.forgetLegacyThreadDocuments; }
 });
 Object.defineProperty(exports, "hasMessageBody", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.hasMessageBody; }
+  get: function () { return chunkC72FSQUE_cjs.hasMessageBody; }
 });
 Object.defineProperty(exports, "insertMention", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.insertMention; }
+  get: function () { return chunkC72FSQUE_cjs.insertMention; }
 });
 Object.defineProperty(exports, "latestThreadOfDocument", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.latestThreadOfDocument; }
+  get: function () { return chunkC72FSQUE_cjs.latestThreadOfDocument; }
 });
 Object.defineProperty(exports, "linkMentions", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.linkMentions; }
+  get: function () { return chunkC72FSQUE_cjs.linkMentions; }
 });
 Object.defineProperty(exports, "mentionFromHref", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.mentionFromHref; }
+  get: function () { return chunkC72FSQUE_cjs.mentionFromHref; }
 });
 Object.defineProperty(exports, "openDocumentId", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.openDocumentId; }
+  get: function () { return chunkC72FSQUE_cjs.openDocumentId; }
 });
 Object.defineProperty(exports, "opensInWord", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.opensInWord; }
+  get: function () { return chunkC72FSQUE_cjs.opensInWord; }
 });
 Object.defineProperty(exports, "persistSearchSession", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.persistSearchSession; }
+  get: function () { return chunkC72FSQUE_cjs.persistSearchSession; }
 });
 Object.defineProperty(exports, "readLegacyThreadDocuments", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.readLegacyThreadDocuments; }
+  get: function () { return chunkC72FSQUE_cjs.readLegacyThreadDocuments; }
 });
 Object.defineProperty(exports, "requestSearch", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.requestSearch; }
+  get: function () { return chunkC72FSQUE_cjs.requestSearch; }
 });
 Object.defineProperty(exports, "savedDocumentIdFor", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.savedDocumentIdFor; }
+  get: function () { return chunkC72FSQUE_cjs.savedDocumentIdFor; }
 });
 Object.defineProperty(exports, "sharedSearchSession", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.sharedSearchSession; }
+  get: function () { return chunkC72FSQUE_cjs.sharedSearchSession; }
 });
 Object.defineProperty(exports, "takeDocumentForTurn", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.takeDocumentForTurn; }
+  get: function () { return chunkC72FSQUE_cjs.takeDocumentForTurn; }
 });
 Object.defineProperty(exports, "takePendingSearch", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.takePendingSearch; }
+  get: function () { return chunkC72FSQUE_cjs.takePendingSearch; }
 });
 Object.defineProperty(exports, "toMessageMentions", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.toMessageMentions; }
+  get: function () { return chunkC72FSQUE_cjs.toMessageMentions; }
 });
 Object.defineProperty(exports, "useAssistantCopy", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.useAssistantCopy; }
+  get: function () { return chunkC72FSQUE_cjs.useAssistantCopy; }
 });
 Object.defineProperty(exports, "useAssistantName", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.useAssistantName; }
+  get: function () { return chunkC72FSQUE_cjs.useAssistantName; }
 });
 Object.defineProperty(exports, "useOpenDocumentId", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.useOpenDocumentId; }
+  get: function () { return chunkC72FSQUE_cjs.useOpenDocumentId; }
 });
 Object.defineProperty(exports, "useRegisterOpenDocument", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.useRegisterOpenDocument; }
+  get: function () { return chunkC72FSQUE_cjs.useRegisterOpenDocument; }
 });
 Object.defineProperty(exports, "useTurnDocumentId", {
   enumerable: true,
-  get: function () { return chunkZ3W4XFWB_cjs.useTurnDocumentId; }
+  get: function () { return chunkC72FSQUE_cjs.useTurnDocumentId; }
 });
 Object.defineProperty(exports, "clearChatArtifacts", {
   enumerable: true,

package/dist/shell/index.js

@@ -1,11 +1,44 @@
-export { ArbiHost, DEFAULT_ASSISTANT_NAME, LEGACY_THREAD_DOCUMENTS_KEY, MENTION_HREF_PREFIX, NotificationBell, Toaster, UNBOUND, assistantCopy, bindingOfRow, clearSearchSession, createSearchSession, extractMentions, filterMentionCandidates, findMentionQuery, forgetLegacyThreadDocuments, hasMessageBody, insertMention, latestThreadOfDocument, linkMentions, mentionFromHref, openDocumentId, opensInWord, persistSearchSession, readLegacyThreadDocuments, requestSearch, savedDocumentIdFor, sharedSearchSession, takeDocumentForTurn, takePendingSearch, toMessageMentions, useAssistantCopy, useAssistantName, useOpenDocumentId, useRegisterOpenDocument, useTurnDocumentId } from '../chunk-OYPKKHXY.js';
-export { clearChatArtifacts, configureNotify, getChatArtifact, getChatArtifacts, notify, persistNotifyHistory, recordChatArtifact, selectUnread, toast, useChatArtifact, useMessageChatArtifact, useNotify } from '../chunk-BF5KW5ZI.js';
-import '../chunk-DPYBZDJB.js';
-import '../chunk-UW2SGTI5.js';
-import '../chunk-WUTL62MC.js';
-import '../chunk-Y3MTRA7D.js';
-import '../chunk-47CCGUWR.js';
-export { useHostConfigRecord } from '../chunk-VSCU7K4V.js';
-import '../chunk-SN5YV6FF.js';
+import {
+  toast,
+  notify,
+  useNotify,
+  selectUnread,
+  configureNotify,
+  persistNotifyHistory
+} from "../notifications/notify-store.js";
+import {
+  sharedSearchSession,
+  createSearchSession,
+  clearSearchSession,
+  requestSearch,
+  takePendingSearch,
+  persistSearchSession
+} from "../search/session.js";
+import { Toaster } from "../notifications/Toaster.js";
+import { NotificationBell } from "../notifications/NotificationBell.js";
+import { ArbiHost } from "../host/ArbiHost.js";
+import { useHostConfigRecord } from "../host/context.js";
+export * from "../host/assistant-copy.js";
+export * from "../chat/mentions.js";
+export * from "../chat/open-document.js";
+export * from "../chat/chat-artifacts.js";
+export * from "../chat/thread-document.js";
+export {
+  ArbiHost,
+  NotificationBell,
+  Toaster,
+  clearSearchSession,
+  configureNotify,
+  createSearchSession,
+  notify,
+  persistNotifyHistory,
+  persistSearchSession,
+  requestSearch,
+  selectUnread,
+  sharedSearchSession,
+  takePendingSearch,
+  toast,
+  useHostConfigRecord,
+  useNotify
+};
 //# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/shell/index.js.map

@@ -1 +1,7 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{
+  "version": 3,
+  "sources": ["../../src/shell/index.ts"],
+  "sourcesContent": ["/**\n * `@arbidocs/react/shell` \u2014 the few things an authenticated app's *shell* needs\n * at first paint, without the rest of the root entry.\n *\n * The toast engine (sonner + the notification-centre store) is imported by the\n * app's entry module, so it lands on every cold load including the login page.\n * It cannot live in `/ui`, which is guarded to stay free of `zustand` and `sonner`\n * for marketing sites, and importing it from the root entry drags AG Grid, the SDK\n * and react-pdf into that first load (neither kit package declares `sideEffects`,\n * so a bundler must keep every import it sees). This entry is the narrow third\n * option. Like `/ui` it shares module instances with the root entry \u2014 one sonner,\n * one notification store \u2014 which `index.test.ts` enforces.\n */\nexport {\n  toast,\n  notify,\n  useNotify,\n  selectUnread,\n  configureNotify,\n  persistNotifyHistory,\n  type AppNotification,\n  type NotifyConfig,\n  type NotifyOptions,\n  type NotifyVariant,\n} from '../notifications/notify-store'\n// The search session: the app's store clears it and its ask bar hands queries to it at first\n// paint, so it is here as well as behind the root entry's search hook.\nexport {\n  sharedSearchSession,\n  createSearchSession,\n  clearSearchSession,\n  requestSearch,\n  takePendingSearch,\n  persistSearchSession,\n  type SearchSession,\n  type SearchSessionState,\n  type SearchStatus,\n} from '../search/session'\nexport { Toaster, type ToasterProps } from '../notifications/Toaster'\n// The notification bell reads the same store as the Toaster, so it lives here, not in `/ui`.\nexport { NotificationBell, type NotificationBellProps } from '../notifications/NotificationBell'\n// The host configuration's provider is SDK-free, so a site that only sets the blocks environment\n// mounts it without the SDK.\n// (Untyped here: each package types it with its own domains, `ArbiHostConfig`.)\nexport { ArbiHost, type ArbiHostConnection, type ArbiHostProps } from '../host/ArbiHost'\nexport { useHostConfigRecord, type HostConfigRecord } from '../host/context'\n// What the kits call the assistant (the host's `assistantName`, else \"ARBI\").\nexport * from '../host/assistant-copy'\n// Pure chat helpers the blocks' composer and viewer need without the SDK: @mentions, and the\n// document open beside the chat (drafting).\nexport * from '../chat/mentions'\nexport * from '../chat/open-document'\nexport * from '../chat/chat-artifacts'\nexport * from '../chat/thread-document'\n"],
+  "mappings": "AAaA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,eAAkC;AAE3C,SAAS,wBAAoD;AAI7D,SAAS,gBAA6D;AACtE,SAAS,2BAAkD;AAE3D,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/skill-pack.js

@@ -0,0 +1,111 @@
+import { createSkillPack } from "./useInstallSkillPack.js";
+const FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+const SLUG = /^[a-z0-9][a-z0-9-]*$/;
+function readFrontmatter(block) {
+  const meta = {};
+  for (const line of block.split(/\r?\n/)) {
+    const i = line.indexOf(":");
+    if (i > 0) meta[line.slice(0, i).trim().toLowerCase()] = line.slice(i + 1).trim();
+  }
+  return meta;
+}
+function withPreamble(preamble, body) {
+  return [preamble?.trim(), body.trim()].filter(Boolean).join("\n\n");
+}
+function checkSlug(slug, where) {
+  if (!SLUG.test(slug)) throw new Error(`${where}: "${slug}" is not a skill slug`);
+}
+function fromFile(path, text, preamble) {
+  const match = FRONTMATTER.exec(text);
+  if (!match) throw new Error(`${path}: a skill needs frontmatter`);
+  const meta = readFrontmatter(match[1]);
+  const slug = meta.name ?? "";
+  checkSlug(slug, path);
+  if (path.includes("/") && !path.includes(`/${slug}/`))
+    throw new Error(`${path}: name must be the folder's slug`);
+  let inputs = [];
+  if (meta.inputs) {
+    try {
+      inputs = JSON.parse(meta.inputs);
+    } catch {
+      throw new Error(`${path}: inputs must be one line of JSON`);
+    }
+  }
+  const instructions = withPreamble(preamble, match[2]);
+  return {
+    slug,
+    title: meta.title || slug,
+    description: meta.description ?? "",
+    icon: meta.icon || void 0,
+    category: meta.category || void 0,
+    inputs,
+    instructions,
+    markdown: `---
+${match[1]}
+---
+
+${instructions}
+`
+  };
+}
+const oneLine = (text) => text.replace(/\s*\n\s*/g, " ").trim();
+function fromDefinition(skill, preamble) {
+  checkSlug(skill.name, "defineSkillPack");
+  const inputs = skill.inputs ?? [];
+  const instructions = withPreamble(preamble, skill.prompt);
+  const meta = [
+    `name: ${skill.name}`,
+    `description: ${oneLine(skill.description)}`,
+    skill.title && `title: ${oneLine(skill.title)}`,
+    skill.icon && `icon: ${skill.icon}`,
+    skill.category && `category: ${oneLine(skill.category)}`,
+    inputs.length > 0 && `inputs: ${JSON.stringify(inputs)}`
+  ].filter(Boolean);
+  return {
+    slug: skill.name,
+    title: skill.title || skill.name,
+    description: skill.description,
+    icon: skill.icon,
+    category: skill.category,
+    inputs,
+    instructions,
+    markdown: `---
+${meta.join("\n")}
+---
+
+${instructions}
+`
+  };
+}
+function defineSkillPack({
+  id,
+  label,
+  preamble,
+  files = {},
+  skills = [],
+  marker
+}) {
+  const all = [
+    ...Object.entries(files).map(([path, text]) => fromFile(path, text, preamble)),
+    ...skills.map((skill) => fromDefinition(skill, preamble))
+  ].sort((a, b) => a.slug.localeCompare(b.slug));
+  const seen = /* @__PURE__ */ new Set();
+  for (const skill of all) {
+    if (seen.has(skill.slug)) throw new Error(`defineSkillPack: two skills are "${skill.slug}"`);
+    seen.add(skill.slug);
+  }
+  return { ...createSkillPack({ id, skills: all, marker }), label, skills: all };
+}
+function skillPackPrompt(pack, slug, request = "") {
+  const skill = pack.skills.find((s) => s.slug === slug);
+  if (!skill) throw new Error(`No skill "${slug}" in the ${pack.id} pack`);
+  return request.trim() ? `${skill.instructions}
+
+## Request
+${request.trim()}` : skill.instructions;
+}
+export {
+  defineSkillPack,
+  skillPackPrompt
+};
+//# sourceMappingURL=skill-pack.js.map

package/dist/skill-pack.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/skill-pack.ts"],
+  "sourcesContent": ["/**\n * A host's skill pack, declared once: its skills as SKILL.md files (with one shared preamble) or\n * inline, in the host's configuration. The same object installs (`useInstallSkillPack`: one hidden\n * marker carries the version) and lists: `@arbidocs/blocks` shows the skills in every `/` menu from\n * `host.workflows.skillPacks`, run through the kit's own skill form and the chat's own send.\n *\n *   const FIRM_SKILLS = defineSkillPack({\n *     id: 'firm-skills',\n *     label: 'Firm skills',\n *     preamble: houseRules,\n *     files: import.meta.glob('./skills/* /SKILL.md', {\n *       query: '?raw',\n *       import: 'default',\n *       eager: true,\n *     }),\n *   })\n *\n * A SKILL.md is the line-based frontmatter the backend reads (`name` is the slug and must be its\n * folder's name), plus `title`, `icon`, `category` and `inputs` (one line of JSON) for the menu\n * and the form. The wording stays in the files: nothing here composes prose.\n */\nimport { createSkillPack, type CreateSkillPackOptions, type SkillPack } from './useInstallSkillPack'\n\n/** One form field of a pack skill (the shape of `inputs` in a SKILL.md frontmatter). */\nexport interface SkillPackField {\n  /** Key in the inputs; also the `{{name}}` placeholder in the instructions. */\n  name: string\n  type: 'text' | 'longtext' | 'boolean' | 'select' | 'number' | 'date' | 'scope' | 'documents'\n  label: string\n  description?: string\n  placeholder?: string\n  required?: boolean\n  default?: string | number | boolean\n  /** `select` only. */\n  options?: ReadonlyArray<{ value: string; label: string; description?: string }>\n  min?: number\n  max?: number\n  advanced?: boolean\n}\n\n/** A skill declared inline (no file). */\nexport interface SkillPackSkillDefinition {\n  /** The slug (`/name` in the menu): lowercase letters, digits and hyphens. */\n  name: string\n  /** Shown in the skill's form. Default: the slug. */\n  title?: string\n  description: string\n  /** The instructions; the pack's preamble goes before them. */\n  prompt: string\n  inputs?: ReadonlyArray<SkillPackField>\n  /** Its group within the pack (the menu sorts by it, then by title). */\n  category?: string\n  icon?: string\n}\n\n/** A skill of a defined pack: what the menu lists and what installs. */\nexport interface SkillPackSkill {\n  slug: string\n  title: string\n  description: string\n  icon?: string\n  category?: string\n  inputs: ReadonlyArray<SkillPackField>\n  /** The preamble, then the skill's own instructions. */\n  instructions: string\n  /** The SKILL.md as installed: its frontmatter, then `instructions`. */\n  markdown: string\n}\n\n/** A skill pack with what the kit lists: installable as is (`useInstallSkillPack(pack)`). */\nexport interface DefinedSkillPack extends SkillPack {\n  /** The heading of its group in the `/` menu. */\n  label?: string\n  skills: readonly SkillPackSkill[]\n}\n\nexport interface DefineSkillPackOptions {\n  /** Stable identity (also the default marker slug, `<id>-version`). */\n  id: string\n  /** The heading of its group in the `/` menu. Absent: the kit's built-in heading. */\n  label?: string\n  /** Text every skill's instructions start with (house rules). */\n  preamble?: string\n  /**\n   * SKILL.md texts by path, as an eager raw glob:\n   * `import.meta.glob(\u2026, { query: '?raw', import: 'default', eager: true })`.\n   */\n  files?: Readonly<Record<string, string>>\n  /** Skills declared inline. */\n  skills?: ReadonlyArray<SkillPackSkillDefinition>\n  marker?: CreateSkillPackOptions['marker']\n}\n\nconst FRONTMATTER = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/\nconst SLUG = /^[a-z0-9][a-z0-9-]*$/\n\nfunction readFrontmatter(block: string): Record<string, string> {\n  const meta: Record<string, string> = {}\n  for (const line of block.split(/\\r?\\n/)) {\n    const i = line.indexOf(':')\n    if (i > 0) meta[line.slice(0, i).trim().toLowerCase()] = line.slice(i + 1).trim()\n  }\n  return meta\n}\n\nfunction withPreamble(preamble: string | undefined, body: string): string {\n  return [preamble?.trim(), body.trim()].filter(Boolean).join('\\n\\n')\n}\n\nfunction checkSlug(slug: string, where: string): void {\n  if (!SLUG.test(slug)) throw new Error(`${where}: \"${slug}\" is not a skill slug`)\n}\n\nfunction fromFile(path: string, text: string, preamble: string | undefined): SkillPackSkill {\n  const match = FRONTMATTER.exec(text)\n  if (!match) throw new Error(`${path}: a skill needs frontmatter`)\n  const meta = readFrontmatter(match[1])\n  const slug = meta.name ?? ''\n  checkSlug(slug, path)\n  if (path.includes('/') && !path.includes(`/${slug}/`))\n    throw new Error(`${path}: name must be the folder's slug`)\n  let inputs: SkillPackField[] = []\n  if (meta.inputs) {\n    try {\n      inputs = JSON.parse(meta.inputs) as SkillPackField[]\n    } catch {\n      throw new Error(`${path}: inputs must be one line of JSON`)\n    }\n  }\n  const instructions = withPreamble(preamble, match[2])\n  return {\n    slug,\n    title: meta.title || slug,\n    description: meta.description ?? '',\n    icon: meta.icon || undefined,\n    category: meta.category || undefined,\n    inputs,\n    instructions,\n    markdown: `---\\n${match[1]}\\n---\\n\\n${instructions}\\n`,\n  }\n}\n\nconst oneLine = (text: string): string => text.replace(/\\s*\\n\\s*/g, ' ').trim()\n\nfunction fromDefinition(\n  skill: SkillPackSkillDefinition,\n  preamble: string | undefined\n): SkillPackSkill {\n  checkSlug(skill.name, 'defineSkillPack')\n  const inputs = skill.inputs ?? []\n  const instructions = withPreamble(preamble, skill.prompt)\n  const meta = [\n    `name: ${skill.name}`,\n    `description: ${oneLine(skill.description)}`,\n    skill.title && `title: ${oneLine(skill.title)}`,\n    skill.icon && `icon: ${skill.icon}`,\n    skill.category && `category: ${oneLine(skill.category)}`,\n    inputs.length > 0 && `inputs: ${JSON.stringify(inputs)}`,\n  ].filter(Boolean)\n  return {\n    slug: skill.name,\n    title: skill.title || skill.name,\n    description: skill.description,\n    icon: skill.icon,\n    category: skill.category,\n    inputs,\n    instructions,\n    markdown: `---\\n${meta.join('\\n')}\\n---\\n\\n${instructions}\\n`,\n  }\n}\n\n/** Define a host's skill pack from SKILL.md files and/or inline skills (see the module comment). */\nexport function defineSkillPack({\n  id,\n  label,\n  preamble,\n  files = {},\n  skills = [],\n  marker,\n}: DefineSkillPackOptions): DefinedSkillPack {\n  const all = [\n    ...Object.entries(files).map(([path, text]) => fromFile(path, text, preamble)),\n    ...skills.map((skill) => fromDefinition(skill, preamble)),\n  ].sort((a, b) => a.slug.localeCompare(b.slug))\n  const seen = new Set<string>()\n  for (const skill of all) {\n    if (seen.has(skill.slug)) throw new Error(`defineSkillPack: two skills are \"${skill.slug}\"`)\n    seen.add(skill.slug)\n  }\n  return { ...createSkillPack({ id, skills: all, marker }), label, skills: all }\n}\n\n/** A request that follows one of the pack's skills: its instructions, then the request. */\nexport function skillPackPrompt(pack: DefinedSkillPack, slug: string, request = ''): string {\n  const skill = pack.skills.find((s) => s.slug === slug)\n  if (!skill) throw new Error(`No skill \"${slug}\" in the ${pack.id} pack`)\n  return request.trim()\n    ? `${skill.instructions}\\n\\n## Request\\n${request.trim()}`\n    : skill.instructions\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/storage.js

@@ -0,0 +1,186 @@
+import { useMemo } from "react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "./useArbi.js";
+import { arbiQueryKeys } from "./query-keys.js";
+function dataOrThrow({ data, error }) {
+  if (error !== void 0) throw error;
+  return data;
+}
+function useStorageProjects(scope = "mine", project) {
+  const arbi = useArbi();
+  const query = { scope, include: ["workspaces"], ...project ? { project } : {} };
+  return useQuery({
+    queryKey: arbiQueryKeys.storageProjects(query),
+    queryFn: async () => dataOrThrow(await arbi.getClient().fetch.GET("/v1/storage/projects", { params: { query } })),
+    enabled: arbi.isLoggedIn,
+    retry: false,
+    staleTime: 3e4
+  });
+}
+function useStorageItems(query, enabled = true) {
+  const arbi = useArbi();
+  const params = { limit: 50, ...query };
+  return useQuery({
+    queryKey: arbiQueryKeys.storageItems(params),
+    queryFn: async () => dataOrThrow(
+      await arbi.getClient().fetch.GET("/v1/storage/items", { params: { query: params } })
+    ),
+    enabled: arbi.isLoggedIn && enabled,
+    retry: false,
+    staleTime: 3e4
+  });
+}
+function useStorageItemNames(items, query) {
+  const arbi = useArbi();
+  const workspaces = [
+    ...new Set(
+      (items ?? []).filter((i) => i.kind === "document" && i.workspace_ext_id).map((i) => i.workspace_ext_id)
+    )
+  ].sort();
+  return useQuery({
+    queryKey: arbiQueryKeys.storageItemNames({ workspaces, query }),
+    enabled: arbi.isLoggedIn && workspaces.length > 0,
+    staleTime: 6e4,
+    retry: false,
+    queryFn: async () => {
+      const names = {};
+      for (const workspace of workspaces) {
+        const { data } = await arbi.getClient().fetch.GET("/v1/storage/items", {
+          params: {
+            query: {
+              ...query,
+              workspace,
+              kind: "document",
+              include: ["names"],
+              limit: 200
+            }
+          }
+        });
+        for (const item of data?.items ?? []) {
+          if (item.ref && item.name) names[item.ref] = item.name;
+        }
+      }
+      return names;
+    }
+  });
+}
+function useStorageSnapshots(enabled) {
+  const arbi = useArbi();
+  const query = { limit: 90 };
+  return useQuery({
+    queryKey: arbiQueryKeys.storageSnapshots(query),
+    queryFn: async () => dataOrThrow(await arbi.getClient().fetch.GET("/v1/storage/snapshots", { params: { query } })),
+    enabled: arbi.isLoggedIn && enabled,
+    retry: false,
+    staleTime: 5 * 6e4
+  });
+}
+function useInvalidateStorage() {
+  const queryClient = useQueryClient();
+  return () => Promise.all([
+    queryClient.invalidateQueries({ queryKey: arbiQueryKeys.storage() }),
+    queryClient.invalidateQueries({ queryKey: arbiQueryKeys.projects() })
+  ]);
+}
+class StorageActionError extends Error {
+}
+const RESTORE_POLL_MS = 3e3;
+function fail(fallback, error) {
+  const detail = error?.detail;
+  const message = typeof detail === "string" ? detail : typeof detail?.message === "string" ? detail.message : fallback;
+  throw new StorageActionError(message);
+}
+function useWorkspaceTrash(workspace, enabled = true) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.workspaceTrash(workspace ?? ""),
+    enabled: arbi.isLoggedIn && Boolean(workspace) && enabled,
+    retry: false,
+    // Other members delete and restore too, and deleting from the documents list doesn't touch this cache:
+    // refetch whenever Recently deleted is opened instead of trusting a long staleTime.
+    staleTime: 0,
+    // A restore copies files back from archive storage first: follow it until the documents leave the list.
+    refetchInterval: (query) => query.state.data?.items.some((d) => d.restoring) ? RESTORE_POLL_MS : false,
+    queryFn: async () => {
+      const { data, error, response } = await arbi.getClient().fetch.GET("/v1/document/deleted", {
+        params: { query: { workspace_ext_id: workspace } }
+      });
+      if (!response.ok || !data) fail("Could not load Recently deleted", error);
+      return data;
+    }
+  });
+}
+function useStorageActions() {
+  const arbi = useArbi();
+  return useMemo(() => {
+    const client = () => arbi.getClient().fetch;
+    return {
+      async purgeDeletedDocuments(workspace, options = {}) {
+        const { data, error, response } = await client().DELETE("/v1/document/deleted", {
+          params: { query: { workspace_ext_id: workspace } },
+          body: {
+            ...options.externalIds ? { external_ids: options.externalIds } : {},
+            include_others_private: Boolean(options.includeOthersPrivate)
+          }
+        });
+        if (!response.ok || !data) fail("Could not delete permanently", error);
+        return data.external_ids;
+      },
+      async purgeStorageItems(project, refs) {
+        const { data, error, response } = await client().DELETE("/v1/storage/items", {
+          params: { query: { project, ...refs?.length ? { refs } : {} } }
+        });
+        if (!response.ok || !data) fail("Could not delete permanently", error);
+        return data.bytes;
+      },
+      async restoreDocuments(workspace, externalIds) {
+        const { error, response } = await client().POST("/v1/document/restore", {
+          params: { query: { workspace_ext_id: workspace } },
+          body: { external_ids: externalIds }
+        });
+        if (!response.ok) fail("Could not restore", error);
+      },
+      async restoreWorkspaces(externalIds) {
+        const { error, response } = await client().POST("/v1/workspace/restore", {
+          body: { external_ids: externalIds }
+        });
+        if (!response.ok) fail("Could not restore the workspace", error);
+      },
+      async deleteDocuments(externalIds) {
+        const { error, response } = await client().DELETE("/v1/document/", {
+          body: { external_ids: externalIds }
+        });
+        if (!response.ok) fail("Could not delete", error);
+      },
+      async updateNativeMail(messageId, action) {
+        const { error, response } = await client().PATCH(
+          "/v1/mail/accounts/{account_id}/messages/{message_id}",
+          {
+            params: { path: { account_id: "native", message_id: messageId } },
+            body: { action }
+          }
+        );
+        if (!response.ok) fail(action === "trash" ? "Could not delete" : "Could not restore", error);
+      },
+      async emptyMailTrash() {
+        const { data, error, response } = await client().DELETE(
+          "/v1/mail/accounts/{account_id}/messages",
+          { params: { path: { account_id: "native" }, query: { folder: "trash" } } }
+        );
+        if (!response.ok || !data) fail("Could not empty the Trash", error);
+        return data.deleted;
+      }
+    };
+  }, [arbi]);
+}
+export {
+  StorageActionError,
+  useInvalidateStorage,
+  useStorageActions,
+  useStorageItemNames,
+  useStorageItems,
+  useStorageProjects,
+  useStorageSnapshots,
+  useWorkspaceTrash
+};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/storage.ts"],
+  "sourcesContent": ["/**\n * Storage: what each project stores (by kind, workspace, live and trash), its largest items, the\n * deployment's view for Box admins / billing managers, a workspace's Recently deleted, and the trash\n * actions (restore, delete permanently, empty trash). The server counts every stored byte against\n * one project (ARBI `src/core/storage_ledger.py`).\n *\n * Requires an `ArbiHost` (with an `arbi`) and a React Query client above it.\n */\n\nimport { useMemo } from 'react'\nimport { useQuery, useQueryClient } from '@tanstack/react-query'\nimport type { components } from '@arbidocs/client'\nimport { useArbi } from './useArbi'\nimport { arbiQueryKeys } from './query-keys'\n\nexport type StorageProjectUsage = components['schemas']['StorageProjectUsage']\nexport type StorageItem = components['schemas']['StorageItem']\nexport type StorageKindUsage = components['schemas']['StorageKindUsage']\nexport type StorageDeploymentUsage = components['schemas']['StorageDeploymentUsage']\nexport type StorageSnapshot = components['schemas']['StorageSnapshotRead']\nexport type DeletedDocument = components['schemas']['DeletedDocument']\nexport type DeletedDocumentsPage = components['schemas']['DeletedDocumentsPage']\n\nexport type StorageScope = 'mine' | 'deployment'\nexport type StorageItemState = 'live' | 'trash' | 'all'\nexport type StorageItemKind = NonNullable<StorageItem['kind']>\n\nexport interface StorageItemsQuery {\n  scope?: StorageScope\n  project?: string\n  workspace?: string\n  kind?: 'document' | 'mail' | 'mail_draft' | 'recording' | 'chat_attachment' | 'other'\n  state?: StorageItemState\n  limit?: number\n}\n\n/** A read's data, or its error response thrown. */\nfunction dataOrThrow<T>({ data, error }: { data?: T; error?: unknown }): T {\n  if (error !== undefined) throw error\n  return data as T\n}\n\n/** My projects' storage (`mine`), or the deployment's (`deployment`: 403 for anyone but admins, not retried). */\nexport function useStorageProjects(scope: StorageScope = 'mine', project?: string) {\n  const arbi = useArbi()\n  const query = { scope, include: ['workspaces' as const], ...(project ? { project } : {}) }\n  return useQuery({\n    queryKey: arbiQueryKeys.storageProjects(query),\n    queryFn: async () =>\n      dataOrThrow(await arbi.getClient().fetch.GET('/v1/storage/projects', { params: { query } })),\n    enabled: arbi.isLoggedIn,\n    retry: false,\n    staleTime: 30_000,\n  })\n}\n\n/** The largest items stored, largest first (`state: 'trash'` is Recently deleted). */\nexport function useStorageItems(query: StorageItemsQuery, enabled = true) {\n  const arbi = useArbi()\n  const params = { limit: 50, ...query }\n  return useQuery({\n    queryKey: arbiQueryKeys.storageItems(params),\n    queryFn: async () =>\n      dataOrThrow(\n        await arbi.getClient().fetch.GET('/v1/storage/items', { params: { query: params } })\n      ),\n    enabled: arbi.isLoggedIn && enabled,\n    retry: false,\n    staleTime: 30_000,\n  })\n}\n\n/**\n * Names of the documents among `items`, one request per workspace (its key is primed on the session\n * when needed, without switching workspace). Names are encrypted; the server decrypts them with the key.\n */\nexport function useStorageItemNames(items: StorageItem[] | undefined, query: StorageItemsQuery) {\n  const arbi = useArbi()\n  const workspaces = [\n    ...new Set(\n      (items ?? [])\n        .filter((i) => i.kind === 'document' && i.workspace_ext_id)\n        .map((i) => i.workspace_ext_id as string)\n    ),\n  ].sort()\n  return useQuery({\n    queryKey: arbiQueryKeys.storageItemNames({ workspaces, query }),\n    enabled: arbi.isLoggedIn && workspaces.length > 0,\n    staleTime: 60_000,\n    retry: false,\n    queryFn: async () => {\n      const names: Record<string, string> = {}\n      for (const workspace of workspaces) {\n        const { data } = await arbi.getClient().fetch.GET('/v1/storage/items', {\n          params: {\n            query: {\n              ...query,\n              workspace,\n              kind: 'document',\n              include: ['names'],\n              limit: 200,\n            },\n          },\n        })\n        for (const item of data?.items ?? []) {\n          if (item.ref && item.name) names[item.ref] = item.name\n        }\n      }\n      return names\n    },\n  })\n}\n\n/** The deployment's storage day by day (admins). */\nexport function useStorageSnapshots(enabled: boolean) {\n  const arbi = useArbi()\n  const query = { limit: 90 }\n  return useQuery({\n    queryKey: arbiQueryKeys.storageSnapshots(query),\n    queryFn: async () =>\n      dataOrThrow(await arbi.getClient().fetch.GET('/v1/storage/snapshots', { params: { query } })),\n    enabled: arbi.isLoggedIn && enabled,\n    retry: false,\n    staleTime: 5 * 60_000,\n  })\n}\n\n/** After anything that changes what is stored: storage views, and the projects' quota meters. */\nexport function useInvalidateStorage() {\n  const queryClient = useQueryClient()\n  return () =>\n    Promise.all([\n      queryClient.invalidateQueries({ queryKey: arbiQueryKeys.storage() }),\n      queryClient.invalidateQueries({ queryKey: arbiQueryKeys.projects() }),\n    ])\n}\n\n/** A refused storage action, with the server's message. */\nexport class StorageActionError extends Error {}\n\n/** How often a Recently deleted list with documents being restored is checked. */\nconst RESTORE_POLL_MS = 3_000\n\nfunction fail(fallback: string, error: unknown): never {\n  const detail = (error as { detail?: unknown } | undefined)?.detail\n  const message =\n    typeof detail === 'string'\n      ? detail\n      : typeof (detail as { message?: unknown } | undefined)?.message === 'string'\n        ? (detail as { message: string }).message\n        : fallback\n  throw new StorageActionError(message)\n}\n\n/**\n * A workspace's Recently deleted documents \u2014 only those the caller could see live (shared, or theirs) \u2014\n * with what they may do; for a workspace manager (project or workspace owner), how much other members keep\n * private in the trash. The workspace's key is primed on the session when needed.\n */\nexport function useWorkspaceTrash(workspace: string | undefined, enabled = true) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.workspaceTrash(workspace ?? ''),\n    enabled: arbi.isLoggedIn && Boolean(workspace) && enabled,\n    retry: false,\n    // Other members delete and restore too, and deleting from the documents list doesn't touch this cache:\n    // refetch whenever Recently deleted is opened instead of trusting a long staleTime.\n    staleTime: 0,\n    // A restore copies files back from archive storage first: follow it until the documents leave the list.\n    refetchInterval: (query) =>\n      query.state.data?.items.some((d) => d.restoring) ? RESTORE_POLL_MS : false,\n    queryFn: async (): Promise<DeletedDocumentsPage> => {\n      const { data, error, response } = await arbi.getClient().fetch.GET('/v1/document/deleted', {\n        params: { query: { workspace_ext_id: workspace as string } },\n      })\n      if (!response.ok || !data) fail('Could not load Recently deleted', error)\n      return data\n    },\n  })\n}\n\n/** The trash actions on the signed-in session. Each throws a {@link StorageActionError} when refused. */\nexport interface StorageActions {\n  /**\n   * Delete a workspace's deleted documents for good: these `externalIds`, or (omitted) Empty trash \u2014 a\n   * manager's everything-they-can-see, plus other members' private items only with `includeOthersPrivate`;\n   * anyone else their own. Returns the documents removed.\n   */\n  purgeDeletedDocuments(\n    workspace: string,\n    options?: { externalIds?: string[]; includeOthersPrivate?: boolean }\n  ): Promise<string[]>\n  /** Delete permanently what is in a project's trash (or only `refs`). Returns the bytes freed. */\n  purgeStorageItems(project: string, refs?: string[]): Promise<number>\n  /**\n   * Restore deleted documents of one workspace: their files come back from archive storage first (they are\n   * listed as `restoring` meanwhile), then they reappear and are re-indexed in the background.\n   */\n  restoreDocuments(workspace: string, externalIds: string[]): Promise<void>\n  /** Restore deleted workspaces (their owner). */\n  restoreWorkspaces(externalIds: string[]): Promise<void>\n  /** Move live documents to Recently deleted (the documents' usual delete). */\n  deleteDocuments(externalIds: string[]): Promise<void>\n  /** ARBI mail: to the Trash, or back from it. */\n  updateNativeMail(messageId: string, action: 'trash' | 'restore'): Promise<void>\n  /** ARBI mail: empty the Trash. Returns the messages deleted. */\n  emptyMailTrash(): Promise<number>\n}\n\nexport function useStorageActions(): StorageActions {\n  const arbi = useArbi()\n  return useMemo(() => {\n    const client = () => arbi.getClient().fetch\n    return {\n      async purgeDeletedDocuments(workspace, options = {}) {\n        const { data, error, response } = await client().DELETE('/v1/document/deleted', {\n          params: { query: { workspace_ext_id: workspace } },\n          body: {\n            ...(options.externalIds ? { external_ids: options.externalIds } : {}),\n            include_others_private: Boolean(options.includeOthersPrivate),\n          },\n        })\n        if (!response.ok || !data) fail('Could not delete permanently', error)\n        return data.external_ids\n      },\n      async purgeStorageItems(project, refs) {\n        const { data, error, response } = await client().DELETE('/v1/storage/items', {\n          params: { query: { project, ...(refs?.length ? { refs } : {}) } },\n        })\n        if (!response.ok || !data) fail('Could not delete permanently', error)\n        return data.bytes\n      },\n      async restoreDocuments(workspace, externalIds) {\n        const { error, response } = await client().POST('/v1/document/restore', {\n          params: { query: { workspace_ext_id: workspace } },\n          body: { external_ids: externalIds },\n        })\n        if (!response.ok) fail('Could not restore', error)\n      },\n      async restoreWorkspaces(externalIds) {\n        const { error, response } = await client().POST('/v1/workspace/restore', {\n          body: { external_ids: externalIds },\n        })\n        if (!response.ok) fail('Could not restore the workspace', error)\n      },\n      async deleteDocuments(externalIds) {\n        const { error, response } = await client().DELETE('/v1/document/', {\n          body: { external_ids: externalIds },\n        })\n        if (!response.ok) fail('Could not delete', error)\n      },\n      async updateNativeMail(messageId, action) {\n        const { error, response } = await client().PATCH(\n          '/v1/mail/accounts/{account_id}/messages/{message_id}',\n          {\n            params: { path: { account_id: 'native', message_id: messageId } },\n            body: { action },\n          }\n        )\n        if (!response.ok) fail(action === 'trash' ? 'Could not delete' : 'Could not restore', error)\n      },\n      async emptyMailTrash() {\n        const { data, error, response } = await client().DELETE(\n          '/v1/mail/accounts/{account_id}/messages',\n          { params: { path: { account_id: 'native' }, query: { folder: 'trash' } } }\n        )\n        if (!response.ok || !data) fail('Could not empty the Trash', error)\n        return data.deleted\n      },\n    }\n  }, [arbi])\n}\n"],
+  "mappings": "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",
+  "names": []
+}