@opencxh/domain 1.260.0 → 1.263.0

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

@@ -89,7 +89,7 @@ export interface ToolSource {
     /** A second line: a snippet, a date, an author. */
     detail?: string;
     /**
-     * Where to open this source. Two forms, told apart by their first character:
+     * Where to open this source. Three forms, told apart by their prefix:
      *
      * - **`/…`** — a shell-absolute in-product route, including the `/apps/<app>`
      *   prefix, since the source may well belong to a different app than the one
@@ -101,6 +101,10 @@ export interface ToolSource {
      *   A Shopify order lives in Shopify's admin and nowhere here; pretending
      *   otherwise would mean either a dead in-product link or dropping the only
      *   address the thing has.
+     * - **`settings:<pageId>`** — a settings page, opened in the overlay. Such a
+     *   page has no route of its own; `sdk.ui.showSettings(pageId)` is the only
+     *   way in. Without this form a source that lives in settings can be named
+     *   but not reached.
      *
      * Absent when the thing has no page at all — a memory item, for instance —
      * which is a reason to show it without a link, not a reason to hide it.

package/dist/platform/resource-source.d.ts

@@ -134,6 +134,38 @@ export declare function resourceKindOf(scopeKey: string): string;
  */
 export declare const SCOPE_RELATED_ROUTE = "/provider/scope/related";
 export declare const SCOPE_READ_ROUTE = "/provider/scope/read";
+/**
+ * **What can be guarded** on the kinds this app owns: the third optional route on the `scope`
+ * role, on the same terms as the two above — an app that does not implement it offers no acts,
+ * never an error.
+ *
+ * It exists because the alternative was a text field. An approval rule names an act
+ * (`issue`, `status:scheduled`), and only the owning app knows which acts it actually guards —
+ * and for `work` that list is not even static: it is one entry per status in every project
+ * ladder. A screen cannot hold that list and a person should not have to type it.
+ */
+export declare const SCOPE_ACTS_ROUTE = "/provider/scope/acts";
+/** One thing that can be made to need a signature. */
+export interface GuardableAct {
+    /** The scope kind it applies to: `"quote"`, `"work_item"`. */
+    kind: string;
+    /** What the owning app calls it when it asks the gate: `"issue"`, `"status:scheduled"`. */
+    act: string;
+    /**
+     * What it is called on a settings screen, already rendered.
+     *
+     * A string and not an i18n key: `work` composes these from statuses an organisation named
+     * itself ("Ingepland"), so there is no key to stamp — and the two halves of one list must not
+     * be localised by different rules.
+     */
+    label: string;
+    /** What the kind is called, same reasoning. Repeated per row so the caller need not join. */
+    kindLabel?: string;
+}
+/** Bare payload of {@link SCOPE_ACTS_ROUTE}, like every describe in this repo. */
+export interface ScopeActsResponse {
+    acts: GuardableAct[];
+}
 /**
  * One explicit link between two resources, stored by apps/context.
  *

package/package.json

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