@agent-native/core 0.102.2 → 0.103.0

package/corpus/templates/mail/server/lib/local-email-store.ts

@@ -0,0 +1,265 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+import { getDbExec, isPostgres } from "@agent-native/core/db";
+import {
+  getSettingsEmitter,
+  getUserSetting,
+  type StoreWriteOptions,
+} from "@agent-native/core/settings";
+import type { EmailMessage } from "@shared/types.js";
+import { nanoid } from "nanoid";
+
+const localEmailMutationLocks = new Map<string, Promise<unknown>>();
+const LOCK_SETTING_KEY = "local-emails-mutation-lock";
+const LOCK_LEASE_MS = 60_000;
+const LOCK_ACQUIRE_TIMEOUT_MS = 10_000;
+const LOCK_RETRY_MS = 25;
+const LOCK_RELEASE_ATTEMPTS = 3;
+const MAX_MUTATION_ATTEMPTS = 8;
+
+interface LocalEmailMutationContext {
+  ownerKey: string;
+  expectedMailboxRaw?: string | null;
+}
+
+class LocalEmailWriteConflict extends Error {}
+
+const localEmailMutationContext =
+  new AsyncLocalStorage<LocalEmailMutationContext>();
+
+interface LocalEmailLease {
+  token: string;
+  expiresAt: number;
+}
+
+function settingsTable(): string {
+  return isPostgres() ? "public.settings" : "settings";
+}
+
+function lockStorageKey(ownerEmail: string): string {
+  return `u:${ownerEmail.toLowerCase()}:${LOCK_SETTING_KEY}`;
+}
+
+function mailboxStorageKey(ownerEmail: string): string {
+  return `u:${ownerEmail}:local-emails`;
+}
+
+function parseLease(raw: string | null): LocalEmailLease | null {
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw) as Partial<LocalEmailLease>;
+    if (
+      typeof parsed.token === "string" &&
+      typeof parsed.expiresAt === "number"
+    ) {
+      return { token: parsed.token, expiresAt: parsed.expiresAt };
+    }
+  } catch {}
+  return null;
+}
+
+async function readLeaseRow(
+  ownerEmail: string,
+): Promise<{ raw: string | null; lease: LocalEmailLease | null }> {
+  // Initialize the framework-owned settings table, then bypass the request
+  // settings cache so every lease attempt sees the latest committed owner row.
+  await getUserSetting(ownerEmail, LOCK_SETTING_KEY);
+  const { rows } = await getDbExec().execute({
+    sql: `SELECT value FROM ${settingsTable()} WHERE key = ?`,
+    args: [lockStorageKey(ownerEmail)],
+  });
+  const raw = rows.length ? String(rows[0].value ?? rows[0][0]) : null;
+  return { raw, lease: parseLease(raw) };
+}
+
+async function compareAndSwapLease(
+  ownerEmail: string,
+  expectedRaw: string | null,
+  nextRaw: string,
+): Promise<boolean> {
+  const client = getDbExec();
+  const key = lockStorageKey(ownerEmail);
+  if (expectedRaw === null) {
+    const result = await client.execute({
+      sql: isPostgres()
+        ? `INSERT INTO ${settingsTable()} (key, value, updated_at) VALUES (?, ?, ?) ON CONFLICT (key) DO NOTHING`
+        : `INSERT OR IGNORE INTO ${settingsTable()} (key, value, updated_at) VALUES (?, ?, ?)`,
+      args: [key, nextRaw, Date.now()],
+    });
+    return result.rowsAffected === 1;
+  }
+  const result = await client.execute({
+    sql: `UPDATE ${settingsTable()} SET value = ?, updated_at = ? WHERE key = ? AND value = ?`,
+    args: [nextRaw, Date.now(), key, expectedRaw],
+  });
+  return result.rowsAffected === 1;
+}
+
+async function acquireDatabaseLease(ownerEmail: string): Promise<string> {
+  const token = nanoid(16);
+  const deadline = Date.now() + LOCK_ACQUIRE_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    const { raw, lease } = await readLeaseRow(ownerEmail);
+    const now = Date.now();
+    if (!lease || lease.expiresAt <= now) {
+      const nextRaw = JSON.stringify({
+        token,
+        expiresAt: now + LOCK_LEASE_MS,
+      } satisfies LocalEmailLease);
+      if (await compareAndSwapLease(ownerEmail, raw, nextRaw)) return nextRaw;
+    }
+    await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+  }
+  throw new Error("Timed out waiting for local mailbox mutation lock");
+}
+
+async function releaseDatabaseLease(
+  ownerEmail: string,
+  leaseRaw: string,
+): Promise<void> {
+  for (let attempt = 0; attempt < LOCK_RELEASE_ATTEMPTS; attempt += 1) {
+    try {
+      await getDbExec().execute({
+        sql: `DELETE FROM ${settingsTable()} WHERE key = ? AND value = ?`,
+        args: [lockStorageKey(ownerEmail), leaseRaw],
+      });
+      return;
+    } catch (error) {
+      if (attempt === LOCK_RELEASE_ATTEMPTS - 1) throw error;
+      await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+    }
+  }
+}
+
+async function readMailboxRow(ownerEmail: string): Promise<string | null> {
+  // Initialize the settings table, then bypass its request cache so CAS retry
+  // attempts always compare against the latest committed mailbox snapshot.
+  await getUserSetting(ownerEmail, "local-emails");
+  const { rows } = await getDbExec().execute({
+    sql: `SELECT value FROM ${settingsTable()} WHERE key = ?`,
+    args: [mailboxStorageKey(ownerEmail)],
+  });
+  return rows.length ? String(rows[0].value ?? rows[0][0]) : null;
+}
+
+function parseEmails(raw: string | null): EmailMessage[] {
+  if (!raw) return [];
+  try {
+    const data = JSON.parse(raw);
+    return Array.isArray(data?.emails) ? data.emails : [];
+  } catch {
+    return [];
+  }
+}
+
+async function compareAndSwapMailbox(
+  ownerEmail: string,
+  expectedRaw: string | null,
+  nextRaw: string,
+): Promise<boolean> {
+  const client = getDbExec();
+  const key = mailboxStorageKey(ownerEmail);
+  if (expectedRaw === null) {
+    const result = await client.execute({
+      sql: isPostgres()
+        ? `INSERT INTO ${settingsTable()} (key, value, updated_at) VALUES (?, ?, ?) ON CONFLICT (key) DO NOTHING`
+        : `INSERT OR IGNORE INTO ${settingsTable()} (key, value, updated_at) VALUES (?, ?, ?)`,
+      args: [key, nextRaw, Date.now()],
+    });
+    return result.rowsAffected === 1;
+  }
+  const result = await client.execute({
+    sql: `UPDATE ${settingsTable()} SET value = ?, updated_at = ? WHERE key = ? AND value = ?`,
+    args: [nextRaw, Date.now(), key, expectedRaw],
+  });
+  return result.rowsAffected === 1;
+}
+
+/**
+ * Serialize read-modify-write operations on an owner's synthetic mailbox.
+ * Local mail is one JSON document, so every writer must participate to avoid
+ * replacing a concurrent writer's newer snapshot.
+ */
+export function withLocalEmailMutationLock<T>(
+  ownerEmail: string,
+  mutate: () => Promise<T>,
+): Promise<T> {
+  const key = ownerEmail.toLowerCase();
+  const previous = localEmailMutationLocks.get(key) ?? Promise.resolve();
+  const runWithDatabaseLease = async () => {
+    for (let attempt = 0; attempt < MAX_MUTATION_ATTEMPTS; attempt += 1) {
+      const leaseRaw = await acquireDatabaseLease(ownerEmail);
+      try {
+        return await localEmailMutationContext.run({ ownerKey: key }, mutate);
+      } catch (error) {
+        if (!(error instanceof LocalEmailWriteConflict)) throw error;
+      } finally {
+        try {
+          await releaseDatabaseLease(ownerEmail, leaseRaw);
+        } catch (error) {
+          // The lease expires and is token-scoped, so a transient cleanup
+          // failure must not turn an already committed mailbox write into an
+          // ambiguous failure that callers may retry.
+          console.warn(
+            "[local-email-store] failed to release mutation lease; it will expire",
+            error,
+          );
+        }
+      }
+    }
+    throw new Error("Local mailbox changed too many times; please retry");
+  };
+  const next = previous.then(runWithDatabaseLease, runWithDatabaseLease);
+  localEmailMutationLocks.set(key, next);
+  const cleanup = () => {
+    if (localEmailMutationLocks.get(key) === next) {
+      localEmailMutationLocks.delete(key);
+    }
+  };
+  next.then(cleanup, cleanup);
+  return next;
+}
+
+export async function readLocalEmails(
+  ownerEmail: string,
+): Promise<EmailMessage[]> {
+  const raw = await readMailboxRow(ownerEmail);
+  const context = localEmailMutationContext.getStore();
+  if (context?.ownerKey === ownerEmail.toLowerCase()) {
+    context.expectedMailboxRaw = raw;
+  }
+  return parseEmails(raw);
+}
+
+export async function writeLocalEmails(
+  ownerEmail: string,
+  emails: EmailMessage[],
+  options?: StoreWriteOptions,
+): Promise<void> {
+  const context = localEmailMutationContext.getStore();
+  if (
+    context?.ownerKey !== ownerEmail.toLowerCase() ||
+    context.expectedMailboxRaw === undefined
+  ) {
+    throw new Error(
+      "Local mailbox writes must run inside withLocalEmailMutationLock after a fresh read",
+    );
+  }
+  const nextRaw = JSON.stringify({ emails });
+  if (
+    !(await compareAndSwapMailbox(
+      ownerEmail,
+      context.expectedMailboxRaw,
+      nextRaw,
+    ))
+  ) {
+    throw new LocalEmailWriteConflict("Local mailbox changed concurrently");
+  }
+  context.expectedMailboxRaw = nextRaw;
+  getSettingsEmitter().emit("settings", {
+    source: "settings",
+    type: "change",
+    key: mailboxStorageKey(ownerEmail),
+    ...(options?.requestSource && { requestSource: options.requestSource }),
+  });
+}

package/corpus/templates/mail/server/plugins/agent-chat.ts

@@ -105,6 +105,12 @@ Available operations:
 - Queue teammate-requested drafts for organization members to review and send
 - Navigate the UI to specific views or threads
 
+## Reliable Mail Mutations
+
+For requests to mark all, every, or many unread conversations read in one account, call \`mark-read\` exactly once with \`scope: "all-unread"\` and the exact \`accountEmail\`. Resolve conversations the user wants preserved to exact thread IDs and pass them in \`excludeThreadIds\`. Never loop \`mark-thread-read\` for broad cleanup. Report the returned matched, excluded, changed, and remaining-unread counts; completeness comes from the action's verification read, not merely from a successful tool submission.
+
+Use \`mark-thread-read\` for one specific conversation only.
+
 ## Provider APIs Are Escape Hatches, Not Limits
 
 Provider-specific Mail actions are shortcuts, not limits. If a first-class action cannot express the exact Gmail, Google Calendar, or CRM endpoint, search query, label/filter setting, request body, pagination mode, account id, payload shape, or API version needed, call \`provider-api-catalog\` and \`provider-api-docs\` as needed, then call \`provider-api-request\` against the provider's real HTTP API.

package/dist/cli/content-local.d.ts

@@ -12,6 +12,7 @@ export interface ContentLocalLaunchPlan {
     manifestPath: string;
     rootPath: string;
     filePath?: string;
+    connectionId: string;
     url: string;
     command: string;
     args: string[];

package/dist/cli/content-local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-local.d.ts","sourceRoot":"","sources":["../../src/cli/content-local.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAoCD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA8CtE;AAqGD,wBAAgB,sBAAsB,CAAC,GAAG,SAAgB,UAmBzD;AAOD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA+ClC;AAgCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,mBA+CnD"}
+{"version":3,"file":"content-local.d.ts","sourceRoot":"","sources":["../../src/cli/content-local.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AA4CD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA8CtE;AAuJD,wBAAgB,sBAAsB,CAAC,GAAG,SAAgB,UAmBzD;AAQD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkDlC;AAgCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,mBAmDnD"}

package/dist/cli/content-local.js

@@ -1,4 +1,5 @@
 import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -7,7 +8,7 @@ const CONTENT_APP_ID = "content";
 const MANIFEST_FILE = "agent-native.json";
 const DEFAULT_PORT = 8083;
 const DEFAULT_PROFILE = "docs/no-bookkeeping";
-const LOCAL_FILE_ID_PREFIX = "local-file:";
+const LOCAL_FOLDER_CONNECTION_PREFIX = "local-folder:";
 function normalizeSlash(value) {
     return value.replace(/\\/g, "/");
 }
@@ -20,8 +21,20 @@ function titleFromPath(value) {
         .trim()
         .replace(/\b\w/g, (char) => char.toUpperCase()) || "Content");
 }
-function encodeLocalFileId(filePath) {
-    return `${LOCAL_FILE_ID_PREFIX}${Buffer.from(filePath, "utf8").toString("base64url")}`;
+function localFolderConnectionId(absoluteRootPath) {
+    let canonicalRootPath = path.resolve(absoluteRootPath);
+    try {
+        canonicalRootPath = fsSync.realpathSync(canonicalRootPath);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const digest = createHash("sha256")
+        .update(canonicalRootPath)
+        .digest("base64url")
+        .slice(0, 24);
+    return `${LOCAL_FOLDER_CONNECTION_PREFIX}${digest}`;
 }
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);
@@ -105,6 +118,7 @@ function resolveTarget(target, cwd) {
         : undefined;
     return {
         absoluteTarget,
+        absoluteRootPath: targetDirectory,
         isFile: stat.isFile(),
         workspaceRoot,
         rootPath: normalizeSlash(rootPath),
@@ -127,7 +141,7 @@ async function readManifest(manifestPath) {
         throw error;
     }
 }
-function upsertContentManifest(manifest, rootPath, options) {
+function upsertContentManifest(manifest, workspaceRoot, rootPath, options) {
     const next = {
         ...manifest,
         version: manifest.version ?? 1,
@@ -154,14 +168,50 @@ function upsertContentManifest(manifest, rootPath, options) {
             ? existingRoot.extensions
             : [".md", ".mdx"],
         ...(profile ? { profile } : {}),
-        ...(include && rootIndex === -1 ? { include } : {}),
+        ...(include && (rootIndex === -1 || Array.isArray(existingRoot?.include))
+            ? {
+                include: Array.from(new Set([
+                    ...(Array.isArray(existingRoot?.include)
+                        ? existingRoot.include.filter((value) => typeof value === "string")
+                        : []),
+                    ...include,
+                ])),
+            }
+            : {}),
+        source: {
+            ...(isRecord(existingRoot?.source) ? existingRoot.source : {}),
+            type: "local-folder",
+            connectionId: options.connectionId,
+            truthPolicy: "source_primary",
+        },
     };
-    const roots = rootIndex === -1
+    let roots = rootIndex === -1
         ? [...existingRoots, root]
         : existingRoots.map((entry, index) => index === rootIndex ? { ...entry, ...root } : entry);
+    if (existingContent.mode === "local-files") {
+        roots = roots.map((entry) => {
+            if (entry === root || typeof entry.path !== "string")
+                return entry;
+            const existingSource = isRecord(entry.source) ? entry.source : {};
+            return {
+                ...entry,
+                source: {
+                    ...existingSource,
+                    type: "local-folder",
+                    connectionId: typeof existingSource.connectionId === "string" &&
+                        existingSource.connectionId
+                        ? existingSource.connectionId
+                        : localFolderConnectionId(path.resolve(workspaceRoot, entry.path)),
+                    truthPolicy: typeof existingSource.truthPolicy === "string"
+                        ? existingSource.truthPolicy
+                        : "source_primary",
+                },
+            };
+        });
+    }
+    delete existingContent.mode;
     apps[CONTENT_APP_ID] = {
         ...existingContent,
-        mode: "local-files",
         roots,
         hide: Array.isArray(existingContent.hide)
             ? existingContent.hide
@@ -184,15 +234,19 @@ export function findContentTemplateDir(cwd = process.cwd()) {
     candidates.push(path.resolve(cliDir, "../../../..", "templates/content"));
     return (candidates.find((candidate) => fsSync.existsSync(path.join(candidate, "package.json"))) ?? null);
 }
-function launchUrl(port, filePath) {
-    const base = `http://127.0.0.1:${port}`;
-    return filePath ? `${base}/page/${encodeLocalFileId(filePath)}` : base;
+function launchUrl(port, connectionId, filePath) {
+    const params = new URLSearchParams({ connectionId });
+    if (filePath)
+        params.set("file", filePath);
+    return `http://127.0.0.1:${port}/local-files?${params.toString()}`;
 }
 export async function prepareContentLocalLaunch(options) {
     const cwd = path.resolve(options.cwd ?? process.cwd());
     const target = resolveTarget(options.target, cwd);
     const manifestPath = path.join(target.workspaceRoot, MANIFEST_FILE);
-    const manifest = upsertContentManifest(await readManifest(manifestPath), target.rootPath, {
+    const connectionId = localFolderConnectionId(target.absoluteRootPath);
+    const manifest = upsertContentManifest(await readManifest(manifestPath), target.workspaceRoot, target.rootPath, {
+        connectionId,
         filePath: target.filePath,
         profile: options.profile,
     });
@@ -208,7 +262,8 @@ export async function prepareContentLocalLaunch(options) {
         manifestPath,
         rootPath: target.rootPath,
         filePath: target.filePath,
-        url: launchUrl(options.port ?? DEFAULT_PORT, target.filePath),
+        connectionId,
+        url: launchUrl(options.port ?? DEFAULT_PORT, connectionId, target.filePath),
         command: "corepack",
         args: [
             "pnpm",
@@ -222,7 +277,6 @@ export async function prepareContentLocalLaunch(options) {
             "--strictPort",
         ],
         env: {
-            AGENT_NATIVE_MODE: "local-files",
             AGENT_NATIVE_MANIFEST_PATH: manifestPath,
         },
         manifest,
@@ -248,7 +302,7 @@ function printHelp() {
   agent-native content <file-or-folder> [options]
 
 Options:
-  --profile <name>   Local file profile, for example docs/no-bookkeeping
+  --profile <name>   Local folder profile, for example docs/no-bookkeeping
   --port <number>    Dev server port (default ${DEFAULT_PORT})
   --open             Open the target in the browser (default)
   --no-open          Start the server without opening the browser
@@ -257,9 +311,13 @@ Options:
 }
 export async function runContentLocal(argv) {
     const parsed = parseContentLocalArgs(argv);
-    if (parsed.help || !parsed.target) {
+    if (parsed.help) {
+        printHelp();
+        return 0;
+    }
+    if (!parsed.target) {
         printHelp();
-        return parsed.target ? 0 : 1;
+        return 1;
     }
     const plan = await prepareContentLocalLaunch({
         target: parsed.target,
@@ -271,7 +329,7 @@ export async function runContentLocal(argv) {
         console.log(JSON.stringify(plan, null, 2));
         return 0;
     }
-    console.log(`Content local files: ${plan.rootPath}`);
+    console.log(`Content folder source: ${plan.rootPath}`);
     console.log(`Manifest: ${plan.manifestPath}`);
     console.log(`Opening: ${plan.url}`);
     if (parsed.open) {

package/dist/cli/content-local.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-local.js","sourceRoot":"","sources":["../../src/cli/content-local.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport fsSync from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst CONTENT_APP_ID = \"content\";\nconst MANIFEST_FILE = \"agent-native.json\";\nconst DEFAULT_PORT = 8083;\nconst DEFAULT_PROFILE = \"docs/no-bookkeeping\";\nconst LOCAL_FILE_ID_PREFIX = \"local-file:\";\n\nexport interface ContentLocalArgs {\n  target?: string;\n  open: boolean;\n  port: number;\n  profile?: string;\n  dryRun: boolean;\n  json: boolean;\n  help: boolean;\n}\n\nexport interface ContentLocalLaunchPlan {\n  workspaceRoot: string;\n  manifestPath: string;\n  rootPath: string;\n  filePath?: string;\n  url: string;\n  command: string;\n  args: string[];\n  env: Record<string, string>;\n  manifest: Record<string, unknown>;\n}\n\nfunction normalizeSlash(value: string) {\n  return value.replace(/\\\\/g, \"/\");\n}\n\nfunction titleFromPath(value: string) {\n  return (\n    path\n      .basename(value)\n      .replace(/\\.(mdx?|markdown)$/i, \"\")\n      .replace(/[-_]+/g, \" \")\n      .replace(/\\s+/g, \" \")\n      .trim()\n      .replace(/\\b\\w/g, (char) => char.toUpperCase()) || \"Content\"\n  );\n}\n\nfunction encodeLocalFileId(filePath: string) {\n  return `${LOCAL_FILE_ID_PREFIX}${Buffer.from(filePath, \"utf8\").toString(\n    \"base64url\",\n  )}`;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction stringFlagValue(argv: string[], index: number, flag: string) {\n  const value = argv[index + 1];\n  if (!value || value.startsWith(\"-\")) {\n    throw new Error(`${flag} requires a value`);\n  }\n  return value;\n}\n\nexport function parseContentLocalArgs(argv: string[]): ContentLocalArgs {\n  const args = argv[0] === \"local-files\" ? argv.slice(1) : argv;\n  const parsed: ContentLocalArgs = {\n    open: true,\n    port: DEFAULT_PORT,\n    dryRun: false,\n    json: false,\n    help: false,\n  };\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index]!;\n    if (arg === \"help\" || arg === \"--help\" || arg === \"-h\") {\n      parsed.help = true;\n    } else if (arg === \"--open\") {\n      parsed.open = true;\n    } else if (arg === \"--no-open\") {\n      parsed.open = false;\n    } else if (arg === \"--dry-run\") {\n      parsed.dryRun = true;\n    } else if (arg === \"--json\") {\n      parsed.json = true;\n    } else if (arg === \"--port\") {\n      parsed.port = Number.parseInt(stringFlagValue(args, index, arg), 10);\n      index += 1;\n    } else if (arg.startsWith(\"--port=\")) {\n      parsed.port = Number.parseInt(arg.slice(\"--port=\".length), 10);\n    } else if (arg === \"--profile\") {\n      parsed.profile = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--profile=\")) {\n      parsed.profile = arg.slice(\"--profile=\".length);\n    } else if (arg.startsWith(\"-\")) {\n      throw new Error(`Unknown option: ${arg}`);\n    } else if (!parsed.target) {\n      parsed.target = arg;\n    } else {\n      throw new Error(`Unexpected argument: ${arg}`);\n    }\n  }\n\n  if (!Number.isInteger(parsed.port) || parsed.port <= 0) {\n    throw new Error(\"--port must be a positive integer\");\n  }\n\n  return parsed;\n}\n\nfunction resolveTarget(target: string, cwd: string) {\n  const absoluteTarget = path.resolve(cwd, target);\n  const stat = fsSync.statSync(absoluteTarget);\n  const targetDirectory = stat.isDirectory()\n    ? absoluteTarget\n    : path.dirname(absoluteTarget);\n  let workspaceRoot = path.resolve(cwd);\n  let rootPath = normalizeSlash(path.relative(workspaceRoot, targetDirectory));\n\n  if (!rootPath || rootPath === \".\" || rootPath.startsWith(\"../\")) {\n    workspaceRoot = path.dirname(targetDirectory);\n    rootPath = path.basename(targetDirectory);\n  }\n\n  const filePath = stat.isFile()\n    ? normalizeSlash(path.posix.join(rootPath, path.basename(absoluteTarget)))\n    : undefined;\n\n  return {\n    absoluteTarget,\n    isFile: stat.isFile(),\n    workspaceRoot,\n    rootPath: normalizeSlash(rootPath),\n    filePath,\n  };\n}\n\nasync function readManifest(\n  manifestPath: string,\n): Promise<Record<string, unknown>> {\n  try {\n    const raw = await fs.readFile(manifestPath, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (!isRecord(parsed)) {\n      throw new Error(`${MANIFEST_FILE} must contain a JSON object`);\n    }\n    return parsed;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      return { version: 1 };\n    }\n    throw error;\n  }\n}\n\nfunction upsertContentManifest(\n  manifest: Record<string, unknown>,\n  rootPath: string,\n  options: { filePath?: string; profile?: string },\n) {\n  const next: Record<string, unknown> = {\n    ...manifest,\n    version: manifest.version ?? 1,\n  };\n  const apps = isRecord(next.apps) ? { ...next.apps } : {};\n  const existingContent = isRecord(apps[CONTENT_APP_ID])\n    ? { ...apps[CONTENT_APP_ID] }\n    : {};\n  const existingRoots = Array.isArray(existingContent.roots)\n    ? existingContent.roots.filter(isRecord).map((root) => ({ ...root }))\n    : [];\n  const include = options.filePath ? [options.filePath] : undefined;\n  const rootIndex = existingRoots.findIndex((entry) => entry.path === rootPath);\n  const existingRoot = rootIndex === -1 ? undefined : existingRoots[rootIndex];\n  const profile =\n    options.profile && !existingRoot?.profile ? options.profile : undefined;\n  const root = {\n    ...existingRoot,\n    name:\n      typeof existingRoot?.name === \"string\"\n        ? existingRoot.name\n        : titleFromPath(rootPath),\n    path: rootPath,\n    kind: typeof existingRoot?.kind === \"string\" ? existingRoot.kind : \"docs\",\n    extensions: Array.isArray(existingRoot?.extensions)\n      ? existingRoot.extensions\n      : [\".md\", \".mdx\"],\n    ...(profile ? { profile } : {}),\n    ...(include && rootIndex === -1 ? { include } : {}),\n  };\n  const roots =\n    rootIndex === -1\n      ? [...existingRoots, root]\n      : existingRoots.map((entry, index) =>\n          index === rootIndex ? { ...entry, ...root } : entry,\n        );\n\n  apps[CONTENT_APP_ID] = {\n    ...existingContent,\n    mode: \"local-files\",\n    roots,\n    hide: Array.isArray(existingContent.hide)\n      ? existingContent.hide\n      : [\"**/_*.md\", \"**/_*.mdx\"],\n  };\n  next.apps = apps;\n  return next;\n}\n\nexport function findContentTemplateDir(cwd = process.cwd()) {\n  const cliDir = path.dirname(fileURLToPath(import.meta.url));\n  const candidates: string[] = [];\n  let current = path.resolve(cwd);\n  for (;;) {\n    candidates.push(\n      path.join(current, \"templates\", \"content\"),\n      path.join(current, \"apps\", \"content\"),\n    );\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n  candidates.push(path.resolve(cliDir, \"../../../..\", \"templates/content\"));\n  return (\n    candidates.find((candidate) =>\n      fsSync.existsSync(path.join(candidate, \"package.json\")),\n    ) ?? null\n  );\n}\n\nfunction launchUrl(port: number, filePath?: string) {\n  const base = `http://127.0.0.1:${port}`;\n  return filePath ? `${base}/page/${encodeLocalFileId(filePath)}` : base;\n}\n\nexport async function prepareContentLocalLaunch(options: {\n  target: string;\n  cwd?: string;\n  port?: number;\n  profile?: string;\n  dryRun?: boolean;\n}): Promise<ContentLocalLaunchPlan> {\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const target = resolveTarget(options.target, cwd);\n  const manifestPath = path.join(target.workspaceRoot, MANIFEST_FILE);\n  const manifest = upsertContentManifest(\n    await readManifest(manifestPath),\n    target.rootPath,\n    {\n      filePath: target.filePath,\n      profile: options.profile,\n    },\n  );\n  const templateDir = findContentTemplateDir(cwd);\n  if (!templateDir) {\n    throw new Error(\n      \"Could not find the Content app template. Run this from the framework checkout or a workspace that includes templates/content.\",\n    );\n  }\n\n  if (!options.dryRun) {\n    await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n  }\n\n  return {\n    workspaceRoot: target.workspaceRoot,\n    manifestPath,\n    rootPath: target.rootPath,\n    filePath: target.filePath,\n    url: launchUrl(options.port ?? DEFAULT_PORT, target.filePath),\n    command: \"corepack\",\n    args: [\n      \"pnpm\",\n      \"--dir\",\n      templateDir,\n      \"dev\",\n      \"--host\",\n      \"127.0.0.1\",\n      \"--port\",\n      String(options.port ?? DEFAULT_PORT),\n      \"--strictPort\",\n    ],\n    env: {\n      AGENT_NATIVE_MODE: \"local-files\",\n      AGENT_NATIVE_MANIFEST_PATH: manifestPath,\n    },\n    manifest,\n  };\n}\n\nfunction openBrowser(url: string) {\n  const command =\n    process.platform === \"darwin\"\n      ? \"open\"\n      : process.platform === \"win32\"\n        ? \"cmd\"\n        : \"xdg-open\";\n  const args = process.platform === \"win32\" ? [\"/c\", \"start\", \"\", url] : [url];\n  const child = spawn(command, args, {\n    detached: true,\n    stdio: \"ignore\",\n    shell: false,\n  });\n  child.unref();\n}\n\nfunction printHelp() {\n  console.log(`Usage:\n  agent-native content local-files <file-or-folder> [options]\n  agent-native content <file-or-folder> [options]\n\nOptions:\n  --profile <name>   Local file profile, for example docs/no-bookkeeping\n  --port <number>    Dev server port (default ${DEFAULT_PORT})\n  --open             Open the target in the browser (default)\n  --no-open          Start the server without opening the browser\n  --dry-run          Print the launch plan without writing ${MANIFEST_FILE}\n  --json             Print the launch plan as JSON`);\n}\n\nexport async function runContentLocal(argv: string[]) {\n  const parsed = parseContentLocalArgs(argv);\n  if (parsed.help || !parsed.target) {\n    printHelp();\n    return parsed.target ? 0 : 1;\n  }\n\n  const plan = await prepareContentLocalLaunch({\n    target: parsed.target,\n    port: parsed.port,\n    profile: parsed.profile ?? DEFAULT_PROFILE,\n    dryRun: parsed.dryRun,\n  });\n\n  if (parsed.dryRun || parsed.json) {\n    console.log(JSON.stringify(plan, null, 2));\n    return 0;\n  }\n\n  console.log(`Content local files: ${plan.rootPath}`);\n  console.log(`Manifest: ${plan.manifestPath}`);\n  console.log(`Opening: ${plan.url}`);\n\n  if (parsed.open) {\n    setTimeout(() => openBrowser(plan.url), 1000).unref();\n  }\n\n  const child = spawn(plan.command, plan.args, {\n    cwd: plan.workspaceRoot,\n    stdio: \"inherit\",\n    shell: process.platform === \"win32\",\n    env: { ...process.env, ...plan.env },\n  });\n\n  return await new Promise<number>((resolve) => {\n    child.on(\"exit\", (code) => resolve(code ?? 0));\n    child.on(\"error\", (error) => {\n      console.error(error.message);\n      resolve(1);\n    });\n    for (const signal of [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const) {\n      process.on(signal, () => {\n        child.kill(signal);\n        resolve(1);\n      });\n    }\n  });\n}\n"]}
+{"version":3,"file":"content-local.js","sourceRoot":"","sources":["../../src/cli/content-local.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { createHash } from \"node:crypto\";\nimport fsSync from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst CONTENT_APP_ID = \"content\";\nconst MANIFEST_FILE = \"agent-native.json\";\nconst DEFAULT_PORT = 8083;\nconst DEFAULT_PROFILE = \"docs/no-bookkeeping\";\nconst LOCAL_FOLDER_CONNECTION_PREFIX = \"local-folder:\";\n\nexport interface ContentLocalArgs {\n  target?: string;\n  open: boolean;\n  port: number;\n  profile?: string;\n  dryRun: boolean;\n  json: boolean;\n  help: boolean;\n}\n\nexport interface ContentLocalLaunchPlan {\n  workspaceRoot: string;\n  manifestPath: string;\n  rootPath: string;\n  filePath?: string;\n  connectionId: string;\n  url: string;\n  command: string;\n  args: string[];\n  env: Record<string, string>;\n  manifest: Record<string, unknown>;\n}\n\nfunction normalizeSlash(value: string) {\n  return value.replace(/\\\\/g, \"/\");\n}\n\nfunction titleFromPath(value: string) {\n  return (\n    path\n      .basename(value)\n      .replace(/\\.(mdx?|markdown)$/i, \"\")\n      .replace(/[-_]+/g, \" \")\n      .replace(/\\s+/g, \" \")\n      .trim()\n      .replace(/\\b\\w/g, (char) => char.toUpperCase()) || \"Content\"\n  );\n}\n\nfunction localFolderConnectionId(absoluteRootPath: string) {\n  let canonicalRootPath = path.resolve(absoluteRootPath);\n  try {\n    canonicalRootPath = fsSync.realpathSync(canonicalRootPath);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n  }\n  const digest = createHash(\"sha256\")\n    .update(canonicalRootPath)\n    .digest(\"base64url\")\n    .slice(0, 24);\n  return `${LOCAL_FOLDER_CONNECTION_PREFIX}${digest}`;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction stringFlagValue(argv: string[], index: number, flag: string) {\n  const value = argv[index + 1];\n  if (!value || value.startsWith(\"-\")) {\n    throw new Error(`${flag} requires a value`);\n  }\n  return value;\n}\n\nexport function parseContentLocalArgs(argv: string[]): ContentLocalArgs {\n  const args = argv[0] === \"local-files\" ? argv.slice(1) : argv;\n  const parsed: ContentLocalArgs = {\n    open: true,\n    port: DEFAULT_PORT,\n    dryRun: false,\n    json: false,\n    help: false,\n  };\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index]!;\n    if (arg === \"help\" || arg === \"--help\" || arg === \"-h\") {\n      parsed.help = true;\n    } else if (arg === \"--open\") {\n      parsed.open = true;\n    } else if (arg === \"--no-open\") {\n      parsed.open = false;\n    } else if (arg === \"--dry-run\") {\n      parsed.dryRun = true;\n    } else if (arg === \"--json\") {\n      parsed.json = true;\n    } else if (arg === \"--port\") {\n      parsed.port = Number.parseInt(stringFlagValue(args, index, arg), 10);\n      index += 1;\n    } else if (arg.startsWith(\"--port=\")) {\n      parsed.port = Number.parseInt(arg.slice(\"--port=\".length), 10);\n    } else if (arg === \"--profile\") {\n      parsed.profile = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--profile=\")) {\n      parsed.profile = arg.slice(\"--profile=\".length);\n    } else if (arg.startsWith(\"-\")) {\n      throw new Error(`Unknown option: ${arg}`);\n    } else if (!parsed.target) {\n      parsed.target = arg;\n    } else {\n      throw new Error(`Unexpected argument: ${arg}`);\n    }\n  }\n\n  if (!Number.isInteger(parsed.port) || parsed.port <= 0) {\n    throw new Error(\"--port must be a positive integer\");\n  }\n\n  return parsed;\n}\n\nfunction resolveTarget(target: string, cwd: string) {\n  const absoluteTarget = path.resolve(cwd, target);\n  const stat = fsSync.statSync(absoluteTarget);\n  const targetDirectory = stat.isDirectory()\n    ? absoluteTarget\n    : path.dirname(absoluteTarget);\n  let workspaceRoot = path.resolve(cwd);\n  let rootPath = normalizeSlash(path.relative(workspaceRoot, targetDirectory));\n\n  if (!rootPath || rootPath === \".\" || rootPath.startsWith(\"../\")) {\n    workspaceRoot = path.dirname(targetDirectory);\n    rootPath = path.basename(targetDirectory);\n  }\n\n  const filePath = stat.isFile()\n    ? normalizeSlash(path.posix.join(rootPath, path.basename(absoluteTarget)))\n    : undefined;\n\n  return {\n    absoluteTarget,\n    absoluteRootPath: targetDirectory,\n    isFile: stat.isFile(),\n    workspaceRoot,\n    rootPath: normalizeSlash(rootPath),\n    filePath,\n  };\n}\n\nasync function readManifest(\n  manifestPath: string,\n): Promise<Record<string, unknown>> {\n  try {\n    const raw = await fs.readFile(manifestPath, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (!isRecord(parsed)) {\n      throw new Error(`${MANIFEST_FILE} must contain a JSON object`);\n    }\n    return parsed;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      return { version: 1 };\n    }\n    throw error;\n  }\n}\n\nfunction upsertContentManifest(\n  manifest: Record<string, unknown>,\n  workspaceRoot: string,\n  rootPath: string,\n  options: {\n    connectionId: string;\n    filePath?: string;\n    profile?: string;\n  },\n) {\n  const next: Record<string, unknown> = {\n    ...manifest,\n    version: manifest.version ?? 1,\n  };\n  const apps = isRecord(next.apps) ? { ...next.apps } : {};\n  const existingContent = isRecord(apps[CONTENT_APP_ID])\n    ? { ...apps[CONTENT_APP_ID] }\n    : {};\n  const existingRoots = Array.isArray(existingContent.roots)\n    ? existingContent.roots.filter(isRecord).map((root) => ({ ...root }))\n    : [];\n  const include = options.filePath ? [options.filePath] : undefined;\n  const rootIndex = existingRoots.findIndex((entry) => entry.path === rootPath);\n  const existingRoot = rootIndex === -1 ? undefined : existingRoots[rootIndex];\n  const profile =\n    options.profile && !existingRoot?.profile ? options.profile : undefined;\n  const root = {\n    ...existingRoot,\n    name:\n      typeof existingRoot?.name === \"string\"\n        ? existingRoot.name\n        : titleFromPath(rootPath),\n    path: rootPath,\n    kind: typeof existingRoot?.kind === \"string\" ? existingRoot.kind : \"docs\",\n    extensions: Array.isArray(existingRoot?.extensions)\n      ? existingRoot.extensions\n      : [\".md\", \".mdx\"],\n    ...(profile ? { profile } : {}),\n    ...(include && (rootIndex === -1 || Array.isArray(existingRoot?.include))\n      ? {\n          include: Array.from(\n            new Set([\n              ...(Array.isArray(existingRoot?.include)\n                ? existingRoot.include.filter(\n                    (value): value is string => typeof value === \"string\",\n                  )\n                : []),\n              ...include,\n            ]),\n          ),\n        }\n      : {}),\n    source: {\n      ...(isRecord(existingRoot?.source) ? existingRoot.source : {}),\n      type: \"local-folder\",\n      connectionId: options.connectionId,\n      truthPolicy: \"source_primary\",\n    },\n  };\n  let roots =\n    rootIndex === -1\n      ? [...existingRoots, root]\n      : existingRoots.map((entry, index) =>\n          index === rootIndex ? { ...entry, ...root } : entry,\n        );\n\n  if (existingContent.mode === \"local-files\") {\n    roots = roots.map((entry) => {\n      if (entry === root || typeof entry.path !== \"string\") return entry;\n      const existingSource = isRecord(entry.source) ? entry.source : {};\n      return {\n        ...entry,\n        source: {\n          ...existingSource,\n          type: \"local-folder\",\n          connectionId:\n            typeof existingSource.connectionId === \"string\" &&\n            existingSource.connectionId\n              ? existingSource.connectionId\n              : localFolderConnectionId(\n                  path.resolve(workspaceRoot, entry.path),\n                ),\n          truthPolicy:\n            typeof existingSource.truthPolicy === \"string\"\n              ? existingSource.truthPolicy\n              : \"source_primary\",\n        },\n      };\n    });\n  }\n\n  delete existingContent.mode;\n  apps[CONTENT_APP_ID] = {\n    ...existingContent,\n    roots,\n    hide: Array.isArray(existingContent.hide)\n      ? existingContent.hide\n      : [\"**/_*.md\", \"**/_*.mdx\"],\n  };\n  next.apps = apps;\n  return next;\n}\n\nexport function findContentTemplateDir(cwd = process.cwd()) {\n  const cliDir = path.dirname(fileURLToPath(import.meta.url));\n  const candidates: string[] = [];\n  let current = path.resolve(cwd);\n  for (;;) {\n    candidates.push(\n      path.join(current, \"templates\", \"content\"),\n      path.join(current, \"apps\", \"content\"),\n    );\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n  candidates.push(path.resolve(cliDir, \"../../../..\", \"templates/content\"));\n  return (\n    candidates.find((candidate) =>\n      fsSync.existsSync(path.join(candidate, \"package.json\")),\n    ) ?? null\n  );\n}\n\nfunction launchUrl(port: number, connectionId: string, filePath?: string) {\n  const params = new URLSearchParams({ connectionId });\n  if (filePath) params.set(\"file\", filePath);\n  return `http://127.0.0.1:${port}/local-files?${params.toString()}`;\n}\n\nexport async function prepareContentLocalLaunch(options: {\n  target: string;\n  cwd?: string;\n  port?: number;\n  profile?: string;\n  dryRun?: boolean;\n}): Promise<ContentLocalLaunchPlan> {\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const target = resolveTarget(options.target, cwd);\n  const manifestPath = path.join(target.workspaceRoot, MANIFEST_FILE);\n  const connectionId = localFolderConnectionId(target.absoluteRootPath);\n  const manifest = upsertContentManifest(\n    await readManifest(manifestPath),\n    target.workspaceRoot,\n    target.rootPath,\n    {\n      connectionId,\n      filePath: target.filePath,\n      profile: options.profile,\n    },\n  );\n  const templateDir = findContentTemplateDir(cwd);\n  if (!templateDir) {\n    throw new Error(\n      \"Could not find the Content app template. Run this from the framework checkout or a workspace that includes templates/content.\",\n    );\n  }\n\n  if (!options.dryRun) {\n    await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n  }\n\n  return {\n    workspaceRoot: target.workspaceRoot,\n    manifestPath,\n    rootPath: target.rootPath,\n    filePath: target.filePath,\n    connectionId,\n    url: launchUrl(options.port ?? DEFAULT_PORT, connectionId, target.filePath),\n    command: \"corepack\",\n    args: [\n      \"pnpm\",\n      \"--dir\",\n      templateDir,\n      \"dev\",\n      \"--host\",\n      \"127.0.0.1\",\n      \"--port\",\n      String(options.port ?? DEFAULT_PORT),\n      \"--strictPort\",\n    ],\n    env: {\n      AGENT_NATIVE_MANIFEST_PATH: manifestPath,\n    },\n    manifest,\n  };\n}\n\nfunction openBrowser(url: string) {\n  const command =\n    process.platform === \"darwin\"\n      ? \"open\"\n      : process.platform === \"win32\"\n        ? \"cmd\"\n        : \"xdg-open\";\n  const args = process.platform === \"win32\" ? [\"/c\", \"start\", \"\", url] : [url];\n  const child = spawn(command, args, {\n    detached: true,\n    stdio: \"ignore\",\n    shell: false,\n  });\n  child.unref();\n}\n\nfunction printHelp() {\n  console.log(`Usage:\n  agent-native content local-files <file-or-folder> [options]\n  agent-native content <file-or-folder> [options]\n\nOptions:\n  --profile <name>   Local folder profile, for example docs/no-bookkeeping\n  --port <number>    Dev server port (default ${DEFAULT_PORT})\n  --open             Open the target in the browser (default)\n  --no-open          Start the server without opening the browser\n  --dry-run          Print the launch plan without writing ${MANIFEST_FILE}\n  --json             Print the launch plan as JSON`);\n}\n\nexport async function runContentLocal(argv: string[]) {\n  const parsed = parseContentLocalArgs(argv);\n  if (parsed.help) {\n    printHelp();\n    return 0;\n  }\n  if (!parsed.target) {\n    printHelp();\n    return 1;\n  }\n\n  const plan = await prepareContentLocalLaunch({\n    target: parsed.target,\n    port: parsed.port,\n    profile: parsed.profile ?? DEFAULT_PROFILE,\n    dryRun: parsed.dryRun,\n  });\n\n  if (parsed.dryRun || parsed.json) {\n    console.log(JSON.stringify(plan, null, 2));\n    return 0;\n  }\n\n  console.log(`Content folder source: ${plan.rootPath}`);\n  console.log(`Manifest: ${plan.manifestPath}`);\n  console.log(`Opening: ${plan.url}`);\n\n  if (parsed.open) {\n    setTimeout(() => openBrowser(plan.url), 1000).unref();\n  }\n\n  const child = spawn(plan.command, plan.args, {\n    cwd: plan.workspaceRoot,\n    stdio: \"inherit\",\n    shell: process.platform === \"win32\",\n    env: { ...process.env, ...plan.env },\n  });\n\n  return await new Promise<number>((resolve) => {\n    child.on(\"exit\", (code) => resolve(code ?? 0));\n    child.on(\"error\", (error) => {\n      console.error(error.message);\n      resolve(1);\n    });\n    for (const signal of [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const) {\n      process.on(signal, () => {\n        child.kill(signal);\n        resolve(1);\n      });\n    }\n  });\n}\n"]}

package/dist/cli/index.js

@@ -975,8 +975,8 @@ Usage:
                                 --with-github-action also writes the PR Visual
                                 Recap workflow into .github/workflows/.
   agent-native content local-files <file-or-folder>
-                                Launch Content in local-file mode for a local
-                                docs/content folder. Use --no-open, --port N,
+                                Connect a local docs/content folder to normal
+                                database-backed Content. Use --no-open, --port N,
                                 or --profile docs/no-bookkeeping as needed.
   agent-native design connect  Start a localhost Design bridge for a running
                                 dev server. Use --url, --port, --root, or