@vellumai/assistant 0.6.0 → 0.6.1

package/src/cli/commands/skills.ts

@@ -3,6 +3,9 @@ import { join } from "node:path";
 
 import type { Command } from "commander";
 
+import { getConfig } from "../../config/loader.js";
+import { resolveSkillStates } from "../../config/skill-state.js";
+import { loadSkillCatalog } from "../../config/skills.js";
 import type { CatalogSkill } from "../../skills/catalog-install.js";
 import {
   fetchCatalog,
@@ -56,13 +59,13 @@ Examples:
 
   skills
     .command("list")
-    .description("List available catalog skills")
+    .description("List all skills (bundled, installed, and catalog)")
     .option("--json", "Machine-readable JSON output")
     .addHelpText(
       "after",
       `
-Lists all skills available in the Vellum catalog with their ID, name,
-description, and dependency information.
+Lists all skills: bundled (compiled-in), installed (user-added), and
+available catalog skills with their ID, name, and description.
 
 Examples:
   $ assistant skills list
@@ -70,34 +73,103 @@ Examples:
     )
     .action(async (opts: { json?: boolean }) => {
       try {
-        // In dev mode, use the local catalog as the source of truth
-        // and skip the remote Platform API entirely.
+        // ── Bundled + installed skills (from loadSkillCatalog) ────────
+        const localCatalog = loadSkillCatalog();
+        const config = getConfig();
+        const resolved = resolveSkillStates(localCatalog, config);
+        const bundled = resolved.filter(
+          (r) => r.summary.source === "bundled",
+        );
+        const installed = resolved.filter(
+          (r) =>
+            r.summary.source === "managed" ||
+            r.summary.source === "workspace" ||
+            r.summary.source === "extra",
+        );
+
+        // ── Remote catalog skills ────────────────────────────────────
         const repoSkillsDir = getRepoSkillsDir();
-        let catalog: CatalogSkill[];
+        let remoteCatalog: CatalogSkill[];
         if (repoSkillsDir) {
-          catalog = readLocalCatalog(repoSkillsDir);
+          remoteCatalog = readLocalCatalog(repoSkillsDir);
         } else {
-          catalog = await fetchCatalog();
+          remoteCatalog = await fetchCatalog();
         }
+        // Exclude catalog skills that are already installed/bundled
+        const localIds = new Set(localCatalog.map((s) => s.id));
+        const availableCatalog = remoteCatalog.filter(
+          (s) => !localIds.has(s.id),
+        );
+
+        const totalCount =
+          bundled.length + installed.length + availableCatalog.length;
 
         if (opts.json) {
-          console.log(JSON.stringify({ ok: true, skills: catalog }));
+          const bundledJson = bundled.map((r) => ({
+            id: r.summary.id,
+            name: r.summary.displayName,
+            description: r.summary.description,
+            emoji: r.summary.emoji,
+            state: r.state,
+          }));
+          const installedJson = installed.map((r) => ({
+            id: r.summary.id,
+            name: r.summary.displayName,
+            description: r.summary.description,
+            emoji: r.summary.emoji,
+            state: r.state,
+          }));
+          console.log(
+            JSON.stringify({
+              ok: true,
+              skills: [...bundledJson, ...installedJson, ...availableCatalog],
+              bundled: bundledJson,
+              installed: installedJson,
+              catalog: availableCatalog,
+            }),
+          );
           return;
         }
 
-        if (catalog.length === 0) {
-          log.info("No skills available in the catalog.");
+        if (totalCount === 0) {
+          log.info("No skills available.");
           return;
         }
 
-        log.info(`Available skills (${catalog.length}):\n`);
-        for (const s of catalog) {
-          const emoji = s.emoji ? `${s.emoji} ` : "";
-          const deps = s.includes?.length
-            ? ` (requires: ${s.includes.join(", ")})`
-            : "";
-          log.info(`  ${emoji}${s.id}`);
-          log.info(`    ${s.name} — ${s.description}${deps}`);
+        if (bundled.length > 0) {
+          log.info(`Bundled skills (${bundled.length}):\n`);
+          for (const r of bundled) {
+            const s = r.summary;
+            const emoji = s.emoji ? `${s.emoji} ` : "";
+            const state = r.state === "disabled" ? " [disabled]" : "";
+            log.info(`  ${emoji}${s.id}${state}`);
+            log.info(`    ${s.displayName} — ${s.description}`);
+          }
+          log.info("");
+        }
+
+        if (installed.length > 0) {
+          log.info(`Installed skills (${installed.length}):\n`);
+          for (const r of installed) {
+            const s = r.summary;
+            const emoji = s.emoji ? `${s.emoji} ` : "";
+            const state = r.state === "disabled" ? " [disabled]" : "";
+            log.info(`  ${emoji}${s.id}${state}`);
+            log.info(`    ${s.displayName} — ${s.description}`);
+          }
+          log.info("");
+        }
+
+        if (availableCatalog.length > 0) {
+          log.info(`Available catalog skills (${availableCatalog.length}):\n`);
+          for (const s of availableCatalog) {
+            const emoji = s.emoji ? `${s.emoji} ` : "";
+            const deps = s.includes?.length
+              ? ` (requires: ${s.includes.join(", ")})`
+              : "";
+            log.info(`  ${emoji}${s.id}`);
+            log.info(`    ${s.name} — ${s.description}${deps}`);
+          }
         }
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
@@ -139,6 +211,14 @@ Examples:
       const limit = parseInt(opts.limit, 10) || 10;
 
       try {
+        // ── Bundled + installed skill search ─────────────────────────
+        const localCatalog = loadSkillCatalog();
+        const bundledMatches = filterByQuery(localCatalog, query, [
+          (s) => s.id,
+          (s) => s.displayName,
+          (s) => s.description,
+        ]);
+
         // ── Vellum catalog search ────────────────────────────────────
         const repoSkillsDir = getRepoSkillsDir();
         let catalog: CatalogSkill[];
@@ -151,8 +231,11 @@ Examples:
             catalog = [];
           }
         }
+        // Exclude catalog entries that match a bundled/installed skill
+        const localIds = new Set(localCatalog.map((s) => s.id));
+        const filteredCatalog = catalog.filter((s) => !localIds.has(s.id));
 
-        const catalogMatches = filterByQuery(catalog, query, [
+        const catalogMatches = filterByQuery(filteredCatalog, query, [
           (s) => s.id,
           (s) => s.name,
           (s) => s.description,
@@ -202,6 +285,7 @@ Examples:
         ]);
 
         if (
+          bundledMatches.length === 0 &&
           catalogMatches.length === 0 &&
           registryResults.length === 0 &&
           clawhubResults.length === 0
@@ -210,6 +294,7 @@ Examples:
             console.log(
               JSON.stringify({
                 ok: true,
+                bundled: [],
                 catalog: [],
                 community: [],
                 clawhub: [],
@@ -255,6 +340,13 @@ Examples:
           console.log(
             JSON.stringify({
               ok: true,
+              bundled: bundledMatches.map((s) => ({
+                id: s.id,
+                name: s.displayName,
+                description: s.description,
+                emoji: s.emoji,
+                source: s.source,
+              })),
               catalog: catalogMatches,
               community: registryResults,
               clawhub: clawhubResults,
@@ -271,6 +363,24 @@ Examples:
         const isInstalled = (id: string) =>
           existsSync(join(skillsDir, id, "SKILL.md"));
 
+        // ── Display bundled/installed results ─────────────────────────
+        if (bundledMatches.length > 0) {
+          log.info(
+            `Bundled & installed skills (${bundledMatches.length}):\n`,
+          );
+          for (const s of bundledMatches) {
+            const emoji = s.emoji ? `${s.emoji} ` : "";
+            const tag = s.source === "bundled" ? " [bundled]" : " [installed]";
+            log.info(`  ${emoji}${s.displayName}${tag}`);
+            if (s.displayName !== s.id) {
+              log.info(`    ID: ${s.id}`);
+            }
+            log.info(`    ${s.description}`);
+            log.info(`    Load: skill_load skill=${s.id}`);
+            log.info("");
+          }
+        }
+
         // ── Display catalog results ──────────────────────────────────
         if (catalogMatches.length > 0) {
           log.info(`Vellum catalog (${catalogMatches.length}):\n`);

package/src/cli/program.ts

@@ -26,6 +26,7 @@ import { registerMemoryCommand } from "./commands/memory.js";
 import { registerNotificationsCommand } from "./commands/notifications.js";
 import { registerOAuthCommand } from "./commands/oauth/index.js";
 import { registerPlatformCommand } from "./commands/platform/index.js";
+import { registerRoutesCommand } from "./commands/routes.js";
 import { registerSequenceCommand } from "./commands/sequence.js";
 import { registerShotgunCommand } from "./commands/shotgun.js";
 import { registerSkillsCommand } from "./commands/skills.js";
@@ -75,6 +76,7 @@ Examples:
   registerNotificationsCommand(program);
   registerPlatformCommand(program);
   registerOAuthCommand(program);
+  registerRoutesCommand(program);
   registerSkillsCommand(program);
   registerBrowserRelayCommand(program);
   registerUsageCommand(program);

package/src/cli.ts

@@ -33,11 +33,6 @@ import {
   type EventStreamWatcher,
   watchEventStream,
 } from "./signals/event-stream.js";
-import {
-  copyToClipboard,
-  extractLastCodeBlock,
-  formatConversationForExport,
-} from "./util/clipboard.js";
 import { formatDiff, formatNewFileDiff } from "./util/diff.js";
 import { getHistoryPath, getSignalsDir } from "./util/platform.js";
 import { Spinner } from "./util/spinner.js";
@@ -143,7 +138,6 @@ export async function startCli(): Promise<void> {
   let conversationId = "";
   let pendingUserContent: string | null = null;
   let generating = false;
-  let lastResponse = "";
   let lastUsage: {
     inputTokens: number;
     outputTokens: number;
@@ -153,7 +147,6 @@ export async function startCli(): Promise<void> {
     model: string;
   } | null = null;
   let pendingSessionPick = false;
-  let pendingCopySession = false;
   let toolStreaming = false;
   let lastDisplayedError: string | null = null;
   let eventSubscription: EventStreamWatcher | null = null;
@@ -398,7 +391,6 @@ export async function startCli(): Promise<void> {
         if (pendingUserContent) {
           const content = pendingUserContent;
           pendingUserContent = null;
-          lastResponse = "";
           sendUserMessage(content).then((result) => {
             if (result.ok) {
               generating = true;
@@ -408,7 +400,6 @@ export async function startCli(): Promise<void> {
                 process.stdout.write(`${result.message}\n`);
                 rl.question("Send anyway? (y/N): ", (answer) => {
                   if (answer.trim().toLowerCase() === "y") {
-                    lastResponse = "";
                     sendUserMessage(content, {
                       bypassSecretCheck: true,
                     }).then((retryResult) => {
@@ -439,7 +430,6 @@ export async function startCli(): Promise<void> {
 
       case "assistant_text_delta":
         spinner.stop();
-        lastResponse += msg.text;
         process.stdout.write(msg.text);
         break;
 
@@ -595,9 +585,8 @@ export async function startCli(): Promise<void> {
       case "error":
         spinner.stop();
         generating = false;
-        if (pendingSessionPick || pendingCopySession) {
+        if (pendingSessionPick) {
           pendingSessionPick = false;
-          pendingCopySession = false;
           rl.removeAllListeners("line");
           rl.on("line", handleLine);
         }
@@ -646,26 +635,6 @@ export async function startCli(): Promise<void> {
         break;
 
       case "history_response":
-        if (pendingCopySession) {
-          pendingCopySession = false;
-          if (msg.messages.length === 0) {
-            process.stdout.write("\n  No messages to copy.\n\n");
-          } else {
-            try {
-              const formatted = formatConversationForExport(msg.messages);
-              copyToClipboard(formatted);
-              process.stdout.write(
-                `\n  Copied conversation (${msg.messages.length} messages) to clipboard.\n\n`,
-              );
-            } catch (err) {
-              process.stdout.write(
-                `\n  Clipboard error: ${(err as Error).message}\n\n`,
-              );
-            }
-          }
-          prompt();
-          break;
-        }
         process.stdout.write("\n");
         if (msg.messages.length === 0) {
           process.stdout.write("  No messages in this conversation.\n");
@@ -686,7 +655,6 @@ export async function startCli(): Promise<void> {
         if (msg.removedCount === 0) {
           process.stdout.write("\n  Nothing to undo.\n\n");
         } else {
-          lastResponse = "";
           process.stdout.write(
             `\n  Removed last exchange (${msg.removedCount} messages).\n\n`,
           );
@@ -754,21 +722,6 @@ export async function startCli(): Promise<void> {
       /* ignore */
     }
 
-    if (content === "/copy") {
-      if (!lastResponse) {
-        process.stdout.write("No response to copy.\n");
-      } else {
-        try {
-          copyToClipboard(lastResponse);
-          process.stdout.write("Copied to clipboard.\n");
-        } catch (err) {
-          process.stdout.write(`Clipboard error: ${(err as Error).message}\n`);
-        }
-      }
-      prompt();
-      return;
-    }
-
     if (content === "/conversations") {
       pendingSessionPick = true;
       try {
@@ -787,65 +740,6 @@ export async function startCli(): Promise<void> {
       return;
     }
 
-    if (content === "/copy-code") {
-      const code = extractLastCodeBlock(lastResponse);
-      if (code == null) {
-        process.stdout.write("No code block found.\n");
-      } else {
-        try {
-          copyToClipboard(code);
-          process.stdout.write("Copied code block to clipboard.\n");
-        } catch (err) {
-          process.stdout.write(`Clipboard error: ${(err as Error).message}\n`);
-        }
-      }
-      prompt();
-      return;
-    }
-
-    if (content === "/copy-conversation") {
-      try {
-        const mapping = getConversationByKey(conversationKey);
-        if (!mapping) {
-          process.stdout.write("\n  No messages to copy.\n\n");
-          prompt();
-          return;
-        }
-        const rawMessages = getMessages(mapping.conversationId);
-        if (rawMessages.length === 0) {
-          process.stdout.write("\n  No messages to copy.\n\n");
-        } else {
-          const rendered = rawMessages.map((msg) => {
-            let parsedContent: unknown;
-            try {
-              parsedContent = JSON.parse(msg.content);
-            } catch {
-              parsedContent = msg.content;
-            }
-            return {
-              role: msg.role as "user" | "assistant",
-              text: renderHistoryContent(parsedContent).text,
-            };
-          });
-          try {
-            const formatted = formatConversationForExport(rendered);
-            copyToClipboard(formatted);
-            process.stdout.write(
-              `\n  Copied conversation (${rawMessages.length} messages) to clipboard.\n\n`,
-            );
-          } catch (err) {
-            process.stdout.write(
-              `\n  Clipboard error: ${(err as Error).message}\n\n`,
-            );
-          }
-        }
-      } catch {
-        process.stdout.write("[Failed to fetch history]\n");
-      }
-      prompt();
-      return;
-    }
-
     if (content === "/new") {
       // Create a new conversation by using a unique key
       conversationKey = `builtin-cli:${randomUUID()}`;
@@ -859,7 +753,6 @@ export async function startCli(): Promise<void> {
     }
 
     if (content === "/clear") {
-      lastResponse = "";
       process.stdout.write("\x1b[r");
       process.stdout.write("\x1b[2J\x1b[H");
       mainScreenLayout = renderMainScreen();
@@ -955,7 +848,6 @@ export async function startCli(): Promise<void> {
               if (result.removedCount === 0) {
                 process.stdout.write("\n  Nothing to undo.\n\n");
               } else {
-                lastResponse = "";
                 process.stdout.write(
                   `\n  Removed last exchange (${result.removedCount} messages).\n\n`,
                 );
@@ -1016,15 +908,6 @@ export async function startCli(): Promise<void> {
         "  /undo               Remove last message exchange\n",
       );
       process.stdout.write("  /usage              Show token usage and cost\n");
-      process.stdout.write(
-        "  /copy               Copy last response to clipboard\n",
-      );
-      process.stdout.write(
-        "  /copy-code          Copy last code block to clipboard\n",
-      );
-      process.stdout.write(
-        "  /copy-conversation  Copy entire conversation to clipboard\n",
-      );
       process.stdout.write("  /help               Show this help\n");
       process.stdout.write("\n");
       prompt();
@@ -1032,14 +915,12 @@ export async function startCli(): Promise<void> {
     }
 
     // Regular user message
-    lastResponse = "";
     sendUserMessage(content).then((result) => {
       if (!result.ok) {
         if (result.error === "secret_blocked" && result.message) {
           process.stdout.write(`${result.message}\n`);
           rl.question("Send anyway? (y/N): ", (answer) => {
             if (answer.trim().toLowerCase() === "y") {
-              lastResponse = "";
               sendUserMessage(content, { bypassSecretCheck: true }).then(
                 (retryResult) => {
                   if (retryResult.ok) {

package/src/config/bundled-skills/app-builder/SKILL.md

@@ -238,7 +238,7 @@ export const Header: FunctionComponent<HeaderProps> = ({ title, count }) => (
 
 file_write("{workspaceDir}/data/apps/project-tracker/src/styles.css", `.app { padding: var(--v-spacing-lg); }
 .header { display: flex; justify-content: space-between; align-items: center; }
-.badge { background: var(--v-accent); color: white; padding: var(--v-spacing-xs) var(--v-spacing-sm); border-radius: var(--v-radius-pill); }`)
+.badge { background: var(--v-accent); color: var(--v-aux-white); padding: var(--v-spacing-xs) var(--v-spacing-sm); border-radius: var(--v-radius-pill); }`)
 
 # After all files are written, compile and refresh:
 app_refresh(app_id)
@@ -290,9 +290,12 @@ Available design tokens:
 | **Typography**  | `--v-font-family`, `--v-font-mono`, `--v-font-size-xs` (10px) / `-sm` (11px) / `-base` (14px) / `-lg` (17px) / `-xl` (22px) / `-2xl` (26px), `--v-line-height` |
 | **Animation**   | `--v-duration-fast` (0.15s) / `-standard` (0.25s) / `-slow` (0.4s)                                                                                             |
 | **Palettes**    | `--v-slate-{950..50}`, `--v-emerald-*`, `--v-violet-*`, `--v-indigo-*`, `--v-rose-*`, `--v-amber-*`                                                            |
+| **Constant**    | `--v-aux-white` (always `#FFFFFF` in both modes — use for text on filled/accent backgrounds)                                                                    |
 
 Utility classes: `.v-button` (`.secondary`/`.danger`/`.ghost`), `.v-card`, `.v-list`/`.v-list-item`, `.v-badge` (`.success`/`.warning`/`.danger`), `.v-input-row`, `.v-empty-state`, `.v-toggle`.
 
+**Never hardcode `color: white` or `color: #fff`.** Use `var(--v-aux-white)` for text on filled/accent backgrounds, or `var(--v-text)` / `var(--v-text-secondary)` for text on surface backgrounds. Hardcoded white causes invisible text on light surfaces.
+
 **Custom themes:** When the user wants a specific branded look, write complete CSS with hardcoded colors and `@media (prefers-color-scheme: dark)` for dark variants. Don't mix `--v-*` auto-switching variables with hardcoded colors in the same element.
 
 **Theme detection in JavaScript:**

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

@@ -156,9 +156,9 @@ Scan tools (`gmail_sender_digest`, `gmail_outreach_scan`) return a `scan_id` tha
 
 Before composing any email that references a date or time:
 
-1. Check the `<temporal_context>` block in the current turn for today's date and timezone
+1. Check the `timestamp:` field in the `<turn_context>` block for today's date and timezone
 2. Verify that "tomorrow" means the day after today's date, "next week" means the upcoming Monday–Friday, etc.
-3. If the email references a date from another message, cross-check it against the temporal context to ensure it's in the future
+3. If the email references a date from another message, cross-check it against the turn context to ensure it's in the future
 
 ## Confidence Scores
 

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

@@ -148,6 +148,7 @@ Telegram is supported as a messaging provider with limited capabilities compared
 - `send_notification` is provided by the **notifications** skill (always active) -- use it when the user asks for an alert/notification (for example "send this as a desktop notification").
 - Use `messaging_send` when the user asks to send a message into a specific chat/email destination.
 - `send_notification` channel routing is LLM-driven; `preferred_channels` are hints, not hard channel forcing.
+- Before using `messaging_send` or `send_notification`, look up the recipient's contact record with `contact_search` to inform tone and content (see **Recipient Context** below).
 
 ## Personalized Drafting
 
@@ -157,6 +158,12 @@ If no style items exist and the user asks you to draft a message, suggest runnin
 
 > "I can analyze your sent messages to learn your writing style so drafts sound like you. Want me to do that?"
 
+## Recipient Context
+
+Before composing or sending a message to someone, look up their contact record with `contact_search` using their name or channel address. If the contact has notes (e.g. relationship context, communication preferences, response expectations), use that context to inform the message's tone, level of detail, and content. This ensures outbound messages are personalized to the recipient — not just the sender's style.
+
+If no contact record exists, proceed without recipient context.
+
 ## Confidence Scores
 
 Medium and high risk tools require a confidence score between 0 and 1:

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

@@ -87,6 +87,14 @@ The `mode` parameter controls what happens when a schedule fires:
 
 Use `notify` for simple reminders ("remind me to take medicine at 9am") and `execute` for tasks that need assistant action ("check my calendar at 8am and send me a digest").
 
+## Conversation Reuse
+
+By default, each schedule run creates a new conversation. For recurring schedules that benefit from accumulating context across runs (e.g. polling-style jobs, daily digests that reference prior results), set `reuse_conversation: true`. When enabled, subsequent runs reuse the conversation from the last successful run instead of creating a new one.
+
+- Only applies to **recurring** schedules; ignored for one-shot schedules.
+- If the prior conversation has been deleted, a new one is created automatically.
+- On the first run (no prior conversation), a new conversation is created as usual.
+
 ## Routing (notify mode)
 
 Control how notify-mode schedules are delivered at trigger time with `routing_intent`:
@@ -101,9 +109,20 @@ Optionally pass `routing_hints` (a JSON object) to influence routing decisions (
 
 - **Default to `all_channels`** for most notifications. Users usually want to be notified wherever they are.
 - **Use `single_channel`** only when the user explicitly specifies a single channel (e.g. "remind me on Telegram").
-- **Check `user_message_channel` (or `channel` when all channels are the same)** from the turn context. If the user is currently active on a specific channel, include it as a routing hint:
+- **Determine the originating channel** for routing hints using this priority:
+  1. **`source_channel`** from `<turn_context>` — use directly if present. This is the authoritative channel name.
+  2. **`interface` fallback** — if `source_channel` is absent (common for guardian/direct users), map the `interface` value to a channel name:
+     | `interface` value | Channel name |
+     | --- | --- |
+     | `macos`, `ios` | `vellum` |
+     | `telegram` | `telegram` |
+     | `slack` | `slack` |
+     | `cli` | _(omit — no routable channel)_ |
+  3. If neither field is present or the interface is `cli`, omit `preferred_channels`.
+
+  When a channel is determined, include it as a routing hint:
   ```
-  routing_hints: { preferred_channels: ["vellum"] }
+  routing_hints: { preferred_channels: ["<resolved channel>"] }
   routing_intent: "all_channels"
   ```
 
@@ -119,6 +138,7 @@ Use `syntax` + `expression` to specify the schedule type explicitly, or just `ex
 
 ## Tips
 
+- **When the user specifies a name for the schedule, use it exactly as given.** Do not paraphrase, embellish, or generate a descriptive name.
 - Use `schedule_create` for both recurring automation ("every day at 9am") and one-time reminders ("remind me at 3pm").
 - For task tracking ("add to my tasks", "add to my queue"), use task_list_add instead.
 - `fire_at` must be a strict ISO 8601 timestamp with timezone offset or Z (e.g. `2025-03-15T09:00:00-05:00`).

package/src/config/bundled-skills/schedule/TOOLS.json

@@ -56,6 +56,10 @@
             "type": "boolean",
             "description": "When true, suppress completion notifications for this schedule. The job still runs and produces output, but no notification or conversation message is sent on completion. Useful for high-frequency recurring jobs that report findings separately. Defaults to false."
           },
+          "reuse_conversation": {
+            "type": "boolean",
+            "description": "When true, reuse the same conversation across recurring schedule runs instead of creating a new one each time. Useful for polling-style schedules that accumulate context over time. Ignored for one-shot schedules. Defaults to false."
+          },
           "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
@@ -147,6 +151,10 @@
             "type": "boolean",
             "description": "When true, suppress completion notifications for this schedule. Useful for high-frequency jobs that report findings separately."
           },
+          "reuse_conversation": {
+            "type": "boolean",
+            "description": "When true, reuse the same conversation across recurring schedule runs instead of creating a new one each time. Useful for polling-style schedules that accumulate context over time. Ignored for one-shot schedules."
+          },
           "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"

package/src/config/bundled-skills/settings/tools/avatar-get.ts

@@ -7,27 +7,17 @@ import type {
   ToolContext,
   ToolExecutionResult,
 } from "../../../../tools/types.js";
-import { getWorkspaceDir } from "../../../../util/platform.js";
+import { getAvatarDir, getAvatarImagePath } from "../../../../util/platform.js";
 
 export async function run(
   _input: Record<string, unknown>,
   _context: ToolContext,
 ): Promise<ToolExecutionResult> {
-  const avatarPath = join(
-    getWorkspaceDir(),
-    "data",
-    "avatar",
-    "avatar-image.png",
-  );
+  const avatarPath = getAvatarImagePath();
 
   if (!existsSync(avatarPath)) {
     // Check for native character traits and regenerate the static PNG
-    const traitsPath = join(
-      getWorkspaceDir(),
-      "data",
-      "avatar",
-      "character-traits.json",
-    );
+    const traitsPath = join(getAvatarDir(), "character-traits.json");
     if (existsSync(traitsPath)) {
       try {
         const traits = JSON.parse(readFileSync(traitsPath, "utf-8"));

package/src/config/bundled-skills/settings/tools/avatar-remove.ts

@@ -1,5 +1,4 @@
 import { existsSync, unlinkSync } from "node:fs";
-import { join } from "node:path";
 
 import { buildAssistantEvent } from "../../../../runtime/assistant-event.js";
 import { assistantEventHub } from "../../../../runtime/assistant-event-hub.js";
@@ -9,7 +8,7 @@ import type {
   ToolExecutionResult,
 } from "../../../../tools/types.js";
 import { getLogger } from "../../../../util/logger.js";
-import { getWorkspaceDir } from "../../../../util/platform.js";
+import { getAvatarImagePath } from "../../../../util/platform.js";
 import { updateIdentityAvatarSection } from "./identity-avatar.js";
 
 const log = getLogger("avatar-remove");
@@ -18,8 +17,7 @@ export async function run(
   _input: Record<string, unknown>,
   _context: ToolContext,
 ): Promise<ToolExecutionResult> {
-  const avatarDir = join(getWorkspaceDir(), "data", "avatar");
-  const avatarPath = join(avatarDir, "avatar-image.png");
+  const avatarPath = getAvatarImagePath();
 
   if (!existsSync(avatarPath)) {
     return {