@dench.com/cli 3.6.6-staging.386 → 3.8.0-staging.389

package/lib/command-registry.ts

@@ -137,6 +137,190 @@ function local(reason: string): LocalOnlyOperation {
 }
 
 const rawApiOperations = [
+  op({
+    id: "environments.list",
+    group: "environments",
+    summary:
+      "List workspace-shared reusable setups and ready revisions (metadata only).",
+    cli: "dench env list",
+    method: "GET",
+    path: "/environments",
+    requestSchema: z
+      .object({
+        limit: z.number().int().min(1).max(100).optional(),
+        cursor: z.string().optional(),
+      })
+      .strict(),
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/environments:list"),
+  }),
+  op({
+    id: "environments.get",
+    group: "environments",
+    summary:
+      "Inspect a saved setup, its manifest, and an optional immutable revision.",
+    cli: "dench env show",
+    method: "GET",
+    path: "/environments/{name}",
+    requestSchema: z
+      .object({
+        name: z.string().regex(/^[a-z][a-z0-9-]{0,63}$/),
+        revision: z
+          .string()
+          .regex(/^[a-f0-9]{64}$/)
+          .optional(),
+      })
+      .strict(),
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/environments:get"),
+  }),
+  op({
+    id: "environments.upload",
+    group: "environments",
+    summary:
+      "Reserve an owner-bound source upload. Prefix the uploaded bytes with the returned proof before saving.",
+    cli: "dench env save",
+    method: "POST",
+    path: "/environments/uploads",
+    requestSchema: z
+      .object({
+        kind: z.literal("source"),
+        size: z.number().int().min(1).max(16777216),
+        sha256: z.string().regex(/^[a-f0-9]{64}$/),
+      })
+      .strict(),
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/environments:requestUpload"),
+  }),
+  op({
+    id: "environments.save",
+    group: "environments",
+    summary:
+      "Publish an explicitly saved source and manifest for one-time preparation. Returns pending/building until verified; does not run the task.",
+    cli: "dench env save",
+    method: "POST",
+    path: "/environments/{name}",
+    requestSchema: z
+      .object({
+        name: z.string().regex(/^[a-z][a-z0-9-]{0,63}$/),
+        manifest: z
+          .object({
+            version: z.literal(1),
+            name: z.string(),
+            purpose: z.string(),
+            files: z.array(z.string()),
+            prepare: z.array(z.string()),
+            verify: z.array(z.string()),
+            env: z.record(z.string(), z.string()).optional(),
+            secretEnv: z.record(z.string(), z.string()).optional(),
+            secretFiles: z
+              .array(
+                z.object({
+                  path: z.string(),
+                  secret: z.string(),
+                  mutable: z.boolean().optional(),
+                }),
+              )
+              .optional(),
+            statePaths: z.array(z.string()).optional(),
+            portable: z.boolean().optional(),
+          })
+          .strict(),
+        uploadId: z.string(),
+        storageId: z.string(),
+        sha256: z.string().regex(/^[a-f0-9]{64}$/),
+      })
+      .strict(),
+    responseSchema: anyResponse,
+    backend: convex("action", "functions/environmentsNode:save"),
+  }),
+  op({
+    id: "environments.delete",
+    group: "environments",
+    summary:
+      "Retire a saved setup from new selection; retain immutable revisions and active job evidence.",
+    cli: "dench env delete",
+    method: "DELETE",
+    path: "/environments/{name}",
+    requestSchema: z
+      .object({ name: z.string().regex(/^[a-z][a-z0-9-]{0,63}$/) })
+      .strict(),
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/environments:remove"),
+  }),
+  op({
+    id: "environments.run",
+    group: "environments",
+    summary:
+      "Run a command with prepared dependencies and declared credentials, saving declared state with a revision check.",
+    cli: "dench env run",
+    method: "POST",
+    path: "/local/environments/run",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: local(
+      "Execution occurs in the CLI process. Use dench env run NAME -- COMMAND; secret-bearing execution resolution is not a general REST read endpoint.",
+    ),
+  }),
+  op({
+    id: "secrets.list",
+    group: "secrets",
+    summary:
+      "List workspace-shared credential names, kinds and versions; never values.",
+    cli: "dench secrets list",
+    method: "GET",
+    path: "/secrets",
+    requestSchema: z
+      .object({
+        limit: z.number().int().min(1).max(100).optional(),
+        cursor: z.string().optional(),
+      })
+      .strict(),
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/workspaceSecrets:list"),
+  }),
+  op({
+    id: "secrets.set",
+    group: "secrets",
+    summary:
+      "Encrypt a workspace credential. Use CLI stdin or the secure chat form; return metadata only. Do not put values in chat, manifests or scripts.",
+    cli: "dench secrets set",
+    method: "PUT",
+    path: "/secrets/{name}",
+    requestSchema: z
+      .object({
+        name: z.string().regex(/^[A-Z][A-Z0-9_]{0,127}$/),
+        kind: z.enum(["env", "file"]),
+        value: z.string().min(1).max(65536),
+        expectedVersion: z.number().int().nonnegative().optional(),
+      })
+      .strict(),
+    responseSchema: z.object({
+      name: z.string(),
+      kind: z.enum(["env", "file"]),
+      version: z.number(),
+      revision: z.number(),
+      status: z.literal("stored"),
+    }),
+    backend: convex("action", "functions/workspaceSecretsNode:set"),
+  }),
+  op({
+    id: "secrets.delete",
+    group: "secrets",
+    summary:
+      "Revoke a workspace credential for future resolution, optionally checking its version.",
+    cli: "dench secrets delete",
+    method: "DELETE",
+    path: "/secrets/{name}",
+    requestSchema: z
+      .object({
+        name: z.string().regex(/^[A-Z][A-Z0-9_]{0,127}$/),
+        expectedVersion: z.number().int().nonnegative().optional(),
+      })
+      .strict(),
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/workspaceSecrets:remove"),
+  }),
   op({
     id: "campaigns.drafts.create",
     group: "campaigns",
@@ -974,6 +1158,18 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("query", "functions/crm/objects:list"),
   }),
+  op({
+    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",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/objects:listCompact"),
+  }),
   op({
     id: "crm.objects.get",
     group: "crm",
@@ -1259,6 +1455,18 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("query", "functions/crm/fields:list"),
   }),
+  op({
+    id: "crm.fields.listCompact",
+    group: "crm",
+    summary:
+      "List field names, types and effective constraints without indexing or enrichment internals.",
+    cli: "dench crm fields list --compact",
+    method: "GET",
+    path: "/crm/catalog/objects/{objectName}/fields",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/fields:listCompact"),
+  }),
   op({
     id: "crm.fields.create",
     group: "crm",
@@ -2306,6 +2514,18 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("query", "functions/crm/query:search"),
   }),
+  op({
+    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",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/query:searchPage"),
+  }),
   op({
     id: "crm.statuses.list",
     group: "crm",
@@ -3347,6 +3567,42 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/emailCampaigns:deleteIdentity"),
   }),
+  op({
+    id: "email.inbox.search",
+    group: "email",
+    summary:
+      "Search authorized synced mailbox headers with bounded cursor pagination. isDone covers stored records, not provider completeness.",
+    cli: "dench email inbox search",
+    method: "GET",
+    path: "/email/inbox/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailInbox:search"),
+  }),
+  op({
+    id: "email.inbox.thread",
+    group: "email",
+    summary:
+      "Read a bounded page of synced headers using an exact thread handle from inbox search; bodies remain on demand.",
+    cli: "dench email inbox thread",
+    method: "GET",
+    path: "/email/inbox/threads/{threadHandle}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailInbox:thread"),
+  }),
+  op({
+    id: "email.inbox.message",
+    group: "email",
+    summary:
+      "Read a bounded stored body using an exact message handle from inbox search; rechecks mailbox and record privacy.",
+    cli: "dench email inbox message",
+    method: "GET",
+    path: "/email/inbox/messages/{messageHandle}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailInbox:message"),
+  }),
   op({
     id: "email.drafts.create",
     group: "email",
@@ -3434,7 +3690,7 @@ const rawApiOperations = [
     group: "email",
     summary:
       "Send through a native Gmail or Outlook mailbox with a durable request receipt. Only use for an explicit send request.",
-    cli: "dench email send --mailbox",
+    cli: "dench email send [--mailbox <id/email>]",
     method: "POST",
     path: "/email/native/send",
     requestSchema: anyObject,
@@ -3449,7 +3705,7 @@ const rawApiOperations = [
     group: "email",
     summary:
       "Send one raw email (no campaign): to/cc/bcc, custom from-name and reply-to, optional reply threading via replyToMessageId.",
-    cli: "dench email send",
+    cli: "dench email send --from <verified-email>",
     method: "POST",
     path: "/email/send",
     requestSchema: anyObject,
@@ -5062,7 +5318,8 @@ const rawApiOperations = [
     id: "agentConfig.identity.show",
     group: "agent-config",
     summary: "Read IDENTITY.md.",
-    cli: "dench identity show",
+    cli: "dench context --sections identity",
+    aliases: ["dench identity show"],
     method: "GET",
     path: "/agent-config/identity",
     requestSchema: noBody,
@@ -5073,7 +5330,8 @@ const rawApiOperations = [
     id: "agentConfig.identity.edit",
     group: "agent-config",
     summary: "Update IDENTITY.md.",
-    cli: "dench identity edit",
+    cli: "dench context set identity",
+    aliases: ["dench identity edit"],
     method: "PUT",
     path: "/agent-config/identity",
     requestSchema: anyObject,
@@ -5084,7 +5342,8 @@ const rawApiOperations = [
     id: "agentConfig.organisation.show",
     group: "agent-config",
     summary: "Read ORGANISATION.md.",
-    cli: "dench organisation show",
+    cli: "dench context --sections organisation",
+    aliases: ["dench organisation show"],
     method: "GET",
     path: "/agent-config/organisation",
     requestSchema: noBody,
@@ -5095,7 +5354,8 @@ const rawApiOperations = [
     id: "agentConfig.organisation.edit",
     group: "agent-config",
     summary: "Update ORGANISATION.md.",
-    cli: "dench organisation edit",
+    cli: "dench context set organisation",
+    aliases: ["dench organisation edit"],
     method: "PUT",
     path: "/agent-config/organisation",
     requestSchema: anyObject,
@@ -5106,7 +5366,8 @@ const rawApiOperations = [
     id: "agentConfig.user.show",
     group: "agent-config",
     summary: "Read USER.md.",
-    cli: "dench user show",
+    cli: "dench context --sections user",
+    aliases: ["dench user show"],
     method: "GET",
     path: "/agent-config/user",
     requestSchema: noBody,
@@ -5117,7 +5378,8 @@ const rawApiOperations = [
     id: "agentConfig.user.edit",
     group: "agent-config",
     summary: "Update USER.md.",
-    cli: "dench user edit",
+    cli: "dench context set user",
+    aliases: ["dench user edit"],
     method: "PUT",
     path: "/agent-config/user",
     requestSchema: anyObject,
@@ -5128,7 +5390,8 @@ const rawApiOperations = [
     id: "agentConfig.tools.show",
     group: "agent-config",
     summary: "Read tool notes.",
-    cli: "dench tools show",
+    cli: "dench context --sections tools",
+    aliases: ["dench tools show"],
     method: "GET",
     path: "/agent-config/tools",
     requestSchema: noBody,
@@ -5139,15 +5402,32 @@ const rawApiOperations = [
     id: "agentConfig.tools.edit",
     group: "agent-config",
     summary: "Update tool notes.",
-    cli: "dench tools notes-edit",
+    cli: "dench context set tools",
+    aliases: ["dench tools edit"],
     method: "PUT",
     path: "/agent-config/tools",
     requestSchema: anyObject,
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/agentConfig:updateToolsNotes"),
   }),
+  op({
+    id: "workspace.context.rules.set",
+    group: "workspace",
+    summary:
+      "Update standing workspace rules; credentials belong in secrets and runnable setup in environments.",
+    cli: "dench context set rules",
+    method: "PUT",
+    path: "/context/rules",
+    requestSchema: z.object({ content: z.string().min(1).max(32000) }).strict(),
+    responseSchema: anyResponse,
+    backend: {
+      ...convex("mutation", "functions/agentConfig:writeMagicFileFromUI"),
+      fixedArgs: { path: "/RULES.md" },
+    },
+  }),
   op({
     id: "agentConfig.mem.show",
+    deprecated: true,
     group: "agent-config",
     summary: "Read aggregate memory.",
     cli: "dench mem show",
@@ -5159,6 +5439,7 @@ const rawApiOperations = [
   }),
   op({
     id: "agentConfig.mem.edit",
+    deprecated: true,
     group: "agent-config",
     summary: "Update aggregate memory.",
     cli: "dench mem set",
@@ -5170,6 +5451,7 @@ const rawApiOperations = [
   }),
   op({
     id: "agentConfig.bootstrap.show",
+    deprecated: true,
     group: "agent-config",
     summary: "Read bootstrap state.",
     cli: "dench bootstrap status",
@@ -5181,6 +5463,7 @@ const rawApiOperations = [
   }),
   op({
     id: "agentConfig.bootstrap.complete",
+    deprecated: true,
     group: "agent-config",
     summary: "Complete bootstrap.",
     cli: "dench bootstrap complete",
@@ -5192,6 +5475,7 @@ const rawApiOperations = [
   }),
   op({
     id: "agentConfig.bootstrap.template",
+    deprecated: true,
     group: "agent-config",
     summary: "Update bootstrap template.",
     cli: "dench bootstrap template",
@@ -5228,6 +5512,7 @@ const rawApiOperations = [
   }),
   op({
     id: "agentConfig.daily.today",
+    deprecated: true,
     group: "agent-config",
     summary: "Read today's daily activity path.",
     cli: "dench daily today",
@@ -5239,6 +5524,7 @@ const rawApiOperations = [
   }),
   op({
     id: "agentConfig.daily.show",
+    deprecated: true,
     group: "agent-config",
     summary: "Read a daily activity path.",
     cli: "dench daily show",