@dench.com/cli 3.8.5-staging.406 → 3.9.0-staging.415

package/app-sdk.d.ts

@@ -937,8 +937,11 @@ export interface ApiRequests {
   "chat.follow": {
     threadId: string;
   };
-  /** List CRM objects. — `dench crm objects list` — GET /api/v1/crm/objects */
-  "crm.objects.list": Record<string, unknown>;
+  /** List CRM objects. — `dench crm objects list [--with-references]` — GET /api/v1/crm/objects */
+  "crm.objects.list": {
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
+  };
   /** List names, display labels, visibility and workspace counts without internal state. — `dench crm objects list --compact` — GET /api/v1/crm/catalog/objects */
   "crm.objects.listCompact": Record<string, unknown>;
   /** Get a CRM object. — `dench crm objects get` — GET /api/v1/crm/objects/{name} */
@@ -1225,8 +1228,10 @@ export interface ApiRequests {
     /** Hex color, e.g. #22c55e. */
     color: string;
   };
-  /** List CRM entries. — `dench crm entries list` — GET /api/v1/crm/objects/{objectName}/entries */
+  /** List CRM entries. — `dench crm entries list [--with-references]` — GET /api/v1/crm/objects/{objectName}/entries */
   "crm.entries.list": {
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
     objectName: string;
     limit?: number;
     /** Personal scope: "me" (the signed-in member / the human behind an agent session), "unassigned", or a member userId or email. Adds one has_any / is_empty rule on the object's assignee user field; rows, totalCount, sums and analytics all follow it. Never saved onto the view. */
@@ -1555,8 +1560,10 @@ export interface ApiRequests {
     /** Cell value. Enum=option string, tags=string array, user=one member userId or a userId array, relation=related entry id, boolean=true/false. */
     value: unknown;
   };
-  /** Query CRM entries. — `dench crm query` — POST /api/v1/crm/query */
+  /** Query CRM entries. — `dench crm query [--with-references]` — POST /api/v1/crm/query */
   "crm.query": {
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
     objectName: string;
     /** Query DSL. Bare equality only; use dslJson for $-operators. */
     dsl?: {
@@ -1574,7 +1581,21 @@ export interface ApiRequests {
     assigneeField?: string;
   };
   /** Scan CRM entries with a resumable cursor. Empty filtered pages can have more results. — `dench crm query --page` — POST /api/v1/crm/query/page */
-  "crm.queryPage": Record<string, unknown>;
+  "crm.queryPage": {
+    objectName: string;
+    dsl?: Record<string, unknown>;
+    dslJson?: string;
+    /** Personal scope: "me" (the signed-in member / the human behind an agent session), "unassigned", or a member userId or email. Adds one has_any / is_empty rule on the object's assignee user field; rows, totalCount, sums and analytics all follow it. Never saved onto the view. */
+    assignedTo?: string;
+    /** Which `user` field "assigned" means. Default: the analytics owner role, else the task `Assignee`, else a user field named like owner/assignee, else the first user field. */
+    assigneeField?: string;
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
+    paginationOpts: {
+      numItems: number;
+      cursor: string | null;
+    };
+  };
   /** Run CRM SQL-compatible query. — `dench crm sql` — POST /api/v1/crm/sql */
   "crm.sql": {
     objectName: string;
@@ -1589,8 +1610,10 @@ export interface ApiRequests {
     /** Number field to total per bucket (e.g. Amount grouped by Stage). Exact at any table size. */
     sumField?: string;
   };
-  /** Search CRM entries. — `dench crm search` — GET /api/v1/crm/search */
+  /** Search CRM entries. — `dench crm search [--with-references]` — GET /api/v1/crm/search */
   "crm.search": {
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
     /** Full-text query. */
     text: string;
     /** Omit to search org-wide. */
@@ -1599,6 +1622,8 @@ export interface ApiRequests {
   };
   /** Search bounded pages of readable CRM entries, optionally projecting cells. Always follow continueCursor until isDone. — `dench crm search --page` — GET /api/v1/crm/search/page */
   "crm.search.page": {
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
     /** Full-text query over readable entries. */
     text: string;
     objectName?: string;
@@ -1624,6 +1649,8 @@ export interface ApiRequests {
   };
   /** Apply a CRM batch. — `dench crm batch` — POST /api/v1/crm/batch */
   "crm.batch": {
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
     ops: Array<{
       type: "entries.create";
       objectName: string;
@@ -2725,8 +2752,10 @@ export interface ApiRequests {
   "campaigns.accounts.linkedin": Record<string, unknown>;
   /** Discover the mailboxes the acting workspace member can send campaign email from: ids for emailMailboxAccountIds, status, warm-up state and when it is done, the daily cold-email cap and what is left today. Never returns provider credentials. — `dench campaign accounts` — GET /api/v1/campaigns/accounts/email */
   "campaigns.accounts.email": Record<string, unknown>;
-  /** List outreach campaigns (archived ones on request). — `dench campaign list` — GET /api/v1/campaigns */
+  /** List outreach campaigns (archived ones on request). — `dench campaign list [--with-references]` — GET /api/v1/campaigns */
   "campaigns.list": {
+    /** Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields. */
+    withReferences?: boolean;
     /** Include archived campaigns. */
     includeArchived?: boolean;
   };
@@ -3626,6 +3655,37 @@ export interface ApiResponses {
   "secrets.delete": unknown;
   "campaigns.drafts.create": {
     sequenceId: string;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   };
   "campaigns.audience.search": {
     rows: Record<string, unknown>[];
@@ -4436,7 +4496,59 @@ export interface ApiResponses {
     createdAt: number;
     updatedAt: number;
     [key: string]: unknown;
-  }>;
+  }> | {
+    data: Array<{
+      _id: string;
+      _creationTime: number;
+      organizationId: string;
+      name: string;
+      description?: string;
+      /** Default view rendered for the object. */
+      defaultView: "table" | "kanban" | "calendar" | "timeline" | "gallery" | "list";
+      sortOrder: number;
+      immutable: boolean;
+      /** Who can read the object's records. Always reported as the value the object behaves as: `meeting` defaults to owner_plus_members, `calendar_event` to owner_only, anything else to workspace. */
+      visibility?: "workspace" | "owner_only" | "owner_plus_members";
+      icon?: string;
+      viewSettings?: Record<string, unknown>;
+      savedViews?: Record<string, unknown>[];
+      entryCount?: number;
+      createdAt: number;
+      updatedAt: number;
+      [key: string]: unknown;
+    }>;
+    references: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
+  };
   "crm.objects.listCompact": Array<{
     _id: string;
     name: string;
@@ -4465,10 +4577,72 @@ export interface ApiResponses {
     entryCount?: number;
     createdAt: number;
     updatedAt: number;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     [key: string]: unknown;
   } | null;
   "crm.objects.create": {
     id: string;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   };
   "crm.objects.update": {
     ok: boolean;
@@ -4645,7 +4819,49 @@ export interface ApiResponses {
     updatedAt: number;
     updatedBy: string;
     sortOrder: number;
-  }[];
+  }[] | {
+    data: {
+      id: string;
+      objectId: string;
+      /** Field-name -> cell value map. */
+      fields: Record<string, unknown>;
+      createdAt: number;
+      updatedAt: number;
+      updatedBy: string;
+      sortOrder: number;
+    }[];
+    references: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
+  };
   "crm.entries.get": {
     id: string;
     objectId: string;
@@ -4655,6 +4871,37 @@ export interface ApiResponses {
     updatedAt: number;
     updatedBy: string;
     sortOrder: number;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   } | null;
   "crm.entries.syncHistory": unknown;
   "crm.entries.syncHistoryStatus": unknown;
@@ -4863,8 +5110,70 @@ export interface ApiResponses {
   "crm.tasks.series.occurrences": Record<string, unknown>[];
   "crm.entries.create": {
     entryId: string;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   };
   "crm.entries.createMany": {
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     results: {
       entryId: string;
     }[];
@@ -4872,8 +5181,70 @@ export interface ApiResponses {
   };
   "crm.entries.update": {
     entryId: string;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   };
   "crm.entries.updateMany": {
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     results: {
       entryId: string;
       deleted?: boolean;
@@ -4890,6 +5261,37 @@ export interface ApiResponses {
   "crm.cells.get": unknown;
   "crm.cells.set": {
     entryId: string;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   };
   "crm.cells.setMany": {
     results: {
@@ -4899,17 +5301,72 @@ export interface ApiResponses {
   };
   "crm.cells.append": {
     entryId: string;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
+  };
+  "crm.query": Record<string, unknown>[] | {
+    data: Record<string, unknown>[];
+    references: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   };
-  "crm.query": {
-    id: string;
-    objectId: string;
-    /** Field-name -> cell value map. */
-    fields: Record<string, unknown>;
-    createdAt: number;
-    updatedAt: number;
-    updatedBy: string;
-    sortOrder: number;
-  }[];
   "crm.queryPage": unknown;
   "crm.sql": {
     id: string;
@@ -4937,8 +5394,83 @@ export interface ApiResponses {
     updatedAt: number;
     updatedBy: string;
     [key: string]: unknown;
-  }[];
+  }[] | {
+    data: {
+      _id: string;
+      _creationTime: number;
+      objectId: string;
+      /** Field-name -> cell value map. */
+      data: Record<string, unknown>;
+      sortOrder: number;
+      createdAt: number;
+      updatedAt: number;
+      updatedBy: string;
+      [key: string]: unknown;
+    }[];
+    references: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
+  };
   "crm.search.page": {
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     page: {
       _id: string;
       objectId: string;
@@ -4965,6 +5497,37 @@ export interface ApiResponses {
     ok: boolean;
   };
   "crm.batch": {
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     results: {
       entryId: string;
       deleted?: boolean;
@@ -4979,6 +5542,37 @@ export interface ApiResponses {
     ok: boolean;
   };
   "crm.transaction.commit": {
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     results: {
       entryId: string;
       deleted?: boolean;
@@ -6350,15 +6944,183 @@ export interface ApiResponses {
     createdAt: number;
     updatedAt: number;
     [key: string]: unknown;
-  }>;
+  }> | {
+    data: Array<{
+      _id: string;
+      name: string;
+      /** Campaign lifecycle status. */
+      status: "draft" | "active" | "paused" | "completed" | "archived";
+      stopOnReply: boolean;
+      /** Campaign email sender pool: up to 50 emailMailboxAccounts ids both you and the campaign owner may use. Omit to preserve existing configuration; [] clears the pool. A person's sender stays fixed for their conversation. Launch validates sender availability. */
+      emailMailboxAccountIds?: string[];
+      /** Campaign LinkedIn sender pool: up to 50 linkedinAccounts ids both you and the campaign owner may use. Omit to preserve existing configuration; [] clears the pool. Legacy step senders remain until a pool is configured. */
+      linkedinAccountIds?: string[];
+      timezone?: string;
+      startsAt?: number;
+      endsAt?: number;
+      sendSchedules?: {
+        /** Label, e.g. "Mon-Fri 9-18". */
+        name: string;
+        /** IANA timezone, e.g. America/Los_Angeles. */
+        timezone: string;
+        /** First hour sends may go out (0-23). */
+        startHour: number;
+        /** Hour sends stop (1-24); must be after startHour. */
+        endHour: number;
+        /** Days sends may go out: 0 = Sunday ... 6 = Saturday. */
+        weekdays: number[];
+      }[];
+      dailySendCap?: number;
+      stepCount: number;
+      /** linear: steps run in order. workflow: steps have keys and paths (next, yesNext, noNext) and may include condition and wait_for_connection. Left out, a workflow stays one and steps with keys, paths or those types make one; nothing turns a workflow back into a list. */
+      stepModel?: "linear" | "workflow";
+      totalEnrolled: number;
+      activeCount: number;
+      pausedCount: number;
+      finishedCount: number;
+      repliedCount: number;
+      failedCount: number;
+      stoppedCount: number;
+      launchedAt?: number;
+      ownerName?: string;
+      isOwner?: boolean;
+      createdAt: number;
+      updatedAt: number;
+      [key: string]: unknown;
+    }>;
+    references: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
+  };
   "campaigns.create": {
     sequenceId: string;
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
   };
   "campaigns.duplicate": {
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     /** The new draft. Rename it with campaigns.update. */
     sequenceId: string;
   };
   "campaigns.get": {
+    references?: Array<{
+      kind: "crm-entry";
+      objectName: string;
+      entryId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "crm-object";
+      objectName: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    } | {
+      kind: "campaign";
+      sequenceId: string;
+      label: string;
+      href: string;
+      url?: string;
+      imageUrl?: string;
+      objectIcon?: string;
+    }>;
+    referenceCoverage?: {
+      returned: number;
+      available: number;
+      truncated: boolean;
+    };
     sequence: {
       _id: string;
       name: string;
@@ -8100,7 +8862,7 @@ export type DenchApiTree = {
       /** Launch readiness without launching: blockers grouped by problem, warnings, and the fingerprint `launch` requires. (`dench campaign launch --check`) */
       preview(args: Req<"campaigns.launch.preview">): Promise<Res<"campaigns.launch.preview">>;
     };
-    /** List outreach campaigns (archived ones on request). (`dench campaign list`) */
+    /** List outreach campaigns (archived ones on request). (`dench campaign list [--with-references]`) */
     list(args?: Req<"campaigns.list">): Promise<Res<"campaigns.list">>;
     /** What the campaign is doing now, what comes next and when, and why it is holding. (`dench campaign get`) */
     live(args: Req<"campaigns.live">): Promise<Res<"campaigns.live">>;
@@ -8345,7 +9107,7 @@ export type DenchApiTree = {
       get(args: Req<"crm.entries.get">): Promise<Res<"crm.entries.get">>;
       /** List a CRM entry's audit history. (`dench crm history`) */
       history(args: Req<"crm.entries.history">): Promise<Res<"crm.entries.history">>;
-      /** List CRM entries. (`dench crm entries list`) */
+      /** List CRM entries. (`dench crm entries list [--with-references]`) */
       list(args: Req<"crm.entries.list">): Promise<Res<"crm.entries.list">>;
       /** Queue a full, paged pull of the record's email history from every connected mailbox; the ledger fills as pages land. (`dench crm entries sync-history`) */
       syncHistory(args: Req<"crm.entries.syncHistory">): Promise<Res<"crm.entries.syncHistory">>;
@@ -8401,7 +9163,7 @@ export type DenchApiTree = {
       delete(args: Req<"crm.objects.delete">): Promise<Res<"crm.objects.delete">>;
       /** Get a CRM object. (`dench crm objects get`) */
       get(args: Req<"crm.objects.get">): Promise<Res<"crm.objects.get">>;
-      /** List CRM objects. (`dench crm objects list`) */
+      /** List CRM objects. (`dench crm objects list [--with-references]`) */
       list(args?: Req<"crm.objects.list">): Promise<Res<"crm.objects.list">>;
       /** List names, display labels, visibility and workspace counts without internal state. (`dench crm objects list --compact`) */
       listCompact(args?: Req<"crm.objects.listCompact">): Promise<Res<"crm.objects.listCompact">>;
@@ -8422,7 +9184,7 @@ export type DenchApiTree = {
       /** Hide (`hidden: true`) or show the caller's own emails / messages with this record to the workspace. An account covers every contact and opportunity linked to it; existing ledger rows are restamped and the shared Brief regenerates. (`dench crm privacy hide|show`) */
       set(args: Req<"crm.privacy.set">): Promise<Res<"crm.privacy.set">>;
     };
-    /** Query CRM entries. (`dench crm query`) */
+    /** Query CRM entries. (`dench crm query [--with-references]`) */
     query(args: Req<"crm.query">): Promise<Res<"crm.query">>;
     /** Scan CRM entries with a resumable cursor. Empty filtered pages can have more results. (`dench crm query --page`) */
     queryPage(args: Req<"crm.queryPage">): Promise<Res<"crm.queryPage">>;
@@ -8431,7 +9193,7 @@ export type DenchApiTree = {
       generate(args: Req<"crm.reports.generate">): Promise<Res<"crm.reports.generate">>;
     };
     search: {
-      /** Search CRM entries. (`dench crm search`) */
+      /** Search CRM entries. (`dench crm search [--with-references]`) */
       (args?: Req<"crm.search">): Promise<Res<"crm.search">>;
       $call(args?: Req<"crm.search">): Promise<Res<"crm.search">>;
       /** Search bounded pages of readable CRM entries, optionally projecting cells. Always follow continueCursor until isDone. (`dench crm search --page`) */