@opencxh/domain 1.286.2 → 1.287.0

package/dist/platform/ai-tools.d.ts

@@ -194,6 +194,16 @@ export interface AiToolDescriptor extends AiTool {
         param: string;
         kind: string;
     };
+    /**
+     * The route permission this tool stands in for, e.g. `{ app: "organization", action:
+     * "settings.write" }`. Checked against the grants on the invoke request; a call that carries
+     * none (an agent run has no session) is refused. Declare it on any tool that writes beyond one
+     * resource, which `scope` cannot authorize.
+     */
+    permission?: {
+        app: string;
+        action: string;
+    };
     /**
      * `"interactive"` = this tool needs a watching user, because it delivers to a client surface (an
      * SSE to an open window, say) instead of persisting something. Unattended runs are not offered

package/dist/platform/coded-message.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A server error message a client can translate: English text first (readable in logs and for API
+ * consumers), then a bracketed code and its params — `"Line 3 has no quantity [line_quantity line=3]"`.
+ *
+ * In the message and not in a separate field because the message is the one part of an error both
+ * transports are known to deliver. The client looks up `error_<code>` in the app's translations
+ * and falls back to the text; `{name}` placeholders use the same syntax as `t()`.
+ */
+export declare function codedMessage(code: string, template: string, params?: Record<string, string | number>): string;
+/** The inverse of {@link codedMessage}. A plain message comes back as `{ text }`. */
+export declare function parseCodedMessage(message: string): {
+    text: string;
+    code?: string;
+    params: Record<string, string>;
+};

package/dist/platform/coded-message.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/platform/ui.d.ts

@@ -105,6 +105,12 @@ export interface SettingsPageConfig {
      * fallback is only there for apps that have not caught up.
      */
     category?: SettingsCategory;
+    /**
+     * Pages sharing a collection are one row in the settings nav, opening a page that lists them —
+     * for pages you set once and rarely reopen (tax rates, number series). Pages from several apps
+     * may share one. The label is the shell's (`global:settings_collection_<key>`), like a category.
+     */
+    collection?: string;
     icon?: string;
     resource: string;
     order?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.286.2",
+  "version": "1.287.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",