@opencxh/domain 1.188.0 → 1.191.0

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

@@ -0,0 +1,99 @@
+import { LocaleBundle } from '../entities/analytics/dashboard';
+import { NotificationText } from './notification';
+/**
+ * Role group of an app that reports what currently needs someone's attention.
+ *
+ * A constant and not a literal at both ends: `Bridge.providers.list` answers an unknown group
+ * with an empty list, so a typo would read as "nothing needs attention".
+ */
+export declare const ASSIST_SOURCE_PROVIDER_GROUP = "assist-source";
+/**
+ * One thing that needs attention now, as the app that owns it sees it.
+ *
+ * Declared by the owner rather than derived centrally: only comms knows that an unanswered
+ * first reply is worse than an unread newsletter, and only `apps/work` knows that `closedAt`
+ * and not a status name decides whether an item is done. A hub that scored this itself would
+ * need every app's types.
+ */
+export interface AssistNudge {
+    /** `<app>.<thing>` — the prefix is the owner, as with memory kinds and dossier keys. */
+    id: string;
+    /** Short label: "SLA", "Over tijd", "Straks". Bare i18n key; the hub stamps the namespace. */
+    tag: string;
+    /** Lucide icon name. */
+    icon?: string;
+    /** One line, in the owner's words. */
+    text: NotificationText;
+    /** The assignment that handles this — fills the launcher, or the agent's procedure. */
+    ask: NotificationText;
+    /** What it is about, as `<kind>:<ref>`. Also the scope the walkthrough's composer writes to. */
+    subjectKey?: string;
+    /** Higher sorts earlier. The source ranks its own; the hub only merges. */
+    priority?: number;
+    /**
+     * Where "open it" goes. `/…` follows the kernel router, `https://…` opens a tab — the same
+     * convention `AiToolResult.sources` uses.
+     */
+    url?: string;
+    /**
+     * Where "later" posts `{ remindAt }`, as an invoke action
+     * (`communication.interaction.<id>.remind`).
+     *
+     * The owner names the route rather than the board deriving one, because parking checks the
+     * resource's own ACL and only the owning app has it. A source without such a route omits this
+     * and simply gets no "later" button — better than a button that always fails.
+     */
+    snoozeAction?: string;
+    /**
+     * Federated resource that draws this nudge's body in the queue, as `"<app>:<Component>"`.
+     *
+     * Absent = the queue falls back to `text` plus a button to `url`, so a source that never
+     * adopts this keeps working. The component is handed `{ nudge, onHandled }`.
+     */
+    resource?: string;
+    /**
+     * Where "done" posts, as an invoke action. Same reasoning as `snoozeAction`: only the owning
+     * app knows what done means (comms closes, work leaves the status ladder) and only it holds
+     * the ACL. A source without such a route omits this and gets no "done" button.
+     */
+    resolveAction?: string;
+}
+/** A fixed starting point, offered even when nothing needs attention. */
+export interface AssistStarter {
+    id: string;
+    label: NotificationText;
+    sub?: NotificationText;
+    icon?: string;
+    ask: NotificationText;
+    /**
+     * Whether this sets an agent to work or just asks something. The source knows — "handle the
+     * SLA conversations" is work, "summarise my open threads" is a question — and guessing it
+     * from the wording is the classify step the launcher deliberately does not have. Absent
+     * counts as `"task"`: a nudge is always something to be done.
+     */
+    mode?: "chat" | "task";
+}
+/**
+ * Bare payload of `GET /provider/assist/describe` — not wrapped in `ResponseFactory`, the way
+ * every fan-out in this repo reads a describe.
+ *
+ * User-scoped: the hub calls it with an acting identity, because a nudge is per person.
+ */
+export interface AssistSourceDescribe {
+    /** The declaring app (== manifest name == `req.source.app`). */
+    source: string;
+    nudges: AssistNudge[];
+    starters: AssistStarter[];
+    /** Texts for every key above, in every language this app ships. `flattenLocales()` helps. */
+    locales?: LocaleBundle;
+}
+/** Every source's answer, merged. */
+export interface AssistBoard {
+    nudges: AssistNudge[];
+    starters: AssistStarter[];
+    /** Which apps answered. */
+    sources: string[];
+    locales: LocaleBundle;
+    /** Apps that answered nothing. Silence is not an answer, so it is named. */
+    degradedApps: string[];
+}

package/dist/platform/attention.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The primitives both attention scorers share.
+ *
+ * Here rather than in one of them, so `apps/work` can score its items without importing
+ * interaction types and vice versa: each app owns one half and neither owns the other.
+ */
+/** Score of something that must not surface at all. Filter with a single `> INELIGIBLE`. */
+export declare const INELIGIBLE: number;
+/** Priority weight, shared by interactions and work items. */
+export declare const W_PRIORITY: Record<"urgent" | "high" | "normal" | "low", number>;
+export interface Scored {
+    score: number;
+    /** Human-readable contributors, insertion order. Drives the tag on an assist nudge. */
+    reasons: string[];
+}
+/** One user's own "later" mark on a resource, as both scorers read it. */
+export interface ParkMark {
+    remindAt: number;
+    parkedAt: number;
+}
+export interface AttentionCtx {
+    /** Whose attention. Drives the unseen + assigned-to-me boosts. */
+    userId: string;
+    /** Epoch-ms "now", injected so scoring stays pure and testable. */
+    now: number;
+    /** Personally parked: resourceId -> own mark. */
+    remindersById?: Record<string, ParkMark>;
+}

package/dist/platform/attention.test.d.ts

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

package/dist/platform/permission.d.ts

@@ -13,9 +13,10 @@
  * later for seeding roles.
  */
 export declare const APP_PERMISSIONS: {
-    readonly ai: readonly ["account.read", "account.write", "agent.read", "agent.write", "assignment.read", "budget.read", "budget.write", "connector.read", "connector.write", "context.read", "context.write", "conversation.read", "conversation.write", "lens.read", "lens.write", "message.read", "message.write", "playbook.read", "playbook.write", "profile.read", "profile.write", "run.read", "run.write", "settings.read", "settings.write", "tool.read", "transcript.write", "usage.read"];
+    readonly ai: readonly ["account.read", "account.write", "agent.read", "agent.write", "assignment.read", "assignment.write", "budget.read", "budget.write", "connector.read", "connector.write", "context.read", "context.write", "conversation.read", "conversation.write", "lens.read", "lens.write", "message.read", "message.write", "playbook.read", "playbook.write", "profile.read", "profile.write", "run.read", "run.write", "settings.read", "settings.write", "tool.read", "transcript.write", "usage.read"];
     readonly analytics: readonly ["report.read"];
     readonly "app-store": readonly ["app.publish", "app.read", "app.write", "setting.read", "setting.write"];
+    readonly assist: readonly ["board.read"];
     readonly automations: readonly ["sync.read", "sync.write", "webhook.read", "webhook.write"];
     readonly communication: readonly ["account.read", "account.write", "activity-type.read", "activity.read", "activity.write", "attachment.read", "attribute.read", "attribute.write", "calendar.read", "calendar.write", "channel.read", "channel.write", "custom-field.read", "custom-field.write", "folder.read", "folder.write", "inbox.read", "inbox.write", "interaction.read", "interaction.write", "reminder.read", "template.read", "template.write", "topic.read", "topic.write"];
     readonly context: readonly ["kind.read", "kind.write", "memory.read", "memory.write"];

package/dist/platform/routing.d.ts

@@ -28,6 +28,15 @@ export interface RouteDefinition {
      * still authenticated unless it opts out with `{ authenticated: false }`.
      */
     public?: boolean;
+    /**
+     * `"none"` drops the navigation column for this route: the content card gets the whole
+     * backdrop. For a surface you work *through* rather than navigate — the Assist queue — where
+     * a column listing where else you could be is the one thing it is trying to remove.
+     *
+     * The tools rail and the card itself stay; this is not the chromeless treatment `public` gets,
+     * which hands the page to somebody else's brand entirely.
+     */
+    chrome?: "none";
 }
 export interface NamespacedRouteDefinition extends RouteDefinition {
     appName: string;

package/package.json

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