@opencxh/domain 1.165.0 → 1.170.0

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

@@ -28,12 +28,15 @@ export interface AIProfile<T extends Record<string, any> = Record<string, any>>
     /** 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.
+     * Per-tool confirmation policy, stored as a LIST (not a keyed map).
+     *
+     * De oorspronkelijke reden was dwingend: de SDK-client transformeerde élke object-key
+     * camel↔snake, en dat verminkte een genamespacede toolnaam (`communication__compose_email` →
+     * `communication_ComposeEmail`) zodat hij niet meer matchte met `enabledTools`. **Die transform
+     * is 17-08-2026 verwijderd**, dus een map zou nu werken.
+     *
+     * De lijst blijft staan: hij zit op bestaande profielrijen met een formulier eroverheen, en een
+     * migratie zou alleen een prettigere vorm opleveren. `enabledTools` ernaast is ook een lijst.
      *
      * Under autonomy "suggest", write tools are held for approval; reads run freely.
      * A tool absent from this list defaults to "write" (safe).

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

@@ -42,9 +42,11 @@ export interface DashboardDef {
     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.
+ * A single localized string. Kept as a flat LIST (not a lang->key->value map).
+ *
+ * The original reason (the http client mangled object KEYS, so "comms.dash.resolution_over_time" as a
+ * key got corrupted) no longer applies — that transform was removed on 2026-08-17. The flat list is
+ * kept because every consumer already iterates it and a nested map would be a migration for looks.
  */
 export interface LocaleString {
     lang: string;

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

@@ -12,10 +12,12 @@ import { MetricDefinition } from './metric';
  */
 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).
+ * One filter clause. Filters (and cells/totals below) are LISTS, not maps.
+ *
+ * The original reason was that the http client mangled object keys; that transform was removed on
+ * 2026-08-17 and keys now travel untouched. The shape stays, for a reason that always held and is
+ * the stronger one: **a filter list can carry the same dimension twice** (`status=open` OR
+ * `status=pending`), and a map cannot. Same for cells, which mirror a table row.
  */
 export interface FilterClause {
     dimensionId: DimensionId;

package/dist/entities/contact-source/types.d.ts

@@ -20,8 +20,11 @@ export interface ContactSourceConfig {
      * Either a built-in source id (`microsoft-directory`, `google`, `eylo-voip`, `local`)
      * or an AI tool name (`mcp__<id>__search_companies`).
      *
-     * A field VALUE, never an object key: the SDK client deep-mangles object keys between
-     * camel and snake case, which would corrupt any namespaced name used as a key.
+     * A field VALUE, never an object key.
+     *
+     * The original reason (the SDK client mangled object keys) is gone as of 2026-08-17. It stays a
+     * value because this is a table row: it carries `order`, `search` and `enrich` alongside, and a
+     * map has no ordering.
      */
     sourceId: string;
     kind: "internal" | "mcp";

package/dist/entities/external-identity/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Wie is "Asana-gebruiker 1203847" hier?
+ *
+ * Deze laag bestond niet, en dat is precies waarom `apps/asana` zijn `assignees` leeg laat: een
+ * Asana-assignee is een gid, en die één-op-één overnemen zou werk toewijzen aan een id dat in dit
+ * platform niemand is — werk op naam van een spook. De enige twee opties waren "veld weglaten" of
+ * "per app een hack", en elke volgende connector die assignees, auteurs, reviewers of commenters
+ * synct loopt er opnieuw tegenaan.
+ *
+ * ## Waarom dit een eigen store is en geen veld
+ *
+ * Een externe identiteit is **niet** hetzelfde als de vier dingen die er op lijken:
+ *
+ * | Lijkt erop | Is | Waarom niet hetzelfde |
+ * |---|---|---|
+ * | `externalId` op een record | dedupe-as voor één rij | zegt niets over personen |
+ * | `ManagedAccount.metadata.externalUserId` | de identiteit van een *verbonden account* | één per account, en alleen van wie zelf verbond |
+ * | `ManagedAccount.userId` | van wie is dit credential | eigendom, geen mapping |
+ * | `Contact` / shadow contact | een persoon *buiten* de organisatie | een assignee is iemand *binnen* de organisatie, in een extern systeem |
+ *
+ * De vraag hier is de vijfde: welke platform-gebruiker hóórt bij dit externe account. Die heeft
+ * een eigen levensduur (je koppelt hem één keer, hij geldt voor elke connector-ronde daarna) en
+ * een eigen beheer-oppervlak ("3 van de 12 Asana-gebruikers gekoppeld").
+ *
+ * ## Waarom in `apps/user`
+ *
+ * Bij de app die gebruikers bezit. De e-mail-bootstrap heeft de tenant-roster nodig en die staat
+ * daar; en niet-sync-consumenten (AI-tools, webhooks, companion-apps) kunnen hem net zo goed
+ * gebruiken. In de sync-pijplijn zetten zou hem onbruikbaar maken buiten sync.
+ */
+/**
+ * Hoe zeker weten we dat deze koppeling klopt?
+ *
+ * De drie waarden zijn geen kwaliteitslabel maar een **beslissingsas**: alleen bij `confirmed` en
+ * `email-match` mag er een `userId` aan hangen, en een `unmatched`-rij bestaat juist om zichtbaar
+ * te maken dat er iets te koppelen valt.
+ */
+export type ExternalIdentityConfidence = 
+/** Een mens heeft dit gekoppeld. Wordt nooit door een bootstrap overschreven. */
+"confirmed"
+/** Het externe adres matchte exact op het adres van een actieve gebruiker. */
+ | "email-match"
+/** Bekend extern account, geen platform-gebruiker gevonden. `userId` is leeg. */
+ | "unmatched";
+export interface ExternalIdentity {
+    id: string;
+    organizationId: string;
+    /**
+     * Welk extern systeem. De catalogus-sleutel van de connector (`"asana"`) of de app-namespace
+     * (`"microsoft"`) — hetzelfde vocabulaire als `SyncSourceDefinition.connectorHint`.
+     *
+     * Bewust niet het connector-**id**: twee organisatie-verbindingen naar hetzelfde product delen
+     * dezelfde gebruikers, en dan zou je de mapping twee keer moeten doen.
+     */
+    connectorKey: string;
+    /** Het id van deze persoon in dat systeem: een Asana-gid, een Graph-`oid`, een Slack-user-id. */
+    externalId: string;
+    /** De platform-gebruiker. Leeg bij `confidence: "unmatched"`. */
+    userId?: string;
+    /** Wat het externe systeem als adres gaf. Bewaard zodat een latere bootstrap kan matchen. */
+    externalEmail?: string;
+    /** Wat het externe systeem als naam gaf. Alleen om de beheerlijst leesbaar te maken. */
+    externalName?: string;
+    confidence: ExternalIdentityConfidence;
+    createdAt?: number;
+    updatedAt?: number;
+}
+/** Eén extern account waarover een connector een vraag stelt. */
+export interface ExternalIdentityQuery {
+    externalId: string;
+    /** Als het externe systeem een adres geeft. Zonder dit kan de bootstrap niets matchen. */
+    email?: string;
+    name?: string;
+}
+/**
+ * `POST /external-identity/resolve` — **batch**, want één sync-pagina draagt er tientallen.
+ *
+ * Per record vragen zou per pagina tientallen app-grenzen kosten, en dat is precies de fout die
+ * `landRecords` al vermijdt door per soort te groeperen.
+ */
+export interface ResolveExternalIdentitiesRequest {
+    connectorKey: string;
+    externals: ExternalIdentityQuery[];
+}
+/** Wat de resolve teruggeeft per extern id. `userId` afwezig = niets om aan toe te wijzen. */
+export interface ResolvedExternalIdentity {
+    userId?: string;
+    confidence: ExternalIdentityConfidence;
+}
+export interface ResolveExternalIdentitiesResponse {
+    /**
+     * Op `externalId`. Elk gevraagd id staat erin, ook de niet-gematchte — een ontbrekende sleutel
+     * en "geen match" zijn twee verschillende dingen, en de beller mag ze niet hoeven raden.
+     *
+     * Een gewone map is hier veilig: sinds de camelCase-transform op antwoorden verwijderd is
+     * (17-08-2026) reizen sleutels ongeschonden, dus een gid met een punt of een streep erin komt
+     * heel aan.
+     */
+    resolved: Record<string, ResolvedExternalIdentity>;
+}
+/** `POST /external-identity/link` — een mens wijst de koppeling aan. */
+export interface LinkExternalIdentityRequest {
+    connectorKey: string;
+    externalId: string;
+    /** Leeg = ontkoppelen; de rij blijft bestaan als `unmatched`. */
+    userId?: string;
+}

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

@@ -22,8 +22,11 @@ export interface KnowledgeBase {
      *  `defaultLocale`; kept so the backfill can still read it. */
     locale?: KbLocale;
 }
-/** A name and blurb for one language. Never a map keyed by locale: the http
- *  client mangles object keys, so `{ "nl-NL": … }` does not survive the wire. */
+/** A name and blurb for one language.
+ *
+ *  A list, not a map keyed by locale. The original reason (the http client mangled object keys) is
+ *  gone as of 2026-08-17 — a map would now survive the wire. Kept as a list because it is stored
+ *  data with a form and a backfill behind it, and a migration would buy nothing but a nicer shape. */
 export interface KbTranslation {
     locale: KbLocale;
     name: string;

package/dist/entities/memory/item.d.ts

@@ -13,9 +13,11 @@ export type MemoryKindId = string;
  * Een verwijzing naar iets anders — intern (`interaction:i_2`) of extern
  * (`hubspot:5591`, `clickup:86ab2`).
  *
- * Een **lijst**, nooit een object met de relatie als key: de app-sdk http-client
- * mangelt elke object-key camel<->snake, dus `{ "crm.company": "..." }` komt verminkt
- * aan de andere kant aan.
+ * Een **lijst**, nooit een object met de relatie als key.
+ *
+ * De oorspronkelijke reden (de http-client mangelde object-keys) geldt niet meer sinds 17-08-2026.
+ * De lijst blijft om een reden die altijd al sterker was: **dezelfde `rel` mag twee keer voorkomen**
+ * — twee gekoppelde bedrijven, drie betrokken interacties — en een map gooit er dan één weg.
  */
 export interface MemoryLink {
     rel: string;

package/dist/entities/memory/kind.d.ts

@@ -48,7 +48,7 @@ export interface MemorySourceDescription {
     /** De declarerende app (== `manifest.name` == `req.source.app`). */
     source: string;
     kinds: MemoryKindDefinition[];
-    /** Vlakke LIJST: keys met een punt worden gemangeld. */
+    /** Vlakke LIJST, zoals {@link LocaleBundle}; zie daar waarom die vorm blijft. */
     locales?: LocaleBundle;
     /** Fase 3: welke subjects/kinds deze bron live kan leveren. */
     live?: {

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

@@ -61,7 +61,7 @@ export interface AssignmentSourceDescription {
     /** De declarerende app (== `manifest.name` == `req.source.app`). */
     source: string;
     targets: AssignmentTargetKind[];
-    /** Vlakke LIJST: keys met een punt worden gemangeld. */
+    /** Vlakke LIJST, zoals {@link LocaleBundle}; zie daar waarom die vorm blijft. */
     locales?: LocaleBundle;
 }
 /** De samengestelde catalogus die de hub aan de builder levert. */

package/dist/index.d.ts

@@ -34,7 +34,7 @@ export * from './entities/team';
 export * from './entities/time-entry';
 export * from './entities/organization';
 export * from './entities/shopify';
-export * from './entities/transcript';
+export * from './entities/external-identity';
 export * from './entities/user';
 export * from './entities/webhook';
 export * from './entities/work';

package/dist/platform/media.d.ts

@@ -9,6 +9,17 @@ export interface AudioSegment {
     endedAt: number;
     avgRMS: number;
     isFinal: boolean;
+    /**
+     * Dit segment begint midden in een lopende zin, omdat de VAD op
+     * `maxSpeechDurationMs` hard moest knippen in plaats van op een stilte.
+     *
+     * Dit is het enige geval waarin twee opeenvolgende segmenten elkaars tekst kunnen
+     * overlappen, en dus het enige geval waarin de naad geplakt moet worden. Een knip op
+     * stilte valt tussen twee woorden: daar valt niets te ontdubbelen. Zonder deze vlag
+     * moest de ontvanger dat verschil raden, en dat raden was de hele reden dat er drie
+     * fuzzy dedupe-lagen bestonden.
+     */
+    continuesPrevious?: boolean;
 }
 export interface TranscriptWord {
     text: string;
@@ -33,6 +44,8 @@ export interface TranscriptSegment {
     endedAt: number;
     language?: string;
     confidence?: number;
+    /** Zie {@link AudioSegment.continuesPrevious} — reist mee zodat de store de naad kent. */
+    continuesPrevious?: boolean;
 }
 export interface AudioPipelineOptions {
     silenceThreshold: number;
@@ -40,7 +53,10 @@ export interface AudioPipelineOptions {
     speechFrameRatio: number;
     silenceDurationMs: number;
     maxSpeechDurationMs: number;
+    /** Naad-overlap, uitsluitend toegepast na een harde `maxSpeechDurationMs`-knip. */
     overlapMs: number;
+    /** Audio die vóór de spraak-onset bewaard blijft, zodat de eerste klank niet wegvalt. */
+    preRollMs: number;
 }
 export type MediaPermissionKind = "microphone" | "camera";
 export type MediaPermissionState = "granted" | "denied" | "prompt" | "unsupported";

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

@@ -212,10 +212,15 @@ export interface SyncRecord {
     /**
      * De velden voor de doel-app.
      *
-     * **Vaste veldnamen, nooit een map met een extern id als sleutel.** De SDK-client mangelt
-     * object-sleutels tussen camel- en snake-case, dus data die ín een sleutel zit komt
-     * verminkt aan. Dezelfde les die `chatCursors` een lijst maakte en `ContactSource.sourceId`
-     * een veldwaarde.
+     * **Vaste veldnamen, nooit een map met een extern id als sleutel.**
+     *
+     * Hier stond de sleutel-mangeling van de SDK-client als reden. Die gold voor dit veld
+     * **nooit**: een `SyncRecord` reist van bron-app naar doel-app over `Bridge.rpc` en komt nooit
+     * bij een browser langs. (En sinds 17-08-2026 mangelt de client helemaal niets meer.)
+     *
+     * De regel blijft, om de reden die er werkelijk is: de doel-app moet de velden kunnen *typen*.
+     * `{ "asana_gid_123": {...} }` is voor `upsertWorkItemFromExternal` niet te lezen zonder eerst
+     * te weten wat de bron erin stopte, en dan verschuift elke fout van `tsc` naar runtime.
      */
     data: Record<string, unknown>;
     /**

package/dist/platform/ui.d.ts

@@ -5,7 +5,7 @@ export interface ModalConfig {
     id: string;
     displayName: string;
     resource: string;
-    size?: 'sm' | 'md' | 'lg' | 'xl';
+    size?: 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
     position?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'corner' | 'sidebar';
     props?: Record<string, any>;
     hideHeader?: boolean;

package/package.json

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

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

@@ -1,10 +0,0 @@
-export interface Transcript {
-    id: string;
-    organizationId: string;
-    interactionId: string;
-    serviceName: string;
-    text: string;
-    speaker?: string;
-    startTime?: number;
-    endTime?: number;
-}