@vellumai/assistant 0.12.0 → 0.12.1-staging.1

package/src/daemon/host-bash-proxy.ts

@@ -1,9 +1,9 @@
 import { getConfig } from "../config/loader.js";
 import { assistantEventHub } from "../runtime/assistant-event-hub.js";
 import {
-  ambiguousSameUserError,
   enforceSameActorOrErrorResult,
-  pickSameUserAutoResolve,
+  pickMostRecentSameUserClient,
+  unavailableSameUserClientError,
 } from "../runtime/auth/same-actor.js";
 import * as pendingInteractions from "../runtime/pending-interactions.js";
 import { formatShellOutput } from "../tools/shared/shell-output.js";
@@ -93,21 +93,17 @@ export class HostBashProxy extends HostProxyBase<
       }
       resolvedTargetClientId = input.targetClientId;
     } else {
-      // Auto-resolve to the unique same-user client. Reject (rather than
-      // broadcast) when multiple same-user clients are connected so that
-      // a single targeted-style request cannot fan out across every one
-      // of the user's machines. Zero same-user matches falls through to
-      // the existing untargeted code path.
-      const resolved = pickSameUserAutoResolve({
+      resolvedTargetClientId = pickMostRecentSameUserClient({
         hub: assistantEventHub,
         capability: "host_bash",
         sourceActorPrincipalId,
       });
-      if (resolved.kind === "ambiguous") {
-        return ambiguousSameUserError("host_bash");
+      if (
+        resolvedTargetClientId === undefined &&
+        sourceActorPrincipalId !== undefined
+      ) {
+        return unavailableSameUserClientError("host_bash");
       }
-      resolvedTargetClientId =
-        resolved.kind === "match" ? resolved.clientId : undefined;
     }
 
     // Targeted requests must be bound to the same authenticated user as the

package/src/daemon/host-browser-proxy.ts

@@ -5,7 +5,10 @@ import {
   assistantEventHub,
   broadcastMessage,
 } from "../runtime/assistant-event-hub.js";
-import { enforceSameActorOrErrorResult } from "../runtime/auth/same-actor.js";
+import {
+  enforceSameActorOrErrorResult,
+  unavailableSameUserClientError,
+} from "../runtime/auth/same-actor.js";
 import * as pendingInteractions from "../runtime/pending-interactions.js";
 import type { ToolExecutionResult } from "../tools/types.js";
 import { AssistantError, ErrorCode } from "../util/errors.js";
@@ -284,6 +287,17 @@ export class HostBrowserProxy {
       targetClientId,
     );
 
+    if (
+      preferredClient === undefined &&
+      sourceActorPrincipalId !== undefined &&
+      targetClientId === undefined
+    ) {
+      if (isExtensionOnlyMethod(input.cdpMethod)) {
+        return Promise.resolve(extensionRequiredResult(input.cdpMethod));
+      }
+      return Promise.resolve(unavailableSameUserClientError("host_browser"));
+    }
+
     // Same-user enforcement: when the caller's actor is known, refuse to
     // dispatch to a client owned by a different actor. This covers the
     // cross-client exposure case where a web/iOS turn for actor A would

package/src/daemon/host-file-proxy.ts

@@ -6,10 +6,10 @@ import {
   broadcastMessage,
 } from "../runtime/assistant-event-hub.js";
 import {
-  ambiguousSameUserError,
   enforceSameActorOrErrorResult,
-  pickSameUserAutoResolve,
+  pickMostRecentSameUserClient,
   snapshotHostProxyActorPrincipalId,
+  unavailableSameUserClientError,
 } from "../runtime/auth/same-actor.js";
 import * as pendingInteractions from "../runtime/pending-interactions.js";
 import { readAudioBase64 } from "../tools/shared/filesystem/audio-read.js";
@@ -102,19 +102,17 @@ export class HostFileProxy {
         });
       }
     } else {
-      // Auto-resolve to the unique same-user client. Reject ambiguous
-      // (multi-machine) cases so a single targeted-style request cannot
-      // fan out across the user's machines.
-      const resolved = pickSameUserAutoResolve({
+      resolvedTargetClientId = pickMostRecentSameUserClient({
         hub: assistantEventHub,
         capability: "host_file",
         sourceActorPrincipalId,
       });
-      if (resolved.kind === "ambiguous") {
-        return Promise.resolve(ambiguousSameUserError("host_file"));
+      if (
+        resolvedTargetClientId === undefined &&
+        sourceActorPrincipalId !== undefined
+      ) {
+        return Promise.resolve(unavailableSameUserClientError("host_file"));
       }
-      resolvedTargetClientId =
-        resolved.kind === "match" ? resolved.clientId : undefined;
     }
 
     // Same-user check: targeted host_file requests must be bound to the same

package/src/daemon/host-transfer-proxy.ts

@@ -10,10 +10,10 @@ import {
   broadcastMessage,
 } from "../runtime/assistant-event-hub.js";
 import {
-  ambiguousSameUserError,
   enforceSameActorOrErrorResult,
-  pickSameUserAutoResolve,
+  pickMostRecentSameUserClient,
   snapshotHostProxyActorPrincipalId,
+  unavailableSameUserClientError,
 } from "../runtime/auth/same-actor.js";
 import * as pendingInteractions from "../runtime/pending-interactions.js";
 import type { ToolExecutionResult } from "../tools/types.js";
@@ -162,19 +162,17 @@ export class HostTransferProxy {
         });
       }
     } else {
-      // Auto-resolve to the unique same-user client; reject ambiguous
-      // (multi-machine) cases so a single targeted-style transfer cannot
-      // fan out across the user's machines.
-      const resolved = pickSameUserAutoResolve({
+      resolvedTargetClientId = pickMostRecentSameUserClient({
         hub: assistantEventHub,
         capability: "host_file",
         sourceActorPrincipalId,
       });
-      if (resolved.kind === "ambiguous") {
-        return Promise.resolve(ambiguousSameUserError("host_file"));
+      if (
+        resolvedTargetClientId === undefined &&
+        sourceActorPrincipalId !== undefined
+      ) {
+        return Promise.resolve(unavailableSameUserClientError("host_file"));
       }
-      resolvedTargetClientId =
-        resolved.kind === "match" ? resolved.clientId : undefined;
     }
 
     if (resolvedTargetClientId != null) {
@@ -364,19 +362,17 @@ export class HostTransferProxy {
         });
       }
     } else {
-      // Auto-resolve to the unique same-user client; reject ambiguous
-      // (multi-machine) cases so a single targeted-style transfer cannot
-      // fan out across the user's machines.
-      const resolved = pickSameUserAutoResolve({
+      resolvedTargetClientId = pickMostRecentSameUserClient({
         hub: assistantEventHub,
         capability: "host_file",
         sourceActorPrincipalId,
       });
-      if (resolved.kind === "ambiguous") {
-        return Promise.resolve(ambiguousSameUserError("host_file"));
+      if (
+        resolvedTargetClientId === undefined &&
+        sourceActorPrincipalId !== undefined
+      ) {
+        return Promise.resolve(unavailableSameUserClientError("host_file"));
       }
-      resolvedTargetClientId =
-        resolved.kind === "match" ? resolved.clientId : undefined;
     }
 
     if (resolvedTargetClientId != null) {

package/src/daemon/lifecycle.ts

@@ -71,7 +71,6 @@ import { ensureCompleteCustomProfiles } from "../workspace/custom-profile-ensure
 import { ensureDefaultProvider } from "../workspace/default-provider-ensure.js";
 import { WORKSPACE_MIGRATIONS } from "../workspace/migrations/registry.js";
 import { runWorkspaceMigrations } from "../workspace/migrations/runner.js";
-import { startAppSourceWatcher } from "./app-source-watcher.js";
 import { startConfigWatcher } from "./config-watcher.js";
 import { startConversationEvictor } from "./conversation-evictor.js";
 import { writePid } from "./daemon-control.js";
@@ -706,10 +705,6 @@ export async function runDaemon(): Promise<void> {
   // config, and broadcast the relevant resource-changed events to clients.
   startConfigWatcher();
 
-  // Watch app source directories so edits recompile + refresh surfaces across
-  // all conversations.
-  startAppSourceWatcher();
-
   // Start the CLI IPC server. Throws on EADDRINUSE to abort startup when another
   // daemon already holds the socket, so this process never runs background jobs
   // against the shared database as an unmanageable duplicate.

package/src/daemon/mcp-reload-service.ts

@@ -1,11 +1,11 @@
 /**
  * Shared MCP reload business logic.
  *
- * Called by the ConfigWatcher when config.json changes or a reload signal
+ * Called by the ConfigWatcher when mcp.json changes or a reload signal
  * file is detected, so the daemon automatically reconnects MCP servers.
  */
 
-import { getConfig, invalidateConfigCache } from "../config/loader.js";
+import { invalidateConfigCache } from "../config/loader.js";
 import {
   buildEffectiveMcpConfig,
   pluginMcpServersChangedSinceLastBuild,
@@ -13,6 +13,7 @@ import {
 import { getMcpServerManager } from "../mcp/manager.js";
 import { migrateLegacyMcpHeaders } from "../mcp/mcp-header-store.js";
 import { signalMcpReloaded } from "../mcp/reload-signal.js";
+import { loadWorkspaceMcpConfig } from "../mcp/workspace-mcp-config.js";
 import { createMcpToolsFromServer } from "../tools/mcp/mcp-tool-factory.js";
 import { registerMcpTools, unregisterAllMcpTools } from "../tools/registry.js";
 import { getLogger } from "../util/logger.js";
@@ -95,16 +96,15 @@ async function doReload(): Promise<McpReloadResult> {
     //    If the config is broken we abort early, preserving the current
     //    working MCP setup instead of leaving zero servers.
     invalidateConfigCache();
-    const config = getConfig();
 
     // 2. Stop existing MCP servers + unregister their tools
     await manager.stop();
     unregisterAllMcpTools();
 
     // Plugins are re-read here too: installing or removing one changes the
-    // server set exactly like editing config.json does, and both arrive
+    // server set exactly like editing mcp.json does, and both arrive
     // through this same reload.
-    const mcpConfig = buildEffectiveMcpConfig(config.mcp);
+    const mcpConfig = buildEffectiveMcpConfig(loadWorkspaceMcpConfig());
     const serverIds = Object.keys(mcpConfig.servers);
 
     // 3. Restart MCP servers

package/src/daemon/message-types/sync.ts

@@ -13,6 +13,7 @@ export const SYNC_TAGS = {
   assistantConfig: "assistant:self:config",
   assistantSounds: "assistant:self:sounds",
   assistantSchedules: "assistant:self:schedules",
+  assistantDesktop: "assistant:self:desktop",
   assistantTheme: "assistant:self:theme",
   appsList: "apps:list",
   documentsList: "documents:list",

package/src/daemon/providers-setup.ts

@@ -63,7 +63,7 @@ export async function initializeProvidersAndTools(
   // Start MCP servers — workspace-configured and plugin-declared alike —
   // and register their tools. Shared with the schedule worker, which hosts
   // agent turns in its own process and so needs its own connections.
-  await startConfiguredMcpServers(config.mcp);
+  await startConfiguredMcpServers();
 
   log.info("Daemon startup: providers and tools initialized");
 }

package/src/daemon/shutdown-handlers.ts

@@ -24,11 +24,7 @@ import { browserManager } from "../tools/browser/browser-manager.js";
 import { getLogger } from "../util/logger.js";
 import { APP_VERSION } from "../version.js";
 import { getEnrichmentService } from "../workspace/commit-message-enrichment-service.js";
-import {
-  commitAllPendingWorkspaceChanges,
-  stopWorkspaceHeartbeatService,
-} from "../workspace/heartbeat-service.js";
-import { stopAppSourceWatcher } from "./app-source-watcher.js";
+import { commitAllPendingWorkspaceChanges } from "../workspace/heartbeat-service.js";
 import { stopConfigWatcher } from "./config-watcher.js";
 import { stopConversationEvictor } from "./conversation-evictor.js";
 import { stopConversations } from "./conversation-store.js";
@@ -98,9 +94,6 @@ async function shutdown(): Promise<void> {
   }, 30_000);
   forceTimer.unref();
 
-  // Workspace git heartbeat timer lives in the monitor process. This
-  // in-process stop is a no-op unless the singleton was started here.
-  await stopWorkspaceHeartbeatService();
   await stopHeartbeatService();
 
   // Stop the periodic consent-cache refresh (a daemon-owned interval).
@@ -134,7 +127,6 @@ async function shutdown(): Promise<void> {
   disposeAcpSessionManager();
   stopConversationEvictor();
   stopConfigWatcher();
-  stopAppSourceWatcher();
   stopCliIpcServer();
   stopConversations();
   await stopCes();

package/src/daemon/skill-memory-refresh.ts

@@ -8,16 +8,24 @@ import {
   maybeSeedCapabilitySkills,
   maybeSeedCliCommandCards,
 } from "../plugins/defaults/memory/substrate/boot-maintenance.js";
+import { readWorkspaceSkillMdSignature } from "../skills/workspace-skill-md-signature.js";
 import { getLogger } from "../util/logger.js";
 
 const log = getLogger("skill-memory-refresh");
 
+/** Poll interval for workspace `SKILL.md` mtimes. Stats only, no tree walk. */
+export const SKILL_MD_MTIME_POLL_MS = 1_500;
+
+let lastSignature: string | undefined;
+let pollTimer: ReturnType<typeof setInterval> | undefined;
+
 export function refreshSkillCapabilityMemories(
   config: AssistantConfig = getConfig(),
 ): void {
   seedSkillGraphNodes();
   maybeSeedCapabilitySkills(config);
   maybeSeedCliCommandCards(config);
+  lastSignature = readWorkspaceSkillMdSignature();
   void seedUninstalledCatalogSkillMemories()
     .then(() => {
       // Re-run after the async catalog fetch populates the cache so stale
@@ -31,3 +39,59 @@ export function refreshSkillCapabilityMemories(
       ),
     );
 }
+
+/**
+ * Reseed skill capability memories when the workspace `SKILL.md` set or
+ * mtimes have changed since the last refresh in this process. No-op when the
+ * signature is unchanged. First call in a process always reseeds so the
+ * memory worker, whose in-process skill cache starts empty, picks up the
+ * catalog without waiting for an install path.
+ */
+export function maybeRefreshSkillCapabilityMemoriesFromMtime(): boolean {
+  const signature = readWorkspaceSkillMdSignature();
+  if (lastSignature !== undefined && signature === lastSignature) {
+    return false;
+  }
+  if (lastSignature !== undefined) {
+    log.info("Workspace SKILL.md set changed, reseeding capability memories");
+  }
+  refreshSkillCapabilityMemories();
+  return true;
+}
+
+function pollOnce(): void {
+  try {
+    maybeRefreshSkillCapabilityMemoriesFromMtime();
+  } catch (err) {
+    log.warn({ err }, "SKILL.md mtime poll failed");
+  }
+}
+
+/**
+ * Start a per-process poll of workspace `SKILL.md` mtimes. Idempotent.
+ * The memory worker and the assistant each run this against their own
+ * in-process skill caches. Runs once immediately so a worker that has never
+ * seeded picks up the catalog without waiting a tick.
+ */
+export function startWorkspaceSkillMdMtimePoll(): void {
+  if (pollTimer !== undefined) {
+    return;
+  }
+  pollOnce();
+  pollTimer = setInterval(pollOnce, SKILL_MD_MTIME_POLL_MS);
+  pollTimer.unref?.();
+}
+
+export function stopWorkspaceSkillMdMtimePoll(): void {
+  if (pollTimer === undefined) {
+    return;
+  }
+  clearInterval(pollTimer);
+  pollTimer = undefined;
+}
+
+/** @internal Test-only: clear the in-process signature and poll timer. */
+export function _resetSkillMdMtimeStateForTests(): void {
+  lastSignature = undefined;
+  stopWorkspaceSkillMdMtimePoll();
+}

package/src/daemon/tool-side-effects.ts

@@ -18,17 +18,15 @@ import { invalidateEdgeIndex } from "../plugins/defaults/memory/substrate/edge-i
 import { invalidatePageIndex } from "../plugins/defaults/memory/substrate/page-index.js";
 import { getConceptsDir } from "../plugins/defaults/memory/substrate/page-store.js";
 import { broadcastMessage } from "../runtime/assistant-event-hub.js";
-import {
-  publishAppsChanged,
-  publishDocumentsChanged,
-} from "../runtime/sync/resource-sync-events.js";
-import { updatePublishedAppDeployment } from "../services/published-app-updater.js";
+import { publishDocumentsChanged } from "../runtime/sync/resource-sync-events.js";
 import type { ToolExecutionResult } from "../tools/types.js";
 import { getLogger } from "../util/logger.js";
 import { getWorkspaceDir } from "../util/platform.js";
-import { ensureAppSourceWatcher } from "./app-source-watcher.js";
+import {
+  broadcastAppFilesChanged,
+  notifyAppSurfacesChanged,
+} from "./app-change-notify.js";
 import type { Conversation } from "./conversation.js";
-import { refreshSurfacesForApp } from "./conversation-surfaces.js";
 import { isDoordashCommand, updateDoordashProgress } from "./doordash-steps.js";
 
 const log = getLogger("tool-side-effects");
@@ -54,7 +52,7 @@ export type PostExecutionHook = (
  * Compilation is the responsibility of the tool executor (see
  * `executeAppCreate`, `executeAppRefresh`): executors own the source→dist
  * transform and surface `compile_errors` in their result when it fails.
- * Post-execution hooks only observe the outcome and notify — they must
+ * Post-execution hooks only observe the outcome and notify. They must
  * not re-run a compile because `compileApp()` begins with `rm -rf dist/`
  * and would race with the executor's own output (LUM-1153).
  */
@@ -63,14 +61,7 @@ function notifyAppChanged(
   appId: string,
   opts?: { fileChange?: boolean; status?: string },
 ): void {
-  refreshSurfacesForApp(ctx, appId, opts);
-  broadcastAppFilesChanged(appId);
-  void updatePublishedAppDeployment(appId);
-}
-
-function broadcastAppFilesChanged(appId: string): void {
-  broadcastMessage({ type: "app_files_changed", appId });
-  publishAppsChanged();
+  notifyAppSurfacesChanged(appId, opts, ctx);
 }
 
 /**
@@ -128,8 +119,6 @@ registerHook("app_create", (_name, _input, result, { ctx }) => {
     log.warn({ err, appId }, "Failed to track conversation ID on app_create");
   }
 
-  ensureAppSourceWatcher();
-
   notifyAppChanged(ctx, appId);
 
   // Seed background icon generation from the created app's canonical record

package/src/desktop/__tests__/fake-desktop.ts

@@ -0,0 +1,119 @@
+import { join } from "node:path";
+
+import { sleep } from "../../util/retry.js";
+import {
+  type DesktopChild,
+  type DesktopChildRole,
+  type DesktopLoss,
+  DesktopSessionManager,
+  type DesktopSpawnRequest,
+} from "../desktop-session-manager.js";
+
+/** A child the test exits by hand. */
+class FakeChild implements DesktopChild {
+  private static nextPid = 1000;
+  readonly pid = FakeChild.nextPid++;
+  readonly exited: Promise<number>;
+  private settle!: (code: number) => void;
+
+  constructor(
+    readonly role: DesktopChildRole,
+    readonly request: DesktopSpawnRequest,
+  ) {
+    this.exited = new Promise((resolve) => {
+      this.settle = resolve;
+    });
+  }
+
+  kill(): void {}
+
+  exit(code = 0): void {
+    this.settle(code);
+  }
+}
+
+export const LINGER_MS = 20;
+export const KILL_GRACE_MS = 20;
+
+export interface FakeDesktopOptions {
+  profileDir: string;
+  /** Defaults inside `profileDir`, for tests that ignore the dock's config. */
+  panelConfigDir?: string;
+  /** Roles whose spawn throws, to exercise a start that fails partway. */
+  failSpawn?: DesktopChildRole[];
+  /** Binaries `which` cannot find. */
+  missingBinaries?: string[];
+  /** Whether a SIGTERM makes the fake child exit on its own. */
+  exitOnTerm?: boolean;
+  /** Whether a SIGKILL does; without either the child survives both. */
+  exitOnKill?: boolean;
+  sourceEnv?: NodeJS.ProcessEnv;
+  renderWallpaper?: (width: number, height: number) => Promise<Buffer | null>;
+}
+
+export function newFakeDesktop(options: FakeDesktopOptions) {
+  const spawned: FakeChild[] = [];
+  const killed: { child: FakeChild; signal: string }[] = [];
+  let vncReady = true;
+  let chromiumPath: () => Promise<string> = async () => "/fake/chromium";
+  const manager = new DesktopSessionManager({
+    spawn: (role, request) => {
+      if (options.failSpawn?.includes(role)) {
+        throw new Error(`spawn ${role} failed`);
+      }
+      const child = new FakeChild(role, request);
+      spawned.push(child);
+      return child;
+    },
+    which: (binary) =>
+      options.missingBinaries?.includes(binary) ? null : `/usr/bin/${binary}`,
+    probeVncPort: async () => vncReady,
+    resolveChromePath: () => chromiumPath(),
+    renderWallpaper: options.renderWallpaper ?? (async () => null),
+    killProcessGroup: (child, signal) => {
+      killed.push({ child: child as FakeChild, signal });
+      const exits =
+        signal === "SIGTERM" ? options.exitOnTerm : options.exitOnKill;
+      if (exits) {
+        (child as FakeChild).exit(0);
+      }
+    },
+    lingerMs: LINGER_MS,
+    readyDeadlineMs: 30,
+    killGraceMs: KILL_GRACE_MS,
+    profileDir: options.profileDir,
+    panelConfigDir:
+      options.panelConfigDir ?? join(options.profileDir, "desktop-panel"),
+    sourceEnv: options.sourceEnv,
+  });
+  return {
+    manager,
+    spawned,
+    killed,
+    /** Children that got a SIGTERM, in order. */
+    terminated: () =>
+      killed.filter((k) => k.signal === "SIGTERM").map((k) => k.child),
+    setVncReady: (ready: boolean) => {
+      vncReady = ready;
+    },
+    setChromiumPath: (resolve: () => Promise<string>) => {
+      chromiumPath = resolve;
+    },
+    child: (role: DesktopChildRole) =>
+      spawned.filter((c) => c.role === role).at(-1)!,
+    roles: () => spawned.map((c) => c.role),
+    count: (role: DesktopChildRole) =>
+      spawned.filter((c) => c.role === role).length,
+  };
+}
+
+/** Let one awaited step (a path resolution, an exit callback) land. */
+export const settle = (): Promise<void> => sleep(0);
+
+export function newViewer() {
+  const lost: DesktopLoss[] = [];
+  return {
+    lost,
+    viewer: { onDesktopLost: (loss: DesktopLoss) => lost.push(loss) },
+  };
+}

package/src/desktop/desktop-chrome-policy.test.ts

@@ -0,0 +1,71 @@
+import {
+  mkdtempSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  statSync,
+  writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, expect, test } from "bun:test";
+
+import { writeDesktopChromePolicy } from "./desktop-chrome-policy.js";
+
+const directories: string[] = [];
+function policyDirectory(): string {
+  const path = mkdtempSync(join(tmpdir(), "desktop-chrome-policy-"));
+  directories.push(path);
+  return path;
+}
+
+afterEach(() => {
+  for (const path of directories.splice(0)) {
+    rmSync(path, { recursive: true, force: true });
+  }
+});
+
+test("preserves unrelated policies and does not rewrite on repeated startup", () => {
+  const directory = policyDirectory();
+  const path = join(directory, "vellum-desktop.json");
+  const otherPath = join(directory, "organization.json");
+  const unrelated = '{ "HomepageLocation": "https://example.com" }\n';
+  writeFileSync(otherPath, unrelated);
+  writeFileSync(path, JSON.stringify({ DownloadRestrictions: 1 }));
+
+  writeDesktopChromePolicy(directory);
+  const content = readFileSync(path, "utf8");
+  expect(JSON.parse(content).DownloadRestrictions).toBe(1);
+  expect(readFileSync(otherPath, "utf8")).toBe(unrelated);
+  expect(readdirSync(directory).sort()).toEqual([
+    "organization.json",
+    "vellum-desktop.json",
+  ]);
+
+  const before = statSync(path);
+  writeDesktopChromePolicy(directory);
+  expect(readFileSync(path, "utf8")).toBe(content);
+  expect(statSync(path).ino).toBe(before.ino);
+  expect(statSync(path).mtimeMs).toBe(before.mtimeMs);
+});
+
+test("creates missing policy directories for a fresh desktop", () => {
+  const directory = join(policyDirectory(), "policies", "managed");
+  writeDesktopChromePolicy(directory);
+  expect(readdirSync(directory)).toEqual(["vellum-desktop.json"]);
+  expect(statSync(join(directory, "vellum-desktop.json")).mode & 0o777).toBe(
+    0o644,
+  );
+});
+
+test.each(["{broken", "[]", "null", "false"])(
+  "leaves invalid existing policy content untouched: %s",
+  (content) => {
+    const directory = policyDirectory();
+    const path = join(directory, "vellum-desktop.json");
+    writeFileSync(path, content);
+    expect(() => writeDesktopChromePolicy(directory)).toThrow();
+    expect(readFileSync(path, "utf8")).toBe(content);
+    expect(readdirSync(directory)).toEqual(["vellum-desktop.json"]);
+  },
+);

package/src/desktop/desktop-chrome-policy.ts

@@ -0,0 +1,42 @@
+import {
+  mkdirSync,
+  mkdtempSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
+import { join } from "node:path";
+
+export function writeDesktopChromePolicy(policyDir: string): void {
+  const path = join(policyDir, "vellum-desktop.json");
+  let policy: Record<string, unknown> = {};
+  try {
+    const value: unknown = JSON.parse(readFileSync(path, "utf8"));
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      throw new Error("Desktop Chrome policy must be a JSON object");
+    }
+    policy = value as Record<string, unknown>;
+  } catch (err) {
+    if ((err as NodeJS.ErrnoException).code !== "ENOENT") {
+      throw err;
+    }
+  }
+  if (policy.CommandLineFlagSecurityWarningsEnabled === false) {
+    return;
+  }
+
+  // This suppresses command-line warnings; Chrome's sandbox stays unchanged.
+  policy.CommandLineFlagSecurityWarningsEnabled = false;
+  mkdirSync(policyDir, { recursive: true });
+  const staging = mkdtempSync(join(policyDir, ".vellum-desktop-"));
+  try {
+    const temporaryPath = join(staging, "policy.json");
+    writeFileSync(temporaryPath, JSON.stringify(policy, null, 2) + "\n", {
+      mode: 0o644,
+    });
+    renameSync(temporaryPath, path);
+  } finally {
+    rmSync(staging, { recursive: true, force: true });
+  }
+}