wizards 0.4.7 → 0.5.1

package/bin/wizards.mjs

@@ -4,7 +4,7 @@
 const [major, minor] = process.versions.node.split(".").map(Number);
 if (major < 24 || (major === 24 && minor < 11)) {
   console.error(
-    `engenty wizards needs Node.js 24.11 or newer; this is ${process.version}.\n` +
+    `engenty wizards needs Node.js 24.11 or newer. This is ${process.version}.\n` +
       "The installer brings its own and leaves yours alone:\n\n" +
       "  curl -fsSL https://engenty.ai/install.sh | bash\n",
   );

package/node_modules/@engenty-wizards/plugin-sdk/dist/index.d.ts

@@ -197,7 +197,7 @@ export interface PluginSpaceContext {
      */
     steps?: ("agent" | "html")[];
 }
-/** A space's brand as the studio's Info & Marke has it: what a plugin draws or writes in its look. */
+/** A space's brand as the studio's Info & brand has it: what a plugin draws or writes in its look. */
 export interface PluginBrand {
     /** The title end users see. */
     name: string;
@@ -232,7 +232,7 @@ export interface PluginIndex {
     /** Takes one key out, or without a key every entry of the plugin in the space. */
     remove(space: string, key?: string): Promise<void>;
 }
-/** A Kategorie of a space: a typed property set on pages, tables, rows and files of Wissen. */
+/** A category of a space: a typed property set on pages, tables, rows and files of Knowledge. */
 export interface PluginCategory {
     name: string;
     type: "choice" | "date" | "number" | "text" | "boolean";
@@ -253,7 +253,7 @@ export interface PluginCategory {
     };
 }
 /**
- * Kategorien of an item, by their names: a choice's value (or a list of them), a day as
+ * Categories of an item, by their names: a choice's value (or a list of them), a day as
  * `YYYY-MM-DD`, a number, a short text, true or false. Null takes one off.
  */
 export type PluginCategoryValues = Record<string, string | number | boolean | (string | number)[] | null>;
@@ -278,9 +278,9 @@ export interface PluginPageInput {
     position?: number;
     original?: PluginOriginal;
     categories?: PluginCategoryValues;
-    /** A model fills the space's Kategorien the page did not get from `categories`. */
+    /** A model fills the space's categories the page did not get from `categories`. */
     fill?: boolean;
-    /** Why a person should look at it ("hardly readable"); shown in Wissen. */
+    /** Why a person should look at it ("hardly readable"); shown in Knowledge. */
     review?: string | null;
 }
 export interface PluginTableInput {
@@ -320,7 +320,7 @@ export interface PluginDocumentInput {
     data: Uint8Array;
     /** Set on what it becomes: its first page, its first table, or the file. */
     categories?: PluginCategoryValues;
-    /** A model fills the space's Kategorien it did not get from `categories`. */
+    /** A model fills the space's categories it did not get from `categories`. */
     fill?: boolean;
 }
 /** What a document became: pages and tables (the first is the one it is found as), or a file. */
@@ -373,12 +373,12 @@ export interface PluginSpaceItem {
     updatedAt: string;
 }
 /**
- * Wissen of a space, written by a plugin: pages, tables and files under keys of its own, with
- * their Kategorien. Every write is indexed: `project_search` finds it a moment later.
+ * Knowledge of a space, written by a plugin: pages, tables and files under keys of its own, with
+ * their categories. Every write is indexed: `project_search` finds it a moment later.
  */
 export interface PluginSpaceData {
     /**
-     * Adds Kategorien to the space, or values to ones it has. `proposed`: shown to the person to
+     * Adds categories to the space, or values to ones it has. `proposed`: shown to the person to
      * confirm, never filled before; a later call without it takes them.
      */
     putCategories(input: {
@@ -417,14 +417,14 @@ export interface PluginSpaceData {
     }): Promise<PluginSpacePage[]>;
     /** The space's files of a kind (`document` when left out), newest first. */
     files(space: string, kind?: "logo" | "asset" | "document" | "pattern"): Promise<PluginSpaceFile[]>;
-    /** One file of the space with its bytes: a price list someone dropped into Wissen. */
+    /** One file of the space with its bytes: a price list someone dropped into Knowledge. */
     readFile(space: string, fileId: string): Promise<PluginSpaceFile & {
         data: Uint8Array;
     }>;
     /** Takes out one key, or every item of the plugin in the space; what a person changed stays. */
     remove(space: string, key?: string): Promise<number>;
     /**
-     * Writes the Übersicht of values: of one, or of every value of a choice (or of every choice)
+     * Writes the summary of values: of one, or of every value of a choice (or of every choice)
      * that has three items or more. Returns how many were written. Costs a model call each.
      */
     summarize(space: string, category?: string, value?: string): Promise<number>;
@@ -1021,6 +1021,24 @@ export interface PluginServerApi {
     publicRef(): Promise<string>;
     /** A route for every tenant at once (one webhook of a service for all of them). */
     registerSharedRoute(route: PluginSharedRoute): void;
+    /**
+     * Keys the plugin holds across the runtime's tenants, each for one tenant at a time: a keyword
+     * on a number every tenant shares, who writes to it, a number a tenant connected. A shared
+     * route finds its tenant with `holder` and enters it with `inTenant`. Keys are the plugin's
+     * own, 1 to 200 characters.
+     */
+    claims: {
+        /** Takes `key` for the current tenant; false when another tenant holds it. */
+        take(key: string): Promise<boolean>;
+        /** Gives `key` to the current tenant, whoever held it. */
+        put(key: string): Promise<void>;
+        /** Gives up the current tenant's `key`; nothing when another tenant holds it. */
+        drop(key: string): Promise<void>;
+        /** The ref of the tenant that holds `key` (for `inTenant`), or null. Asked outside a tenant too. */
+        holder(key: string): Promise<string | null>;
+        /** Whether the current tenant holds `key`. */
+        mine(key: string): Promise<boolean>;
+    };
     /** The full address of a shared route, the same for every tenant. */
     sharedUrl(path: string): string;
     /**
@@ -1046,10 +1064,11 @@ export interface PluginServerApi {
         withdraw(): Promise<boolean>;
         /**
          * Books what the tenant's number carried, at the Manage-App's prices: `sms` by segment
-         * (sent or received), `call` by started minute. The same `key` twice books once.
+         * (sent or received), `call` by started minute, `whatsapp` by message sent. The same `key`
+         * twice books once.
          */
         book(input: {
-            kind: "sms" | "call";
+            kind: "sms" | "call" | "whatsapp";
             quantity: number;
             key: string;
             runId?: string | null;
@@ -1066,7 +1085,7 @@ export interface PluginServerApi {
     every(name: string, everyMs: number, handler: (tick: PluginTick) => void | Promise<void>): void;
     /** The space's search index, which `project_search` asks. */
     index: PluginIndex;
-    /** Wissen of a space: pages, tables and files the plugin writes, with their Kategorien. */
+    /** Knowledge of a space: pages, tables and files the plugin writes, with their categories. */
     spaceData: PluginSpaceData;
     spaces: {
         /** The space's brand, of the current tenant; null for a space it does not have. */

package/node_modules/@engenty-wizards/plugin-sdk/dist/studio.d.ts

@@ -57,8 +57,8 @@ export interface StudioSpaceSection {
     component: ComponentType;
 }
 /**
- * A part of the space page of the plugin's own, beside Info & Marke, Wissen, Daten and
- * Ergebnisse: an entry in the parts' menu and a page at `/space/<id>`. The component draws the
+ * A part of the space page of the plugin's own, beside Info & brand, Knowledge, Data and
+ * Results: an entry in the parts' menu and a page at `/space/<id>`. The component draws the
  * whole part; `useSpaceMenu` fills the part's menu with what it draws.
  */
 export interface StudioSpacePart {
@@ -159,7 +159,7 @@ export interface StudioAssistantCard {
     tool: string;
     component: ComponentType<StudioAssistantCardProps<any>>;
 }
-/** A space's brand as Info & Marke has it: what a plugin draws in its look. */
+/** A space's brand as Info & brand has it: what a plugin draws in its look. */
 export interface StudioBrand {
     /** The title end users see. */
     name: string;