@dench.com/cli 3.8.6-staging.409 → 3.9.0-staging.417

package/lib/api-schemas.ts

@@ -1346,6 +1346,59 @@ const crmFieldDoc = z
   .passthrough()
   .describe("A CRM field (column) document.");
 
+// Presentation metadata is separate from CRM field maps and optional on raw results.
+const referenceIdentity = {
+  label: z.string(),
+  href: z.string(),
+  url: z.string().optional(),
+  imageUrl: z.string().optional(),
+  objectIcon: z.string().optional(),
+};
+const workspaceReference = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("crm-entry"),
+    objectName: z.string(),
+    entryId: z.string(),
+    ...referenceIdentity,
+  }),
+  z.object({
+    kind: z.literal("crm-object"),
+    objectName: z.string(),
+    ...referenceIdentity,
+  }),
+  z.object({
+    kind: z.literal("campaign"),
+    sequenceId: z.string(),
+    ...referenceIdentity,
+  }),
+]);
+const workspaceReferenceFields = {
+  references: z.array(workspaceReference).max(100),
+  referenceCoverage: z.object({
+    returned: z.number().int().nonnegative(),
+    available: z.number().int().nonnegative(),
+    truncated: z.boolean(),
+  }),
+};
+const optionalWorkspaceReferenceFields = {
+  references: workspaceReferenceFields.references.optional(),
+  referenceCoverage: workspaceReferenceFields.referenceCoverage.optional(),
+};
+const withReferencesRequest = {
+  withReferences: z
+    .boolean()
+    .optional()
+    .describe(
+      "Include bounded navigation references. Array reads return {data, references, referenceCoverage}; existing result envelopes keep their fields.",
+    ),
+};
+function referenceListResponse<T extends z.ZodTypeAny>(row: T) {
+  return z.union([
+    z.array(row),
+    z.object({ data: z.array(row), ...workspaceReferenceFields }),
+  ]);
+}
+
 const crmEntryShape = z
   .object({
     id: z.string(),
@@ -1358,7 +1411,10 @@ const crmEntryShape = z
   })
   .describe("A materialized CRM entry (row).");
 
-const entryWriteResponse = z.object({ entryId: z.string() });
+const entryWriteResponse = z.object({
+  entryId: z.string(),
+  ...optionalWorkspaceReferenceFields,
+});
 
 const commentActorShape = z
   .object({
@@ -1494,6 +1550,7 @@ const notificationPreferencesShape = z.object({
 });
 
 const crmBatchResults = z.object({
+  ...optionalWorkspaceReferenceFields,
   results: z.array(
     z
       .object({
@@ -3283,6 +3340,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
   "campaigns.accounts.linkedin": noInput,
   "campaigns.accounts.email": noInput,
   "campaigns.list": z.object({
+    ...withReferencesRequest,
     includeArchived: z
       .boolean()
       .optional()
@@ -3882,7 +3940,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
   "chat.follow": z.object({ threadId: z.string() }),
 
   // CRM objects
-  "crm.objects.list": noInput,
+  "crm.objects.list": z.object(withReferencesRequest),
   "crm.objects.listCompact": noInput,
   "crm.objects.get": z.object({ name: z.string() }),
   "crm.objects.create": z.object({
@@ -4086,6 +4144,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
 
   // CRM entries
   "crm.entries.list": z.object({
+    ...withReferencesRequest,
     objectName: z.string(),
     limit: z.coerce.number().int().min(1).max(1000).optional(),
     ...assigneeScopeRequest,
@@ -4473,6 +4532,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
 
   // CRM query
   "crm.query": z.object({
+    ...withReferencesRequest,
     objectName: z.string(),
     dsl: z
       .object({
@@ -4497,6 +4557,17 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
       ),
     ...assigneeScopeRequest,
   }),
+  "crm.queryPage": z.object({
+    objectName: z.string(),
+    dsl: z.record(z.string(), z.unknown()).optional(),
+    dslJson: z.string().optional(),
+    ...assigneeScopeRequest,
+    ...withReferencesRequest,
+    paginationOpts: z.object({
+      numItems: z.number().int().min(1).max(100),
+      cursor: z.string().nullable(),
+    }),
+  }),
   "crm.sql": z.object({
     objectName: z.string(),
     dsl: z.record(z.string(), z.unknown()).optional(),
@@ -4513,6 +4584,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
       ),
   }),
   "crm.search.page": z.object({
+    ...withReferencesRequest,
     text: z.string().describe("Full-text query over readable entries."),
     objectName: z.string().optional(),
     select: z.array(z.string().min(1)).min(1).max(30).optional(),
@@ -4525,6 +4597,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
       ),
   }),
   "crm.search": z.object({
+    ...withReferencesRequest,
     text: z.string().describe("Full-text query."),
     objectName: z.string().optional().describe("Omit to search org-wide."),
     limit: z.coerce.number().int().min(1).max(100).optional(),
@@ -4546,6 +4619,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
 
   // CRM batch + transactions
   "crm.batch": z.object({
+    ...withReferencesRequest,
     ops: z.array(crmOp).max(200),
     idempotencyKey: z.string().optional(),
   }),
@@ -5260,7 +5334,10 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
     previewRows: z.array(z.unknown()),
     title: z.string(),
   }),
-  "campaigns.drafts.create": z.object({ sequenceId: z.string() }),
+  "campaigns.drafts.create": z.object({
+    sequenceId: z.string(),
+    ...optionalWorkspaceReferenceFields,
+  }),
   "campaigns.audience.search": campaignSearchPage,
   "campaigns.people.addBatch": campaignBatchResult,
   "campaigns.people.addFromSearch": campaignSearchPage
@@ -5321,15 +5398,20 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
   // Outreach campaigns (dench campaign)
   "campaigns.accounts.linkedin": z.array(campaignLinkedinSenderSummary),
   "campaigns.accounts.email": z.array(campaignMailboxSummary),
-  "campaigns.list": z.array(campaignRow),
-  "campaigns.create": z.object({ sequenceId: z.string() }),
+  "campaigns.list": referenceListResponse(campaignRow),
+  "campaigns.create": z.object({
+    sequenceId: z.string(),
+    ...optionalWorkspaceReferenceFields,
+  }),
   "campaigns.duplicate": z.object({
+    ...optionalWorkspaceReferenceFields,
     sequenceId: z
       .string()
       .describe("The new draft. Rename it with campaigns.update."),
   }),
   "campaigns.get": z
     .object({
+      ...optionalWorkspaceReferenceFields,
       sequence: campaignRow,
       steps: z
         .array(campaignStepInput.passthrough())
@@ -5719,7 +5801,7 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
     ),
 
   // CRM objects
-  "crm.objects.list": z.array(crmObjectDoc),
+  "crm.objects.list": referenceListResponse(crmObjectDoc),
   "crm.objects.listCompact": z.array(
     z.object({
       _id: z.string(),
@@ -5732,8 +5814,13 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
       archived: z.boolean(),
     }),
   ),
-  "crm.objects.get": crmObjectDoc.nullable(),
-  "crm.objects.create": z.object({ id: z.string() }),
+  "crm.objects.get": crmObjectDoc
+    .extend(optionalWorkspaceReferenceFields)
+    .nullable(),
+  "crm.objects.create": z.object({
+    id: z.string(),
+    ...optionalWorkspaceReferenceFields,
+  }),
   "crm.objects.update": okResponse,
   "crm.objects.rename": okResponse,
   "crm.objects.delete": okResponse,
@@ -5833,7 +5920,7 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
   }),
 
   // CRM entries + cells
-  "crm.entries.list": z.array(crmEntryShape),
+  "crm.entries.list": referenceListResponse(crmEntryShape),
   "crm.views.entries": z
     .object({
       entries: z
@@ -5855,9 +5942,12 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
     .describe(
       "The same payload the workspace table renders from (fields, statuses, savedViews, …).",
     ),
-  "crm.entries.get": crmEntryShape.nullable(),
+  "crm.entries.get": crmEntryShape
+    .extend(optionalWorkspaceReferenceFields)
+    .nullable(),
   "crm.entries.create": entryWriteResponse,
   "crm.entries.createMany": z.object({
+    ...optionalWorkspaceReferenceFields,
     results: z.array(z.object({ entryId: z.string() })),
     count: z.number(),
   }),
@@ -5939,11 +6029,11 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
   "settings.sync.update": syncSettingsShape,
 
   // CRM query + search
-  "crm.query": z
-    .array(crmEntryShape)
-    .describe(
-      "Entry rows. With dsl.select the rows are flat {_id, ...selectedFields} objects instead.",
-    ),
+  "crm.query": referenceListResponse(
+    z.record(z.string(), z.unknown()),
+  ).describe(
+    "Entry rows. With dsl.select the rows are flat {_id, ...selectedFields} objects instead.",
+  ),
   "crm.sql": z
     .array(crmEntryShape)
     .describe(
@@ -5957,6 +6047,7 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
     }),
   ),
   "crm.search.page": z.object({
+    ...optionalWorkspaceReferenceFields,
     page: z.array(
       z.object({ _id: z.string(), objectId: z.string(), data: fieldsMap }),
     ),
@@ -5966,7 +6057,7 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
     selectedFields: z.array(z.string()).nullable(),
     completeness: z.literal("page"),
   }),
-  "crm.search": z.array(
+  "crm.search": referenceListResponse(
     z
       .object({
         _id: z.string(),
@@ -6551,11 +6642,30 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
 // ---------------------------------------------------------------------------
 
 export type ConvexExtras = {
+  withReferencesFunctionName?: string;
   fixedArgs?: Record<string, unknown>;
   transformArgs?: (input: Record<string, unknown>) => Record<string, unknown>;
 };
 
 export const convexExtras: Record<string, ConvexExtras> = {
+  "campaigns.list": {
+    withReferencesFunctionName:
+      "functions/outreachSequences:listSequencesWithReferences",
+  },
+  "crm.objects.list": {
+    withReferencesFunctionName: "functions/crm/objects:listWithReferences",
+  },
+  "crm.entries.list": {
+    withReferencesFunctionName: "functions/crm/entries:listWithReferences",
+  },
+  "crm.query": {
+    withReferencesFunctionName:
+      "functions/crm/query:runQueryEntriesWithReferences",
+  },
+  "crm.search": {
+    withReferencesFunctionName: "functions/crm/query:searchWithReferences",
+  },
+
   "campaigns.steps.replace": {
     transformArgs: ({ allowSingleBraces: _allowSingleBraces, ...input }) =>
       input,

package/lib/app-sdk-catalog.generated.ts

@@ -164,7 +164,7 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"chat.new","group":"chat","summary":"Start a new chat-turn workflow.","cli":"dench chat new","method":"POST","path":"/chat/threads","permission":"ai:chat","pathParams":[]},
   {"id":"chat.send","group":"chat","summary":"Send a message to an existing chat thread.","cli":"dench chat send","method":"POST","path":"/chat/threads/{threadId}/messages","permission":"ai:chat","pathParams":["threadId"]},
   {"id":"chat.follow","group":"chat","summary":"Follow a live chat response stream.","cli":"dench chat follow","method":"GET","path":"/chat/threads/{threadId}/stream","permission":"ai:chat","pathParams":["threadId"]},
-  {"id":"crm.objects.list","group":"crm","summary":"List CRM objects.","cli":"dench crm objects list","method":"GET","path":"/crm/objects","permission":"crm:read","pathParams":[]},
+  {"id":"crm.objects.list","group":"crm","summary":"List CRM objects.","cli":"dench crm objects list [--with-references]","method":"GET","path":"/crm/objects","permission":"crm:read","pathParams":[]},
   {"id":"crm.objects.listCompact","group":"crm","summary":"List names, display labels, visibility and workspace counts without internal state.","cli":"dench crm objects list --compact","method":"GET","path":"/crm/catalog/objects","permission":"crm:read","pathParams":[]},
   {"id":"crm.objects.get","group":"crm","summary":"Get a CRM object.","cli":"dench crm objects get","method":"GET","path":"/crm/objects/{name}","permission":"crm:read","pathParams":["name"]},
   {"id":"crm.objects.create","group":"crm","summary":"Create a CRM object.","cli":"dench crm objects create","method":"POST","path":"/crm/objects","permission":"crm:write","pathParams":[]},
@@ -200,7 +200,7 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"crm.fields.enum.remove","group":"crm","summary":"Remove an enum value.","cli":"dench crm fields enum-remove","method":"DELETE","path":"/crm/objects/{objectName}/fields/{fieldName}/enum/{value}","permission":"crm:write","pathParams":["objectName","fieldName","value"]},
   {"id":"crm.fields.enum.rename","group":"crm","summary":"Rename an enum value.","cli":"dench crm fields enum-rename","method":"POST","path":"/crm/objects/{objectName}/fields/{fieldName}/enum/{oldValue}/rename","permission":"crm:write","pathParams":["objectName","fieldName","oldValue"]},
   {"id":"crm.fields.enum.color","group":"crm","summary":"Set an enum color.","cli":"dench crm fields enum-set-color","method":"POST","path":"/crm/objects/{objectName}/fields/{fieldName}/enum/{value}/color","permission":"crm:write","pathParams":["objectName","fieldName","value"]},
-  {"id":"crm.entries.list","group":"crm","summary":"List CRM entries.","cli":"dench crm entries list","method":"GET","path":"/crm/objects/{objectName}/entries","permission":"crm:read","pathParams":["objectName"]},
+  {"id":"crm.entries.list","group":"crm","summary":"List CRM entries.","cli":"dench crm entries list [--with-references]","method":"GET","path":"/crm/objects/{objectName}/entries","permission":"crm:read","pathParams":["objectName"]},
   {"id":"crm.entries.get","group":"crm","summary":"Get a CRM entry.","cli":"dench crm entries get","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}","permission":"crm:read","pathParams":["objectName","entryId"]},
   {"id":"crm.entries.syncHistory","group":"crm","summary":"Queue a full, paged pull of the record's email history from every connected mailbox; the ledger fills as pages land.","cli":"dench crm entries sync-history","method":"POST","path":"/crm/objects/{objectName}/entries/{entryId}/sync-history","permission":"crm:write","pathParams":["objectName","entryId"]},
   {"id":"crm.entries.syncHistoryStatus","group":"crm","summary":"Has Dench read this record's email history? One row per address per mailbox.","cli":"dench crm entries sync-history --status","method":"GET","path":"/crm/objects/{objectName}/entries/{entryId}/sync-history","permission":"crm:read","pathParams":["objectName","entryId"]},
@@ -258,11 +258,11 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"crm.cells.set","group":"crm","summary":"Set a CRM cell value.","cli":"dench crm cells set","method":"PUT","path":"/crm/objects/{objectName}/entries/{entryId}/fields/{fieldName}","permission":"crm:write","pathParams":["objectName","entryId","fieldName"]},
   {"id":"crm.cells.setMany","group":"crm","summary":"Set many CRM cell values.","cli":"dench crm cells set-many","method":"POST","path":"/crm/cells/batch","permission":"crm:write","pathParams":[]},
   {"id":"crm.cells.append","group":"crm","summary":"Append to a CRM cell.","cli":"dench crm cells append","method":"POST","path":"/crm/objects/{objectName}/entries/{entryId}/fields/{fieldName}/append","permission":"crm:write","pathParams":["objectName","entryId","fieldName"]},
-  {"id":"crm.query","group":"crm","summary":"Query CRM entries.","cli":"dench crm query","method":"POST","path":"/crm/query","permission":"crm:read","pathParams":[]},
+  {"id":"crm.query","group":"crm","summary":"Query CRM entries.","cli":"dench crm query [--with-references]","method":"POST","path":"/crm/query","permission":"crm:read","pathParams":[]},
   {"id":"crm.queryPage","group":"crm","summary":"Scan CRM entries with a resumable cursor. Empty filtered pages can have more results.","cli":"dench crm query --page","method":"POST","path":"/crm/query/page","permission":"crm:read","pathParams":[]},
   {"id":"crm.sql","group":"crm","summary":"Run CRM SQL-compatible query.","cli":"dench crm sql","method":"POST","path":"/crm/sql","permission":"crm:read","pathParams":[]},
   {"id":"crm.aggregate","group":"crm","summary":"Aggregate CRM entries.","cli":"dench crm aggregate","method":"POST","path":"/crm/aggregate","permission":"crm:read","pathParams":[]},
-  {"id":"crm.search","group":"crm","summary":"Search CRM entries.","cli":"dench crm search","method":"GET","path":"/crm/search","permission":"crm:read","pathParams":[]},
+  {"id":"crm.search","group":"crm","summary":"Search CRM entries.","cli":"dench crm search [--with-references]","method":"GET","path":"/crm/search","permission":"crm:read","pathParams":[]},
   {"id":"crm.search.page","group":"crm","summary":"Search bounded pages of readable CRM entries, optionally projecting cells. Always follow continueCursor until isDone.","cli":"dench crm search --page","method":"GET","path":"/crm/search/page","permission":"crm:read","pathParams":[]},
   {"id":"crm.statuses.list","group":"crm","summary":"List CRM statuses.","cli":"dench crm statuses list","method":"GET","path":"/crm/objects/{objectName}/statuses","permission":"crm:read","pathParams":["objectName"]},
   {"id":"crm.statuses.set","group":"crm","summary":"Set CRM statuses.","cli":"dench crm statuses set","method":"PUT","path":"/crm/objects/{objectName}/statuses","permission":"crm:write","pathParams":["objectName"]},
@@ -388,7 +388,7 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"email.sequence.enrollment.stop","group":"email","summary":"Stop one enrollment (no further steps send).","cli":"dench email sequence enrollment stop","method":"POST","path":"/email/sequences/enrollments/{enrollmentId}/stop","permission":"email:write","pathParams":["enrollmentId"]},
   {"id":"campaigns.accounts.linkedin","group":"campaigns","summary":"Discover LinkedIn sender ids, labels, availability and remaining capacity visible to the acting workspace member. Never returns provider credentials.","cli":"dench campaign accounts","method":"GET","path":"/campaigns/accounts/linkedin","permission":"campaigns:read","pathParams":[]},
   {"id":"campaigns.accounts.email","group":"campaigns","summary":"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.","cli":"dench campaign accounts","method":"GET","path":"/campaigns/accounts/email","permission":"campaigns:read","pathParams":[]},
-  {"id":"campaigns.list","group":"campaigns","summary":"List outreach campaigns (archived ones on request).","cli":"dench campaign list","method":"GET","path":"/campaigns","permission":"campaigns:read","pathParams":[]},
+  {"id":"campaigns.list","group":"campaigns","summary":"List outreach campaigns (archived ones on request).","cli":"dench campaign list [--with-references]","method":"GET","path":"/campaigns","permission":"campaigns:read","pathParams":[]},
   {"id":"campaigns.create","group":"campaigns","summary":"Create a draft outreach campaign with email and LinkedIn sender pools and a business-hours send window in the given timezone.","cli":"dench campaign create","method":"POST","path":"/campaigns","permission":"campaigns:write","pathParams":[]},
   {"id":"campaigns.duplicate","group":"campaigns","summary":"Copy a campaign into a new draft named \"<name> copy\": the same steps, schedule, sender pools and personalized lines, its lead source paused, and no people. To reach more than 300 people, duplicate and add the next page of the search to the copy.","cli":"dench campaign duplicate","method":"POST","path":"/campaigns/{sequenceId}/duplicate","permission":"campaigns:write","pathParams":["sequenceId"]},
   {"id":"campaigns.get","group":"campaigns","summary":"Read a campaign: settings, steps, people, their current step and hold, last touches, linked leads.","cli":"dench campaign get","method":"GET","path":"/campaigns/{sequenceId}","permission":"campaigns:read","pathParams":["sequenceId"]},

package/lib/campaign-agent.ts

@@ -36,6 +36,7 @@ import {
   SEARCH_TEXT_FLAGS,
   usesSearchFlags,
 } from "./campaign-filters";
+import { campaignReferenceResult } from "./campaign-reference";
 import {
   assertNoUnknownFlags,
   getFlag,
@@ -59,6 +60,7 @@ type Context = {
   jsonOutput: boolean;
   sessionToken?: string;
   host?: string;
+  workspaceSlug?: string;
   resolveCampaign: (reference: string) => Promise<CampaignRef>;
 };
 
@@ -1349,6 +1351,7 @@ async function addRecipients(
 }
 
 type CampaignSettings = {
+  references?: unknown[];
   _id: string;
   name: string;
   status: string;
@@ -1373,7 +1376,10 @@ async function readCampaign(
     throw new Error(
       `Campaign ${sequenceId} could not be read back. Run dench campaign list to find it.`,
     );
-  return detail.sequence;
+  return {
+    ...detail.sequence,
+    references: (detail as { references?: unknown[] }).references,
+  };
 }
 
 function plural(count: number, one: string, many: string) {
@@ -1442,20 +1448,26 @@ async function draft(ctx: Context) {
     .join("; ");
   return print(
     ctx,
-    {
+    campaignReferenceResult(
+      ctx,
+      {
+        references: campaign.references,
+        sequenceId,
+        name: campaign.name,
+        status: campaign.status,
+        clientRequestId,
+        timezone: campaign.timezone ?? timezone,
+        sendSchedules,
+        dailySendCap: campaign.dailySendCap ?? null,
+        stopOnReply: campaign.stopOnReply !== false,
+        ...(campaign.startsAt ? { startsAt: campaign.startsAt } : {}),
+        ...(campaign.endsAt ? { endsAt: campaign.endsAt } : {}),
+        emailMailboxAccountIds,
+        linkedinAccountIds,
+      },
       sequenceId,
-      name: campaign.name,
-      status: campaign.status,
-      clientRequestId,
-      timezone: campaign.timezone ?? timezone,
-      sendSchedules,
-      dailySendCap: campaign.dailySendCap ?? null,
-      stopOnReply: campaign.stopOnReply !== false,
-      ...(campaign.startsAt ? { startsAt: campaign.startsAt } : {}),
-      ...(campaign.endsAt ? { endsAt: campaign.endsAt } : {}),
-      emailMailboxAccountIds,
-      linkedinAccountIds,
-    },
+      campaign.name,
+    ),
     `Draft "${campaign.name}" [${sequenceId}] · ${windows || "no send window"} · ${plural(emailMailboxAccountIds.length, "mailbox", "mailboxes")}, ${plural(linkedinAccountIds.length, "LinkedIn account", "LinkedIn accounts")} · request id ${clientRequestId}`,
   );
 }

package/lib/campaign-reference.ts

@@ -0,0 +1,39 @@
+import {
+  boundWorkspaceReferences,
+  parseWorkspaceReference,
+  type WorkspaceReference,
+  withWorkspaceReferenceUrls,
+  workspaceReferenceHref,
+} from "./workspace-references";
+
+export function campaignReferenceResult(
+  context: { host?: string; workspaceSlug?: string },
+  result: Record<string, unknown>,
+  sequenceId: string,
+  label: string,
+) {
+  const inherited = Array.isArray(result.references)
+    ? result.references
+        .map(parseWorkspaceReference)
+        .find(
+          (ref) => ref?.kind === "campaign" && ref.sequenceId === sequenceId,
+        )
+    : undefined;
+  const identity = { kind: "campaign" as const, sequenceId };
+  const reference: WorkspaceReference = withWorkspaceReferenceUrls(
+    {
+      ...identity,
+      label,
+      href: workspaceReferenceHref(identity),
+      ...(inherited?.imageUrl ? { imageUrl: inherited.imageUrl } : {}),
+      ...(inherited?.objectIcon ? { objectIcon: inherited.objectIcon } : {}),
+    },
+    context,
+  );
+  return {
+    ...result,
+    ...boundWorkspaceReferences([reference]),
+    href: reference.href,
+    ...(reference.url ? { url: reference.url } : {}),
+  };
+}

package/lib/command-registry.ts

@@ -7,6 +7,8 @@ export type ConvexOperation = {
   kind: "convex";
   functionType: "query" | "mutation" | "action";
   functionName: string;
+  /** Explicit envelope variant; the legacy function keeps its array contract. */
+  withReferencesFunctionName?: string;
   auth: ApiAuthMode;
   tokenArg?: "sessionToken" | "apiKey";
   includeRunId?: boolean;
@@ -1293,7 +1295,7 @@ const rawApiOperations = [
     id: "crm.objects.list",
     group: "crm",
     summary: "List CRM objects.",
-    cli: "dench crm objects list",
+    cli: "dench crm objects list [--with-references]",
     method: "GET",
     path: "/crm/objects",
     requestSchema: noBody,
@@ -1715,10 +1717,12 @@ const rawApiOperations = [
     id: "crm.entries.list",
     group: "crm",
     summary: "List CRM entries.",
-    cli: "dench crm entries list",
+    cli: "dench crm entries list [--with-references]",
     method: "GET",
     path: "/crm/objects/{objectName}/entries",
-    requestSchema: noBody,
+    requestSchema: z
+      .object({ withReferences: z.boolean().optional() })
+      .passthrough(),
     responseSchema: anyResponse,
     backend: convex("query", "functions/crm/entries:list"),
   }),
@@ -2604,7 +2608,7 @@ const rawApiOperations = [
     id: "crm.query",
     group: "crm",
     summary: "Query CRM entries.",
-    cli: "dench crm query",
+    cli: "dench crm query [--with-references]",
     method: "POST",
     path: "/crm/query",
     requestSchema: anyObject,
@@ -2649,7 +2653,7 @@ const rawApiOperations = [
     id: "crm.search",
     group: "crm",
     summary: "Search CRM entries.",
-    cli: "dench crm search",
+    cli: "dench crm search [--with-references]",
     method: "GET",
     path: "/crm/search",
     requestSchema: anyObject,
@@ -4275,7 +4279,7 @@ const rawApiOperations = [
     id: "campaigns.list",
     group: "campaigns",
     summary: "List outreach campaigns (archived ones on request).",
-    cli: "dench campaign list",
+    cli: "dench campaign list [--with-references]",
     method: "GET",
     path: "/campaigns",
     requestSchema: anyObject,