@dench.com/cli 2.1.2 → 2.1.3

package/agent-config.ts

@@ -1,6 +1,6 @@
 /**
- * `dench identity / organisation / user / heartbeat / bootstrap /
- *  model / daily / mem aggregate` — CLI surface for the OpenClaw-
+ * `dench identity / organisation / user / bootstrap / model / daily /
+ *  mem aggregate` — CLI surface for the OpenClaw-
  * parity self-updating harness.
  *
  * Mirrors the auth pattern in `cli/cron.ts`:
@@ -17,14 +17,12 @@
  *   user show | edit
  *   tools show | notes-edit
  *   memory show | append <text> | set                   (MEMORY.md aggregate)
- *   heartbeat status | enable | disable | interval <duration> |
- *             instructions
  *   bootstrap status | complete | reopen | template
  *   model default <id> | model default clear |
  *   model thread <threadId> <id> | model thread <threadId> clear
  *   daily today | daily show <YYYY-MM-DD> | daily append <text>
  *
- * `edit` / `notes-edit` / `instructions` / `template` open the
+ * `edit` / `notes-edit` / `template` open the
  * user's `$EDITOR` (default `vi`) to capture the new body. The
  * stdin path is also supported via `--stdin`, useful in scripts.
  */
@@ -60,9 +58,6 @@ const api = {
       updateUserProfile: makeFunctionReference<"mutation">(
         "functions/agentConfig:updateUserProfile",
       ),
-      updateHeartbeat: makeFunctionReference<"mutation">(
-        "functions/agentConfig:updateHeartbeat",
-      ),
       updateBootstrapTemplate: makeFunctionReference<"mutation">(
         "functions/agentConfig:updateBootstrapTemplate",
       ),
@@ -182,12 +177,6 @@ async function loadAgentConfig(ctx: CliCtx): Promise<{
       completedAt?: number;
       template?: string;
     };
-    heartbeat: {
-      enabled: boolean;
-      intervalMs: number;
-      instructions: string;
-      lastFiredAt?: number;
-    };
   };
   userProfile: { content: string; updatedAt: number } | null;
   organizationId: string;
@@ -206,12 +195,6 @@ async function loadAgentConfig(ctx: CliCtx): Promise<{
         completedAt?: number;
         template?: string;
       };
-      heartbeat: {
-        enabled: boolean;
-        intervalMs: number;
-        instructions: string;
-        lastFiredAt?: number;
-      };
     };
     userProfile: { content: string; updatedAt: number } | null;
     organizationId: string;
@@ -306,106 +289,6 @@ async function handleSimpleMagicFile(
   );
 }
 
-function formatInterval(ms: number): string {
-  if (ms < 60_000) return `${Math.round(ms / 1000)}s`;
-  if (ms < 60 * 60_000) return `${Math.round(ms / 60_000)}m`;
-  if (ms < 24 * 60 * 60_000) {
-    const hours = ms / (60 * 60_000);
-    return Number.isInteger(hours) ? `${hours}h` : `${hours.toFixed(1)}h`;
-  }
-  return `${(ms / (24 * 60 * 60_000)).toFixed(1)}d`;
-}
-
-const DURATION_RE = /^(\d+)\s*(ms|s|m|h|d)$/i;
-function parseDurationFlagToMs(input: string): number | null {
-  const m = DURATION_RE.exec(input.trim());
-  if (!m) return null;
-  const n = parseInt(m[1], 10);
-  if (!Number.isFinite(n) || n <= 0) return null;
-  switch (m[2].toLowerCase()) {
-    case "ms":
-      return n;
-    case "s":
-      return n * 1000;
-    case "m":
-      return n * 60_000;
-    case "h":
-      return n * 3_600_000;
-    case "d":
-      return n * 86_400_000;
-  }
-  return null;
-}
-
-async function handleHeartbeat(ctx: CliCtx, args: string[]): Promise<void> {
-  const sub = args[0];
-  if (!sub || sub === "status" || sub === "show") {
-    const config = await loadAgentConfig(ctx);
-    const hb = config.agentConfig.heartbeat;
-    if (ctx.jsonOutput) {
-      out(ctx, hb);
-      return;
-    }
-    out(
-      ctx,
-      `enabled=${hb.enabled} interval=${formatInterval(hb.intervalMs)}\n\n${hb.instructions}`,
-    );
-    return;
-  }
-  if (sub === "enable") {
-    await runMutation(ctx, api.functions.agentConfig.updateHeartbeat, {
-      enabled: true,
-    });
-    out(ctx, { ok: true, enabled: true });
-    return;
-  }
-  if (sub === "disable") {
-    await runMutation(ctx, api.functions.agentConfig.updateHeartbeat, {
-      enabled: false,
-    });
-    out(ctx, { ok: true, enabled: false });
-    return;
-  }
-  if (sub === "interval") {
-    const raw = args[1];
-    if (!raw) {
-      throw new AgentConfigCliError(
-        "Usage: dench heartbeat interval <duration> (e.g. 30m, 2h, 1d)",
-      );
-    }
-    const ms = parseDurationFlagToMs(raw);
-    if (!ms) throw new AgentConfigCliError(`Invalid duration: ${raw}`);
-    await runMutation(ctx, api.functions.agentConfig.updateHeartbeat, {
-      intervalMs: ms,
-    });
-    out(ctx, { ok: true, intervalMs: ms, label: formatInterval(ms) });
-    return;
-  }
-  if (sub === "instructions" || sub === "edit") {
-    let content: string;
-    if (hasFlag(args, "--stdin") || getFlag(args, "--content")) {
-      content = await resolveContent(args);
-    } else {
-      const config = await loadAgentConfig(ctx);
-      content = openEditor(
-        config.agentConfig.heartbeat.instructions,
-        "heartbeat",
-      );
-    }
-    if (!content.trim().length) {
-      throw new AgentConfigCliError("heartbeat instructions cannot be empty");
-    }
-    await runMutation(ctx, api.functions.agentConfig.updateHeartbeat, {
-      instructions: content,
-    });
-    out(ctx, { ok: true, kind: "heartbeat" });
-    return;
-  }
-  throw new AgentConfigCliError(
-    `Unknown heartbeat subcommand: "${sub}". Try "status", "enable", "disable", "interval <duration>", "instructions".`,
-  );
-}
-
 async function handleBootstrap(ctx: CliCtx, args: string[]): Promise<void> {
   const sub = args[0];
   if (!sub || sub === "status" || sub === "show") {
@@ -598,10 +481,6 @@ export async function runMemoryAggregateCommand(ctx: CliCtx): Promise<void> {
   );
 }
 
-export async function runHeartbeatCommand(ctx: CliCtx): Promise<void> {
-  await handleHeartbeat(ctx, ctx.args);
-}
-
 export async function runBootstrapCommand(ctx: CliCtx): Promise<void> {
   await handleBootstrap(ctx, ctx.args);
 }
@@ -666,8 +545,6 @@ export function printAgentConfigCliHelp(): void {
   dench user show | edit                            USER.md (per-member)
   dench tools show | notes-edit                     TOOLS.md notes section
   dench mem show | append <text> | set              MEMORY.md aggregate
-  dench heartbeat status | enable | disable         Heartbeat cron
-                  | interval <30m|1h|…> | instructions
   dench bootstrap status | complete | reopen | template
   dench model default <id|clear> | model thread <threadId> <id|clear>
   dench daily today | show <YYYY-MM-DD>              Activity log paths

package/chat.ts

@@ -433,7 +433,7 @@ async function runChatDeleteCommand(ctx: ChatCliContext): Promise<void> {
       );
     }
     const automatedSuffix = includeAutomated
-      ? " (INCLUDING ROUTINES / HEARTBEATS — automated thread protection bypassed)"
+      ? " (INCLUDING AUTOMATED ROUTINES — automated thread protection bypassed)"
       : "";
     const ok = await promptYesNo(
       `PERMANENTLY queue delete of ${threadIds.length} chat${

package/dench.ts

@@ -490,6 +490,15 @@ LinkedIn outreach (Browserbase, verified before CRM update):
   dench linkedin connect <profileUrl> [--entry people:<entryId>] [--json]
   Help: dench linkedin help
 
+Managed email campaigns (Dench Emailing Service):
+  dench email identity verify --from founder@example.com [--json]
+  dench email template create --name "Intro" --subject "Hi {{firstName}}" --html-file body.html [--json]
+  dench email campaign create --name "Q2 outreach" --identity <id> --template <id> [--json]
+  dench email campaign recipients add --campaign <id> --file recipients.jsonl [--json]
+  dench email campaign submit --campaign <id> [--json]
+  dench email campaign status --campaign <id> [--json]
+  Help: dench email help
+
 Image generation / editing (via the Dench Gateway):
   dench image generate "<prompt>" [--size 1024x1024] [--quality auto|low|medium|high] [--format png|jpeg|webp] [--save-path /workspace/path/file.png] [--output <local file>] [--no-write] [--json]
   dench image edit "<prompt>" --input <path> [--input <path> ...] [--mask <path>] [--size ...] [--quality ...] [--format ...] [--save-path ...] [--output ...] [--json]
@@ -552,8 +561,6 @@ Self-updating agent harness:
   dench user show | edit                        USER.md (per-member)
   dench tools show | edit                       TOOLS.md notes section
   dench mem show | append "<text>" | set        MEMORY.md aggregate
-  dench heartbeat status | enable | disable
-                  | interval <30m|1h|…> | instructions
   dench bootstrap status | complete | reopen | template
   dench model default <id|clear>
   dench model thread <threadId> <id|clear>
@@ -3666,6 +3673,20 @@ async function main() {
     return;
   }
 
+  if (
+    command === "email" &&
+    (!subcommand || subcommand === "help" || hasFlag("--help"))
+  ) {
+    const { runEmailCommand } = await import("./email");
+    await runEmailCommand({
+      // biome-ignore lint/suspicious/noExplicitAny: harmless help-only stub
+      convex: {} as any,
+      args: subcommand ? [subcommand] : ["help"],
+      jsonOutput: json,
+    });
+    return;
+  }
+
   if (
     command === "billing" &&
     (!subcommand || subcommand === "help" || hasFlag("--help"))
@@ -3897,6 +3918,31 @@ async function main() {
     return;
   }
 
+  if (command === "email") {
+    const subArgs = args.slice(args.indexOf("email") + 1);
+    const { runEmailCommand } = await import("./email");
+    const runtime = await getRuntime();
+    const authedRuntime = requireAuthenticatedRuntime(runtime, "dench email");
+    let gatewayAuth:
+      | Awaited<ReturnType<typeof resolveGatewayCommandAuth>>
+      | undefined;
+    try {
+      gatewayAuth = await resolveGatewayCommandAuth(runtime, "dench email");
+    } catch {
+      gatewayAuth = undefined;
+    }
+    await runEmailCommand({
+      convex: authedRuntime.client,
+      args: subArgs.filter((arg) => arg !== "--json"),
+      jsonOutput: json,
+      sessionToken: authedRuntime.sessionToken,
+      bearerToken: gatewayAuth?.bearerToken ?? authedRuntime.sessionToken,
+      gatewayBaseUrl: gatewayAuth?.gatewayBaseUrl,
+      gatewayHeaders: gatewayAuth?.gatewayHeaders,
+    });
+    return;
+  }
+
   if (command === "apps") {
     const runtime = await getRuntime();
     const gatewayAuth = await resolveGatewayCommandAuth(runtime, "dench apps");
@@ -4093,7 +4139,7 @@ async function main() {
   // ── OpenClaw-parity self-update CLI surface ──────────────────────────
   //
   // Dispatch all `dench identity / organisation / user / tools / mem /
-  // heartbeat / bootstrap / model / daily` traffic through the shared
+  // bootstrap / model / daily` traffic through the shared
   // agent-config CLI module. Each command requires the same auth shape
   // as `dench cron` (Bearer DENCH_API_KEY or `dench signin` session
   // token) so server-side `requireCronAccess` accepts both.
@@ -4103,7 +4149,6 @@ async function main() {
     "user",
     "tools",
     "mem",
-    "heartbeat",
     "bootstrap",
     "model",
     "daily",
@@ -4151,10 +4196,6 @@ async function main() {
       await mod.runMemoryAggregateCommand(ctxBase);
       return;
     }
-    if (command === "heartbeat") {
-      await mod.runHeartbeatCommand(ctxBase);
-      return;
-    }
     if (command === "bootstrap") {
       await mod.runBootstrapCommand(ctxBase);
       return;

package/lib/api-schemas.ts

@@ -888,11 +888,6 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
     content: z.string(),
     append: z.boolean().optional(),
   }),
-  "agentConfig.heartbeat.update": z.object({
-    enabled: z.boolean().optional(),
-    intervalMs: z.number().int().optional(),
-    instructions: z.string().optional(),
-  }),
   "agentConfig.bootstrap.complete": z.object({
     completed: z.boolean().optional(),
   }),

package/lib/command-registry.ts

@@ -1095,6 +1095,180 @@ const rawApiOperations = [
     ),
   }),
 
+  // Managed email campaigns.
+  op({
+    id: "email.identity.verify",
+    group: "email",
+    summary: "Start Dench Emailing Service sender verification.",
+    cli: "dench email identity verify",
+    method: "POST",
+    path: "/email/identities/verify",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/email/identities/verify"),
+  }),
+  op({
+    id: "email.identity.create",
+    group: "email",
+    summary: "Create a durable Dench email sending identity record.",
+    cli: "dench email identity verify",
+    method: "POST",
+    path: "/email/sending-identities",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:createIdentity"),
+  }),
+  op({
+    id: "email.identity.refresh",
+    group: "email",
+    summary: "Refresh a Dench Emailing Service sender verification status.",
+    cli: "dench email identity status --identity-id",
+    method: "POST",
+    path: "/email/sending-identities/{identityId}/status",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "action",
+      "functions/emailCampaignsNode:refreshIdentityStatus",
+    ),
+  }),
+  op({
+    id: "email.identity.beginVerification",
+    group: "email",
+    summary:
+      "Begin the full Dench sender verification flow for a sending identity.",
+    cli: "dench email identity verify",
+    method: "POST",
+    path: "/email/sending-identities/{identityId}/verify",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "action",
+      "functions/emailCampaignsNode:beginSenderVerification",
+    ),
+  }),
+  op({
+    id: "email.identity.status",
+    group: "email",
+    summary: "Read Dench Emailing Service sender verification status.",
+    cli: "dench email identity status",
+    method: "GET",
+    path: "/email/identities/{identity}/status",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("GET", "/email/identities/{identity}/status"),
+  }),
+  op({
+    id: "email.template.create",
+    group: "email",
+    summary: "Create a managed email campaign template.",
+    cli: "dench email template create",
+    method: "POST",
+    path: "/email/templates",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:createTemplate"),
+  }),
+  op({
+    id: "email.template.preview",
+    group: "email",
+    summary: "Preview a managed email campaign template.",
+    cli: "dench email template preview",
+    method: "POST",
+    path: "/email/templates/{templateId}/preview",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailCampaigns:previewTemplate"),
+  }),
+  op({
+    id: "email.campaign.create",
+    group: "email",
+    summary: "Create a managed email campaign draft.",
+    cli: "dench email campaign create",
+    method: "POST",
+    path: "/email/campaigns",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:createCampaign"),
+  }),
+  op({
+    id: "email.campaign.get",
+    group: "email",
+    summary: "Read campaign status and counters.",
+    cli: "dench email campaign status",
+    method: "GET",
+    path: "/email/campaigns/{campaignId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailCampaigns:getCampaign"),
+  }),
+  op({
+    id: "email.campaign.recipients.add",
+    group: "email",
+    summary: "Add recipients to a managed email campaign.",
+    cli: "dench email campaign recipients add",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/recipients",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:addRecipients"),
+  }),
+  op({
+    id: "email.campaign.preview",
+    group: "email",
+    summary: "Preview rendered messages for a campaign sample.",
+    cli: "dench email campaign preview",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/preview",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailCampaigns:previewCampaign"),
+  }),
+  op({
+    id: "email.campaign.submit",
+    group: "email",
+    summary: "Submit a campaign for approval or sending.",
+    cli: "dench email campaign submit",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/submit",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:submitCampaign"),
+  }),
+  op({
+    id: "email.campaign.pause",
+    group: "email",
+    summary: "Pause a sending email campaign.",
+    cli: "dench email campaign pause",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/pause",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:pauseCampaign"),
+  }),
+  op({
+    id: "email.campaign.resume",
+    group: "email",
+    summary: "Resume a paused email campaign.",
+    cli: "dench email campaign resume",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/resume",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:resumeCampaign"),
+  }),
+  op({
+    id: "email.campaign.cancel",
+    group: "email",
+    summary: "Cancel an email campaign.",
+    cli: "dench email campaign cancel",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/cancel",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:cancelCampaign"),
+  }),
+
   // Routines.
   op({
     id: "cron.list",
@@ -1521,28 +1695,6 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/agentConfig:updateMemory"),
   }),
-  op({
-    id: "agentConfig.heartbeat.show",
-    group: "agent-config",
-    summary: "Read heartbeat config.",
-    cli: "dench heartbeat status",
-    method: "GET",
-    path: "/agent-config/heartbeat",
-    requestSchema: noBody,
-    responseSchema: anyResponse,
-    backend: convex("query", "functions/agentConfig:getAgentConfig"),
-  }),
-  op({
-    id: "agentConfig.heartbeat.update",
-    group: "agent-config",
-    summary: "Update heartbeat config.",
-    cli: "dench heartbeat enable|disable|interval|instructions",
-    method: "PATCH",
-    path: "/agent-config/heartbeat",
-    requestSchema: anyObject,
-    responseSchema: anyResponse,
-    backend: convex("mutation", "functions/agentConfig:updateHeartbeat"),
-  }),
   op({
     id: "agentConfig.bootstrap.show",
     group: "agent-config",

package/lib/enrichment-gateway.ts

@@ -1055,12 +1055,13 @@ export async function aviatoEnrichPerson(
   body: AviatoEnrichPersonBody,
   options: EnrichmentGatewayOptions = {},
 ): Promise<Record<string, unknown>> {
+  const linkedinUrl = body.linkedinUrl?.trim();
+  const linkedinID = body.linkedinID?.trim();
+  const linkedinNumID = body.linkedinNumID?.trim();
+  const linkedinEntityId = body.linkedinEntityId?.trim();
+  const email = body.email?.trim();
   const hasIdentifier =
-    body.linkedinUrl ||
-    body.linkedinID ||
-    body.linkedinNumID ||
-    body.linkedinEntityId ||
-    body.email;
+    linkedinUrl || linkedinID || linkedinNumID || linkedinEntityId || email;
   if (!hasIdentifier) {
     throw new EnrichmentGatewayError(
       "Aviato person enrichment requires at least one identifier: linkedinUrl, linkedinID, linkedinNumID, linkedinEntityId, or email.",
@@ -1068,14 +1069,24 @@ export async function aviatoEnrichPerson(
     );
   }
 
+  // Aviato rejects email-only lookups in preview mode ("Email lookups are
+  // not allowed in preview mode"), so when email is the sole identifier we
+  // upgrade to a full (charged) lookup rather than surfacing a hard 400.
+  const emailOnly =
+    Boolean(email) &&
+    !linkedinUrl &&
+    !linkedinID &&
+    !linkedinNumID &&
+    !linkedinEntityId;
+
   const requestBody: Record<string, unknown> = {};
-  if (body.linkedinUrl) requestBody.linkedinURL = body.linkedinUrl.trim();
-  if (body.linkedinID) requestBody.linkedinID = body.linkedinID.trim();
-  if (body.linkedinNumID) requestBody.linkedinNumID = body.linkedinNumID.trim();
-  if (body.linkedinEntityId)
-    requestBody.linkedinEntityId = body.linkedinEntityId.trim();
-  if (body.email) requestBody.email = body.email.trim();
-  if (body.preview !== undefined) requestBody.preview = body.preview;
+  if (linkedinUrl) requestBody.linkedinURL = linkedinUrl;
+  if (linkedinID) requestBody.linkedinID = linkedinID;
+  if (linkedinNumID) requestBody.linkedinNumID = linkedinNumID;
+  if (linkedinEntityId) requestBody.linkedinEntityId = linkedinEntityId;
+  if (email) requestBody.email = email;
+  if (body.preview !== undefined && !(body.preview && emailOnly))
+    requestBody.preview = body.preview;
 
   const raw = await callGatewayJson("/v1/enrichment/aviato/person", {
     method: "POST",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dench.com/cli",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Dench agent workspace CLI. v2 unifies auth behind `dench signin`; the legacy `dench login` / `dench onboard` / `dench setup` / `dench what-can-i-do` / `dench register` commands now error with a redirect.",
   "type": "module",
   "bin": {