@dench.com/cli 2.3.1 → 2.3.2

package/dench.ts

@@ -163,6 +163,14 @@ const api = {
         "functions/agentWorkspace:whatCanIDoHere",
       ),
     },
+    agentConfig: {
+      workspaceInstructions: makeFunctionReference<"query">(
+        "functions/agentConfig:workspaceInstructions",
+      ),
+      devWorkspaceInstructions: makeFunctionReference<"query">(
+        "functions/agentConfig:devWorkspaceInstructions",
+      ),
+    },
     files: {
       listTree: makeFunctionReference<"query">("functions/files:listTree"),
       deleteFile: makeFunctionReference<"mutation">(
@@ -450,7 +458,8 @@ Usage:
   dench use <session-key-or-workspace-slug> [--host <host>] [--json]
   dench logout [session-key-or-workspace-slug] [--session <key-or-scope>] [--host <host>] [--all] [--json]
   dench backend [show|set|clear] [<production|staging|local|<url>>] [--json]
-  dench context [--json]
+  dench context [--instructions] [--json]
+  dench instructions [--json]
   dench status [--mine|--self] [--json]
   dench memory search "query" [--limit 8] [--json]
   dench memory save <key> "text" [--kind fact|decision|preference|goal|tool_note|other] [--tags a,b] [--sensitivity normal|broad|sensitive] [--scope user|org] [--json]
@@ -682,10 +691,14 @@ function contextHelp() {
   console.log(`Dench context
 
 Usage:
-  dench context [--json]
+  dench context [--instructions] [--json]
+  dench instructions [--json]
 
 Shows the current workspace, current agent, assigned tasks, pending approvals
 requested by this agent, connected apps when available, and useful next commands.
+
+Use --instructions (or dench instructions) to print the standing workspace
+instructions external agents should treat as system-level guidance.
 `);
 }
 
@@ -2900,6 +2913,24 @@ function formatContext(context: JsonRecord) {
   return lines.join("\n");
 }
 
+async function buildWorkspaceInstructionsContext(
+  runtime: Awaited<ReturnType<typeof getRuntime>>,
+) {
+  if (runtime.mode === "dev") {
+    return (await runtime.client.query(
+      api.functions.agentConfig.devWorkspaceInstructions,
+      runtime.workspaceArgs,
+    )) as JsonRecord;
+  }
+  if (runtime.mode !== "session" && runtime.mode !== "apiKey") {
+    throw loginRequiredError("dench context --instructions");
+  }
+  return (await runtime.client.query(
+    api.functions.agentConfig.workspaceInstructions,
+    { sessionToken: runtime.sessionToken },
+  )) as JsonRecord;
+}
+
 async function devOverview(runtime: Awaited<ReturnType<typeof getRuntime>>) {
   if (runtime.mode !== "dev") {
     throw new Error("Not in dev mode");
@@ -4355,6 +4386,22 @@ async function main() {
     return;
   }
 
+  if (command === "context" && args.includes("--instructions")) {
+    const instructions = await buildWorkspaceInstructionsContext(runtime);
+    print(
+      json ? instructions : (stringField(instructions, "instructions") ?? ""),
+    );
+    return;
+  }
+
+  if (command === "instructions") {
+    const instructions = await buildWorkspaceInstructionsContext(runtime);
+    print(
+      json ? instructions : (stringField(instructions, "instructions") ?? ""),
+    );
+    return;
+  }
+
   if (command === "context") {
     const context = await buildContext(runtime);
     print(json ? context : formatContext(context));

package/lib/api-schemas.ts

@@ -340,6 +340,18 @@ const workspaceStatusPayload = z
     "Workspace orientation payload shared by /context, /status, /agents, and /approvals.",
   );
 
+const workspaceInstructionsResponse = z.object({
+  instructions: z
+    .string()
+    .describe(
+      "Markdown standing instructions for external agents connected to this workspace.",
+    ),
+  workspace: z.object({
+    name: z.string(),
+    slug: z.string().optional(),
+  }),
+});
+
 const memoryDoc = z
   .object({
     _id: z.string(),
@@ -1183,6 +1195,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
 
   // Workspace
   "workspace.context": noInput,
+  "workspace.instructions": noInput,
   "workspace.status": noInput,
   "workspace.agents": noInput,
   "workspace.approvals.list": noInput,
@@ -1909,6 +1922,7 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
 
   // Workspace orientation
   "workspace.context": workspaceStatusPayload,
+  "workspace.instructions": workspaceInstructionsResponse,
   "workspace.status": workspaceStatusPayload,
   "workspace.agents": workspaceStatusPayload,
   "workspace.approvals.list": workspaceStatusPayload,
@@ -2757,6 +2771,11 @@ export const responseExamples: Record<string, unknown> = {
     },
   },
   "workspace.context": workspaceStatusExample,
+  "workspace.instructions": {
+    workspace: { name: "Acme", slug: "acme" },
+    instructions:
+      "# Dench Workspace Instructions\n\nWorkspace: Acme (acme)\n\n## Identity\nYou are Dench...",
+  },
   "workspace.status": workspaceStatusExample,
   "workspace.agents": workspaceStatusExample,
   "workspace.approvals.list": workspaceStatusExample,

package/lib/command-registry.ts

@@ -245,6 +245,18 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("query", "functions/agentWorkspace:whatCanIDoHere"),
   }),
+  op({
+    id: "workspace.instructions",
+    group: "workspace",
+    summary:
+      "Return the current workspace's standing instructions for external agents.",
+    cli: "dench context --instructions",
+    method: "GET",
+    path: "/context/instructions",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:workspaceInstructions"),
+  }),
   op({
     id: "workspace.status",
     group: "workspace",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dench.com/cli",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "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": {