@opencxh/domain 1.123.0 → 1.125.0

package/dist/entities/activity/types.d.ts

@@ -1,3 +1,4 @@
+import { ActingIdentity } from '../../platform/identity';
 import { AIMessageInput, AIMessageOutput } from '../ai-message/types';
 import { TranscriptSegment } from '../../platform/media';
 export type CallStatus = "new" | "connecting" | "ringing" | "connected" | "held" | "ended" | "failed";
@@ -198,6 +199,8 @@ export type AIActionProposedPayload = {
         params?: Record<string, unknown>;
     }[];
     status: "pending" | "approved" | "rejected";
+    /** Namens wie het voorstel is gedaan, zodat de kaart "namens Finance" kan tonen. */
+    actor?: ActingIdentity;
 };
 /** Playbook lifecycle marker in the interaction timeline (system-authored). */
 export type PlaybookLifecyclePayload = {
@@ -205,6 +208,8 @@ export type PlaybookLifecyclePayload = {
     playbookId?: string;
     playbookName?: string;
     status?: string;
+    /** Namens wie de run handelde; voorkomt dat de UI de playbook opnieuw moet ophalen. */
+    actor?: ActingIdentity;
 };
 export type Activity = (BaseActivity & {
     type: "VOICE_CALL_STARTED";

package/dist/entities/playbook/actor.d.ts

@@ -0,0 +1,16 @@
+import { ActingIdentity } from '../../platform/identity';
+import { OwnerScope } from '../contact/types';
+/**
+ * `ownerScope` **is** de actor van een playbook: er is geen apart `runAs`-veld.
+ * Zichtbaarheid, werkgebied en toeschrijving volgen dus uit hetzelfde veld.
+ *
+ * Aan de bewaarkant heet de persoonlijke variant `personal` (zoals bij elke andere
+ * entity), aan de uitvoerkant `user` (zoals elke andere acting identity). Deze
+ * functie is die vertaling, en de enige plek waar hij hoort.
+ */
+export declare function playbookActor(scope: OwnerScope): ActingIdentity;
+/**
+ * Stabiele sleutel om actors te groeperen. Tien playbooks van hetzelfde team horen
+ * één autorisatie-call te kosten, niet tien.
+ */
+export declare function actorKey(actor: ActingIdentity): string;

package/dist/entities/playbook/index.d.ts

@@ -1 +1,4 @@
+export * from './labels';
+export * from './trigger-vars';
+export * from './actor';
 export * from './types';

package/dist/entities/playbook/labels.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Leesbare naam van een actie/tool voor een mens: `tool:communication__update_interaction`
+ * wordt `communication · update interaction`.
+ *
+ * Gedeeld, want de proposal-kaart in comms had deze helper al terwijl de run-timeline in
+ * de AI-app de rauwe id printte — dus daar las je letterlijk
+ * `voorstel: tool:mcp__jira__create_issue`.
+ */
+export declare function humanizeAction(action: string): string;

package/dist/entities/playbook/trigger-vars.d.ts

@@ -0,0 +1,61 @@
+/**
+ * De variabelen die de engine onder `vars.trigger` zet bij een activity-trigger.
+ *
+ * Contract tussen `buildTriggerVars` (server) en de variabelen-picker (builder). Die
+ * twee waren uiteengelopen: de picker bood `trigger.fromEmail` en `trigger.channel`
+ * aan — die bestaan niet — en miste `subject`, `textRaw`, `direction`, `authorType` en
+ * `activityId`. Elk pad dat hij aanbood leverde dus `undefined` op. Eén lijst, aan
+ * beide kanten geïmporteerd, kan niet opnieuw uiteenlopen.
+ */
+export declare const TRIGGER_VARS: readonly [{
+    readonly name: "text";
+    readonly type: "string";
+}, {
+    readonly name: "subject";
+    readonly type: "string";
+}, {
+    readonly name: "from";
+    readonly type: "string";
+}, {
+    readonly name: "type";
+    readonly type: "string";
+}, {
+    readonly name: "direction";
+    readonly type: "string";
+}, {
+    readonly name: "channelId";
+    readonly type: "string";
+}, {
+    readonly name: "interactionId";
+    readonly type: "string";
+}, {
+    readonly name: "activityId";
+    readonly type: "string";
+}, {
+    readonly name: "authorType";
+    readonly type: "string";
+}, {
+    readonly name: "authorName";
+    readonly type: "string";
+}, {
+    readonly name: "textRaw";
+    readonly type: "string";
+}];
+/** De variabelen die een classify-stap oplevert, per mode. */
+export declare const CLASSIFY_VARS: {
+    readonly topics: readonly [{
+        readonly name: "topic";
+        readonly type: "string";
+    }, {
+        readonly name: "confidence";
+        readonly type: "number";
+    }];
+    readonly question: readonly [{
+        readonly name: "answer";
+        readonly type: "boolean";
+    }, {
+        readonly name: "confidence";
+        readonly type: "number";
+    }];
+    readonly extract: readonly [];
+};

package/dist/entities/playbook/types.d.ts

@@ -1,3 +1,4 @@
+import { ActingIdentity } from '../../platform/identity';
 import { OwnerScope } from '../contact/types';
 /**
  * Playbooks — event-driven automation with AI steps. See docs/PLAYBOOKS.md.
@@ -19,7 +20,6 @@ export type PlaybookTrigger = {
 export interface Guardrails {
     maxSteps?: number;
     maxToolCalls?: number;
-    policyCaps?: Record<string, unknown>;
 }
 export interface ConditionStep {
     type: "condition";
@@ -102,7 +102,24 @@ export interface Playbook {
         autoActions: number;
     };
 }
-export type RunStatus = "pending" | "running" | "awaiting_approval" | "awaiting_reply" | "done" | "escalated" | "failed" | "timed_out" | "stopped";
+/**
+ * Levenscyclus van een run. Geen `pending`: runs worden ingevoegd als `running` en
+ * de `PLAYBOOK_STARTED`-activity dekt "hij is begonnen" al. (Die status bestond,
+ * werd nooit geproduceerd, en had wél een label in de UI.)
+ */
+export type RunStatus = "running" | "awaiting_approval" | "awaiting_reply" | "done" | "escalated" | "failed" | "timed_out" | "stopped";
+/** Eindstanden: hier komt een run niet meer vanzelf uit. */
+export declare const TERMINAL_RUN_STATUSES: readonly ["done", "escalated", "failed", "timed_out", "stopped"];
+/** Wacht deze run op iets externs? */
+export declare const PAUSED_RUN_STATUSES: readonly ["awaiting_approval", "awaiting_reply"];
+export declare function isTerminal(status: RunStatus | string): boolean;
+/**
+ * Statussen waarvan een run opnieuw gestart mag worden. Een lopende of
+ * mens-gepauzeerde run blijft met rust, zodat een retry nooit over live uitvoering
+ * heen loopt of een openstaand voorstel overschrijft — vandaar: precies de eindstanden.
+ */
+export declare function isRetryable(status: RunStatus | string): boolean;
+export declare function isPaused(status: RunStatus | string): boolean;
 export interface RunStepTrace {
     path: string;
     type: string;
@@ -126,29 +143,38 @@ export interface PlaybookRun {
     trace: RunStepTrace[];
     /** Snapshot of the playbook steps at run start — version-pinned resume (docs 11.4). */
     steps?: Step[];
-    /** Held action(s) awaiting human approval (autonomy: suggest) — a batch per paused step. */
+    /**
+     * Namens wie deze run handelt, vastgepind bij de start — net als `steps`. Anders
+     * wisselt een lopende of geparkeerde run stilletjes van identiteit zodra iemand de
+     * playbook van "Alleen ik" naar "Team Finance" zet. `resume`/`retry` lezen dit veld,
+     * niet `playbook.ownerScope`.
+     */
+    actor?: ActingIdentity;
+    /**
+     * Held action(s) awaiting human approval (autonomy: suggest) — a batch per paused
+     * step. `null` wanneer het veld gewist is; de store schrijft `null`, dus dat staat
+     * ook in het type in plaats van dat elke lezer drie toestanden moet aankunnen.
+     */
     pending?: {
-        stepIndex: number;
-        actions: {
-            action: string;
-            params: Record<string, unknown>;
-        }[];
-    };
+        action: string;
+        params: Record<string, unknown>;
+    }[] | null;
     /** The AI_ACTION_PROPOSED activity created for the current pending batch (for resolve on approve/reject). */
-    proposalActivityId?: string;
-    /** Parked run (awaiting_reply): where to continue + correlation + round counter. */
-    awaitFor?: {
-        interactionId?: string;
-    };
-    resumeIndex?: number;
+    proposalActivityId?: string | null;
+    /**
+     * Index van de stap waarop de flow pauzeerde — voor zowel `awaiting_approval` als
+     * `awaiting_reply`. (Was `resumeIndex` naast `pending.stepIndex`: twee velden voor
+     * hetzelfde feit, in twee takken geschreven en in twee takken gelezen.)
+     */
+    pausedAt?: number | null;
     rounds?: number;
     /** Denormalized interaction audience for efficient list-filtering. */
     audience?: string[];
     createdBy: string;
-    approvedBy?: string;
+    approvedBy?: string | null;
     result?: {
         ok: boolean;
         error?: string;
-    };
+    } | null;
     lastStepAt?: number;
 }

package/dist/index.cjs

@@ -1,10 +1,10 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=140;function A(e){return e.replace(/<style[\s\S]*?<\/style>/gi," ").replace(/<script[\s\S]*?<\/script>/gi," ").replace(/<[^>]+>/g," ").replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/\s+/g," ").trim()}function D(e){const t=e.trim();return t.length<=c?t:t.slice(0,c-1).trimEnd()+"…"}function l(e){if(!e||e<0)return"";const t=Math.floor(e/60),n=Math.floor(e%60);return`${t}:${n.toString().padStart(2,"0")}`}function O(e){switch(e.type){case"EMAIL_RECEIVED":case"EMAIL_SENT":{const t=e.payload,n=t.bodySnippet?.trim()||A(t.body??"");return t.subject?`${t.subject} — ${n}`:n}case"CHAT_MESSAGE_SENT":case"CHAT_MESSAGE_RECEIVED":return e.payload.text??"";case"CHAT_RENAMED":return`Hernoemd naar "${e.payload.newName}"`;case"CHAT_MEMBER_JOINED":return`${e.payload.members.map(t=>t.name).join(", ")} toegevoegd`;case"CHAT_MEMBER_LEFT":return`${e.payload.members.map(t=>t.name).join(", ")} verlaten`;case"CHAT_CALL_STARTED":return"Gesprek gestart";case"CHAT_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${l(e.payload.duration)})`:""}`;case"CHAT_EVENT":return e.payload.text??e.payload.eventType;case"VOICE_CALL_STARTED":case"VIDEO_CALL_STARTED":return"Gesprek gestart";case"VOICE_CALL_ANSWERED":case"VIDEO_CALL_ANSWERED":return"Gesprek aangenomen";case"VOICE_CALL_HOLD":case"VIDEO_CALL_HOLD":return"In de wacht";case"VOICE_CALL_UNHOLD":case"VIDEO_CALL_UNHOLD":return"Hervat";case"VOICE_CALL_ENDED":case"VIDEO_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${l(e.payload.duration)})`:""}`;case"VOICE_CALL_MISSED":case"VIDEO_CALL_MISSED":return"Gemiste oproep";case"VOICE_CALL_FAILED":case"VIDEO_CALL_FAILED":return"Gesprek mislukt";case"VOICE_CALL_VOICEMAIL":return e.payload.transcription?.trim()?e.payload.transcription:"Voicemail ontvangen";case"TRANSCRIPT_ADDED":return(e.payload.segments??[]).map(t=>t.text).join(" ");case"AI_MESSAGE_ADDED":return e.payload.output?.text??e.payload.input?.text??"";case"AI_ACTION_PROPOSED":return`Voorstel wacht op goedkeuring (${e.payload.actions?.length??0} actie(s))`;case"PLAYBOOK_STARTED":return`Playbook gestart${e.payload.playbookName?`: ${e.payload.playbookName}`:""}`;case"PLAYBOOK_COMPLETED":return"Playbook afgerond";case"PLAYBOOK_ESCALATED":return"Playbook geëscaleerd naar een mens";case"MEETING_SCHEDULED":return`Vergadering gepland: ${e.payload.title}`;case"MEETING_STARTED":return`Vergadering gestart: ${e.payload.title}`;case"MEETING_ENDED":return`Vergadering beëindigd${e.payload.duration?` (${l(e.payload.duration)})`:""}`;case"MEETING_PARTICIPANT_JOINED":return`${e.payload.name} deelgenomen`;case"MEETING_PARTICIPANT_LEFT":return`${e.payload.name} verlaten`;case"COMMENT_ADDED":return e.payload.text??"";case"FILE_UPLOADED":return`Bestand: ${e.payload.fileName}`;case"INTERACTION_CREATED":return"Interactie aangemaakt";case"INTERACTION_STATUS_CHANGED":return`Status: ${e.payload.fromStatus} → ${e.payload.toStatus}`;case"INTERACTION_ASSIGNED":return"Interactie toegewezen";default:return""}}function L(e){return{activityId:e.id,type:e.type,snippet:D(O(e)),authorName:e.author?.name??"",direction:e.direction,createdAt:e.createdAt??Date.now()}}function M(e,t,n=[]){const r=e.createdAt;if(!r)return[];const s=new Set(n);return e.author.type==="user"&&e.author.id&&s.add(e.author.id),Object.entries(t).filter(([a,o])=>o>=r&&!s.has(a)).map(([a])=>a)}const C=[{id:"agent",label:"Agent",labelSource:"user"},{id:"team",label:"Team",labelSource:"team"},{id:"inbox",label:"Inbox",labelSource:"inbox"},{id:"channel",label:"Kanaal",labelSource:"channel"},{id:"provider",label:"Provider",labelSource:"raw"},{id:"status",label:"Status",labelSource:"raw"},{id:"handledBy",label:"Afhandelaar",labelSource:"raw"},{id:"time",label:"Tijd",labelSource:"raw"}];function m(e){const t=[];for(const n of Object.keys(e))for(const r of Object.keys(e[n]))t.push({lang:n,key:r,value:e[n][r]});return t}function i(e){return e<10?`0${e}`:`${e}`}function g(e,t){const n=new Date(e),r=`${n.getUTCFullYear()}-${i(n.getUTCMonth()+1)}-${i(n.getUTCDate())}`;return t==="day"?r:`${r}T${i(n.getUTCHours())}`}function _(e,t){const n=new Date(e);return n.setUTCMinutes(0,0,0),t==="day"&&n.setUTCHours(0),n.getTime()}const h=36e5,y=864e5;function P(e,t,n){const r=n==="hour"?h:y,s=[];for(let a=_(e,n);a<=t;a+=r)s.push(g(a,n));return s}const U=new Set(["mail","message"]);function I(e,t){const n=e.settings?.signatures?.[t];return!n||!n.enabled||!n.body||n.body.trim()===""?null:n}function $(e,t,n,r="html"){if(!e)return n;const s=I(e,t);return s?`${n}${r==="text"?`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=140;function g(e){return e.replace(/<style[\s\S]*?<\/style>/gi," ").replace(/<script[\s\S]*?<\/script>/gi," ").replace(/<[^>]+>/g," ").replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/\s+/g," ").trim()}function M(e){const t=e.trim();return t.length<=c?t:t.slice(0,c-1).trimEnd()+"…"}function i(e){if(!e||e<0)return"";const t=Math.floor(e/60),n=Math.floor(e%60);return`${t}:${n.toString().padStart(2,"0")}`}function C(e){switch(e.type){case"EMAIL_RECEIVED":case"EMAIL_SENT":{const t=e.payload,n=t.bodySnippet?.trim()||g(t.body??"");return t.subject?`${t.subject} — ${n}`:n}case"CHAT_MESSAGE_SENT":case"CHAT_MESSAGE_RECEIVED":return e.payload.text??"";case"CHAT_RENAMED":return`Hernoemd naar "${e.payload.newName}"`;case"CHAT_MEMBER_JOINED":return`${e.payload.members.map(t=>t.name).join(", ")} toegevoegd`;case"CHAT_MEMBER_LEFT":return`${e.payload.members.map(t=>t.name).join(", ")} verlaten`;case"CHAT_CALL_STARTED":return"Gesprek gestart";case"CHAT_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${i(e.payload.duration)})`:""}`;case"CHAT_EVENT":return e.payload.text??e.payload.eventType;case"VOICE_CALL_STARTED":case"VIDEO_CALL_STARTED":return"Gesprek gestart";case"VOICE_CALL_ANSWERED":case"VIDEO_CALL_ANSWERED":return"Gesprek aangenomen";case"VOICE_CALL_HOLD":case"VIDEO_CALL_HOLD":return"In de wacht";case"VOICE_CALL_UNHOLD":case"VIDEO_CALL_UNHOLD":return"Hervat";case"VOICE_CALL_ENDED":case"VIDEO_CALL_ENDED":return`Gesprek beëindigd${e.payload.duration?` (${i(e.payload.duration)})`:""}`;case"VOICE_CALL_MISSED":case"VIDEO_CALL_MISSED":return"Gemiste oproep";case"VOICE_CALL_FAILED":case"VIDEO_CALL_FAILED":return"Gesprek mislukt";case"VOICE_CALL_VOICEMAIL":return e.payload.transcription?.trim()?e.payload.transcription:"Voicemail ontvangen";case"TRANSCRIPT_ADDED":return(e.payload.segments??[]).map(t=>t.text).join(" ");case"AI_MESSAGE_ADDED":return e.payload.output?.text??e.payload.input?.text??"";case"AI_ACTION_PROPOSED":return`Voorstel wacht op goedkeuring (${e.payload.actions?.length??0} actie(s))`;case"PLAYBOOK_STARTED":return`Playbook gestart${e.payload.playbookName?`: ${e.payload.playbookName}`:""}`;case"PLAYBOOK_COMPLETED":return"Playbook afgerond";case"PLAYBOOK_ESCALATED":return"Playbook geëscaleerd naar een mens";case"MEETING_SCHEDULED":return`Vergadering gepland: ${e.payload.title}`;case"MEETING_STARTED":return`Vergadering gestart: ${e.payload.title}`;case"MEETING_ENDED":return`Vergadering beëindigd${e.payload.duration?` (${i(e.payload.duration)})`:""}`;case"MEETING_PARTICIPANT_JOINED":return`${e.payload.name} deelgenomen`;case"MEETING_PARTICIPANT_LEFT":return`${e.payload.name} verlaten`;case"COMMENT_ADDED":return e.payload.text??"";case"FILE_UPLOADED":return`Bestand: ${e.payload.fileName}`;case"INTERACTION_CREATED":return"Interactie aangemaakt";case"INTERACTION_STATUS_CHANGED":return`Status: ${e.payload.fromStatus} → ${e.payload.toStatus}`;case"INTERACTION_ASSIGNED":return"Interactie toegewezen";default:return""}}function h(e){return{activityId:e.id,type:e.type,snippet:M(C(e)),authorName:e.author?.name??"",direction:e.direction,createdAt:e.createdAt??Date.now()}}function U(e,t,n=[]){const r=e.createdAt;if(!r)return[];const s=new Set(n);return e.author.type==="user"&&e.author.id&&s.add(e.author.id),Object.entries(t).filter(([a,o])=>o>=r&&!s.has(a)).map(([a])=>a)}const P=[{id:"agent",label:"Agent",labelSource:"user"},{id:"team",label:"Team",labelSource:"team"},{id:"inbox",label:"Inbox",labelSource:"inbox"},{id:"channel",label:"Kanaal",labelSource:"channel"},{id:"provider",label:"Provider",labelSource:"raw"},{id:"status",label:"Status",labelSource:"raw"},{id:"handledBy",label:"Afhandelaar",labelSource:"raw"},{id:"time",label:"Tijd",labelSource:"raw"}];function $(e){const t=[];for(const n of Object.keys(e))for(const r of Object.keys(e[n]))t.push({lang:n,key:r,value:e[n][r]});return t}function l(e){return e<10?`0${e}`:`${e}`}function A(e,t){const n=new Date(e),r=`${n.getUTCFullYear()}-${l(n.getUTCMonth()+1)}-${l(n.getUTCDate())}`;return t==="day"?r:`${r}T${l(n.getUTCHours())}`}function f(e,t){const n=new Date(e);return n.setUTCMinutes(0,0,0),t==="day"&&n.setUTCHours(0),n.getTime()}const k=36e5,G=864e5;function V(e,t,n){const r=n==="hour"?k:G,s=[];for(let a=f(e,n);a<=t;a+=r)s.push(A(a,n));return s}function H(e){return(e.startsWith("tool:")?e.slice(5):e).replace(/__/g," · ").replace(/\./g," · ").replace(/_/g," ")}const w=[{name:"text",type:"string"},{name:"subject",type:"string"},{name:"from",type:"string"},{name:"type",type:"string"},{name:"direction",type:"string"},{name:"channelId",type:"string"},{name:"interactionId",type:"string"},{name:"activityId",type:"string"},{name:"authorType",type:"string"},{name:"authorName",type:"string"},{name:"textRaw",type:"string"}],F={topics:[{name:"topic",type:"string"},{name:"confidence",type:"number"}],question:[{name:"answer",type:"boolean"},{name:"confidence",type:"number"}],extract:[]};function I(e){switch(e.kind){case"user":return`user:${e.userId}`;case"team":return`team:${e.teamId}`;case"org":return"org"}}function x(e){if(typeof e!="string")return;const t=e.trim();if(t==="org")return{kind:"org"};const n=t.indexOf(":");if(n<=0)return;const r=t.slice(0,n),s=t.slice(n+1).trim();if(s){if(r==="user")return{kind:"user",userId:s};if(r==="team")return{kind:"team",teamId:s}}}function _(e){return I(e)}function B(e){switch(e.kind){case"personal":return{kind:"user",userId:e.userId};case"team":return{kind:"team",teamId:e.teamId};case"org":return{kind:"org"}}}function j(e){return _(e)}const S=["done","escalated","failed","timed_out","stopped"],T=["awaiting_approval","awaiting_reply"];function m(e){return S.includes(e)}function W(e){return m(e)}function K(e){return T.includes(e)}const Y=new Set(["mail","message"]);function R(e,t){const n=e.settings?.signatures?.[t];return!n||!n.enabled||!n.body||n.body.trim()===""?null:n}function q(e,t,n,r="html"){if(!e)return n;const s=R(e,t);return s?`${n}${r==="text"?`
 
-`:t==="mail"?"<br><br>-- <br>":"<br><br>"}${s.body}`:n}function G(e){return e.endpoints??[]}const H=e=>!!e.assignedUserId||!!e.assignedInboxId,V=e=>e.status==="closed",k=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,w=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function B(e,t){return e.lastActivityAt?!(e.seenBy??[]).includes(t):!1}const F=[/<blockquote/i,/class="?gmail_quote/i,/id="?[^"]*divRplyFwdMsg/i,/id="?[^"]*mail-editor-reference-message-container/i,/-{3,}\s*Original Message\s*-{3,}/i,/\n_{5,}\s*\n/,/\bOn\b[\s\S]{0,200}?\bwrote:/i],u=/^\s*(?:>+\s*)?(?:from|van|sent|verzonden|to|aan|cc|subject|onderwerp|date|datum)\s*:/i,x=/^\s*(?:on|op)\b.{0,200}?\b(?:wrote|schreef|geschreven)\s*:?\s*$/i;function j(e){const t=e.split(`
-`);for(let n=0;n<t.length;n++)if(x.test(t[n])||u.test(t[n])&&t.slice(n+1,n+4).some(r=>u.test(r)))return t.slice(0,n).join(`
+`:t==="mail"?"<br><br>-- <br>":"<br><br>"}${s.body}`:n}function z(e){return e.endpoints??[]}const v=e=>!!e.assignedUserId||!!e.assignedInboxId,J=e=>e.status==="closed",Q=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,X=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function Z(e,t){return e.lastActivityAt?!(e.seenBy??[]).includes(t):!1}const ee=[/<blockquote/i,/class="?gmail_quote/i,/id="?[^"]*divRplyFwdMsg/i,/id="?[^"]*mail-editor-reference-message-container/i,/-{3,}\s*Original Message\s*-{3,}/i,/\n_{5,}\s*\n/,/\bOn\b[\s\S]{0,200}?\bwrote:/i],u=/^\s*(?:>+\s*)?(?:from|van|sent|verzonden|to|aan|cc|subject|onderwerp|date|datum)\s*:/i,te=/^\s*(?:on|op)\b.{0,200}?\b(?:wrote|schreef|geschreven)\s*:?\s*$/i;function ne(e){const t=e.split(`
+`);for(let n=0;n<t.length;n++)if(te.test(t[n])||u.test(t[n])&&t.slice(n+1,n+4).some(r=>u.test(r)))return t.slice(0,n).join(`
 `).trim();return e}function E(e){let t=e;return t=t.replace(/<(script|style)[\s\S]*?<\/\1>/gi,""),t=t.replace(/<br\s*\/?>/gi,`
 `),t=t.replace(/<\/(p|div|li|tr|h[1-6]|ul|ol|table)>/gi,`
 `),t=t.replace(/<[^>]+>/g,""),t=t.replace(/<[^>]*$/,""),t}function d(e){return e.replace(/&nbsp;/gi," ").replace(/&lt;/gi,"<").replace(/&gt;/gi,">").replace(/&quot;/gi,'"').replace(/&#39;/gi,"'").replace(/&#(\d+);/g,(t,n)=>String.fromCharCode(Number(n))).replace(/&amp;/gi,"&")}function p(e){return e.replace(/\r/g,"").replace(/[ \t]+/g," ").replace(/ *\n */g,`
 `).replace(/\n{3,}/g,`
 
-`).trim()}function W(e){if(typeof e!="string"||!e)return"";let t=e.length;for(const a of F){const o=e.search(a);o>=0&&o<t&&(t=o)}const n=e.slice(0,t);let r=p(d(E(n)));return r||(r=p(d(E(e)))),j(r)||r}const Y=/(^|[._+-])(no-?reply|noreply|donotreply|do-not-reply|newsletter|nieuwsbrief|mailer|mailing|notifications?|bounce|postmaster|marketing)@/i,K=/\b(unsubscribe|afmelden|uitschrijven|opt[\s-]?out|manage (your )?preferences|geen (e-?mails?|nieuwsbrief|berichten) meer)\b/i;function q(e,t){return!!(e&&Y.test(e)||t&&K.test(t))}const T=3,f=600;function z(e,t){return e>=T||t>=f}function S(e,t){const n=new Set(e.disabledIntents??[]),r=e.intentOverrides??{},s=t.intents.filter(o=>!n.has(o.intent)).map(o=>Q(o,r[o.intent]));if(!e.extraIntents||e.extraIntents.length===0)return s;const a=new Set(s.map(o=>o.intent));for(const o of e.extraIntents)a.has(o.intent)||(s.push(o),a.add(o.intent));return s}function b(e,t){const n={};for(const r of e.intents){if(!r.togglable)continue;const s=t?.[r.intent];n[r.intent]=s??r.defaultEnabled??!0}return n}function J(e,t){const n=b(e,t);return Object.entries(n).filter(([,r])=>!r).map(([r])=>r)}function Q(e,t){return t?{intent:t.intent??e.intent,targetSchemes:t.targetSchemes??e.targetSchemes,transport:t.transport??e.transport}:e}function X(e,t){const n=[];for(const r of e){if(!r.enabled)continue;const s=t[r.providerId];if(s)for(const a of S(r,s))n.push({channel:r,description:s,capability:a})}return n}function Z(e,t){return t.filter(n=>n.capability.intent===e)}function N(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function v(e,t){return N(e.scheme,t)}function ee(e,t,n){const r=[];for(const s of e)for(const a of n)a.capability.intent===t&&a.capability.targetSchemes.includes(s.scheme)&&r.push({channelIntent:a,endpoint:s});return r}var R=(e=>(e.MAILTO="mailto",e.SIP="sip",e.TEL="tel",e.WEBHOOK="webhook",e.USERNAME="username",e.ID="id",e.CUSTOM="custom",e.URL="url",e.TELEGRAM="telegram",e.WHATSAPP="whatsapp",e.MESSENGER="messenger",e.INSTAGRAM="instagram",e.VIBER="viber",e.SMS="sms",e.FAX="fax",e.TEAMS="teams",e.CALENDAR="calendar",e))(R||{});const te="message_window",ne="message_templates",re={FROM:"from",TO:"to",CC:"cc",BCC:"bcc",ORGANIZER:"organizer",PRESENTER:"presenter",ATTENDEE:"attendee",OWNER:"owner",MEMBER:"member",GUEST:"guest",HOST:"host",PARTICIPANT:"participant"},se=(e,t)=>({intent:e,...t}),ae="folder_management",oe="remote_search",le={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},ie=9e4,ce="installation-id";exports.CORE_DIMENSIONS=C;exports.CommunicationScheme=R;exports.FEATURE_FOLDER_MANAGEMENT=ae;exports.FEATURE_REMOTE_SEARCH=oe;exports.INSTALLATION_HEADER=ce;exports.InteractionParticipantRole=re;exports.PRESENCE_ONLINE_WINDOW_MS=ie;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=ne;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=te;exports.SIGNATURE_INTENTS=U;exports.SUMMARY_MIN_LAST_CHARS=f;exports.SUMMARY_MIN_MESSAGES=T;exports.UNSUPPORTED=le;exports.applySignature=$;exports.buildActivityPreview=L;exports.buildChannelIntents=X;exports.cleanMessageText=W;exports.defineIntent=se;exports.disabledIntentsFromCapabilities=J;exports.filterByEndpoint=v;exports.filterByIntent=Z;exports.filterByTargetScheme=N;exports.flattenLocales=m;exports.floorToPeriod=_;exports.formatPeriod=g;exports.getActivitySeenUserIds=M;exports.getContactEndpoints=G;exports.getShortTitle=w;exports.getUrgencyScore=k;exports.isAssigned=H;exports.isClosed=V;exports.isInteractionUnseen=B;exports.isLikelyBulk=q;exports.isThreadLongEnough=z;exports.matchContactToIntents=ee;exports.periodsInRange=P;exports.resolveAccountCapabilities=b;exports.resolveChannelIntents=S;exports.resolveSignature=I;exports.stripHtml=A;
+`).trim()}function re(e){if(typeof e!="string"||!e)return"";let t=e.length;for(const a of ee){const o=e.search(a);o>=0&&o<t&&(t=o)}const n=e.slice(0,t);let r=p(d(E(n)));return r||(r=p(d(E(e)))),ne(r)||r}const se=/(^|[._+-])(no-?reply|noreply|donotreply|do-not-reply|newsletter|nieuwsbrief|mailer|mailing|notifications?|bounce|postmaster|marketing)@/i,ae=/\b(unsubscribe|afmelden|uitschrijven|opt[\s-]?out|manage (your )?preferences|geen (e-?mails?|nieuwsbrief|berichten) meer)\b/i;function oe(e,t){return!!(e&&se.test(e)||t&&ae.test(t))}const b=3,N=600;function ie(e,t){return e>=b||t>=N}function D(e,t){const n=new Set(e.disabledIntents??[]),r=e.intentOverrides??{},s=t.intents.filter(o=>!n.has(o.intent)).map(o=>ce(o,r[o.intent]));if(!e.extraIntents||e.extraIntents.length===0)return s;const a=new Set(s.map(o=>o.intent));for(const o of e.extraIntents)a.has(o.intent)||(s.push(o),a.add(o.intent));return s}function y(e,t){const n={};for(const r of e.intents){if(!r.togglable)continue;const s=t?.[r.intent];n[r.intent]=s??r.defaultEnabled??!0}return n}function le(e,t){const n=y(e,t);return Object.entries(n).filter(([,r])=>!r).map(([r])=>r)}function ce(e,t){return t?{intent:t.intent??e.intent,targetSchemes:t.targetSchemes??e.targetSchemes,transport:t.transport??e.transport}:e}function ue(e,t){const n=[];for(const r of e){if(!r.enabled)continue;const s=t[r.providerId];if(s)for(const a of D(r,s))n.push({channel:r,description:s,capability:a})}return n}function Ee(e,t){return t.filter(n=>n.capability.intent===e)}function L(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function de(e,t){return L(e.scheme,t)}function pe(e,t,n){const r=[];for(const s of e)for(const a of n)a.capability.intent===t&&a.capability.targetSchemes.includes(s.scheme)&&r.push({channelIntent:a,endpoint:s});return r}var O=(e=>(e.MAILTO="mailto",e.SIP="sip",e.TEL="tel",e.WEBHOOK="webhook",e.USERNAME="username",e.ID="id",e.CUSTOM="custom",e.URL="url",e.TELEGRAM="telegram",e.WHATSAPP="whatsapp",e.MESSENGER="messenger",e.INSTAGRAM="instagram",e.VIBER="viber",e.SMS="sms",e.FAX="fax",e.TEAMS="teams",e.CALENDAR="calendar",e))(O||{});const ge="message_window",Ae="message_templates",fe={FROM:"from",TO:"to",CC:"cc",BCC:"bcc",ORGANIZER:"organizer",PRESENTER:"presenter",ATTENDEE:"attendee",OWNER:"owner",MEMBER:"member",GUEST:"guest",HOST:"host",PARTICIPANT:"participant"},Ie=(e,t)=>({intent:e,...t}),_e="folder_management",Se="remote_search",Te={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},me=9e4,Re="installation-id";exports.CLASSIFY_VARS=F;exports.CORE_DIMENSIONS=P;exports.CommunicationScheme=O;exports.FEATURE_FOLDER_MANAGEMENT=_e;exports.FEATURE_REMOTE_SEARCH=Se;exports.INSTALLATION_HEADER=Re;exports.InteractionParticipantRole=fe;exports.PAUSED_RUN_STATUSES=T;exports.PRESENCE_ONLINE_WINDOW_MS=me;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=Ae;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=ge;exports.SIGNATURE_INTENTS=Y;exports.SUMMARY_MIN_LAST_CHARS=N;exports.SUMMARY_MIN_MESSAGES=b;exports.TERMINAL_RUN_STATUSES=S;exports.TRIGGER_VARS=w;exports.UNSUPPORTED=Te;exports.actingIdentityKey=_;exports.actorKey=j;exports.applySignature=q;exports.buildActivityPreview=h;exports.buildChannelIntents=ue;exports.cleanMessageText=re;exports.defineIntent=Ie;exports.disabledIntentsFromCapabilities=le;exports.filterByEndpoint=de;exports.filterByIntent=Ee;exports.filterByTargetScheme=L;exports.flattenLocales=$;exports.floorToPeriod=f;exports.formatActingIdentity=I;exports.formatPeriod=A;exports.getActivitySeenUserIds=U;exports.getContactEndpoints=z;exports.getShortTitle=X;exports.getUrgencyScore=Q;exports.humanizeAction=H;exports.isAssigned=v;exports.isClosed=J;exports.isInteractionUnseen=Z;exports.isLikelyBulk=oe;exports.isPaused=K;exports.isRetryable=W;exports.isTerminal=m;exports.isThreadLongEnough=ie;exports.matchContactToIntents=pe;exports.parseActingIdentity=x;exports.periodsInRange=V;exports.playbookActor=B;exports.resolveAccountCapabilities=y;exports.resolveChannelIntents=D;exports.resolveSignature=R;exports.stripHtml=g;

package/dist/index.d.ts

@@ -38,6 +38,7 @@ export * from './platform/capabilities';
 export * from './platform/context';
 export * from './platform/communication';
 export * from './platform/federated';
+export * from './platform/identity';
 export * from './platform/intents';
 export * from './platform/kernel';
 export * from './platform/lifecycle';

package/dist/index.js

@@ -1,20 +1,20 @@
-function p(e) {
+function E(e) {
   return e.replace(/<style[\s\S]*?<\/style>/gi, " ").replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/\s+/g, " ").trim();
 }
 function g(e) {
   const t = e.trim();
   return t.length <= 140 ? t : t.slice(0, 139).trimEnd() + "…";
 }
-function l(e) {
+function i(e) {
   if (!e || e < 0) return "";
   const t = Math.floor(e / 60), n = Math.floor(e % 60);
   return `${t}:${n.toString().padStart(2, "0")}`;
 }
-function A(e) {
+function f(e) {
   switch (e.type) {
     case "EMAIL_RECEIVED":
     case "EMAIL_SENT": {
-      const t = e.payload, n = t.bodySnippet?.trim() || p(t.body ?? "");
+      const t = e.payload, n = t.bodySnippet?.trim() || E(t.body ?? "");
       return t.subject ? `${t.subject} — ${n}` : n;
     }
     case "CHAT_MESSAGE_SENT":
@@ -29,7 +29,7 @@ function A(e) {
     case "CHAT_CALL_STARTED":
       return "Gesprek gestart";
     case "CHAT_CALL_ENDED":
-      return `Gesprek beëindigd${e.payload.duration ? ` (${l(e.payload.duration)})` : ""}`;
+      return `Gesprek beëindigd${e.payload.duration ? ` (${i(e.payload.duration)})` : ""}`;
     case "CHAT_EVENT":
       return e.payload.text ?? e.payload.eventType;
     case "VOICE_CALL_STARTED":
@@ -46,7 +46,7 @@ function A(e) {
       return "Hervat";
     case "VOICE_CALL_ENDED":
     case "VIDEO_CALL_ENDED":
-      return `Gesprek beëindigd${e.payload.duration ? ` (${l(e.payload.duration)})` : ""}`;
+      return `Gesprek beëindigd${e.payload.duration ? ` (${i(e.payload.duration)})` : ""}`;
     case "VOICE_CALL_MISSED":
     case "VIDEO_CALL_MISSED":
       return "Gemiste oproep";
@@ -72,7 +72,7 @@ function A(e) {
     case "MEETING_STARTED":
       return `Vergadering gestart: ${e.payload.title}`;
     case "MEETING_ENDED":
-      return `Vergadering beëindigd${e.payload.duration ? ` (${l(e.payload.duration)})` : ""}`;
+      return `Vergadering beëindigd${e.payload.duration ? ` (${i(e.payload.duration)})` : ""}`;
     case "MEETING_PARTICIPANT_JOINED":
       return `${e.payload.name} deelgenomen`;
     case "MEETING_PARTICIPANT_LEFT":
@@ -91,23 +91,23 @@ function A(e) {
       return "";
   }
 }
-function $(e) {
+function H(e) {
   return {
     activityId: e.id,
     type: e.type,
-    snippet: g(A(e)),
+    snippet: g(f(e)),
     authorName: e.author?.name ?? "",
     direction: e.direction,
     createdAt: e.createdAt ?? Date.now()
   };
 }
-function U(e, t, n = []) {
+function V(e, t, n = []) {
   const r = e.createdAt;
   if (!r) return [];
   const s = new Set(n);
   return e.author.type === "user" && e.author.id && s.add(e.author.id), Object.entries(t).filter(([a, o]) => o >= r && !s.has(a)).map(([a]) => a);
 }
-const H = [
+const x = [
   { id: "agent", label: "Agent", labelSource: "user" },
   { id: "team", label: "Team", labelSource: "team" },
   { id: "inbox", label: "Inbox", labelSource: "inbox" },
@@ -117,56 +117,130 @@ const H = [
   { id: "handledBy", label: "Afhandelaar", labelSource: "raw" },
   { id: "time", label: "Tijd", labelSource: "raw" }
 ];
-function G(e) {
+function B(e) {
   const t = [];
   for (const n of Object.keys(e))
     for (const r of Object.keys(e[n]))
       t.push({ lang: n, key: r, value: e[n][r] });
   return t;
 }
-function i(e) {
+function l(e) {
   return e < 10 ? `0${e}` : `${e}`;
 }
-function f(e, t) {
-  const n = new Date(e), r = `${n.getUTCFullYear()}-${i(n.getUTCMonth() + 1)}-${i(n.getUTCDate())}`;
-  return t === "day" ? r : `${r}T${i(n.getUTCHours())}`;
+function A(e, t) {
+  const n = new Date(e), r = `${n.getUTCFullYear()}-${l(n.getUTCMonth() + 1)}-${l(n.getUTCDate())}`;
+  return t === "day" ? r : `${r}T${l(n.getUTCHours())}`;
 }
 function _(e, t) {
   const n = new Date(e);
   return n.setUTCMinutes(0, 0, 0), t === "day" && n.setUTCHours(0), n.getTime();
 }
-const T = 36e5, I = 864e5;
-function V(e, t, n) {
-  const r = n === "hour" ? T : I, s = [];
+const I = 36e5, T = 864e5;
+function F(e, t, n) {
+  const r = n === "hour" ? I : T, s = [];
   for (let a = _(e, n); a <= t; a += r)
-    s.push(f(a, n));
+    s.push(A(a, n));
   return s;
 }
-const w = /* @__PURE__ */ new Set(["mail", "message"]);
-function S(e, t) {
+function j(e) {
+  return (e.startsWith("tool:") ? e.slice(5) : e).replace(/__/g, " · ").replace(/\./g, " · ").replace(/_/g, " ");
+}
+const W = [
+  { name: "text", type: "string" },
+  { name: "subject", type: "string" },
+  { name: "from", type: "string" },
+  { name: "type", type: "string" },
+  { name: "direction", type: "string" },
+  { name: "channelId", type: "string" },
+  { name: "interactionId", type: "string" },
+  { name: "activityId", type: "string" },
+  { name: "authorType", type: "string" },
+  { name: "authorName", type: "string" },
+  { name: "textRaw", type: "string" }
+], K = {
+  topics: [
+    { name: "topic", type: "string" },
+    { name: "confidence", type: "number" }
+  ],
+  question: [
+    { name: "answer", type: "boolean" },
+    { name: "confidence", type: "number" }
+  ],
+  extract: []
+};
+function S(e) {
+  switch (e.kind) {
+    case "user":
+      return `user:${e.userId}`;
+    case "team":
+      return `team:${e.teamId}`;
+    case "org":
+      return "org";
+  }
+}
+function Y(e) {
+  if (typeof e != "string") return;
+  const t = e.trim();
+  if (t === "org") return { kind: "org" };
+  const n = t.indexOf(":");
+  if (n <= 0) return;
+  const r = t.slice(0, n), s = t.slice(n + 1).trim();
+  if (s) {
+    if (r === "user") return { kind: "user", userId: s };
+    if (r === "team") return { kind: "team", teamId: s };
+  }
+}
+function m(e) {
+  return S(e);
+}
+function q(e) {
+  switch (e.kind) {
+    case "personal":
+      return { kind: "user", userId: e.userId };
+    case "team":
+      return { kind: "team", teamId: e.teamId };
+    case "org":
+      return { kind: "org" };
+  }
+}
+function z(e) {
+  return m(e);
+}
+const b = ["done", "escalated", "failed", "timed_out", "stopped"], N = ["awaiting_approval", "awaiting_reply"];
+function D(e) {
+  return b.includes(e);
+}
+function X(e) {
+  return D(e);
+}
+function J(e) {
+  return N.includes(e);
+}
+const Q = /* @__PURE__ */ new Set(["mail", "message"]);
+function R(e, t) {
   const n = e.settings?.signatures?.[t];
   return !n || !n.enabled || !n.body || n.body.trim() === "" ? null : n;
 }
-function k(e, t, n, r = "html") {
+function Z(e, t, n, r = "html") {
   if (!e) return n;
-  const s = S(e, t);
+  const s = R(e, t);
   return s ? `${n}${r === "text" ? `
 
 ` : t === "mail" ? "<br><br>-- <br>" : "<br><br>"}${s.body}` : n;
 }
-function x(e) {
+function v(e) {
   return e.endpoints ?? [];
 }
-const B = (e) => !!e.assignedUserId || !!e.assignedInboxId, F = (e) => e.status === "closed", j = (e) => ({
+const ee = (e) => !!e.assignedUserId || !!e.assignedInboxId, te = (e) => e.status === "closed", ne = (e) => ({
   urgent: 10,
   high: 5,
   normal: 2,
   low: 1
-})[e.priority] || 0, W = (e, t = 30) => e.title?.length <= t ? e.title : `${e.title.substring(0, t)}...`;
-function K(e, t) {
+})[e.priority] || 0, re = (e, t = 30) => e.title?.length <= t ? e.title : `${e.title.substring(0, t)}...`;
+function se(e, t) {
   return e.lastActivityAt ? !(e.seenBy ?? []).includes(t) : !1;
 }
-const b = [
+const L = [
   /<blockquote/i,
   /class="?gmail_quote/i,
   // Gmail quote container
@@ -179,12 +253,12 @@ const b = [
   // Outlook underscore separator before "From:"
   /\bOn\b[\s\S]{0,200}?\bwrote:/i
   // Gmail "On <date> <name> wrote:"
-], u = /^\s*(?:>+\s*)?(?:from|van|sent|verzonden|to|aan|cc|subject|onderwerp|date|datum)\s*:/i, D = /^\s*(?:on|op)\b.{0,200}?\b(?:wrote|schreef|geschreven)\s*:?\s*$/i;
-function N(e) {
+], u = /^\s*(?:>+\s*)?(?:from|van|sent|verzonden|to|aan|cc|subject|onderwerp|date|datum)\s*:/i, O = /^\s*(?:on|op)\b.{0,200}?\b(?:wrote|schreef|geschreven)\s*:?\s*$/i;
+function y(e) {
   const t = e.split(`
 `);
   for (let n = 0; n < t.length; n++)
-    if (D.test(t[n]) || u.test(t[n]) && t.slice(n + 1, n + 4).some((r) => u.test(r)))
+    if (O.test(t[n]) || u.test(t[n]) && t.slice(n + 1, n + 4).some((r) => u.test(r)))
       return t.slice(0, n).join(`
 `).trim();
   return e;
@@ -195,43 +269,43 @@ function c(e) {
 `), t = t.replace(/<\/(p|div|li|tr|h[1-6]|ul|ol|table)>/gi, `
 `), t = t.replace(/<[^>]+>/g, ""), t = t.replace(/<[^>]*$/, ""), t;
 }
-function E(e) {
+function d(e) {
   return e.replace(/&nbsp;/gi, " ").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;/gi, "'").replace(/&#(\d+);/g, (t, n) => String.fromCharCode(Number(n))).replace(/&amp;/gi, "&");
 }
-function d(e) {
+function p(e) {
   return e.replace(/\r/g, "").replace(/[ \t]+/g, " ").replace(/ *\n */g, `
 `).replace(/\n{3,}/g, `
 
 `).trim();
 }
-function Y(e) {
+function ae(e) {
   if (typeof e != "string" || !e) return "";
   let t = e.length;
-  for (const a of b) {
+  for (const a of L) {
     const o = e.search(a);
     o >= 0 && o < t && (t = o);
   }
   const n = e.slice(0, t);
-  let r = d(E(c(n)));
-  return r || (r = d(E(c(e)))), N(r) || r;
+  let r = p(d(c(n)));
+  return r || (r = p(d(c(e)))), y(r) || r;
 }
-const L = /(^|[._+-])(no-?reply|noreply|donotreply|do-not-reply|newsletter|nieuwsbrief|mailer|mailing|notifications?|bounce|postmaster|marketing)@/i, O = /\b(unsubscribe|afmelden|uitschrijven|opt[\s-]?out|manage (your )?preferences|geen (e-?mails?|nieuwsbrief|berichten) meer)\b/i;
-function q(e, t) {
-  return !!(e && L.test(e) || t && O.test(t));
+const C = /(^|[._+-])(no-?reply|noreply|donotreply|do-not-reply|newsletter|nieuwsbrief|mailer|mailing|notifications?|bounce|postmaster|marketing)@/i, M = /\b(unsubscribe|afmelden|uitschrijven|opt[\s-]?out|manage (your )?preferences|geen (e-?mails?|nieuwsbrief|berichten) meer)\b/i;
+function oe(e, t) {
+  return !!(e && C.test(e) || t && M.test(t));
 }
-const R = 3, m = 600;
-function X(e, t) {
-  return e >= R || t >= m;
+const h = 3, P = 600;
+function ie(e, t) {
+  return e >= h || t >= P;
 }
-function C(e, t) {
-  const n = new Set(e.disabledIntents ?? []), r = e.intentOverrides ?? {}, s = t.intents.filter((o) => !n.has(o.intent)).map((o) => h(o, r[o.intent]));
+function U(e, t) {
+  const n = new Set(e.disabledIntents ?? []), r = e.intentOverrides ?? {}, s = t.intents.filter((o) => !n.has(o.intent)).map((o) => k(o, r[o.intent]));
   if (!e.extraIntents || e.extraIntents.length === 0) return s;
   const a = new Set(s.map((o) => o.intent));
   for (const o of e.extraIntents)
     a.has(o.intent) || (s.push(o), a.add(o.intent));
   return s;
 }
-function M(e, t) {
+function $(e, t) {
   const n = {};
   for (const r of e.intents) {
     if (!r.togglable) continue;
@@ -240,46 +314,46 @@ function M(e, t) {
   }
   return n;
 }
-function z(e, t) {
-  const n = M(e, t);
+function le(e, t) {
+  const n = $(e, t);
   return Object.entries(n).filter(([, r]) => !r).map(([r]) => r);
 }
-function h(e, t) {
+function k(e, t) {
   return t ? {
     intent: t.intent ?? e.intent,
     targetSchemes: t.targetSchemes ?? e.targetSchemes,
     transport: t.transport ?? e.transport
   } : e;
 }
-function J(e, t) {
+function ue(e, t) {
   const n = [];
   for (const r of e) {
     if (!r.enabled) continue;
     const s = t[r.providerId];
     if (s)
-      for (const a of C(r, s))
+      for (const a of U(r, s))
         n.push({ channel: r, description: s, capability: a });
   }
   return n;
 }
-function Q(e, t) {
+function ce(e, t) {
   return t.filter((n) => n.capability.intent === e);
 }
-function P(e, t) {
+function w(e, t) {
   return t.filter((n) => n.capability.targetSchemes.includes(e));
 }
-function Z(e, t) {
-  return P(e.scheme, t);
+function de(e, t) {
+  return w(e.scheme, t);
 }
-function v(e, t, n) {
+function pe(e, t, n) {
   const r = [];
   for (const s of e)
     for (const a of n)
       a.capability.intent === t && a.capability.targetSchemes.includes(s.scheme) && r.push({ channelIntent: a, endpoint: s });
   return r;
 }
-var y = /* @__PURE__ */ ((e) => (e.MAILTO = "mailto", e.SIP = "sip", e.TEL = "tel", e.WEBHOOK = "webhook", e.USERNAME = "username", e.ID = "id", e.CUSTOM = "custom", e.URL = "url", e.TELEGRAM = "telegram", e.WHATSAPP = "whatsapp", e.MESSENGER = "messenger", e.INSTAGRAM = "instagram", e.VIBER = "viber", e.SMS = "sms", e.FAX = "fax", e.TEAMS = "teams", e.CALENDAR = "calendar", e))(y || {});
-const ee = "message_window", te = "message_templates", ne = {
+var G = /* @__PURE__ */ ((e) => (e.MAILTO = "mailto", e.SIP = "sip", e.TEL = "tel", e.WEBHOOK = "webhook", e.USERNAME = "username", e.ID = "id", e.CUSTOM = "custom", e.URL = "url", e.TELEGRAM = "telegram", e.WHATSAPP = "whatsapp", e.MESSENGER = "messenger", e.INSTAGRAM = "instagram", e.VIBER = "viber", e.SMS = "sms", e.FAX = "fax", e.TEAMS = "teams", e.CALENDAR = "calendar", e))(G || {});
+const Ee = "message_window", ge = "message_templates", fe = {
   // E-mail
   FROM: "from",
   TO: "to",
@@ -296,46 +370,59 @@ const ee = "message_window", te = "message_templates", ne = {
   // Voice/conference
   HOST: "host",
   PARTICIPANT: "participant"
-}, re = (e, t) => ({ intent: e, ...t }), se = "folder_management", ae = "remote_search", oe = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, le = 9e4, ie = "installation-id";
+}, Ae = (e, t) => ({ intent: e, ...t }), _e = "folder_management", Ie = "remote_search", Te = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, Se = 9e4, me = "installation-id";
 export {
-  H as CORE_DIMENSIONS,
-  y as CommunicationScheme,
-  se as FEATURE_FOLDER_MANAGEMENT,
-  ae as FEATURE_REMOTE_SEARCH,
-  ie as INSTALLATION_HEADER,
-  ne as InteractionParticipantRole,
-  le as PRESENCE_ONLINE_WINDOW_MS,
-  te as PROVIDER_FEATURE_MESSAGE_TEMPLATES,
-  ee as PROVIDER_FEATURE_MESSAGE_WINDOW,
-  w as SIGNATURE_INTENTS,
-  m as SUMMARY_MIN_LAST_CHARS,
-  R as SUMMARY_MIN_MESSAGES,
-  oe as UNSUPPORTED,
-  k as applySignature,
-  $ as buildActivityPreview,
-  J as buildChannelIntents,
-  Y as cleanMessageText,
-  re as defineIntent,
-  z as disabledIntentsFromCapabilities,
-  Z as filterByEndpoint,
-  Q as filterByIntent,
-  P as filterByTargetScheme,
-  G as flattenLocales,
+  K as CLASSIFY_VARS,
+  x as CORE_DIMENSIONS,
+  G as CommunicationScheme,
+  _e as FEATURE_FOLDER_MANAGEMENT,
+  Ie as FEATURE_REMOTE_SEARCH,
+  me as INSTALLATION_HEADER,
+  fe as InteractionParticipantRole,
+  N as PAUSED_RUN_STATUSES,
+  Se as PRESENCE_ONLINE_WINDOW_MS,
+  ge as PROVIDER_FEATURE_MESSAGE_TEMPLATES,
+  Ee as PROVIDER_FEATURE_MESSAGE_WINDOW,
+  Q as SIGNATURE_INTENTS,
+  P as SUMMARY_MIN_LAST_CHARS,
+  h as SUMMARY_MIN_MESSAGES,
+  b as TERMINAL_RUN_STATUSES,
+  W as TRIGGER_VARS,
+  Te as UNSUPPORTED,
+  m as actingIdentityKey,
+  z as actorKey,
+  Z as applySignature,
+  H as buildActivityPreview,
+  ue as buildChannelIntents,
+  ae as cleanMessageText,
+  Ae as defineIntent,
+  le as disabledIntentsFromCapabilities,
+  de as filterByEndpoint,
+  ce as filterByIntent,
+  w as filterByTargetScheme,
+  B as flattenLocales,
   _ as floorToPeriod,
-  f as formatPeriod,
-  U as getActivitySeenUserIds,
-  x as getContactEndpoints,
-  W as getShortTitle,
-  j as getUrgencyScore,
-  B as isAssigned,
-  F as isClosed,
-  K as isInteractionUnseen,
-  q as isLikelyBulk,
-  X as isThreadLongEnough,
-  v as matchContactToIntents,
-  V as periodsInRange,
-  M as resolveAccountCapabilities,
-  C as resolveChannelIntents,
-  S as resolveSignature,
-  p as stripHtml
+  S as formatActingIdentity,
+  A as formatPeriod,
+  V as getActivitySeenUserIds,
+  v as getContactEndpoints,
+  re as getShortTitle,
+  ne as getUrgencyScore,
+  j as humanizeAction,
+  ee as isAssigned,
+  te as isClosed,
+  se as isInteractionUnseen,
+  oe as isLikelyBulk,
+  J as isPaused,
+  X as isRetryable,
+  D as isTerminal,
+  ie as isThreadLongEnough,
+  pe as matchContactToIntents,
+  Y as parseActingIdentity,
+  F as periodsInRange,
+  q as playbookActor,
+  $ as resolveAccountCapabilities,
+  U as resolveChannelIntents,
+  R as resolveSignature,
+  E as stripHtml
 };

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

@@ -31,8 +31,39 @@ export interface AiToolResult {
     content: string;
     isError?: boolean;
 }
-/** Returned by an app's `GET /provider/ai-tools/describe`. */
-export type AiToolDescriptor = AiTool;
+/**
+ * Returned by an app's `GET /provider/ai-tools/describe`.
+ *
+ * Beide extra velden zijn optioneel en additief: een tool die ze niet zet gedraagt
+ * zich exact als voorheen. Ze bestaan zodat generieke lagen (de suggest-gate, de
+ * scope-gate in `registerAiToolProvider`) een tool kunnen beoordelen **zonder hem
+ * te kennen** — nu zit die kennis in `AIProfile.toolPolicy` met "onbekend = write".
+ */
+export interface AiToolDescriptor extends AiTool {
+    /** Muteert deze tool iets? Bepaalt de suggest-gate. Afwezig = onbekend. */
+    access?: "read" | "write";
+    /**
+     * De resource waarop deze tool werkt, zodat een generieke gate hem kan
+     * autoriseren: `{ param: "interactionId", kind: "interaction" }` betekent
+     * "autoriseer `interaction:<args.interactionId>` voor de acting identity".
+     */
+    scope?: {
+        param: string;
+        kind: string;
+    };
+}
+/**
+ * Body van `POST /provider/ai-tools/invoke`. Vervangt vijf inline structurele
+ * types (de beller in de ai-app plus de vier ontvangende apps).
+ *
+ * De acting identity zit hier **niet** in: die reist als header mee
+ * (`ACTING_IDENTITY_HEADER` in `@opencxh/platform-api`). Gemeten in fase 0 dat dat
+ * werkt vanuit een request, een job én een subscriber — dus geen tweede kanaal.
+ */
+export interface AiToolInvokeRequest {
+    tool: string;
+    arguments?: Record<string, unknown>;
+}
 /** One step in the assistant's tool-use trace, persisted on the message. */
 export interface ToolTraceEntry {
     call: AiToolCall;

package/dist/platform/identity.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Namens wie een actie gebeurt.
+ *
+ * Orthogonaal aan *wie* er belt (dat is `Caller` in `@opencxh/platform-api`): een
+ * app kan bellen namens een gebruiker, namens een team, of namens de organisatie.
+ * Een app-to-app call draagt van zichzelf geen bruikbare identiteit — de auth die
+ * de runtime meestuurt is die van de oorspronkelijke beller, niet van degene
+ * namens wie gehandeld wordt. Vandaar dit eigen, expliciete kanaal.
+ *
+ * `MutationAuthor` wordt hieruit *afgeleid* (attributie is een projectie van
+ * identiteit), niet parallel bijgehouden. Zie `resolveAuthor`.
+ */
+export type ActingIdentity = {
+    kind: "user";
+    userId: string;
+} | {
+    kind: "team";
+    teamId: string;
+} | {
+    kind: "org";
+};
+/**
+ * Compacte, header-veilige vorm: `"user:<id>"` | `"team:<id>"` | `"org"`.
+ * ASCII, geen JSON — een header hoort geen gestructureerde payload te dragen, en
+ * dit blijft leesbaar in logs.
+ */
+export declare function formatActingIdentity(actor: ActingIdentity): string;
+/**
+ * Leest de compacte vorm terug. Strikt: een onbekende soort, een ontbrekende of
+ * lege ref levert `undefined` — nooit een gok en nooit een half-gevulde identiteit
+ * zoals `{ kind: "user", userId: "" }`, want die zou als geldig door een gate
+ * glippen.
+ *
+ * Round-trip: `parseActingIdentity(formatActingIdentity(a))` is diep gelijk aan `a`.
+ */
+export declare function parseActingIdentity(raw: string | null | undefined): ActingIdentity | undefined;
+/**
+ * Stabiele sleutel om identiteiten te vergelijken of te dedupliceren (bijvoorbeeld
+ * "één autorisatie-call per distincte actor"). Gelijk aan de wire-vorm; apart
+ * genoemd omdat de bedoeling anders is dan transporteren.
+ */
+export declare function actingIdentityKey(actor: ActingIdentity): string;

package/dist/platform/scope.d.ts

@@ -1,10 +1,4 @@
-/**
- * Cross-app scope-authorization contract. A resource is addressed by an opaque
- * scopeKey ("<kind>:<ref>", e.g. "interaction:abc"); the app that owns that kind
- * answers "may this user access it?" over the `scope` provider role. Consumed by
- * the AI live-assistant (conversation access) and, from fase 2, the attribute store.
- * Implementation: authorizeScope / assertScopeAccess in @opencxh/platform-api.
- */
+import { ActingIdentity } from './identity';
 /** Access decision + whether the scope anchor is team-shared + the SSE audience. */
 export interface ScopeAuth {
     allowed: boolean;
@@ -14,9 +8,27 @@ export interface ScopeAuth {
 /** GET /provider/scope/describe response: the scopeKey prefixes an app owns. */
 export interface ScopeDescribe {
     kinds: string[];
+    /**
+     * Welke soorten acting identity deze provider daadwerkelijk evalueert.
+     * Afwezig = alleen het klassieke `userId`-contract.
+     *
+     * Dit is een fail-closed schakelaar, geen documentatie: een provider die
+     * `actor` negeert ziet bij een team-actor een lege `userId` en zou dat als
+     * "trusted system caller" lezen — dus volledige toegang. `authorizeIdentity`
+     * weigert daarom een `team`-actor zolang de eigenaar `"team"` niet declareert.
+     */
+    actorKinds?: ActingIdentity["kind"][];
 }
-/** POST /provider/scope/authorize body. userId omitted = trusted system caller. */
+/**
+ * POST /provider/scope/authorize body.
+ *
+ * `userId` blijft voor back-compat: bestaande providers lezen alleen dat veld, en
+ * een `user`-actor vult het mee zodat zij ongewijzigd blijven werken. `userId`
+ * afwezig = trusted system caller (ruim!), dus zie de waarschuwing bij
+ * {@link ScopeDescribe.actorKinds}.
+ */
 export interface ScopeAuthorizeRequest {
     scopeKey: string;
     userId?: string;
+    actor?: ActingIdentity;
 }

package/package.json

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