@opencxh/domain 1.91.0 → 1.94.0

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

@@ -3,7 +3,7 @@ import { TranscriptSegment } from '../../platform/media';
 export type CallStatus = "new" | "connecting" | "ringing" | "connected" | "held" | "ended" | "failed";
 export type CallDirection = "inbound" | "outbound";
 export type CallType = "audio" | "video" | "data" | "screen-share";
-export type ActivityType = "VOICE_CALL_STARTED" | "VOICE_CALL_ANSWERED" | "VOICE_CALL_HOLD" | "VOICE_CALL_UNHOLD" | "VOICE_CALL_ENDED" | "VOICE_CALL_MISSED" | "VOICE_CALL_VOICEMAIL" | "VIDEO_CALL_STARTED" | "VIDEO_CALL_ANSWERED" | "VIDEO_CALL_HOLD" | "VIDEO_CALL_UNHOLD" | "VIDEO_CALL_ENDED" | "VIDEO_CALL_MISSED" | "EMAIL_RECEIVED" | "EMAIL_SENT" | "CHAT_MESSAGE_SENT" | "CHAT_MESSAGE_RECEIVED" | "CHAT_MEMBER_JOINED" | "CHAT_MEMBER_LEFT" | "CHAT_RENAMED" | "CHAT_CALL_STARTED" | "CHAT_CALL_ENDED" | "CHAT_EVENT" | "AI_MESSAGE_ADDED" | "MEETING_SCHEDULED" | "MEETING_STARTED" | "MEETING_ENDED" | "MEETING_PARTICIPANT_JOINED" | "MEETING_PARTICIPANT_LEFT" | "COMMENT_ADDED" | "FILE_UPLOADED" | "INTERACTION_CREATED" | "INTERACTION_STATUS_CHANGED" | "INTERACTION_ASSIGNED" | "VOICE_CALL_FAILED" | "VIDEO_CALL_FAILED" | "TRANSCRIPT_ADDED";
+export type ActivityType = "VOICE_CALL_STARTED" | "VOICE_CALL_ANSWERED" | "VOICE_CALL_HOLD" | "VOICE_CALL_UNHOLD" | "VOICE_CALL_ENDED" | "VOICE_CALL_MISSED" | "VOICE_CALL_VOICEMAIL" | "VIDEO_CALL_STARTED" | "VIDEO_CALL_ANSWERED" | "VIDEO_CALL_HOLD" | "VIDEO_CALL_UNHOLD" | "VIDEO_CALL_ENDED" | "VIDEO_CALL_MISSED" | "EMAIL_RECEIVED" | "EMAIL_SENT" | "CHAT_MESSAGE_SENT" | "CHAT_MESSAGE_RECEIVED" | "CHAT_MEMBER_JOINED" | "CHAT_MEMBER_LEFT" | "CHAT_RENAMED" | "CHAT_CALL_STARTED" | "CHAT_CALL_ENDED" | "CHAT_EVENT" | "AI_MESSAGE_ADDED" | "AI_ACTION_PROPOSED" | "PLAYBOOK_STARTED" | "PLAYBOOK_COMPLETED" | "PLAYBOOK_ESCALATED" | "MEETING_SCHEDULED" | "MEETING_STARTED" | "MEETING_ENDED" | "MEETING_PARTICIPANT_JOINED" | "MEETING_PARTICIPANT_LEFT" | "COMMENT_ADDED" | "FILE_UPLOADED" | "INTERACTION_CREATED" | "INTERACTION_STATUS_CHANGED" | "INTERACTION_ASSIGNED" | "VOICE_CALL_FAILED" | "VIDEO_CALL_FAILED" | "TRANSCRIPT_ADDED";
 export interface Attachment {
     id: string;
     filename: string;
@@ -183,6 +183,29 @@ export type AIMessageAddedPayload = {
     accountId?: string;
     model?: string;
 };
+/**
+ * A playbook proposes one or more actions for a human to approve/reject (autonomy:
+ * suggest). Rendered inline in the interaction timeline; approve/reject call the ai
+ * app's `playbook-run` endpoints. System-authored, so it does not re-trigger playbooks.
+ */
+export type AIActionProposedPayload = {
+    runId: string;
+    playbookId?: string;
+    playbookName?: string;
+    /** The held actions, e.g. { action: "tool:mcp__jira__create_issue", params }. */
+    actions: {
+        action: string;
+        params?: Record<string, unknown>;
+    }[];
+    status: "pending" | "approved" | "rejected";
+};
+/** Playbook lifecycle marker in the interaction timeline (system-authored). */
+export type PlaybookLifecyclePayload = {
+    runId: string;
+    playbookId?: string;
+    playbookName?: string;
+    status?: string;
+};
 export type Activity = (BaseActivity & {
     type: "VOICE_CALL_STARTED";
     payload: VoiceCallPayload;
@@ -264,6 +287,18 @@ export type Activity = (BaseActivity & {
 }) | (BaseActivity & {
     type: "AI_MESSAGE_ADDED";
     payload: AIMessageAddedPayload;
+}) | (BaseActivity & {
+    type: "AI_ACTION_PROPOSED";
+    payload: AIActionProposedPayload;
+}) | (BaseActivity & {
+    type: "PLAYBOOK_STARTED";
+    payload: PlaybookLifecyclePayload;
+}) | (BaseActivity & {
+    type: "PLAYBOOK_COMPLETED";
+    payload: PlaybookLifecyclePayload;
+}) | (BaseActivity & {
+    type: "PLAYBOOK_ESCALATED";
+    payload: PlaybookLifecyclePayload;
 }) | (BaseActivity & {
     type: "MEETING_SCHEDULED";
     payload: MeetingPayload;

package/dist/entities/ai-profile/types.d.ts

@@ -22,6 +22,22 @@ export interface AIProfile<T extends Record<string, any> = Record<string, any>>
     predefinedPrompts?: PredefinedPrompt[];
     /** Namespaced tool names this profile may use (default: none enabled). */
     enabledTools?: string[];
+    /**
+     * Per-tool confirmation policy. Stored as a LIST (not a keyed map) on purpose:
+     * namespaced tool names contain "__", and the SDK client transforms every
+     * object KEY between camelCase/snake_case — which mangles map keys (e.g.
+     * `communication__compose_email` -> `communication_ComposeEmail`) so they no
+     * longer match `enabledTools`. As a list the tool name lives in a string VALUE,
+     * which the transform leaves untouched.
+     *
+     * Under autonomy "suggest", write tools are held for approval; reads run freely.
+     * A tool absent from this list defaults to "write" (safe). Also usable by the
+     * interactive assistant's requiresConfirmation flow.
+     */
+    toolPolicy?: {
+        name: string;
+        policy: "read" | "write";
+    }[];
     /**
      * Whether the acting user's PERSONAL MCP tools (their own per-user connections)
      * are available on this profile, on top of the admin-curated `enabledTools`.

package/dist/entities/analytics/dashboard.d.ts

@@ -0,0 +1,58 @@
+import { OwnerScope } from '../contact/types';
+import { DimensionId } from './dimensions';
+import { WidgetConfig } from './report';
+/**
+ * A dashboard SECTION, declaratively. The analytics frontend runs the right widget(s) for the viz and
+ * renders the matching component. `title` and the parent def's `title` are i18n keys resolved against the
+ * merged locale bundle the owning app ships (see AnalyticsSourceDescription.locales).
+ */
+export type SectionViz = "kpis" | "line" | "bar" | "heatmap" | "table";
+export interface DashboardSection {
+    viz: SectionViz;
+    /** i18n key (namespaced per owning app, e.g. "comms.dash.busiest_times"). */
+    title?: string;
+    /** kpis: one card per id; line: one series per id; bar/heatmap: switchable set; table: columns. */
+    metricIds: string[];
+    /** Row dimension for bar/table (line/heatmap imply the time axis). */
+    groupBy?: DimensionId;
+}
+/**
+ * A preset dashboard shipped by an owning app (or by analytics for cross-source ones). Discovered like
+ * metrics/dimensions via /provider/analytics/describe; the frontend composes all sources' dashboards.
+ */
+export interface DashboardDef {
+    /** Stable, ideally app-namespaced key, e.g. "comms.workload". */
+    key: string;
+    /** i18n key for the display name (resolved via the source's locale bundle). */
+    title: string;
+    sections: DashboardSection[];
+    /** Owning app (filled by discovery); handy for grouping in the list. */
+    source?: string;
+}
+/**
+ * A single localized string. Kept as a flat LIST (not a lang->key->value map) because the app-sdk http
+ * client mangles object KEYS (snake<->camel) — i18n keys with underscores/dots as map keys get corrupted
+ * (e.g. "comms.dash.resolution_over_time"). As list VALUES they pass through untouched.
+ */
+export interface LocaleString {
+    lang: string;
+    key: string;
+    value: string;
+}
+export type LocaleBundle = LocaleString[];
+/** Authoring convenience: turn a nested { lang: { key: value } } map into a transport-safe LocaleBundle. */
+export declare function flattenLocales(nested: Record<string, Record<string, string>>): LocaleBundle;
+/**
+ * Persisted, user-saved dashboard (future: the custom builder). Distinct from DashboardDef: it stores
+ * fully-resolved widget configs rather than a preset template.
+ */
+export interface DashboardConfig {
+    id: string;
+    organizationId: string;
+    name: string;
+    /** Reuse the platform's ownerScope (org/team/personal). */
+    ownerScope?: OwnerScope;
+    widgets: WidgetConfig[];
+    createdAt?: number;
+    updatedAt?: number;
+}

package/dist/entities/analytics/dimensions.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Dimensions — the axes you group or filter reports by.
+ *
+ * Dimensions are declared/discovered exactly like metrics (see ./metric): there is NO closed enum.
+ * Two tiers:
+ *  - CORE_DIMENSIONS (below): shared and cross-app, with the same key space everywhere
+ *    (`agent` = userId, `team` = teamId, `channel` = the communication channelId, …). Every source
+ *    app may emit facts on these. Needed so you can group across sources (comms + voice on `agent`).
+ *  - App-owned dimensions: declared by the owning app via `GET /analytics/describe`, namespaced
+ *    (`comms.tag`, `comms.topic`, `comms.cf.<field>`). Only that app emits facts on them.
+ *
+ * Contract note: a core dimension only merges correctly across sources when every source uses the
+ * SAME canonical entity id. An app that cannot guarantee that must declare an app-owned dimension
+ * (e.g. `voice.line`) instead of emitting on a core dim.
+ */
+/** Dimension id: core (e.g. "agent") or app-namespaced (e.g. "comms.topic"). Open string, not an enum. */
+export type DimensionId = string;
+/** Who handled the work. Core dimension "handledBy"; derived from activity.author.type. NOT separate metrics. */
+export type HandledBy = "teammate" | "autopilot" | "ai_assistant";
+/** How the frontend turns a raw dimension key into a display label. */
+export type DimensionLabelSource = "user" | "team" | "inbox" | "channel" | "topic" | "raw";
+export interface DimensionDefinition {
+    id: DimensionId;
+    label: string;
+    /**
+     * Multi-valued: one source record can map to several values (e.g. tags). The rollup then fans out
+     * (one fact per value). NB: totals over a multi-valued dim can exceed the conversation count — that
+     * is correct/expected; see the multi-valued totals note in docs/ANALYTICS.md §13.
+     */
+    multiValued?: boolean;
+    labelSource?: DimensionLabelSource;
+}
+/**
+ * Shared base dimensions — any source app may emit facts on these. Kept un-namespaced on purpose.
+ * "time" is special: its value comes from MetricFact.period, not from the dims map.
+ */
+export declare const CORE_DIMENSIONS: ({
+    id: string;
+    label: string;
+    labelSource: "user";
+} | {
+    id: string;
+    label: string;
+    labelSource: "team";
+} | {
+    id: string;
+    label: string;
+    labelSource: "inbox";
+} | {
+    id: string;
+    label: string;
+    labelSource: "channel";
+} | {
+    id: string;
+    label: string;
+    labelSource: "raw";
+})[];

package/dist/entities/analytics/fact.d.ts

@@ -0,0 +1,58 @@
+import { DimensionId } from './dimensions';
+/** Rollup bucket granularity. Coarser grains (week/month) are re-bucketed from these at read time. */
+export type Grain = "hour" | "day";
+/**
+ * Open map of dimension-id → value (e.g. { agent: "u_123", channel: "c_9", "comms.topic": "t_4" }).
+ * A missing key means that dimension is n/a for this fact. Open map (not a fixed interface) so that a
+ * newly declared dimension costs ZERO type changes. "time" is NOT stored here — it comes from `period`.
+ */
+export type MetricDimensions = Record<DimensionId, string>;
+/**
+ * The measure is an extensible, per-kind shaped payload. This is what makes a non-additive metric
+ * (distinct / percentile / min-max) an ADDITIVE extension later: you add a `kind` + a finalize branch
+ * without breaking existing facts or the contract. Every kind is bucket-mergeable (additive sums,
+ * distinct HLL-unions, distribution sums buckets, extent takes min/max) and snapshot-replaceable (§6).
+ *
+ * Phase 1 emits & folds only "additive".
+ */
+export type MetricMeasure = 
+/** sum/avg/rate. count metric: sum = #events; duration/currency: sum = total; count = denominator for avg. */
+{
+    kind: "additive";
+    sum: number;
+    count: number;
+}
+/** distinct counts (e.g. Active accounts) — serialized HyperLogLog sketch. (later) */
+ | {
+    kind: "distinct";
+    hll: string;
+}
+/** histogram/percentile — counts per value bucket, e.g. { "[0,3600000)": 12, "[3600000,)": 30 }. (later) */
+ | {
+    kind: "distribution";
+    buckets: Record<string, number>;
+}
+/** min/max. (later) */
+ | {
+    kind: "extent";
+    min: number;
+    max: number;
+};
+/**
+ * A MetricFact is the aggregated outcome of one metric, for one period bucket, for one combination of
+ * dimension values. It is both what a source app pushes and what analytics stores. It is a declarative
+ * SNAPSHOT, not a delta — ingest replaces the measure for a given key (see docs/ANALYTICS.md §5/§6).
+ *
+ * NB: the stored server entity adds framework-generated `id/createdAt/updatedAt` (not declared in the
+ * schema) plus a `source` field so analytics can replace a bucket per source.
+ */
+export interface MetricFact {
+    organizationId: string;
+    metricId: string;
+    grain: Grain;
+    /** Period key: "2026-07-25T14" (hour) or "2026-07-25" (day). Feeds the "time" dimension. */
+    period: string;
+    dims: MetricDimensions;
+    /** Phase 1 carries only `{ kind: "additive", … }`; the kind follows the metric's aggregation (./metric). */
+    measure: MetricMeasure;
+}

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

@@ -0,0 +1,7 @@
+export * from './dimensions';
+export * from './metric';
+export * from './fact';
+export * from './source';
+export * from './report';
+export * from './dashboard';
+export * from './period';

package/dist/entities/analytics/metric.d.ts

@@ -0,0 +1,38 @@
+import { DimensionId } from './dimensions';
+/**
+ * Metric register — the declarative building block. Fixed in code as a typed `const` in the owning app
+ * (no DB), but with exactly this type so we can later move to a DB registry without breaking consumers.
+ *
+ * `valueType` and `aggregation` are a deliberately BOUNDED central vocabulary (the engine must know how
+ * to fold and format). Extending them is a central, additive change — see docs/ANALYTICS.md §13.
+ */
+export type MetricValueType = "count" | "duration_ms" | "percent" | "currency";
+export type MetricAggregation = "sum" | "avg" | "rate" | "distinct" | "p50" | "p90" | "min" | "max";
+export interface MetricDefinition {
+    /**
+     * Globally-unique, app-namespaced id: "<source>.<family>.<name>", e.g. "comms.reply_time.first",
+     * "voice.calls.answered". The prefix guarantees disjoint ownership → no double counting across apps.
+     */
+    id: string;
+    /** Human-readable (source language; the UI may localize). */
+    label: string;
+    /** Picker bucket, e.g. "Volume" | "Responsiviteit" | "Resolutie" | "Taken". */
+    category: string;
+    /** How a single value is interpreted & formatted. */
+    valueType: MetricValueType;
+    /** How measures fold across periods and grouped rows. Determines the required measure kind (./fact). */
+    aggregation: MetricAggregation;
+    /** Only for aggregation:"rate" — ids of the numerator/denominator base metrics (must exist in the catalog). */
+    numeratorId?: string;
+    denominatorId?: string;
+    /**
+     * Which dimensions are meaningful to group/filter this metric on.
+     * NB: duplicates knowledge held by the extractor — a metric that declares a dim its extractor never
+     * emits yields empty groups. Keep them in sync (docs/ANALYTICS.md §13).
+     */
+    supportedDimensions: DimensionId[];
+    /** Optional longer description for tooltips. */
+    description?: string;
+    /** Hidden from the picker (e.g. a numerator/denominator base metric of a rate). */
+    hidden?: boolean;
+}

package/dist/entities/analytics/period.d.ts

@@ -0,0 +1,7 @@
+import { Grain } from './fact';
+/** hour -> "YYYY-MM-DDTHH", day -> "YYYY-MM-DD". */
+export declare function formatPeriod(ms: number, grain: Grain): string;
+/** Floor an instant to the start of its bucket (UTC). */
+export declare function floorToPeriod(ms: number, grain: Grain): number;
+/** All period keys from the bucket containing `start` up to and including the bucket of `end`. */
+export declare function periodsInRange(start: number, end: number, grain: Grain): string[];

package/dist/entities/analytics/report.d.ts

@@ -0,0 +1,75 @@
+import { DimensionId } from './dimensions';
+import { Grain } from './fact';
+import { MetricDefinition } from './metric';
+/**
+ * Report / widget contract (frontend → analytics). One config shape drives tables, counters and the
+ * builder. The engine reads only MetricFact rows (never a source store), groups by dims[groupBy], folds
+ * the measure and finalizes per the metric's aggregation.
+ *
+ * The widget/render vocabulary grows centrally by design — genericity lives in data/metrics/dimensions,
+ * not in presentation (docs/ANALYTICS.md §13). A future `matrix` widget (rows × cols × 1 metric) covers
+ * cross-tabs and heatmaps; distribution widgets cover histograms — both purely additive to this union.
+ */
+export type WidgetType = "table" | "counter";
+/**
+ * One filter clause. Filters (and cells/totals below) are LISTS, not maps — the app-sdk http client
+ * deep-mangles every object KEY (camel<->snake), which would corrupt dimension ids / metric ids used as
+ * keys (they contain dots and mixed case). As list VALUES they pass through untouched. This mirrors the
+ * platform's existing {name,value}[] pattern (see AIProfile.toolPolicy).
+ */
+export interface FilterClause {
+    dimensionId: DimensionId;
+    value: string;
+}
+export type ReportFilters = FilterClause[];
+/** One metric value in a row/footer. A list entry, not a map key — see FilterClause above. */
+export interface MetricCell {
+    metricId: string;
+    value: number | null;
+}
+export interface DateRange {
+    from: number;
+    to: number;
+}
+export interface WidgetConfig {
+    type: WidgetType;
+    /** counter: exactly 1 metric; table: 1..n columns. */
+    metricIds: string[];
+    /** Row grouping. Required for table; omit for counter (grand aggregate). "time" → time-series rows. */
+    groupBy?: DimensionId;
+    filters?: ReportFilters;
+    range: DateRange;
+    grain: Grain;
+    /** counter only: also compute the delta vs. the equally-long previous period. */
+    compareToPrevious?: boolean;
+}
+export interface ReportColumn {
+    metricId: string;
+    /** Sent along so the UI knows valueType/label without a separate lookup. */
+    definition: MetricDefinition;
+}
+export interface ReportRow {
+    /** Dimension value (agentId/channelId/…) or period key when groupBy = "time". */
+    key: string;
+    /** One entry per column metric (order matches `columns`); value null = no data. */
+    cells: MetricCell[];
+}
+export interface TableResult {
+    type: "table";
+    groupBy: DimensionId;
+    columns: ReportColumn[];
+    rows: ReportRow[];
+    /** Footer: sum for count metrics, weighted average for avg. Suppress/label for multi-valued groupings. */
+    totals: MetricCell[];
+}
+export interface CounterResult {
+    type: "counter";
+    metricId: string;
+    definition: MetricDefinition;
+    value: number | null;
+    /** Filled when compareToPrevious. */
+    previous?: number | null;
+    /** (value - previous) / previous. */
+    deltaRatio?: number | null;
+}
+export type WidgetResult = TableResult | CounterResult;

package/dist/entities/analytics/source.d.ts

@@ -0,0 +1,52 @@
+import { DashboardDef, LocaleBundle } from './dashboard';
+import { DimensionDefinition } from './dimensions';
+import { MetricDefinition } from './metric';
+import { Grain, MetricFact } from './fact';
+/**
+ * Source discovery + ingest — the app↔app contract.
+ *
+ * Each source app declares `app.role({ type: "analytics-source" })` and implements
+ * `GET /analytics/describe` → AnalyticsSourceDescription. Analytics enumerates those roles (mirroring
+ * the `ai-tool` role auto-discovery) and composes the catalog.
+ */
+export interface AnalyticsSourceDescription {
+    /** The declaring app's name (== manifest.name == req.source.app). */
+    source: string;
+    /** Metric definitions this app owns. */
+    metrics: MetricDefinition[];
+    /** App-owned dimensions this app owns (namespaced). Do NOT repeat core dimensions. */
+    dimensions: DimensionDefinition[];
+    /** Preset dashboards this app ships (single-source). Titles are i18n keys resolved via `locales`. */
+    dashboards?: DashboardDef[];
+    /** Locale bundle for this app's dashboard/section title keys (lang -> key -> string). */
+    locales?: LocaleBundle;
+}
+/** The composed catalog analytics serves to the frontend (`GET /analytics/metrics`). */
+export interface MetricCatalog {
+    /** Merged across all sources. */
+    metrics: MetricDefinition[];
+    /** CORE_DIMENSIONS + every app-declared dimension. */
+    dimensions: DimensionDefinition[];
+}
+/** The composed dashboard catalog analytics serves to the frontend (`GET /dashboards`). */
+export interface DashboardCatalog {
+    /** All sources' preset dashboards (+ analytics' own cross-source ones), in discovery order. */
+    dashboards: DashboardDef[];
+    /** Merged locale bundle across all sources, for resolving dashboard/section title keys. */
+    locales: LocaleBundle;
+}
+/**
+ * A source app's rollup cron pushes its facts to `POST http://analytics/facts/ingest` (app-to-app auth,
+ * org via Bridge.tenant.id). Facts are snapshots: analytics replaces every existing fact within each
+ * (source, grain, period) by the pushed set, so a disappeared dimension leaves no orphan rows.
+ */
+export interface FactIngestRequest {
+    /** Caller org (== Bridge.tenant.id); included for validation. */
+    organizationId: string;
+    /** Declaring app (== req.source.app). */
+    source: string;
+    grain: Grain;
+    /** The period buckets this push fully covers — analytics replaces within each of these. */
+    periods: string[];
+    facts: MetricFact[];
+}

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

@@ -93,6 +93,12 @@ export interface Interaction {
     updatedAt?: number;
     lastActivityAt?: number;
     lastActivityPreview?: ActivityPreview;
+    /**
+     * Epoch-ms van de eerste uitgaande reactie op deze interactie. Eenmalig gezet door
+     * `applyActivityToInteraction` bij de eerste outbound-activity; drijft de first-response-time
+     * analytics-metric (firstResponseAt - createdAt). Afwezig = nog geen reactie.
+     */
+    firstResponseAt?: number;
     /**
      * Provider-side folder waar deze thread onder gearchiveerd staat (mail).
      * Gezet door de sync (folder-membership van already-engaged threads) en door

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

@@ -0,0 +1 @@
+export * from './types';

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

@@ -0,0 +1,154 @@
+import { OwnerScope } from '../contact/types';
+/**
+ * Playbooks — event-driven automation with AI steps. See docs/PLAYBOOKS.md.
+ * Fase 0 covers the deterministic subset; AI steps are typed here but the
+ * executor rejects them until Fase 2.
+ */
+export type Autonomy = "suggest" | "auto";
+export type PlaybookTrigger = {
+    kind: "activity";
+    activityTypes: string[];
+    /** Channel kinds: "mail" | "chat" | "voice" (derived from the activity type). */
+    channels?: string[];
+    /** Specific channel ids (e.g. per mailbox). Matched against activity.channelId. */
+    channelIds?: string[];
+    filter?: unknown;
+} | {
+    kind: "manual";
+};
+export interface Guardrails {
+    maxSteps?: number;
+    maxToolCalls?: number;
+    policyCaps?: Record<string, unknown>;
+}
+export interface ConditionStep {
+    type: "condition";
+    /** JSONLogic expression evaluated against the run vars. */
+    if: unknown;
+    /** Gate: what to do when the condition is false. "then" = the steps that follow. */
+    onFalse: "stop" | "escalate" | "continue";
+}
+export interface ForEachStep {
+    type: "for-each";
+    in: string;
+    as: string;
+    body: Step[];
+}
+export interface LookupStep {
+    type: "lookup";
+    /** "tool:<namespaced>" (Fase 1) or a local source ("interactions"/"tasks"). */
+    source: string;
+    filter?: unknown;
+    as: string;
+}
+export interface ActionStep {
+    type: "action";
+    /** Local action ("task.create"/"interaction.set"/"notify.user") or "tool:<namespaced>" (Fase 1). */
+    action: string;
+    params: Record<string, unknown>;
+    autonomy?: Autonomy;
+}
+/** AI steps — typed in Fase 0, executed from Fase 2. */
+export interface ClassifyStep {
+    type: "classify";
+    as: string;
+    accountId: string;
+    model: string;
+    mode: "topics" | "question" | "extract";
+    topicIds?: string[];
+    question?: string;
+    fields?: unknown;
+    instruction?: string;
+}
+export interface GenerateStep {
+    type: "generate";
+    profileId: string;
+    goal?: string;
+    kind: "reply" | "compose" | "note";
+    as?: string;
+}
+export interface AgentStep {
+    type: "agent";
+    profileId: string;
+    goal: string;
+    guardrails: Guardrails;
+    toolsOverride?: string[];
+    autonomy?: Autonomy;
+    as?: string;
+}
+export interface WaitForReplyStep {
+    type: "wait-for-reply";
+    deadline?: number;
+}
+export type Step = ConditionStep | ForEachStep | LookupStep | ActionStep | ClassifyStep | GenerateStep | AgentStep | WaitForReplyStep;
+export interface Playbook {
+    id: string;
+    organizationId: string;
+    ownerScope: OwnerScope;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    autonomy: Autonomy;
+    trigger: PlaybookTrigger;
+    steps: Step[];
+    /** Bumped on every change; runs pin to the version they started on. */
+    version: number;
+    /** Actor of autonomous actions. */
+    createdBy: string;
+    lastRunAt?: number;
+    stats?: {
+        runs: number;
+        proposals: number;
+        autoActions: number;
+    };
+}
+export type RunStatus = "pending" | "running" | "awaiting_approval" | "awaiting_reply" | "done" | "escalated" | "failed" | "timed_out" | "stopped";
+export interface RunStepTrace {
+    path: string;
+    type: string;
+    ok: boolean;
+    note?: string;
+    ms?: number;
+}
+export interface PlaybookRun {
+    id: string;
+    organizationId: string;
+    playbookId: string;
+    playbookVersion: number;
+    interactionId?: string;
+    status: RunStatus;
+    trigger: {
+        activityType?: string;
+        activityId?: string;
+        event: Record<string, unknown>;
+    };
+    vars: Record<string, unknown>;
+    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. */
+    pending?: {
+        stepIndex: number;
+        actions: {
+            action: string;
+            params: Record<string, unknown>;
+        }[];
+    };
+    /** 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;
+    rounds?: number;
+    /** Denormalized interaction audience for efficient list-filtering. */
+    audience?: string[];
+    createdBy: string;
+    approvedBy?: string;
+    result?: {
+        ok: boolean;
+        error?: string;
+    };
+    lastStepAt?: number;
+}

package/dist/index.cjs

@@ -1,3 +1,8 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=140;function i(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 I(e){const t=e.trim();return t.length<=l?t:t.slice(0,l-1).trimEnd()+"…"}function E(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 _(e){switch(e.type){case"EMAIL_RECEIVED":case"EMAIL_SENT":{const t=e.payload,n=t.bodySnippet?.trim()||i(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?` (${E(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?` (${E(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"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?` (${E(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 T(e){return{activityId:e.id,type:e.type,snippet:I(_(e)),authorName:e.author?.name??"",direction:e.direction,createdAt:e.createdAt??Date.now()}}function g(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 S=new Set(["mail","message"]);function u(e,t){const n=e.settings?.signatures?.[t];return!n||!n.enabled||!n.body||n.body.trim()===""?null:n}function f(e,t,n,r="html"){if(!e)return n;const s=u(e,t);return s?`${n}${r==="text"?`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=140;function p(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 b(e){const t=e.trim();return t.length<=E?t:t.slice(0,E-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 D(e){switch(e.type){case"EMAIL_RECEIVED":case"EMAIL_SENT":{const t=e.payload,n=t.bodySnippet?.trim()||p(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 N(e){return{activityId:e.id,type:e.type,snippet:b(D(e)),authorName:e.author?.name??"",direction:e.direction,createdAt:e.createdAt??Date.now()}}function O(e,t,n=[]){const r=e.createdAt;if(!r)return[];const a=new Set(n);return e.author.type==="user"&&e.author.id&&a.add(e.author.id),Object.entries(t).filter(([s,o])=>o>=r&&!a.has(s)).map(([s])=>s)}const R=[{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 C(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 A(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 g(e,t){const n=new Date(e);return n.setUTCMinutes(0,0,0),t==="day"&&n.setUTCHours(0),n.getTime()}const L=36e5,M=864e5;function m(e,t,n){const r=n==="hour"?L:M,a=[];for(let s=g(e,n);s<=t;s+=r)a.push(A(s,n));return a}const P=new Set(["mail","message"]);function T(e,t){const n=e.settings?.signatures?.[t];return!n||!n.enabled||!n.body||n.body.trim()===""?null:n}function y(e,t,n,r="html"){if(!e)return n;const a=T(e,t);return a?`${n}${r==="text"?`
 
-`:t==="mail"?"<br><br>-- <br>":"<br><br>"}${s.body}`:n}function N(e){return e.endpoints??[]}const D=e=>!!e.assignedUserId||!!e.assignedInboxId,R=e=>e.status==="closed",L=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,O=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function C(e,t){return e.lastActivityAt?!(e.seenBy??[]).includes(t):!1}function c(e,t){const n=new Set(e.disabledIntents??[]),r=e.intentOverrides??{},s=t.intents.filter(o=>!n.has(o.intent)).map(o=>b(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 d(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 M(e,t){const n=d(e,t);return Object.entries(n).filter(([,r])=>!r).map(([r])=>r)}function b(e,t){return t?{intent:t.intent??e.intent,targetSchemes:t.targetSchemes??e.targetSchemes,transport:t.transport??e.transport}:e}function m(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))n.push({channel:r,description:s,capability:a})}return n}function P(e,t){return t.filter(n=>n.capability.intent===e)}function p(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function U(e,t){return p(e.scheme,t)}function G(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 A=(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))(A||{});const y="message_window",V="message_templates",h={FROM:"from",TO:"to",CC:"cc",BCC:"bcc",ORGANIZER:"organizer",PRESENTER:"presenter",ATTENDEE:"attendee",OWNER:"owner",MEMBER:"member",GUEST:"guest",HOST:"host",PARTICIPANT:"participant"},H=(e,t)=>({intent:e,...t}),$="folder_management",F="remote_search",w={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},B=9e4,x="installation-id";exports.CommunicationScheme=A;exports.FEATURE_FOLDER_MANAGEMENT=$;exports.FEATURE_REMOTE_SEARCH=F;exports.INSTALLATION_HEADER=x;exports.InteractionParticipantRole=h;exports.PRESENCE_ONLINE_WINDOW_MS=B;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=V;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=y;exports.SIGNATURE_INTENTS=S;exports.UNSUPPORTED=w;exports.applySignature=f;exports.buildActivityPreview=T;exports.buildChannelIntents=m;exports.defineIntent=H;exports.disabledIntentsFromCapabilities=M;exports.filterByEndpoint=U;exports.filterByIntent=P;exports.filterByTargetScheme=p;exports.getActivitySeenUserIds=g;exports.getContactEndpoints=N;exports.getShortTitle=O;exports.getUrgencyScore=L;exports.isAssigned=D;exports.isClosed=R;exports.isInteractionUnseen=C;exports.matchContactToIntents=G;exports.resolveAccountCapabilities=d;exports.resolveChannelIntents=c;exports.resolveSignature=u;exports.stripHtml=i;
+`:t==="mail"?"<br><br>-- <br>":"<br><br>"}${a.body}`:n}function h(e){return e.endpoints??[]}const U=e=>!!e.assignedUserId||!!e.assignedInboxId,$=e=>e.status==="closed",G=e=>({urgent:10,high:5,normal:2,low:1})[e.priority]||0,H=(e,t=30)=>e.title?.length<=t?e.title:`${e.title.substring(0,t)}...`;function V(e,t){return e.lastActivityAt?!(e.seenBy??[]).includes(t):!1}const F=[/<blockquote/i,/class="?gmail_quote/i,/id="?[^"]*divRplyFwdMsg/i,/-{3,}\s*Original Message\s*-{3,}/i,/\n_{5,}\s*\n/,/\bOn\b[\s\S]{0,200}?\bwrote:/i];function c(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 u(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){return e.replace(/\r/g,"").replace(/[ \t]+/g," ").replace(/ *\n */g,`
+`).replace(/\n{3,}/g,`
+
+`).trim()}function k(e){if(typeof e!="string"||!e)return"";let t=e.length;for(const a of F){const s=e.search(a);s>=0&&s<t&&(t=s)}const n=e.slice(0,t);let r=d(u(c(n)));return r||(r=d(u(c(e)))),r}function I(e,t){const n=new Set(e.disabledIntents??[]),r=e.intentOverrides??{},a=t.intents.filter(o=>!n.has(o.intent)).map(o=>x(o,r[o.intent]));if(!e.extraIntents||e.extraIntents.length===0)return a;const s=new Set(a.map(o=>o.intent));for(const o of e.extraIntents)s.has(o.intent)||(a.push(o),s.add(o.intent));return a}function _(e,t){const n={};for(const r of e.intents){if(!r.togglable)continue;const a=t?.[r.intent];n[r.intent]=a??r.defaultEnabled??!0}return n}function w(e,t){const n=_(e,t);return Object.entries(n).filter(([,r])=>!r).map(([r])=>r)}function x(e,t){return t?{intent:t.intent??e.intent,targetSchemes:t.targetSchemes??e.targetSchemes,transport:t.transport??e.transport}:e}function B(e,t){const n=[];for(const r of e){if(!r.enabled)continue;const a=t[r.providerId];if(a)for(const s of I(r,a))n.push({channel:r,description:a,capability:s})}return n}function W(e,t){return t.filter(n=>n.capability.intent===e)}function f(e,t){return t.filter(n=>n.capability.targetSchemes.includes(e))}function j(e,t){return f(e.scheme,t)}function K(e,t,n){const r=[];for(const a of e)for(const s of n)s.capability.intent===t&&s.capability.targetSchemes.includes(a.scheme)&&r.push({channelIntent:s,endpoint:a});return r}var S=(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))(S||{});const Y="message_window",q="message_templates",z={FROM:"from",TO:"to",CC:"cc",BCC:"bcc",ORGANIZER:"organizer",PRESENTER:"presenter",ATTENDEE:"attendee",OWNER:"owner",MEMBER:"member",GUEST:"guest",HOST:"host",PARTICIPANT:"participant"},J=(e,t)=>({intent:e,...t}),X="folder_management",Q="remote_search",Z={ok:!1,code:"UNSUPPORTED",message:"Provider does not support this op"},v=9e4,ee="installation-id";exports.CORE_DIMENSIONS=R;exports.CommunicationScheme=S;exports.FEATURE_FOLDER_MANAGEMENT=X;exports.FEATURE_REMOTE_SEARCH=Q;exports.INSTALLATION_HEADER=ee;exports.InteractionParticipantRole=z;exports.PRESENCE_ONLINE_WINDOW_MS=v;exports.PROVIDER_FEATURE_MESSAGE_TEMPLATES=q;exports.PROVIDER_FEATURE_MESSAGE_WINDOW=Y;exports.SIGNATURE_INTENTS=P;exports.UNSUPPORTED=Z;exports.applySignature=y;exports.buildActivityPreview=N;exports.buildChannelIntents=B;exports.cleanMessageText=k;exports.defineIntent=J;exports.disabledIntentsFromCapabilities=w;exports.filterByEndpoint=j;exports.filterByIntent=W;exports.filterByTargetScheme=f;exports.flattenLocales=C;exports.floorToPeriod=g;exports.formatPeriod=A;exports.getActivitySeenUserIds=O;exports.getContactEndpoints=h;exports.getShortTitle=H;exports.getUrgencyScore=G;exports.isAssigned=U;exports.isClosed=$;exports.isInteractionUnseen=V;exports.matchContactToIntents=K;exports.periodsInRange=m;exports.resolveAccountCapabilities=_;exports.resolveChannelIntents=I;exports.resolveSignature=T;exports.stripHtml=p;

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './entities/activity';
+export * from './entities/analytics';
+export * from './entities/playbook';
 export * from './entities/kb';
 export * from './entities/topic';
 export * from './entities/ai-account';
@@ -22,6 +24,7 @@ export * from './entities/organization';
 export * from './entities/shopify';
 export * from './entities/transcript';
 export * from './entities/user';
+export * from './text/message';
 export * from './platform/ai-tools';
 export * from './platform/api';
 export * from './platform/common';

package/dist/index.js

@@ -1,20 +1,20 @@
-function u(e) {
+function p(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 l(e) {
+function d(e) {
   const t = e.trim();
   return t.length <= 140 ? t : t.slice(0, 139).trimEnd() + "…";
 }
-function E(e) {
+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 p(e) {
+function A(e) {
   switch (e.type) {
     case "EMAIL_RECEIVED":
     case "EMAIL_SENT": {
-      const t = e.payload, n = t.bodySnippet?.trim() || u(t.body ?? "");
+      const t = e.payload, n = t.bodySnippet?.trim() || p(t.body ?? "");
       return t.subject ? `${t.subject} — ${n}` : n;
     }
     case "CHAT_MESSAGE_SENT":
@@ -29,7 +29,7 @@ function p(e) {
     case "CHAT_CALL_STARTED":
       return "Gesprek gestart";
     case "CHAT_CALL_ENDED":
-      return `Gesprek beëindigd${e.payload.duration ? ` (${E(e.payload.duration)})` : ""}`;
+      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":
@@ -46,7 +46,7 @@ function p(e) {
       return "Hervat";
     case "VOICE_CALL_ENDED":
     case "VIDEO_CALL_ENDED":
-      return `Gesprek beëindigd${e.payload.duration ? ` (${E(e.payload.duration)})` : ""}`;
+      return `Gesprek beëindigd${e.payload.duration ? ` (${l(e.payload.duration)})` : ""}`;
     case "VOICE_CALL_MISSED":
     case "VIDEO_CALL_MISSED":
       return "Gemiste oproep";
@@ -59,12 +59,20 @@ function p(e) {
       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 ? ` (${E(e.payload.duration)})` : ""}`;
+      return `Vergadering beëindigd${e.payload.duration ? ` (${l(e.payload.duration)})` : ""}`;
     case "MEETING_PARTICIPANT_JOINED":
       return `${e.payload.name} deelgenomen`;
     case "MEETING_PARTICIPANT_LEFT":
@@ -83,103 +91,176 @@ function p(e) {
       return "";
   }
 }
-function T(e) {
+function C(e) {
   return {
     activityId: e.id,
     type: e.type,
-    snippet: l(p(e)),
+    snippet: d(A(e)),
     authorName: e.author?.name ?? "",
     direction: e.direction,
     createdAt: e.createdAt ?? Date.now()
   };
 }
-function g(e, t, n = []) {
+function R(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 a = new Set(n);
+  return e.author.type === "user" && e.author.id && a.add(e.author.id), Object.entries(t).filter(([s, o]) => o >= r && !a.has(s)).map(([s]) => s);
+}
+const M = [
+  { 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 u(e) {
+  return e < 10 ? `0${e}` : `${e}`;
+}
+function g(e, t) {
+  const n = new Date(e), r = `${n.getUTCFullYear()}-${u(n.getUTCMonth() + 1)}-${u(n.getUTCDate())}`;
+  return t === "day" ? r : `${r}T${u(n.getUTCHours())}`;
+}
+function T(e, t) {
+  const n = new Date(e);
+  return n.setUTCMinutes(0, 0, 0), t === "day" && n.setUTCHours(0), n.getTime();
+}
+const f = 36e5, _ = 864e5;
+function P(e, t, n) {
+  const r = n === "hour" ? f : _, a = [];
+  for (let s = T(e, n); s <= t; s += r)
+    a.push(g(s, n));
+  return a;
 }
-const f = /* @__PURE__ */ new Set(["mail", "message"]);
-function d(e, t) {
+const $ = /* @__PURE__ */ 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 D(e, t, n, r = "html") {
+function h(e, t, n, r = "html") {
   if (!e) return n;
-  const s = d(e, t);
-  return s ? `${n}${r === "text" ? `
+  const a = I(e, t);
+  return a ? `${n}${r === "text" ? `
 
-` : t === "mail" ? "<br><br>-- <br>" : "<br><br>"}${s.body}` : n;
+` : t === "mail" ? "<br><br>-- <br>" : "<br><br>"}${a.body}` : n;
 }
-function N(e) {
+function y(e) {
   return e.endpoints ?? [];
 }
-const S = (e) => !!e.assignedUserId || !!e.assignedInboxId, L = (e) => e.status === "closed", R = (e) => ({
+const U = (e) => !!e.assignedUserId || !!e.assignedInboxId, H = (e) => e.status === "closed", V = (e) => ({
   urgent: 10,
   high: 5,
   normal: 2,
   low: 1
-})[e.priority] || 0, O = (e, t = 30) => e.title?.length <= t ? e.title : `${e.title.substring(0, t)}...`;
-function C(e, t) {
+})[e.priority] || 0, G = (e, t = 30) => e.title?.length <= t ? e.title : `${e.title.substring(0, t)}...`;
+function k(e, t) {
   return e.lastActivityAt ? !(e.seenBy ?? []).includes(t) : !1;
 }
-function c(e, t) {
-  const n = new Set(e.disabledIntents ?? []), r = e.intentOverrides ?? {}, s = t.intents.filter((o) => !n.has(o.intent)).map((o) => A(o, r[o.intent]));
-  if (!e.extraIntents || e.extraIntents.length === 0) return s;
-  const a = new Set(s.map((o) => o.intent));
+const S = [
+  /<blockquote/i,
+  /class="?gmail_quote/i,
+  // Gmail quote container
+  /id="?[^"]*divRplyFwdMsg/i,
+  // Outlook web reply/forward header
+  /-{3,}\s*Original Message\s*-{3,}/i,
+  /\n_{5,}\s*\n/,
+  // Outlook underscore separator before "From:"
+  /\bOn\b[\s\S]{0,200}?\bwrote:/i
+  // Gmail "On <date> <name> wrote:"
+];
+function c(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 E(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 i(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 S) {
+    const s = e.search(a);
+    s >= 0 && s < t && (t = s);
+  }
+  const n = e.slice(0, t);
+  let r = i(E(c(n)));
+  return r || (r = i(E(c(e)))), r;
+}
+function b(e, t) {
+  const n = new Set(e.disabledIntents ?? []), r = e.intentOverrides ?? {}, a = t.intents.filter((o) => !n.has(o.intent)).map((o) => O(o, r[o.intent]));
+  if (!e.extraIntents || e.extraIntents.length === 0) return a;
+  const s = new Set(a.map((o) => o.intent));
   for (const o of e.extraIntents)
-    a.has(o.intent) || (s.push(o), a.add(o.intent));
-  return s;
+    s.has(o.intent) || (a.push(o), s.add(o.intent));
+  return a;
 }
-function i(e, t) {
+function D(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;
+    const a = t?.[r.intent];
+    n[r.intent] = a ?? r.defaultEnabled ?? !0;
   }
   return n;
 }
-function M(e, t) {
-  const n = i(e, t);
+function x(e, t) {
+  const n = D(e, t);
   return Object.entries(n).filter(([, r]) => !r).map(([r]) => r);
 }
-function A(e, t) {
+function O(e, t) {
   return t ? {
     intent: t.intent ?? e.intent,
     targetSchemes: t.targetSchemes ?? e.targetSchemes,
     transport: t.transport ?? e.transport
   } : e;
 }
-function b(e, t) {
+function F(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))
-        n.push({ channel: r, description: s, capability: a });
+    const a = t[r.providerId];
+    if (a)
+      for (const s of b(r, a))
+        n.push({ channel: r, description: a, capability: s });
   }
   return n;
 }
-function P(e, t) {
+function B(e, t) {
   return t.filter((n) => n.capability.intent === e);
 }
-function I(e, t) {
+function N(e, t) {
   return t.filter((n) => n.capability.targetSchemes.includes(e));
 }
-function m(e, t) {
-  return I(e.scheme, t);
+function j(e, t) {
+  return N(e.scheme, t);
 }
-function G(e, t, n) {
+function W(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 });
+  for (const a of e)
+    for (const s of n)
+      s.capability.intent === t && s.capability.targetSchemes.includes(a.scheme) && r.push({ channelIntent: s, endpoint: a });
   return r;
 }
-var _ = /* @__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))(_ || {});
-const V = "message_window", $ = "message_templates", H = {
+var L = /* @__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))(L || {});
+const K = "message_window", Y = "message_templates", q = {
   // E-mail
   FROM: "from",
   TO: "to",
@@ -196,36 +277,42 @@ const V = "message_window", $ = "message_templates", H = {
   // Voice/conference
   HOST: "host",
   PARTICIPANT: "participant"
-}, U = (e, t) => ({ intent: e, ...t }), h = "folder_management", y = "remote_search", w = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, x = 9e4, F = "installation-id";
+}, X = (e, t) => ({ intent: e, ...t }), z = "folder_management", J = "remote_search", Q = { ok: !1, code: "UNSUPPORTED", message: "Provider does not support this op" }, Z = 9e4, v = "installation-id";
 export {
-  _ as CommunicationScheme,
-  h as FEATURE_FOLDER_MANAGEMENT,
-  y as FEATURE_REMOTE_SEARCH,
-  F as INSTALLATION_HEADER,
-  H as InteractionParticipantRole,
-  x as PRESENCE_ONLINE_WINDOW_MS,
-  $ as PROVIDER_FEATURE_MESSAGE_TEMPLATES,
-  V as PROVIDER_FEATURE_MESSAGE_WINDOW,
-  f as SIGNATURE_INTENTS,
-  w as UNSUPPORTED,
-  D as applySignature,
-  T as buildActivityPreview,
-  b as buildChannelIntents,
-  U as defineIntent,
-  M as disabledIntentsFromCapabilities,
-  m as filterByEndpoint,
-  P as filterByIntent,
-  I as filterByTargetScheme,
-  g as getActivitySeenUserIds,
-  N as getContactEndpoints,
-  O as getShortTitle,
-  R as getUrgencyScore,
-  S as isAssigned,
-  L as isClosed,
-  C as isInteractionUnseen,
-  G as matchContactToIntents,
-  i as resolveAccountCapabilities,
-  c as resolveChannelIntents,
-  d as resolveSignature,
-  u as stripHtml
+  M as CORE_DIMENSIONS,
+  L as CommunicationScheme,
+  z as FEATURE_FOLDER_MANAGEMENT,
+  J as FEATURE_REMOTE_SEARCH,
+  v as INSTALLATION_HEADER,
+  q as InteractionParticipantRole,
+  Z as PRESENCE_ONLINE_WINDOW_MS,
+  Y as PROVIDER_FEATURE_MESSAGE_TEMPLATES,
+  K as PROVIDER_FEATURE_MESSAGE_WINDOW,
+  $ as SIGNATURE_INTENTS,
+  Q as UNSUPPORTED,
+  h as applySignature,
+  C as buildActivityPreview,
+  F as buildChannelIntents,
+  w as cleanMessageText,
+  X as defineIntent,
+  x as disabledIntentsFromCapabilities,
+  j as filterByEndpoint,
+  B as filterByIntent,
+  N as filterByTargetScheme,
+  m as flattenLocales,
+  T as floorToPeriod,
+  g as formatPeriod,
+  R as getActivitySeenUserIds,
+  y as getContactEndpoints,
+  G as getShortTitle,
+  V as getUrgencyScore,
+  U as isAssigned,
+  H as isClosed,
+  k as isInteractionUnseen,
+  W as matchContactToIntents,
+  P as periodsInRange,
+  D as resolveAccountCapabilities,
+  b as resolveChannelIntents,
+  I as resolveSignature,
+  p as stripHtml
 };

package/dist/text/message.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Clean an inbound message body for display/LLM use: cut the quoted reply /
+ * forwarded thread, strip HTML, decode common entities, collapse whitespace.
+ * Without this the raw HTML + full Gmail/Outlook quote leaks the OLD message into
+ * classify/extract/agent (or history views) instead of the sender's new content.
+ * Pure, dependency-free (lives in domain so both server apps can share it).
+ */
+export declare function cleanMessageText(raw: unknown): string;

package/package.json

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