@vellumai/assistant 0.4.56 → 0.5.0

package/src/calls/twilio-rest.ts

@@ -331,254 +331,6 @@ export async function updatePhoneNumberWebhooks(
   }
 }
 
-// ── Toll-Free Verification ──────────────────────────────────────────────
-
-/** Twilio Messaging API base URL for toll-free verification endpoints. */
-const TOLLFREE_VERIFICATION_BASE =
-  "https://messaging.twilio.com/v1/Tollfree/Verifications";
-
-export interface TollFreeVerification {
-  sid: string;
-  status: string;
-  rejectionReason?: string;
-  rejectionReasons?: string[];
-  errorCode?: string;
-  editAllowed?: boolean;
-  editExpiration?: string;
-  regulationType?: string;
-}
-
-function parseTollFreeVerification(
-  raw: Record<string, unknown>,
-): TollFreeVerification {
-  return {
-    sid: raw.sid as string,
-    status: raw.status as string,
-    rejectionReason: (raw.rejection_reason as string) ?? undefined,
-    rejectionReasons: (raw.rejection_reasons as string[]) ?? undefined,
-    errorCode: raw.error_code != null ? String(raw.error_code) : undefined,
-    editAllowed: (raw.edit_allowed as boolean) ?? undefined,
-    editExpiration: (raw.edit_expiration as string) ?? undefined,
-    regulationType: (raw.regulation_type as string) ?? undefined,
-  };
-}
-
-/**
- * Get toll-free verification status for a phone number.
- * If `phoneNumberSid` is provided, filters by that SID; otherwise returns the
- * first verification found.
- */
-export async function getTollFreeVerificationStatus(
-  accountSid: string,
-  authToken: string,
-  phoneNumberSid?: string,
-): Promise<TollFreeVerification | null> {
-  const params = new URLSearchParams();
-  if (phoneNumberSid) params.set("TollfreePhoneNumberSid", phoneNumberSid);
-
-  const url = params.toString()
-    ? `${TOLLFREE_VERIFICATION_BASE}?${params.toString()}`
-    : TOLLFREE_VERIFICATION_BASE;
-
-  const res = await fetch(url, {
-    method: "GET",
-    headers: { Authorization: twilioAuthHeader(accountSid, authToken) },
-  });
-
-  if (!res.ok) {
-    const text = await res.text();
-    throw new ProviderError(
-      `Twilio Toll-Free Verification API error ${res.status}: ${text}`,
-      "twilio",
-      res.status,
-    );
-  }
-
-  const data = (await res.json()) as {
-    verifications?: Array<Record<string, unknown>>;
-  };
-  const verifications = data.verifications ?? [];
-  if (verifications.length === 0) return null;
-
-  return parseTollFreeVerification(verifications[0]);
-}
-
-/** Fetch a specific toll-free verification by SID. */
-export async function getTollFreeVerificationBySid(
-  accountSid: string,
-  authToken: string,
-  verificationSid: string,
-): Promise<TollFreeVerification | null> {
-  const res = await fetch(
-    `${TOLLFREE_VERIFICATION_BASE}/${encodeURIComponent(verificationSid)}`,
-    {
-      method: "GET",
-      headers: { Authorization: twilioAuthHeader(accountSid, authToken) },
-    },
-  );
-
-  if (res.status === 404) {
-    return null;
-  }
-
-  if (!res.ok) {
-    const text = await res.text();
-    throw new ProviderError(
-      `Twilio Toll-Free Verification fetch error ${res.status}: ${text}`,
-      "twilio",
-      res.status,
-    );
-  }
-
-  const data = (await res.json()) as Record<string, unknown>;
-  return parseTollFreeVerification(data);
-}
-
-export interface TollFreeVerificationSubmitParams {
-  tollfreePhoneNumberSid: string;
-  businessName: string;
-  businessWebsite: string;
-  notificationEmail: string;
-  useCaseCategories: string[];
-  useCaseSummary: string;
-  productionMessageSample: string;
-  optInImageUrls: string[];
-  optInType: string;
-  messageVolume: string;
-  businessType?: string;
-  customerProfileSid?: string;
-}
-
-/** Submit a new toll-free verification request. */
-export async function submitTollFreeVerification(
-  accountSid: string,
-  authToken: string,
-  params: TollFreeVerificationSubmitParams,
-): Promise<TollFreeVerification> {
-  const body = new URLSearchParams();
-  body.set("TollfreePhoneNumberSid", params.tollfreePhoneNumberSid);
-  body.set("BusinessName", params.businessName);
-  body.set("BusinessWebsite", params.businessWebsite);
-  body.set("NotificationEmail", params.notificationEmail);
-  body.set("UseCaseSummary", params.useCaseSummary);
-  body.set("ProductionMessageSample", params.productionMessageSample);
-  body.set("OptInType", params.optInType);
-  body.set("MessageVolume", params.messageVolume);
-  body.set("BusinessType", params.businessType ?? "SOLE_PROPRIETOR");
-
-  for (const cat of params.useCaseCategories) {
-    body.append("UseCaseCategories", cat);
-  }
-  for (const url of params.optInImageUrls) {
-    body.append("OptInImageUrls", url);
-  }
-  if (params.customerProfileSid) {
-    body.set("CustomerProfileSid", params.customerProfileSid);
-  }
-
-  const res = await fetch(TOLLFREE_VERIFICATION_BASE, {
-    method: "POST",
-    headers: {
-      Authorization: twilioAuthHeader(accountSid, authToken),
-      "Content-Type": "application/x-www-form-urlencoded",
-    },
-    body: body.toString(),
-  });
-
-  if (!res.ok) {
-    const text = await res.text();
-    throw new ProviderError(
-      `Twilio Toll-Free Verification submit error ${res.status}: ${text}`,
-      "twilio",
-      res.status,
-    );
-  }
-
-  const data = (await res.json()) as Record<string, unknown>;
-  return parseTollFreeVerification(data);
-}
-
-/** Update an existing toll-free verification. */
-export async function updateTollFreeVerification(
-  accountSid: string,
-  authToken: string,
-  verificationSid: string,
-  params: Partial<TollFreeVerificationSubmitParams>,
-): Promise<TollFreeVerification> {
-  const body = new URLSearchParams();
-  if (params.businessName) body.set("BusinessName", params.businessName);
-  if (params.businessWebsite)
-    body.set("BusinessWebsite", params.businessWebsite);
-  if (params.notificationEmail)
-    body.set("NotificationEmail", params.notificationEmail);
-  if (params.useCaseSummary) body.set("UseCaseSummary", params.useCaseSummary);
-  if (params.productionMessageSample)
-    body.set("ProductionMessageSample", params.productionMessageSample);
-  if (params.optInType) body.set("OptInType", params.optInType);
-  if (params.messageVolume) body.set("MessageVolume", params.messageVolume);
-  if (params.businessType) body.set("BusinessType", params.businessType);
-  if (params.useCaseCategories) {
-    for (const cat of params.useCaseCategories) {
-      body.append("UseCaseCategories", cat);
-    }
-  }
-  if (params.optInImageUrls) {
-    for (const url of params.optInImageUrls) {
-      body.append("OptInImageUrls", url);
-    }
-  }
-  if (params.customerProfileSid)
-    body.set("CustomerProfileSid", params.customerProfileSid);
-
-  const res = await fetch(
-    `${TOLLFREE_VERIFICATION_BASE}/${encodeURIComponent(verificationSid)}`,
-    {
-      method: "POST",
-      headers: {
-        Authorization: twilioAuthHeader(accountSid, authToken),
-        "Content-Type": "application/x-www-form-urlencoded",
-      },
-      body: body.toString(),
-    },
-  );
-
-  if (!res.ok) {
-    const text = await res.text();
-    throw new ProviderError(
-      `Twilio Toll-Free Verification update error ${res.status}: ${text}`,
-      "twilio",
-      res.status,
-    );
-  }
-
-  const data = (await res.json()) as Record<string, unknown>;
-  return parseTollFreeVerification(data);
-}
-
-/** Delete a toll-free verification. */
-export async function deleteTollFreeVerification(
-  accountSid: string,
-  authToken: string,
-  verificationSid: string,
-): Promise<void> {
-  const res = await fetch(
-    `${TOLLFREE_VERIFICATION_BASE}/${encodeURIComponent(verificationSid)}`,
-    {
-      method: "DELETE",
-      headers: { Authorization: twilioAuthHeader(accountSid, authToken) },
-    },
-  );
-
-  if (!res.ok) {
-    const text = await res.text();
-    throw new ProviderError(
-      `Twilio Toll-Free Verification delete error ${res.status}: ${text}`,
-      "twilio",
-      res.status,
-    );
-  }
-}
-
 /**
  * Get the SID for an incoming phone number.
  * Looks up the number via `IncomingPhoneNumbers.json?PhoneNumber=...`.

package/src/cli/AGENTS.md

@@ -6,14 +6,11 @@ Commands in `assistant/src/cli/` are scoped to a **single running assistant inst
 
 This contrasts with `cli/`, which manages the **lifecycle of assistant instances** (create, start, stop, delete) and operates across instances. See `cli/AGENTS.md`.
 
-## When a command belongs here vs `cli/`
-
-| `assistant/src/cli/` (this directory)               | `cli/`                                          |
-| --------------------------------------------------- | ----------------------------------------------- |
-| Operates within a single assistant's workspace      | Operates on or across assistant instances       |
-| Manages instance-local state (config, memory, etc.) | Manages lifecycle (create, start, stop, delete) |
-| Implicitly scoped to the running assistant          | Requires specifying which assistant to target   |
-| May require or start the daemon                     | Works without an assistant process running      |
+## Scope
+
+Commands here operate on a **single running assistant's** local state — config, memory, contacts, trust rules, conversations, autonomy, etc. They are implicitly scoped to the running assistant and may require or start the daemon.
+
+For commands that manage the **lifecycle of assistant instances** (create, start, stop, delete), see `cli/AGENTS.md`.
 
 Examples: `config`, `contacts`, `memory`, `autonomy`, `conversations`, `doctor` belong here. `hatch`, `wake`, `sleep`, `retire`, `ps`, `ssh` belong in `cli/`.
 

package/src/cli/__tests__/notifications.test.ts

@@ -337,7 +337,7 @@ describe("notifications list", () => {
       id: `evt-${Date.now()}-1`,
       sourceEventName: "user.send_notification",
       sourceChannel: "assistant_tool",
-      sourceSessionId: "session-1",
+      sourceContextId: "session-1",
       attentionHints: {
         requiresAction: true,
         urgency: "medium",
@@ -362,7 +362,7 @@ describe("notifications list", () => {
         id: `evt-limit-${Date.now()}-${i}`,
         sourceEventName: "user.send_notification",
         sourceChannel: "assistant_tool",
-        sourceSessionId: `session-limit-${i}`,
+        sourceContextId: `session-limit-${i}`,
         attentionHints: {
           requiresAction: true,
           urgency: "medium",
@@ -386,7 +386,7 @@ describe("notifications list", () => {
       id: `evt-filter-notif-${Date.now()}`,
       sourceEventName: "user.send_notification",
       sourceChannel: "assistant_tool",
-      sourceSessionId: "session-filter-1",
+      sourceContextId: "session-filter-1",
       attentionHints: {
         requiresAction: true,
         urgency: "medium",
@@ -400,7 +400,7 @@ describe("notifications list", () => {
       id: `evt-filter-reminder-${Date.now()}`,
       sourceEventName: "schedule.notify",
       sourceChannel: "scheduler",
-      sourceSessionId: "session-filter-2",
+      sourceContextId: "session-filter-2",
       attentionHints: {
         requiresAction: true,
         urgency: "high",
@@ -430,7 +430,7 @@ describe("notifications list", () => {
       id: `evt-custom-${Date.now()}`,
       sourceEventName: "custom.my_event",
       sourceChannel: "assistant_tool",
-      sourceSessionId: "session-custom",
+      sourceContextId: "session-custom",
       attentionHints: {
         requiresAction: true,
         urgency: "medium",

package/src/cli/commands/avatar.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
 
 import type { Command } from "commander";
@@ -9,6 +9,10 @@ import {
   type CharacterTraits,
   writeTraitsAndRenderAvatar,
 } from "../../avatar/traits-png-sync.js";
+import { setPlatformBaseUrl } from "../../config/env.js";
+import { credentialKey } from "../../security/credential-key.js";
+import { getSecureKeyAsync } from "../../security/secure-keys.js";
+import { generateAndSaveAvatar } from "../../tools/system/avatar-generator.js";
 import { getWorkspaceDir } from "../../util/platform.js";
 import { log } from "../logger.js";
 import { writeOutput } from "../output.js";
@@ -39,9 +43,67 @@ Files are stored in ~/.vellum/workspace/data/avatar/:
 Examples:
   $ assistant avatar character update --body-shape blob --eye-style curious --color green
   $ assistant avatar character components
-  $ assistant avatar character ascii`,
+  $ assistant avatar character ascii
+  $ assistant avatar generate --description "a cute blue cat"`,
   );
 
+  avatar
+    .command("generate")
+    .description("Generate an AI avatar from a text description")
+    .requiredOption(
+      "--description <text>",
+      "Description of the avatar to generate",
+    )
+    .addHelpText(
+      "after",
+      `
+Generates an avatar image using AI based on the provided text description
+and saves it as the assistant's avatar PNG. This replaces any existing
+native character avatar — the character traits and ASCII files are removed.
+
+On success, writes avatar-image.png to ~/.vellum/workspace/data/avatar/
+and removes character-traits.json and character-ascii.txt if they exist.
+
+Examples:
+  $ assistant avatar generate --description "a cute blue cat"
+  $ assistant avatar generate --description "a friendly robot with green eyes"`,
+    )
+    .action(async (opts: { description: string }) => {
+      // Rehydrate the platform base URL from the credential store so the
+      // managed proxy fallback works. The CLI runs as a separate process
+      // without the daemon's in-memory state.
+      try {
+        const key = credentialKey("vellum", "platform_base_url");
+        const persisted = await getSecureKeyAsync(key);
+        if (persisted) {
+          setPlatformBaseUrl(persisted);
+        }
+      } catch {
+        // Non-fatal — direct Gemini key may still work
+      }
+
+      const result = await generateAndSaveAvatar(opts.description);
+
+      if (result.isError) {
+        log.error(result.content);
+        process.exitCode = 1;
+        return;
+      }
+
+      // Remove native character files since AI-generated image takes precedence
+      const avatarDir = join(getWorkspaceDir(), "data", "avatar");
+      const traitsPath = join(avatarDir, "character-traits.json");
+      const asciiPath = join(avatarDir, "character-ascii.txt");
+      try {
+        if (existsSync(traitsPath)) unlinkSync(traitsPath);
+        if (existsSync(asciiPath)) unlinkSync(asciiPath);
+      } catch {
+        // Best-effort cleanup
+      }
+
+      log.info(result.content);
+    });
+
   const character = avatar
     .command("character")
     .description("Manage the native character avatar");

package/src/cli/commands/conversations.ts

@@ -1,8 +1,13 @@
 import type { Command } from "commander";
 
-import { getQdrantUrlEnv } from "../../config/env.js";
+import {
+  getQdrantUrlEnv,
+  getRuntimeHttpHost,
+  getRuntimeHttpPort,
+} from "../../config/env.js";
 import { getConfig } from "../../config/loader.js";
 import { shouldAutoStartDaemon } from "../../daemon/connection-policy.js";
+import { healthCheckHost, isHttpHealthy } from "../../daemon/daemon-control.js";
 import { ensureDaemonRunning } from "../../daemon/lifecycle.js";
 import { formatJson, formatMarkdown } from "../../export/formatter.js";
 import {
@@ -10,13 +15,20 @@ import {
   createConversation,
   getConversation,
   getMessages,
+  wipeConversation,
 } from "../../memory/conversation-crud.js";
 import { listConversations } from "../../memory/conversation-queries.js";
 import {
   selectEmbeddingBackend,
   SPARSE_EMBEDDING_VERSION,
 } from "../../memory/embedding-backend.js";
+import { enqueueMemoryJob } from "../../memory/jobs-store.js";
 import { initQdrantClient } from "../../memory/qdrant-client.js";
+import {
+  initAuthSigningKey,
+  loadOrCreateSigningKey,
+  mintDaemonDeliveryToken,
+} from "../../runtime/auth/token-service.js";
 import { timeAgo } from "../../util/time.js";
 import { initializeDb } from "../db.js";
 import { log } from "../logger.js";
@@ -253,4 +265,122 @@ Examples:
 
       log.info("Done.");
     });
+
+  conversations
+    .command("wipe <conversationId>")
+    .description("Wipe a conversation and revert all memory changes it made")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .addHelpText(
+      "after",
+      `
+Arguments:
+  conversationId   Conversation ID (or unique prefix). Supports prefix matching.
+
+Permanently wipes the conversation and reverts all memory changes it caused:
+restores superseded memory items, deletes conversation summaries, and cancels
+pending memory jobs. This action cannot be undone.
+
+Examples:
+  $ assistant conversations wipe abc123
+  $ assistant conversations wipe abc123 --yes`,
+    )
+    .action(async (conversationId: string, opts?: { yes?: boolean }) => {
+      initializeDb();
+
+      // Resolve conversation with prefix matching (same pattern as `export`)
+      let conversation = getConversation(conversationId);
+      if (!conversation) {
+        const all = listConversations(Number.MAX_SAFE_INTEGER);
+        const match = all.find((c) => c.id.startsWith(conversationId));
+        if (match) {
+          conversation = match;
+        } else {
+          log.error(`Conversation not found: ${conversationId}`);
+          process.exit(1);
+        }
+      }
+
+      if (!opts?.yes) {
+        const readline = await import("node:readline");
+        const rl = readline.createInterface({
+          input: process.stdin,
+          output: process.stdout,
+        });
+        const answer = await new Promise<string>((resolve) => {
+          rl.question(
+            `Wipe conversation "${conversation!.title ?? "Untitled"}" and revert all memory changes? (y/N) `,
+            resolve,
+          );
+        });
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          log.info("Cancelled");
+          return;
+        }
+      }
+
+      // When the assistant is running, delegate to its HTTP wipe endpoint
+      // so it tears down in-memory conversation state before deleting DB
+      // rows — preventing FK constraint failures from follow-up writes.
+      if (await isHttpHealthy()) {
+        const port = getRuntimeHttpPort();
+        const host = healthCheckHost(getRuntimeHttpHost());
+        initAuthSigningKey(loadOrCreateSigningKey());
+        const token = mintDaemonDeliveryToken();
+        const res = await fetch(
+          `http://${host}:${port}/v1/conversations/${conversation.id}/wipe`,
+          {
+            method: "POST",
+            headers: { Authorization: `Bearer ${token}` },
+          },
+        );
+        if (!res.ok) {
+          const body = await res.text();
+          log.error(`Assistant wipe failed (${res.status}): ${body}`);
+          process.exit(1);
+        }
+        const json = (await res.json()) as {
+          unsupersededItems: number;
+          deletedSummaries: number;
+          cancelledJobs: number;
+        };
+        log.info(
+          `Wiped conversation "${conversation.title ?? "Untitled"}". ` +
+            `Restored ${json.unsupersededItems} memory items, ` +
+            `deleted ${json.deletedSummaries} summaries, ` +
+            `cancelled ${json.cancelledJobs} jobs.`,
+        );
+        return;
+      }
+
+      // Daemon not running — safe to wipe directly (no in-memory state).
+      const result = wipeConversation(conversation.id);
+
+      // Enqueue Qdrant cleanup
+      for (const segId of result.segmentIds) {
+        enqueueMemoryJob("delete_qdrant_vectors", {
+          targetType: "segment",
+          targetId: segId,
+        });
+      }
+      for (const itemId of result.orphanedItemIds) {
+        enqueueMemoryJob("delete_qdrant_vectors", {
+          targetType: "item",
+          targetId: itemId,
+        });
+      }
+      for (const summaryId of result.deletedSummaryIds) {
+        enqueueMemoryJob("delete_qdrant_vectors", {
+          targetType: "summary",
+          targetId: summaryId,
+        });
+      }
+
+      log.info(
+        `Wiped conversation "${conversation.title ?? "Untitled"}". ` +
+          `Restored ${result.unsupersededItemIds.length} memory items, ` +
+          `deleted ${result.deletedSummaryIds.length} summaries, ` +
+          `cancelled ${result.cancelledJobCount} jobs.`,
+      );
+    });
 }

package/src/cli/commands/credentials.ts

@@ -4,6 +4,7 @@ import {
   fetchManagedCatalog,
   type ManagedCredentialDescriptor,
 } from "../../credential-execution/managed-catalog.js";
+import { syncManualTokenConnection } from "../../oauth/manual-token-connection.js";
 import {
   disconnectOAuthProvider,
   getConnectionByProvider,
@@ -439,6 +440,7 @@ Examples:
             usageDescription: opts.description,
             allowedTools,
           });
+          await syncManualTokenConnection(service);
 
           writeOutput(cmd, {
             ok: true,

package/src/cli/commands/notifications.ts

@@ -252,12 +252,12 @@ Examples:
 
           initializeDb();
 
-          const sourceSessionId = opts.conversationId ?? `cli-${Date.now()}`;
+          const sourceContextId = opts.conversationId ?? `cli-${Date.now()}`;
 
           const result = await emitNotificationSignal({
             sourceEventName: opts.sourceEventName,
             sourceChannel: opts.sourceChannel,
-            sourceSessionId,
+            sourceContextId,
             attentionHints: {
               requiresAction: opts.requiresAction ?? true,
               urgency,
@@ -374,7 +374,7 @@ Examples:
             id: row.id,
             sourceEventName: row.sourceEventName,
             sourceChannel: row.sourceChannel,
-            sourceSessionId: row.sourceSessionId,
+            sourceContextId: row.sourceContextId,
             urgency: (JSON.parse(row.attentionHintsJson) as { urgency: string })
               .urgency,
             dedupeKey: row.dedupeKey,

package/src/cli.ts

@@ -160,6 +160,7 @@ export async function startCli(): Promise<void> {
   let pendingConfirmation = false;
   let pendingCopySession = false;
   let toolStreaming = false;
+  let lastDisplayedError: string | null = null;
   let eventSubscription: EventStreamWatcher | null = null;
   const spinner = new Spinner();
 
@@ -842,6 +843,14 @@ export async function startCli(): Promise<void> {
         renderConfirmationPrompt(msg);
         break;
 
+      case "conversation_error":
+        spinner.stop();
+        if (lastDisplayedError !== msg.userMessage) {
+          process.stdout.write(`\n[Error: ${msg.userMessage}]\n`);
+        }
+        lastDisplayedError = null;
+        break;
+
       case "error":
         spinner.stop();
         generating = false;
@@ -852,6 +861,7 @@ export async function startCli(): Promise<void> {
           rl.removeAllListeners("line");
           rl.on("line", handleLine);
         }
+        lastDisplayedError = msg.message;
         process.stdout.write(`\n[Error: ${msg.message}]\n`);
         prompt();
         break;

package/src/config/bundled-skills/acp/SKILL.md

@@ -8,7 +8,7 @@ metadata:
     display-name: "ACP"
 ---
 
-ACP agent orchestration — spawn external coding agents (Claude Code, Codex, Gemini CLI, etc.) to work on tasks via the Agent Client Protocol.
+ACP agent orchestration - spawn external coding agents (Claude Code, Codex, Gemini CLI, etc.) to work on tasks via the Agent Client Protocol.
 
 ## Usage
 
@@ -40,13 +40,13 @@ When the user first tries to use ACP and it's not configured, set it up automati
    }
    ```
 
-3. **Wait a few seconds** for the config watcher to pick up the change (it hot-reloads automatically — no restart needed).
+3. **Wait a few seconds** for the config watcher to pick up the change (it hot-reloads automatically - no restart needed).
 
-4. Then retry the `acp_spawn` call. Do NOT run `vellum sleep && vellum wake` — that kills the conversation.
+4. Then retry the `acp_spawn` call. Do NOT run `vellum sleep && vellum wake` - that kills the conversation.
 
 ## Critical: correct agent command
 
-- The command MUST be `claude-agent-acp` — this is the ACP adapter from `@zed-industries/claude-agent-acp`.
+- The command MUST be `claude-agent-acp` - this is the ACP adapter from `@zed-industries/claude-agent-acp`.
 - NEVER use `claude`, `claude -p`, `claude --acp`, or any other command. Only `claude-agent-acp` speaks the ACP JSON-RPC protocol.
 - NEVER change an existing ACP config to use a different command. If the config already has `claude-agent-acp`, leave it alone.
 
@@ -55,4 +55,4 @@ When the user first tries to use ACP and it's not configured, set it up automati
 - The spawned agent runs autonomously with its own tools, file editing, and terminal access.
 - Results are streamed back and injected into the conversation when the agent completes.
 - Use `acp_status` to check on running agents and `acp_abort` to stop them.
-- The `cwd` parameter controls where the agent works — set it to the project root the user wants the agent to operate in.
+- The `cwd` parameter controls where the agent works - set it to the project root the user wants the agent to operate in.