@dench.com/cli 3.6.6-staging.386 → 3.7.0-staging.387

package/agent-config.ts

@@ -81,6 +81,12 @@ type CliCtx = {
   sessionToken?: string;
 };
 
+function consumeOutputFlag(ctx: CliCtx): void {
+  // Drain even when the parent already resolved JSON mode: otherwise a free
+  // text body or an optional model positional would consume the literal flag.
+  ctx.jsonOutput = hasFlag(ctx.args, "--json") || ctx.jsonOutput;
+}
+
 function out(ctx: CliCtx, value: unknown): void {
   if (ctx.jsonOutput) {
     console.log(JSON.stringify(value, null, 2));
@@ -229,7 +235,7 @@ async function handleSimpleMagicFile(
   }
   if (sub === "edit" || sub === "set") {
     let content: string;
-    if (hasFlag(args, "--stdin") || getFlag(args, "--content")) {
+    if (args.includes("--stdin") || args.includes("--content")) {
       content = await resolveContent(args);
     } else {
       const config = await loadAgentConfig(ctx);
@@ -315,7 +321,7 @@ async function handleBootstrap(ctx: CliCtx, args: string[]): Promise<void> {
   }
   if (sub === "template") {
     let content: string;
-    if (hasFlag(args, "--stdin") || getFlag(args, "--content")) {
+    if (args.includes("--stdin") || args.includes("--content")) {
       content = await resolveContent(args);
     } else {
       const config = await loadAgentConfig(ctx);
@@ -399,6 +405,7 @@ async function handleModel(ctx: CliCtx, args: string[]): Promise<void> {
 // ── Entry points consumed by cli/dench.ts ────────────────────────────────
 
 export async function runIdentityCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   await handleSimpleMagicFile(ctx, ctx.args, {
     label: "identity",
     field: "identity",
@@ -406,6 +413,7 @@ export async function runIdentityCommand(ctx: CliCtx): Promise<void> {
 }
 
 export async function runOrganisationCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   await handleSimpleMagicFile(ctx, ctx.args, {
     label: "organisation",
     field: "organisation",
@@ -413,6 +421,7 @@ export async function runOrganisationCommand(ctx: CliCtx): Promise<void> {
 }
 
 export async function runUserCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   await handleSimpleMagicFile(ctx, ctx.args, {
     label: "user",
     field: "identity", // unused (perMember=true)
@@ -421,6 +430,7 @@ export async function runUserCommand(ctx: CliCtx): Promise<void> {
 }
 
 export async function runToolsCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   await handleSimpleMagicFile(ctx, ctx.args, {
     label: "tools",
     field: "toolsNotes",
@@ -433,6 +443,7 @@ export async function runToolsCommand(ctx: CliCtx): Promise<void> {
  *   show | append <text> | set
  */
 export async function runMemoryAggregateCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   const sub = ctx.args[0];
   if (!sub || sub === "show") {
     const config = await loadAgentConfig(ctx);
@@ -451,7 +462,7 @@ export async function runMemoryAggregateCommand(ctx: CliCtx): Promise<void> {
   }
   if (sub === "set" || sub === "edit") {
     let content: string;
-    if (hasFlag(ctx.args, "--stdin") || getFlag(ctx.args, "--content")) {
+    if (ctx.args.includes("--stdin") || ctx.args.includes("--content")) {
       content = await resolveContent(ctx.args);
     } else {
       const config = await loadAgentConfig(ctx);
@@ -476,10 +487,12 @@ export async function runMemoryAggregateCommand(ctx: CliCtx): Promise<void> {
 }
 
 export async function runBootstrapCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   await handleBootstrap(ctx, ctx.args);
 }
 
 export async function runModelCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   await handleModel(ctx, ctx.args);
 }
 
@@ -490,6 +503,7 @@ export async function runModelCommand(ctx: CliCtx): Promise<void> {
  * heading wrappers stay consistent.
  */
 export async function runDailyCommand(ctx: CliCtx): Promise<void> {
+  consumeOutputFlag(ctx);
   const sub = ctx.args[0];
   if (!sub || sub === "today") {
     const today = new Date();

package/app-sdk.d.ts

@@ -722,6 +722,8 @@ export interface ApiRequests {
   };
   /** List CRM objects. — `dench crm objects list` — GET /api/v1/crm/objects */
   "crm.objects.list": Record<string, unknown>;
+  /** 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} */
   "crm.objects.get": {
     name: string;
@@ -883,6 +885,10 @@ export interface ApiRequests {
   "crm.fields.list": {
     objectName: string;
   };
+  /** List field names, types and effective constraints without indexing or enrichment internals. — `dench crm fields list --compact` — GET /api/v1/crm/catalog/objects/{objectName}/fields */
+  "crm.fields.listCompact": {
+    objectName: string;
+  };
   /** Create a CRM field or read-only campaign activity boolean column. — `dench crm fields create` — POST /api/v1/crm/objects/{objectName}/fields */
   "crm.fields.create": {
     objectName: string;
@@ -1374,6 +1380,16 @@ export interface ApiRequests {
     objectName?: string;
     limit?: number;
   };
+  /** 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": {
+    /** Full-text query over readable entries. */
+    text: string;
+    objectName?: string;
+    select?: string[];
+    limit?: number;
+    /** Use the preceding continueCursor, with the same query and projection. */
+    cursor?: string;
+  };
   /** List CRM statuses. — `dench crm statuses list` — GET /api/v1/crm/objects/{objectName}/statuses */
   "crm.statuses.list": {
     objectName: string;
@@ -2179,6 +2195,32 @@ export interface ApiRequests {
     /** Identity id, sender email, or domain (deletes every sender on the domain). Permanent: re-adding requires re-verification. */
     identity: string;
   };
+  /** Search authorized synced mailbox headers with bounded cursor pagination. isDone covers stored records, not provider completeness. — `dench email inbox search` — GET /api/v1/email/inbox/search */
+  "email.inbox.search": {
+    limit?: number;
+    cursor?: string;
+    mailbox?: string;
+    from?: string;
+    to?: string;
+    subject?: string;
+    /** Inclusive Unix milliseconds; missing sentAt falls back to createdAt. */
+    after?: number;
+    /** Exclusive Unix milliseconds. */
+    before?: number;
+    direction?: "inbound" | "outbound";
+  };
+  /** Read a bounded page of synced headers using an exact thread handle from inbox search; bodies remain on demand. — `dench email inbox thread` — GET /api/v1/email/inbox/threads/{threadHandle} */
+  "email.inbox.thread": {
+    limit?: number;
+    cursor?: string;
+    threadHandle: string;
+  };
+  /** Read a bounded stored body using an exact message handle from inbox search; rechecks mailbox and record privacy. — `dench email inbox message` — GET /api/v1/email/inbox/messages/{messageHandle} */
+  "email.inbox.message": {
+    messageHandle: string;
+    format?: "text" | "html";
+    maxBytes?: number;
+  };
   /** Create an editable Dench email draft and synchronize its selected native mailbox asynchronously. Use a stable requestId for retries. — `dench email draft create` — POST /api/v1/email/drafts */
   "email.drafts.create": {
     organizationId?: string;
@@ -2261,13 +2303,13 @@ export interface ApiRequests {
   "email.drafts.signature": {
     draftId: string;
   };
-  /** Send through a native Gmail or Outlook mailbox with a durable request receipt. Only use for an explicit send request. — `dench email send --mailbox` — POST /api/v1/email/native/send */
+  /** Send through a native Gmail or Outlook mailbox with a durable request receipt. Only use for an explicit send request. — `dench email send [--mailbox <id/email>]` — POST /api/v1/email/native/send */
   "email.native.send": {
     organizationId?: string;
     threadId?: string;
     mailbox?: string;
     requestId: string;
-    to?: {
+    to: {
       email: string;
       name?: string;
     }[];
@@ -2289,7 +2331,7 @@ export interface ApiRequests {
       size: number;
     }[];
   };
-  /** Send one raw email (no campaign): to/cc/bcc, custom from-name and reply-to, optional reply threading via replyToMessageId. — `dench email send` — POST /api/v1/email/send */
+  /** Send one raw email (no campaign): to/cc/bcc, custom from-name and reply-to, optional reply threading via replyToMessageId. — `dench email send --from <verified-email>` — POST /api/v1/email/send */
   "email.send": {
     /** Verified sender mailbox. */
     fromEmail: string;
@@ -3165,7 +3207,7 @@ export interface ApiRequests {
     /** Execution ref from a prior search, OR pass session_id+tool_slug. */
     execution_ref?: string;
     session_id?: string;
-    /** Tool slug, e.g. GMAIL_FETCH_EMAILS. */
+    /** Tool slug, e.g. SLACK_LIST_CHANNELS. */
     tool_slug?: string;
     /** Tool arguments object. */
     arguments?: Record<string, unknown>;
@@ -3213,7 +3255,7 @@ export interface ApiRequests {
   };
   /** Read tool notes. — `dench tools show` — GET /api/v1/agent-config/tools */
   "agentConfig.tools.show": Record<string, unknown>;
-  /** Update tool notes. — `dench tools notes-edit` — PUT /api/v1/agent-config/tools */
+  /** Update tool notes. — `dench tools edit` — PUT /api/v1/agent-config/tools */
   "agentConfig.tools.edit": {
     content: string;
   };
@@ -4097,6 +4139,16 @@ export interface ApiResponses {
     updatedAt: number;
     [key: string]: unknown;
   }>;
+  "crm.objects.listCompact": Array<{
+    _id: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    entryCount: number | null;
+    countScope: "workspace" | "private_unknown";
+    visibility: "workspace" | "owner_only" | "owner_plus_members";
+    archived: boolean;
+  }>;
   "crm.objects.get": {
     _id: string;
     _creationTime: number;
@@ -4235,6 +4287,18 @@ export interface ApiResponses {
     updatedAt: number;
     [key: string]: unknown;
   }>;
+  "crm.fields.listCompact": {
+    _id: string;
+    name: string;
+    type: string;
+    required: boolean;
+    readOnly: boolean;
+    defaultValue?: string;
+    enumValues?: string[];
+    enumMultiple: boolean;
+    relatedObjectId?: string;
+    relationshipType?: string;
+  }[];
   "crm.fields.create": {
     id: string;
   };
@@ -4576,6 +4640,19 @@ export interface ApiResponses {
     updatedBy: string;
     [key: string]: unknown;
   }[];
+  "crm.search.page": {
+    page: {
+      _id: string;
+      objectId: string;
+      /** Field-name -> cell value map. */
+      data: Record<string, unknown>;
+    }[];
+    isDone: boolean;
+    continueCursor: string | null;
+    returnedCount: number;
+    selectedFields: string[] | null;
+    completeness: "page";
+  };
   "crm.statuses.list": {
     _id: string;
     _creationTime: number;
@@ -5447,6 +5524,150 @@ export interface ApiResponses {
       disabled: boolean;
     }[];
   };
+  "email.inbox.search": {
+    page: Array<{
+      messageHandle: string;
+      threadHandle: string;
+      mailboxId: string;
+      from: {
+        email: string;
+        name?: string;
+      };
+      to: {
+        email: string;
+        name?: string;
+      }[];
+      subject: string;
+      at: number;
+      dateSource: "sentAt" | "createdAt";
+      direction: "inbound" | "outbound";
+      status: string;
+      hasAttachments: boolean;
+      headersTruncated: boolean;
+    }>;
+    continueCursor: string | null;
+    isDone: boolean;
+    coverage: {
+      source: "synced";
+      scope: "mailbox_linked_messages";
+      mailboxId: string;
+      mailboxEmail: string;
+      mailboxStatus: string;
+      ingestionMode: string;
+      phase: string;
+      syncStatus: string | null;
+      lastPolledAt: number | null;
+      lastBackfillCompletedAt: number | null;
+      oldestSeenAt: number | null;
+      backfillStatus: string | null;
+      backfillCapped: boolean;
+      providerComplete: false;
+      privacyLimited: boolean;
+    };
+    order: "sentAt_desc_then_undated";
+  };
+  "email.inbox.thread": {
+    page: Array<{
+      messageHandle: string;
+      threadHandle: string;
+      mailboxId: string;
+      from: {
+        email: string;
+        name?: string;
+      };
+      to: {
+        email: string;
+        name?: string;
+      }[];
+      subject: string;
+      at: number;
+      dateSource: "sentAt" | "createdAt";
+      direction: "inbound" | "outbound";
+      status: string;
+      hasAttachments: boolean;
+      headersTruncated: boolean;
+    }>;
+    continueCursor: string | null;
+    isDone: boolean;
+    coverage: {
+      source: "synced";
+      scope: "mailbox_linked_messages";
+      mailboxId: string;
+      mailboxEmail: string;
+      mailboxStatus: string;
+      ingestionMode: string;
+      phase: string;
+      syncStatus: string | null;
+      lastPolledAt: number | null;
+      lastBackfillCompletedAt: number | null;
+      oldestSeenAt: number | null;
+      backfillStatus: string | null;
+      backfillCapped: boolean;
+      providerComplete: false;
+      privacyLimited: boolean;
+    };
+    order: "sentAt_desc_then_undated";
+  };
+  "email.inbox.message": {
+    header: {
+      messageHandle: string;
+      threadHandle: string;
+      mailboxId: string;
+      from: {
+        email: string;
+        name?: string;
+      };
+      to: {
+        email: string;
+        name?: string;
+      }[];
+      subject: string;
+      at: number;
+      dateSource: "sentAt" | "createdAt";
+      direction: "inbound" | "outbound";
+      status: string;
+      hasAttachments: boolean;
+      headersTruncated: boolean;
+    };
+    coverage: {
+      source: "synced";
+      scope: "mailbox_linked_messages";
+      mailboxId: string;
+      mailboxEmail: string;
+      mailboxStatus: string;
+      ingestionMode: string;
+      phase: string;
+      syncStatus: string | null;
+      lastPolledAt: number | null;
+      lastBackfillCompletedAt: number | null;
+      oldestSeenAt: number | null;
+      backfillStatus: string | null;
+      backfillCapped: boolean;
+      providerComplete: false;
+      privacyLimited: boolean;
+    };
+    body: {
+      format: "text" | "html";
+      content: string;
+      truncated: boolean;
+      totalBytes: number;
+    };
+    recipients: {
+      to: {
+        email: string;
+        name?: string;
+      }[];
+      cc: {
+        email: string;
+        name?: string;
+      }[];
+      bcc: {
+        email: string;
+        name?: string;
+      }[];
+      truncated: boolean;
+    };
+  };
   "email.drafts.create": {
     ok: boolean;
     kind: "email";
@@ -7369,7 +7590,7 @@ export type DenchApiTree = {
       show(args?: Req<"agentConfig.organisation.show">): Promise<Res<"agentConfig.organisation.show">>;
     };
     tools: {
-      /** Update tool notes. (`dench tools notes-edit`) */
+      /** Update tool notes. (`dench tools edit`) */
       edit(args: Req<"agentConfig.tools.edit">): Promise<Res<"agentConfig.tools.edit">>;
       /** Read tool notes. (`dench tools show`) */
       show(args?: Req<"agentConfig.tools.show">): Promise<Res<"agentConfig.tools.show">>;
@@ -7770,6 +7991,8 @@ export type DenchApiTree = {
       };
       /** List fields for a CRM object, including read-only calculation metadata. (`dench crm fields list`) */
       list(args: Req<"crm.fields.list">): Promise<Res<"crm.fields.list">>;
+      /** List field names, types and effective constraints without indexing or enrichment internals. (`dench crm fields list --compact`) */
+      listCompact(args: Req<"crm.fields.listCompact">): Promise<Res<"crm.fields.listCompact">>;
       /** Reorder CRM fields. (`dench crm fields reorder`) */
       reorder(args: Req<"crm.fields.reorder">): Promise<Res<"crm.fields.reorder">>;
       /** Update a CRM field or change/explicitly clear an existing campaign calculation. (`dench crm fields update`) */
@@ -7796,6 +8019,8 @@ export type DenchApiTree = {
       get(args: Req<"crm.objects.get">): Promise<Res<"crm.objects.get">>;
       /** List CRM objects. (`dench crm objects list`) */
       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">>;
       /** Rename a CRM object. (`dench crm objects rename`) */
       rename(args: Req<"crm.objects.rename">): Promise<Res<"crm.objects.rename">>;
       /** Restore a CRM object's workspace sidebar row. Admin-only. (`dench crm objects unarchive`) */
@@ -7821,8 +8046,13 @@ export type DenchApiTree = {
       /** Generate a CRM report. (`dench crm reports generate`) */
       generate(args: Req<"crm.reports.generate">): Promise<Res<"crm.reports.generate">>;
     };
-    /** Search CRM entries. (`dench crm search`) */
-    search(args?: Req<"crm.search">): Promise<Res<"crm.search">>;
+    search: {
+      /** Search CRM entries. (`dench crm search`) */
+      (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`) */
+      page(args?: Req<"crm.search.page">): Promise<Res<"crm.search.page">>;
+    };
     sidebar: {
       groups: {
         /** Create a named sidebar group (e.g. "Hiring") in the workspace-shared Library. Open to any member. (`dench crm sidebar group create`) */
@@ -8035,6 +8265,14 @@ export type DenchApiTree = {
       /** Start Dench Emailing Service sender verification. (`dench email identity verify`) */
       verify(args: Req<"email.identity.verify">): Promise<Res<"email.identity.verify">>;
     };
+    inbox: {
+      /** Read a bounded stored body using an exact message handle from inbox search; rechecks mailbox and record privacy. (`dench email inbox message`) */
+      message(args: Req<"email.inbox.message">): Promise<Res<"email.inbox.message">>;
+      /** Search authorized synced mailbox headers with bounded cursor pagination. isDone covers stored records, not provider completeness. (`dench email inbox search`) */
+      search(args?: Req<"email.inbox.search">): Promise<Res<"email.inbox.search">>;
+      /** Read a bounded page of synced headers using an exact thread handle from inbox search; bodies remain on demand. (`dench email inbox thread`) */
+      thread(args: Req<"email.inbox.thread">): Promise<Res<"email.inbox.thread">>;
+    };
     message: {
       /** Read a raw email message's status and open/click counters. (`dench email message status`) */
       get(args: Req<"email.message.get">): Promise<Res<"email.message.get">>;
@@ -8042,10 +8280,10 @@ export type DenchApiTree = {
       list(args?: Req<"email.message.list">): Promise<Res<"email.message.list">>;
     };
     native: {
-      /** Send through a native Gmail or Outlook mailbox with a durable request receipt. Only use for an explicit send request. (`dench email send --mailbox`) */
+      /** Send through a native Gmail or Outlook mailbox with a durable request receipt. Only use for an explicit send request. (`dench email send [--mailbox <id/email>]`) */
       send(args: Req<"email.native.send">): Promise<Res<"email.native.send">>;
     };
-    /** Send one raw email (no campaign): to/cc/bcc, custom from-name and reply-to, optional reply threading via replyToMessageId. (`dench email send`) */
+    /** Send one raw email (no campaign): to/cc/bcc, custom from-name and reply-to, optional reply threading via replyToMessageId. (`dench email send --from <verified-email>`) */
     send(args: Req<"email.send">): Promise<Res<"email.send">>;
     sequence: {
       /** Activate a sequence so its enrollments begin sending. (`dench email sequence activate`) */