@agent-native/core 0.79.26 → 0.79.27

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

@@ -0,0 +1,31 @@
+export interface ContentLocalArgs {
+    target?: string;
+    open: boolean;
+    port: number;
+    profile?: string;
+    dryRun: boolean;
+    json: boolean;
+    help: boolean;
+}
+export interface ContentLocalLaunchPlan {
+    workspaceRoot: string;
+    manifestPath: string;
+    rootPath: string;
+    filePath?: string;
+    url: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    manifest: Record<string, unknown>;
+}
+export declare function parseContentLocalArgs(argv: string[]): ContentLocalArgs;
+export declare function findContentTemplateDir(cwd?: string): string;
+export declare function prepareContentLocalLaunch(options: {
+    target: string;
+    cwd?: string;
+    port?: number;
+    profile?: string;
+    dryRun?: boolean;
+}): Promise<ContentLocalLaunchPlan>;
+export declare function runContentLocal(argv: string[]): Promise<number>;
+//# sourceMappingURL=content-local.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/content-local.js

@@ -0,0 +1,300 @@
+import { spawn } from "node:child_process";
+import fsSync from "node:fs";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+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:";
+function normalizeSlash(value) {
+    return value.replace(/\\/g, "/");
+}
+function titleFromPath(value) {
+    return (path
+        .basename(value)
+        .replace(/\.(mdx?|markdown)$/i, "")
+        .replace(/[-_]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (char) => char.toUpperCase()) || "Content");
+}
+function encodeLocalFileId(filePath) {
+    return `${LOCAL_FILE_ID_PREFIX}${Buffer.from(filePath, "utf8").toString("base64url")}`;
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function stringFlagValue(argv, index, flag) {
+    const value = argv[index + 1];
+    if (!value || value.startsWith("-")) {
+        throw new Error(`${flag} requires a value`);
+    }
+    return value;
+}
+export function parseContentLocalArgs(argv) {
+    const args = argv[0] === "local-files" ? argv.slice(1) : argv;
+    const parsed = {
+        open: true,
+        port: DEFAULT_PORT,
+        dryRun: false,
+        json: false,
+        help: false,
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "help" || arg === "--help" || arg === "-h") {
+            parsed.help = true;
+        }
+        else if (arg === "--open") {
+            parsed.open = true;
+        }
+        else if (arg === "--no-open") {
+            parsed.open = false;
+        }
+        else if (arg === "--dry-run") {
+            parsed.dryRun = true;
+        }
+        else if (arg === "--json") {
+            parsed.json = true;
+        }
+        else if (arg === "--port") {
+            parsed.port = Number.parseInt(stringFlagValue(args, index, arg), 10);
+            index += 1;
+        }
+        else if (arg.startsWith("--port=")) {
+            parsed.port = Number.parseInt(arg.slice("--port=".length), 10);
+        }
+        else if (arg === "--profile") {
+            parsed.profile = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--profile=")) {
+            parsed.profile = arg.slice("--profile=".length);
+        }
+        else if (arg.startsWith("-")) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        else if (!parsed.target) {
+            parsed.target = arg;
+        }
+        else {
+            throw new Error(`Unexpected argument: ${arg}`);
+        }
+    }
+    if (!Number.isInteger(parsed.port) || parsed.port <= 0) {
+        throw new Error("--port must be a positive integer");
+    }
+    return parsed;
+}
+function resolveTarget(target, cwd) {
+    const absoluteTarget = path.resolve(cwd, target);
+    const stat = fsSync.statSync(absoluteTarget);
+    const targetDirectory = stat.isDirectory()
+        ? absoluteTarget
+        : path.dirname(absoluteTarget);
+    let workspaceRoot = path.resolve(cwd);
+    let rootPath = normalizeSlash(path.relative(workspaceRoot, targetDirectory));
+    if (!rootPath || rootPath === "." || rootPath.startsWith("../")) {
+        workspaceRoot = path.dirname(targetDirectory);
+        rootPath = path.basename(targetDirectory);
+    }
+    const filePath = stat.isFile()
+        ? normalizeSlash(path.posix.join(rootPath, path.basename(absoluteTarget)))
+        : undefined;
+    return {
+        absoluteTarget,
+        isFile: stat.isFile(),
+        workspaceRoot,
+        rootPath: normalizeSlash(rootPath),
+        filePath,
+    };
+}
+async function readManifest(manifestPath) {
+    try {
+        const raw = await fs.readFile(manifestPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!isRecord(parsed)) {
+            throw new Error(`${MANIFEST_FILE} must contain a JSON object`);
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { version: 1 };
+        }
+        throw error;
+    }
+}
+function upsertContentManifest(manifest, rootPath, options) {
+    const next = {
+        ...manifest,
+        version: manifest.version ?? 1,
+    };
+    const apps = isRecord(next.apps) ? { ...next.apps } : {};
+    const existingContent = isRecord(apps[CONTENT_APP_ID])
+        ? { ...apps[CONTENT_APP_ID] }
+        : {};
+    const existingRoots = Array.isArray(existingContent.roots)
+        ? existingContent.roots.filter(isRecord).map((root) => ({ ...root }))
+        : [];
+    const include = options.filePath ? [options.filePath] : undefined;
+    const rootIndex = existingRoots.findIndex((entry) => entry.path === rootPath);
+    const existingRoot = rootIndex === -1 ? undefined : existingRoots[rootIndex];
+    const profile = options.profile && !existingRoot?.profile ? options.profile : undefined;
+    const root = {
+        ...existingRoot,
+        name: typeof existingRoot?.name === "string"
+            ? existingRoot.name
+            : titleFromPath(rootPath),
+        path: rootPath,
+        kind: typeof existingRoot?.kind === "string" ? existingRoot.kind : "docs",
+        extensions: Array.isArray(existingRoot?.extensions)
+            ? existingRoot.extensions
+            : [".md", ".mdx"],
+        ...(profile ? { profile } : {}),
+        ...(include && rootIndex === -1 ? { include } : {}),
+    };
+    const roots = rootIndex === -1
+        ? [...existingRoots, root]
+        : existingRoots.map((entry, index) => index === rootIndex ? { ...entry, ...root } : entry);
+    apps[CONTENT_APP_ID] = {
+        ...existingContent,
+        mode: "local-files",
+        roots,
+        hide: Array.isArray(existingContent.hide)
+            ? existingContent.hide
+            : ["**/_*.md", "**/_*.mdx"],
+    };
+    next.apps = apps;
+    return next;
+}
+export function findContentTemplateDir(cwd = process.cwd()) {
+    const cliDir = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [];
+    let current = path.resolve(cwd);
+    for (;;) {
+        candidates.push(path.join(current, "templates", "content"), path.join(current, "apps", "content"));
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    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;
+}
+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, {
+        filePath: target.filePath,
+        profile: options.profile,
+    });
+    const templateDir = findContentTemplateDir(cwd);
+    if (!templateDir) {
+        throw new Error("Could not find the Content app template. Run this from the framework checkout or a workspace that includes templates/content.");
+    }
+    if (!options.dryRun) {
+        await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    }
+    return {
+        workspaceRoot: target.workspaceRoot,
+        manifestPath,
+        rootPath: target.rootPath,
+        filePath: target.filePath,
+        url: launchUrl(options.port ?? DEFAULT_PORT, target.filePath),
+        command: "corepack",
+        args: [
+            "pnpm",
+            "--dir",
+            templateDir,
+            "dev",
+            "--host",
+            "127.0.0.1",
+            "--port",
+            String(options.port ?? DEFAULT_PORT),
+            "--strictPort",
+        ],
+        env: {
+            AGENT_NATIVE_MODE: "local-files",
+            AGENT_NATIVE_MANIFEST_PATH: manifestPath,
+        },
+        manifest,
+    };
+}
+function openBrowser(url) {
+    const command = process.platform === "darwin"
+        ? "open"
+        : process.platform === "win32"
+            ? "cmd"
+            : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    const child = spawn(command, args, {
+        detached: true,
+        stdio: "ignore",
+        shell: false,
+    });
+    child.unref();
+}
+function printHelp() {
+    console.log(`Usage:
+  agent-native content local-files <file-or-folder> [options]
+  agent-native content <file-or-folder> [options]
+
+Options:
+  --profile <name>   Local file 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
+  --dry-run          Print the launch plan without writing ${MANIFEST_FILE}
+  --json             Print the launch plan as JSON`);
+}
+export async function runContentLocal(argv) {
+    const parsed = parseContentLocalArgs(argv);
+    if (parsed.help || !parsed.target) {
+        printHelp();
+        return parsed.target ? 0 : 1;
+    }
+    const plan = await prepareContentLocalLaunch({
+        target: parsed.target,
+        port: parsed.port,
+        profile: parsed.profile ?? DEFAULT_PROFILE,
+        dryRun: parsed.dryRun,
+    });
+    if (parsed.dryRun || parsed.json) {
+        console.log(JSON.stringify(plan, null, 2));
+        return 0;
+    }
+    console.log(`Content local files: ${plan.rootPath}`);
+    console.log(`Manifest: ${plan.manifestPath}`);
+    console.log(`Opening: ${plan.url}`);
+    if (parsed.open) {
+        setTimeout(() => openBrowser(plan.url), 1000).unref();
+    }
+    const child = spawn(plan.command, plan.args, {
+        cwd: plan.workspaceRoot,
+        stdio: "inherit",
+        shell: process.platform === "win32",
+        env: { ...process.env, ...plan.env },
+    });
+    return await new Promise((resolve) => {
+        child.on("exit", (code) => resolve(code ?? 0));
+        child.on("error", (error) => {
+            console.error(error.message);
+            resolve(1);
+        });
+        for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+            process.on(signal, () => {
+                child.kill(signal);
+                resolve(1);
+            });
+        }
+    });
+}
+//# sourceMappingURL=content-local.js.map

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

@@ -0,0 +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"]}

package/dist/cli/index.js

@@ -639,6 +639,18 @@ switch (command) {
         });
         break;
     }
+    case "content": {
+        import("./content-local.js")
+            .then(async (m) => {
+            const code = await m.runContentLocal(args);
+            process.exit(code);
+        })
+            .catch((err) => {
+            console.error(err?.message ?? err);
+            process.exit(1);
+        });
+        break;
+    }
     case "recap": {
         // PR visual recap helpers used by the GitHub Action. Promoted to the CLI
         // so an installed repo's workflow can call `agent-native recap …` instead
@@ -806,6 +818,10 @@ Usage:
                                 non-interactive shells print the connect command.
                                 --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,
+                                or --profile docs/no-bookkeeping as needed.
   agent-native recap <cmd>      PR visual recap setup and GitHub Action helpers.
                                 Run 'agent-native recap help' for subcommands.
   agent-native plan <cmd>       Plan helpers for block catalogs and local files.