@agent-native/core 0.52.0 → 0.54.0

package/dist/cli/add.js

@@ -0,0 +1,352 @@
+/**
+ * `agent-native add <kind> [name|url]` — the **blueprint installer**.
+ *
+ * Borrowed from Flue's `flue add`: instead of being a dumb scaffolder that
+ * writes files for you, this command emits a curated Markdown *integration
+ * blueprint* to stdout. You pipe that blueprint into your own coding agent,
+ * which applies the changes against the live repo:
+ *
+ *   agent-native add provider stripe | claude
+ *   agent-native add channel discord  | codex
+ *
+ * This fits the agent-applies-changes, filesystem-first house style: the
+ * framework supplies the recipe (the canonical files to touch, the rules to
+ * honor, the verification step), and the coding agent does the editing with
+ * full repo context.
+ *
+ * A bare name resolves a curated blueprint from `blueprints/<kind>/<name>.md`.
+ * A URL instead of a name emits a GENERIC "research-and-integrate" blueprint
+ * for that kind with the URL embedded as the research starting point (mirrors
+ * Flue: a URL is a research seed, not a known recipe).
+ *
+ * Blueprint `.md` files ship in the published package via the `blueprints`
+ * entry in `package.json` `files`, so they live at
+ * `node_modules/@agent-native/core/blueprints/**` at runtime. Resolution works
+ * both from source (tsx: `src/cli` → `../../blueprints`) and from the compiled
+ * package (`dist/cli` → `../../blueprints`), with an upward-walk fallback.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Locate the directory that holds the blueprint `.md` recipes.
+ *
+ * Both `src/cli` (tsx/source) and `dist/cli` (published) sit two levels under
+ * the package root, where `blueprints/` lives, so `../../blueprints` from this
+ * module's directory is the primary path. We additionally walk upward looking
+ * for a `blueprints` directory as a resilience fallback (e.g. unusual bundler
+ * layouts). An explicit override is honored for tests.
+ */
+export function resolveBlueprintsRoot(overrideRoot) {
+    if (overrideRoot)
+        return overrideRoot;
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const primary = path.resolve(here, "../../blueprints");
+    if (isDir(primary))
+        return primary;
+    // Fallback: walk up from this module looking for a sibling `blueprints` dir.
+    let dir = here;
+    for (let i = 0; i < 8; i += 1) {
+        const candidate = path.join(dir, "blueprints");
+        if (isDir(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Return the primary path even if missing so error messages are concrete.
+    return primary;
+}
+function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** True for an argument that should be treated as a research URL, not a name. */
+export function looksLikeUrl(value) {
+    return /^https?:\/\//i.test(value.trim());
+}
+/** List the blueprint kinds (subdirectories) available, sorted. */
+export function listKinds(root) {
+    if (!isDir(root))
+        return [];
+    return fs
+        .readdirSync(root, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .sort();
+}
+/** List the blueprint names available under a kind, sorted (no `.md`). */
+export function listBlueprintNames(root, kind) {
+    const dir = path.join(root, kind);
+    if (!isDir(dir))
+        return [];
+    return fs
+        .readdirSync(dir, { withFileTypes: true })
+        .filter((e) => e.isFile() && e.name.endsWith(".md"))
+        .map((e) => e.name.slice(0, -".md".length))
+        .sort();
+}
+/** A flat catalog of every kind and its blueprint names. */
+export function listCatalog(root) {
+    return listKinds(root).map((kind) => ({
+        kind,
+        names: listBlueprintNames(root, kind),
+    }));
+}
+/** Render the `--list` / no-args catalog text. */
+export function formatCatalog(root) {
+    const catalog = listCatalog(root);
+    const lines = [];
+    lines.push("Available blueprints:");
+    lines.push("");
+    if (catalog.length === 0) {
+        lines.push("  (none found)");
+    }
+    else {
+        for (const { kind, names } of catalog) {
+            const shown = names.length > 0 ? names.join(", ") : "(generic — pass a URL)";
+            lines.push(`  ${kind.padEnd(10)} ${shown}`);
+        }
+    }
+    lines.push("");
+    lines.push("Usage:");
+    lines.push("  agent-native add <kind> <name>            Print a curated blueprint");
+    lines.push("  agent-native add <kind> <https://docs…>   Research-and-integrate from a URL");
+    lines.push("  agent-native add --list                   Show this list");
+    lines.push("");
+    lines.push("Pipe a blueprint into your coding agent to apply it:");
+    lines.push("  agent-native add provider stripe | claude");
+    lines.push("  agent-native add channel discord | codex");
+    return lines.join("\n");
+}
+/**
+ * Build the generic "research-and-integrate" blueprint emitted when the user
+ * passes a URL instead of a known blueprint name. Mirrors Flue: a URL is a
+ * research seed. We keep this self-contained — the coding agent reading it has
+ * no other context.
+ */
+export function buildGenericUrlBlueprint(kind, url) {
+    const kindGuidance = GENERIC_KIND_GUIDANCE[kind] ?? GENERIC_DEFAULT_GUIDANCE;
+    return `# Blueprint: integrate a new ${kind} from a URL
+
+You are a coding agent working inside an **agent-native** app (a repo built on
+\`@agent-native/core\`). Apply this blueprint as real source changes on the
+current branch. Do not just describe the work — research, implement, then verify.
+
+## Research seed
+
+Start from this URL and follow it for the API/protocol/contract you need:
+
+  ${url}
+
+Fetch it (and the pages it links to) to learn the real endpoints, auth model,
+payload shapes, and any signature/verification requirements. Do not guess from
+training data — the docs are the source of truth, and package/API versions
+drift. Confirm the current version before writing code.
+
+## What you're adding
+
+A new **${kind}** integration. ${kindGuidance}
+
+## How agent-native wants it built
+
+- **Actions are the single source of truth.** Add app operations in \`actions/\`
+  with \`defineAction\` (Zod schema). The agent calls them as tools; the frontend
+  calls the same action through \`useActionQuery\` / \`useActionMutation\`. Do NOT
+  add \`/api/*\` or Nitro pass-through routes that just wrap an action.
+- **Prefer the provider-api substrate for external HTTP.** For ad-hoc reads
+  against a third-party API, register the provider with
+  \`@agent-native/core/provider-api\` and expose the
+  \`provider-api-catalog\` / \`provider-api-docs\` / \`provider-api-request\` trio
+  instead of one rigid action per endpoint. First-class actions are shortcuts,
+  not capability limits.
+- **Read the relevant skill before editing** — \`actions\`,
+  \`integration-webhooks\`, \`secrets\`, \`onboarding\`, \`sharing\`, \`security\` —
+  for the area you're touching.
+- **Never hardcode secrets.** Read API keys / tokens / signing secrets from the
+  secret store (\`readAppSecret\`, the provider credential adapter, OAuth token
+  helpers) at call time. Use obviously-fake placeholders in any example
+  (e.g. \`sk_test_PLACEHOLDER_xxx\`), never a real credential.
+- **Scope ownable data.** Tables with \`ownableColumns()\` require
+  \`accessFilter\` / \`resolveAccess\` / \`assertAccess\`; fail closed.
+- **Changeset.** If you edit a publishable package's source
+  (\`packages/core\`, \`packages/dispatch\`, \`packages/scheduling\`,
+  \`packages/pinpoint\`), add a \`.changeset/*.md\`.
+
+## Verify
+
+1. \`agent-native typecheck\` (or \`tsc --noEmit\`) passes.
+2. Add a focused \`*.spec.ts\` for the new surface and run it.
+3. Exercise the real workflow end to end: invoke the new action from the agent
+   chat (and the UI if applicable), and confirm the external call round-trips
+   with credentials injected and secrets redacted.
+`;
+}
+const GENERIC_DEFAULT_GUIDANCE = "Identify whether it is best modeled as an action, a provider-api integration, " +
+    "an inbound channel adapter, or a sandbox backend, and follow that area's skill.";
+const GENERIC_KIND_GUIDANCE = {
+    provider: "Wire it into the provider-api substrate (`@agent-native/core/provider-api`): " +
+        "register the base URL, auth style, credential key, and docs URLs, then expose " +
+        "the `provider-api-catalog` / `provider-api-docs` / `provider-api-request` trio " +
+        "so any endpoint is reachable without one action per endpoint.",
+    channel: "Implement a `PlatformAdapter` (see " +
+        "`packages/core/src/integrations/types.ts` and the adapters under " +
+        "`packages/core/src/integrations/adapters/`) and register it in " +
+        "`getDefaultAdapters()` in `packages/core/src/integrations/plugin.ts`. " +
+        "Enqueue to SQL and return 200 fast; run the agent loop in the separate " +
+        "`_process-task` execution. Read the `integration-webhooks` skill.",
+    sandbox: "Implement the `SandboxAdapter` seam in " +
+        "`packages/core/src/coding-tools/sandbox/` (mirror " +
+        "`local-child-process-adapter.ts`) and select it via `AGENT_NATIVE_SANDBOX` " +
+        "or `registerSandboxAdapter()`. The adapter only runs the already-prepared, " +
+        "non-secret module source — it never sees app secrets.",
+    action: "Add a single multi-surface `defineAction` in `actions/` with a Zod schema. " +
+        "Keep the surface small and orthogonal (one CRUD-style `update` over N " +
+        "per-field actions). Read the `actions` skill.",
+};
+/**
+ * Resolve a blueprint for a `kind` + optional `name`/`url`.
+ *
+ * - A known name → the curated `blueprints/<kind>/<name>.md`.
+ * - A URL → the generic research-and-integrate blueprint for the kind.
+ * - Unknown name → throws `AddResolutionError` listing what's available.
+ */
+export function resolveBlueprint(opts) {
+    const { kind, nameOrUrl, root } = opts;
+    const kinds = listKinds(root);
+    if (!kinds.includes(kind)) {
+        throw new AddResolutionError(`Unknown blueprint kind: ${kind}\n\n${formatCatalog(root)}`);
+    }
+    // A URL seed → generic blueprint for the kind.
+    if (nameOrUrl && looksLikeUrl(nameOrUrl)) {
+        return {
+            markdown: buildGenericUrlBlueprint(kind, nameOrUrl.trim()),
+            source: {
+                kind: "generic-url",
+                blueprintKind: kind,
+                url: nameOrUrl.trim(),
+            },
+        };
+    }
+    const names = listBlueprintNames(root, kind);
+    // No name given: if exactly one curated blueprint exists, use it; otherwise
+    // ask the user to pick one (or pass a URL for the generic path).
+    if (!nameOrUrl) {
+        if (names.length === 1) {
+            return loadCurated(root, kind, names[0]);
+        }
+        throw new AddResolutionError(`Specify a ${kind} blueprint name or a URL.\n` +
+            `  Available ${kind} blueprints: ${names.length ? names.join(", ") : "(none — pass a URL)"}\n` +
+            `  Or research from a URL: agent-native add ${kind} https://…`);
+    }
+    if (!names.includes(nameOrUrl)) {
+        throw new AddResolutionError(`Unknown ${kind} blueprint: ${nameOrUrl}\n` +
+            `  Available ${kind} blueprints: ${names.length ? names.join(", ") : "(none)"}\n` +
+            `  Or research from a URL: agent-native add ${kind} https://…`);
+    }
+    return loadCurated(root, kind, nameOrUrl);
+}
+function loadCurated(root, kind, name) {
+    const filePath = path.join(root, kind, `${name}.md`);
+    const markdown = fs.readFileSync(filePath, "utf-8");
+    return {
+        markdown,
+        source: { kind: "curated", blueprintKind: kind, name, path: filePath },
+    };
+}
+/** Thrown for an unknown kind/name; the CLI prints the message and exits 1. */
+export class AddResolutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AddResolutionError";
+    }
+}
+export function parseAddArgs(argv) {
+    const out = {
+        list: false,
+        help: false,
+        print: false,
+        positionals: [],
+    };
+    for (const arg of argv) {
+        if (arg === "--")
+            continue;
+        if (arg === "--list" || arg === "-l")
+            out.list = true;
+        else if (arg === "--help" || arg === "-h")
+            out.help = true;
+        else if (arg === "--print" || arg === "-p")
+            out.print = true;
+        else if (arg.startsWith("-")) {
+            // Ignore unknown flags rather than misparse them as a name.
+            continue;
+        }
+        else
+            out.positionals.push(arg);
+    }
+    return out;
+}
+const HELP = `agent-native add — emit an integration blueprint for your coding agent.
+
+Instead of scaffolding files, \`add\` prints a curated Markdown recipe to stdout.
+Pipe it into a coding agent (Claude Code, Codex, …) and it applies the changes
+against your live repo, the agent-native way.
+
+Usage:
+  agent-native add <kind> <name>            Print a curated blueprint
+  agent-native add <kind> <https://docs…>   Research-and-integrate from a URL
+  agent-native add --list                   List available kinds and blueprints
+
+Examples:
+  agent-native add provider stripe | claude
+  agent-native add channel discord | codex
+  agent-native add sandbox docker
+  agent-native add action crud
+  agent-native add provider https://docs.example.com/api | claude
+
+Options:
+  -l, --list     List available blueprint kinds and names
+  -p, --print    Print the blueprint to stdout (the default; explicit no-op)
+  -h, --help     Show this help`;
+/**
+ * CLI entry point. Returns the process exit code so the dispatcher / tests can
+ * assert on it. Writes the blueprint Markdown to stdout and diagnostics to
+ * stderr so `... | claude` only receives the blueprint.
+ */
+export function runAdd(argv, io = {}) {
+    const out = io.out ?? ((s) => process.stdout.write(s));
+    const err = io.err ?? ((s) => process.stderr.write(s));
+    const root = resolveBlueprintsRoot(io.root);
+    const parsed = parseAddArgs(argv);
+    if (parsed.help) {
+        out(HELP + "\n");
+        return 0;
+    }
+    // `--list` or no positionals → show the catalog (to stdout; this is the
+    // requested output, not an error).
+    if (parsed.list || parsed.positionals.length === 0) {
+        out(formatCatalog(root) + "\n");
+        return 0;
+    }
+    const [kind, nameOrUrl] = parsed.positionals;
+    try {
+        const resolved = resolveBlueprint({ kind, nameOrUrl, root });
+        out(resolved.markdown.endsWith("\n")
+            ? resolved.markdown
+            : resolved.markdown + "\n");
+        return 0;
+    }
+    catch (e) {
+        if (e instanceof AddResolutionError) {
+            err(e.message + "\n");
+            return 1;
+        }
+        throw e;
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/cli/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/cli/add.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `agent-native add <kind> [name|url]` — the **blueprint installer**.\n *\n * Borrowed from Flue's `flue add`: instead of being a dumb scaffolder that\n * writes files for you, this command emits a curated Markdown *integration\n * blueprint* to stdout. You pipe that blueprint into your own coding agent,\n * which applies the changes against the live repo:\n *\n *   agent-native add provider stripe | claude\n *   agent-native add channel discord  | codex\n *\n * This fits the agent-applies-changes, filesystem-first house style: the\n * framework supplies the recipe (the canonical files to touch, the rules to\n * honor, the verification step), and the coding agent does the editing with\n * full repo context.\n *\n * A bare name resolves a curated blueprint from `blueprints/<kind>/<name>.md`.\n * A URL instead of a name emits a GENERIC \"research-and-integrate\" blueprint\n * for that kind with the URL embedded as the research starting point (mirrors\n * Flue: a URL is a research seed, not a known recipe).\n *\n * Blueprint `.md` files ship in the published package via the `blueprints`\n * entry in `package.json` `files`, so they live at\n * `node_modules/@agent-native/core/blueprints/**` at runtime. Resolution works\n * both from source (tsx: `src/cli` → `../../blueprints`) and from the compiled\n * package (`dist/cli` → `../../blueprints`), with an upward-walk fallback.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/** A coarse classification of what `add` resolved for a given invocation. */\nexport type AddBlueprintSource =\n  | { kind: \"curated\"; blueprintKind: string; name: string; path: string }\n  | { kind: \"generic-url\"; blueprintKind: string; url: string };\n\nexport interface ResolvedBlueprint {\n  /** The Markdown to print to stdout (piped into a coding agent). */\n  markdown: string;\n  source: AddBlueprintSource;\n}\n\n/**\n * Locate the directory that holds the blueprint `.md` recipes.\n *\n * Both `src/cli` (tsx/source) and `dist/cli` (published) sit two levels under\n * the package root, where `blueprints/` lives, so `../../blueprints` from this\n * module's directory is the primary path. We additionally walk upward looking\n * for a `blueprints` directory as a resilience fallback (e.g. unusual bundler\n * layouts). An explicit override is honored for tests.\n */\nexport function resolveBlueprintsRoot(overrideRoot?: string): string {\n  if (overrideRoot) return overrideRoot;\n\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  const primary = path.resolve(here, \"../../blueprints\");\n  if (isDir(primary)) return primary;\n\n  // Fallback: walk up from this module looking for a sibling `blueprints` dir.\n  let dir = here;\n  for (let i = 0; i < 8; i += 1) {\n    const candidate = path.join(dir, \"blueprints\");\n    if (isDir(candidate)) return candidate;\n    const parent = path.dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  // Return the primary path even if missing so error messages are concrete.\n  return primary;\n}\n\nfunction isDir(p: string): boolean {\n  try {\n    return fs.statSync(p).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/** True for an argument that should be treated as a research URL, not a name. */\nexport function looksLikeUrl(value: string): boolean {\n  return /^https?:\\/\\//i.test(value.trim());\n}\n\n/** List the blueprint kinds (subdirectories) available, sorted. */\nexport function listKinds(root: string): string[] {\n  if (!isDir(root)) return [];\n  return fs\n    .readdirSync(root, { withFileTypes: true })\n    .filter((e) => e.isDirectory())\n    .map((e) => e.name)\n    .sort();\n}\n\n/** List the blueprint names available under a kind, sorted (no `.md`). */\nexport function listBlueprintNames(root: string, kind: string): string[] {\n  const dir = path.join(root, kind);\n  if (!isDir(dir)) return [];\n  return fs\n    .readdirSync(dir, { withFileTypes: true })\n    .filter((e) => e.isFile() && e.name.endsWith(\".md\"))\n    .map((e) => e.name.slice(0, -\".md\".length))\n    .sort();\n}\n\n/** A flat catalog of every kind and its blueprint names. */\nexport function listCatalog(root: string): Array<{\n  kind: string;\n  names: string[];\n}> {\n  return listKinds(root).map((kind) => ({\n    kind,\n    names: listBlueprintNames(root, kind),\n  }));\n}\n\n/** Render the `--list` / no-args catalog text. */\nexport function formatCatalog(root: string): string {\n  const catalog = listCatalog(root);\n  const lines: string[] = [];\n  lines.push(\"Available blueprints:\");\n  lines.push(\"\");\n  if (catalog.length === 0) {\n    lines.push(\"  (none found)\");\n  } else {\n    for (const { kind, names } of catalog) {\n      const shown =\n        names.length > 0 ? names.join(\", \") : \"(generic — pass a URL)\";\n      lines.push(`  ${kind.padEnd(10)} ${shown}`);\n    }\n  }\n  lines.push(\"\");\n  lines.push(\"Usage:\");\n  lines.push(\n    \"  agent-native add <kind> <name>            Print a curated blueprint\",\n  );\n  lines.push(\n    \"  agent-native add <kind> <https://docs…>   Research-and-integrate from a URL\",\n  );\n  lines.push(\"  agent-native add --list                   Show this list\");\n  lines.push(\"\");\n  lines.push(\"Pipe a blueprint into your coding agent to apply it:\");\n  lines.push(\"  agent-native add provider stripe | claude\");\n  lines.push(\"  agent-native add channel discord | codex\");\n  return lines.join(\"\\n\");\n}\n\n/**\n * Build the generic \"research-and-integrate\" blueprint emitted when the user\n * passes a URL instead of a known blueprint name. Mirrors Flue: a URL is a\n * research seed. We keep this self-contained — the coding agent reading it has\n * no other context.\n */\nexport function buildGenericUrlBlueprint(kind: string, url: string): string {\n  const kindGuidance = GENERIC_KIND_GUIDANCE[kind] ?? GENERIC_DEFAULT_GUIDANCE;\n  return `# Blueprint: integrate a new ${kind} from a URL\n\nYou are a coding agent working inside an **agent-native** app (a repo built on\n\\`@agent-native/core\\`). Apply this blueprint as real source changes on the\ncurrent branch. Do not just describe the work — research, implement, then verify.\n\n## Research seed\n\nStart from this URL and follow it for the API/protocol/contract you need:\n\n  ${url}\n\nFetch it (and the pages it links to) to learn the real endpoints, auth model,\npayload shapes, and any signature/verification requirements. Do not guess from\ntraining data — the docs are the source of truth, and package/API versions\ndrift. Confirm the current version before writing code.\n\n## What you're adding\n\nA new **${kind}** integration. ${kindGuidance}\n\n## How agent-native wants it built\n\n- **Actions are the single source of truth.** Add app operations in \\`actions/\\`\n  with \\`defineAction\\` (Zod schema). The agent calls them as tools; the frontend\n  calls the same action through \\`useActionQuery\\` / \\`useActionMutation\\`. Do NOT\n  add \\`/api/*\\` or Nitro pass-through routes that just wrap an action.\n- **Prefer the provider-api substrate for external HTTP.** For ad-hoc reads\n  against a third-party API, register the provider with\n  \\`@agent-native/core/provider-api\\` and expose the\n  \\`provider-api-catalog\\` / \\`provider-api-docs\\` / \\`provider-api-request\\` trio\n  instead of one rigid action per endpoint. First-class actions are shortcuts,\n  not capability limits.\n- **Read the relevant skill before editing** — \\`actions\\`,\n  \\`integration-webhooks\\`, \\`secrets\\`, \\`onboarding\\`, \\`sharing\\`, \\`security\\` —\n  for the area you're touching.\n- **Never hardcode secrets.** Read API keys / tokens / signing secrets from the\n  secret store (\\`readAppSecret\\`, the provider credential adapter, OAuth token\n  helpers) at call time. Use obviously-fake placeholders in any example\n  (e.g. \\`sk_test_PLACEHOLDER_xxx\\`), never a real credential.\n- **Scope ownable data.** Tables with \\`ownableColumns()\\` require\n  \\`accessFilter\\` / \\`resolveAccess\\` / \\`assertAccess\\`; fail closed.\n- **Changeset.** If you edit a publishable package's source\n  (\\`packages/core\\`, \\`packages/dispatch\\`, \\`packages/scheduling\\`,\n  \\`packages/pinpoint\\`), add a \\`.changeset/*.md\\`.\n\n## Verify\n\n1. \\`agent-native typecheck\\` (or \\`tsc --noEmit\\`) passes.\n2. Add a focused \\`*.spec.ts\\` for the new surface and run it.\n3. Exercise the real workflow end to end: invoke the new action from the agent\n   chat (and the UI if applicable), and confirm the external call round-trips\n   with credentials injected and secrets redacted.\n`;\n}\n\nconst GENERIC_DEFAULT_GUIDANCE =\n  \"Identify whether it is best modeled as an action, a provider-api integration, \" +\n  \"an inbound channel adapter, or a sandbox backend, and follow that area's skill.\";\n\nconst GENERIC_KIND_GUIDANCE: Record<string, string> = {\n  provider:\n    \"Wire it into the provider-api substrate (`@agent-native/core/provider-api`): \" +\n    \"register the base URL, auth style, credential key, and docs URLs, then expose \" +\n    \"the `provider-api-catalog` / `provider-api-docs` / `provider-api-request` trio \" +\n    \"so any endpoint is reachable without one action per endpoint.\",\n  channel:\n    \"Implement a `PlatformAdapter` (see \" +\n    \"`packages/core/src/integrations/types.ts` and the adapters under \" +\n    \"`packages/core/src/integrations/adapters/`) and register it in \" +\n    \"`getDefaultAdapters()` in `packages/core/src/integrations/plugin.ts`. \" +\n    \"Enqueue to SQL and return 200 fast; run the agent loop in the separate \" +\n    \"`_process-task` execution. Read the `integration-webhooks` skill.\",\n  sandbox:\n    \"Implement the `SandboxAdapter` seam in \" +\n    \"`packages/core/src/coding-tools/sandbox/` (mirror \" +\n    \"`local-child-process-adapter.ts`) and select it via `AGENT_NATIVE_SANDBOX` \" +\n    \"or `registerSandboxAdapter()`. The adapter only runs the already-prepared, \" +\n    \"non-secret module source — it never sees app secrets.\",\n  action:\n    \"Add a single multi-surface `defineAction` in `actions/` with a Zod schema. \" +\n    \"Keep the surface small and orthogonal (one CRUD-style `update` over N \" +\n    \"per-field actions). Read the `actions` skill.\",\n};\n\n/**\n * Resolve a blueprint for a `kind` + optional `name`/`url`.\n *\n * - A known name → the curated `blueprints/<kind>/<name>.md`.\n * - A URL → the generic research-and-integrate blueprint for the kind.\n * - Unknown name → throws `AddResolutionError` listing what's available.\n */\nexport function resolveBlueprint(opts: {\n  kind: string;\n  nameOrUrl?: string;\n  root: string;\n}): ResolvedBlueprint {\n  const { kind, nameOrUrl, root } = opts;\n  const kinds = listKinds(root);\n\n  if (!kinds.includes(kind)) {\n    throw new AddResolutionError(\n      `Unknown blueprint kind: ${kind}\\n\\n${formatCatalog(root)}`,\n    );\n  }\n\n  // A URL seed → generic blueprint for the kind.\n  if (nameOrUrl && looksLikeUrl(nameOrUrl)) {\n    return {\n      markdown: buildGenericUrlBlueprint(kind, nameOrUrl.trim()),\n      source: {\n        kind: \"generic-url\",\n        blueprintKind: kind,\n        url: nameOrUrl.trim(),\n      },\n    };\n  }\n\n  const names = listBlueprintNames(root, kind);\n\n  // No name given: if exactly one curated blueprint exists, use it; otherwise\n  // ask the user to pick one (or pass a URL for the generic path).\n  if (!nameOrUrl) {\n    if (names.length === 1) {\n      return loadCurated(root, kind, names[0]);\n    }\n    throw new AddResolutionError(\n      `Specify a ${kind} blueprint name or a URL.\\n` +\n        `  Available ${kind} blueprints: ${\n          names.length ? names.join(\", \") : \"(none — pass a URL)\"\n        }\\n` +\n        `  Or research from a URL: agent-native add ${kind} https://…`,\n    );\n  }\n\n  if (!names.includes(nameOrUrl)) {\n    throw new AddResolutionError(\n      `Unknown ${kind} blueprint: ${nameOrUrl}\\n` +\n        `  Available ${kind} blueprints: ${\n          names.length ? names.join(\", \") : \"(none)\"\n        }\\n` +\n        `  Or research from a URL: agent-native add ${kind} https://…`,\n    );\n  }\n\n  return loadCurated(root, kind, nameOrUrl);\n}\n\nfunction loadCurated(\n  root: string,\n  kind: string,\n  name: string,\n): ResolvedBlueprint {\n  const filePath = path.join(root, kind, `${name}.md`);\n  const markdown = fs.readFileSync(filePath, \"utf-8\");\n  return {\n    markdown,\n    source: { kind: \"curated\", blueprintKind: kind, name, path: filePath },\n  };\n}\n\n/** Thrown for an unknown kind/name; the CLI prints the message and exits 1. */\nexport class AddResolutionError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AddResolutionError\";\n  }\n}\n\ninterface ParsedAddArgs {\n  list: boolean;\n  help: boolean;\n  /** Accepted as an explicit no-op alias for the default print behavior. */\n  print: boolean;\n  positionals: string[];\n}\n\nexport function parseAddArgs(argv: string[]): ParsedAddArgs {\n  const out: ParsedAddArgs = {\n    list: false,\n    help: false,\n    print: false,\n    positionals: [],\n  };\n  for (const arg of argv) {\n    if (arg === \"--\") continue;\n    if (arg === \"--list\" || arg === \"-l\") out.list = true;\n    else if (arg === \"--help\" || arg === \"-h\") out.help = true;\n    else if (arg === \"--print\" || arg === \"-p\") out.print = true;\n    else if (arg.startsWith(\"-\")) {\n      // Ignore unknown flags rather than misparse them as a name.\n      continue;\n    } else out.positionals.push(arg);\n  }\n  return out;\n}\n\nconst HELP = `agent-native add — emit an integration blueprint for your coding agent.\n\nInstead of scaffolding files, \\`add\\` prints a curated Markdown recipe to stdout.\nPipe it into a coding agent (Claude Code, Codex, …) and it applies the changes\nagainst your live repo, the agent-native way.\n\nUsage:\n  agent-native add <kind> <name>            Print a curated blueprint\n  agent-native add <kind> <https://docs…>   Research-and-integrate from a URL\n  agent-native add --list                   List available kinds and blueprints\n\nExamples:\n  agent-native add provider stripe | claude\n  agent-native add channel discord | codex\n  agent-native add sandbox docker\n  agent-native add action crud\n  agent-native add provider https://docs.example.com/api | claude\n\nOptions:\n  -l, --list     List available blueprint kinds and names\n  -p, --print    Print the blueprint to stdout (the default; explicit no-op)\n  -h, --help     Show this help`;\n\n/**\n * CLI entry point. Returns the process exit code so the dispatcher / tests can\n * assert on it. Writes the blueprint Markdown to stdout and diagnostics to\n * stderr so `... | claude` only receives the blueprint.\n */\nexport function runAdd(\n  argv: string[],\n  io: {\n    out?: (s: string) => void;\n    err?: (s: string) => void;\n    root?: string;\n  } = {},\n): number {\n  const out = io.out ?? ((s: string) => process.stdout.write(s));\n  const err = io.err ?? ((s: string) => process.stderr.write(s));\n  const root = resolveBlueprintsRoot(io.root);\n\n  const parsed = parseAddArgs(argv);\n\n  if (parsed.help) {\n    out(HELP + \"\\n\");\n    return 0;\n  }\n\n  // `--list` or no positionals → show the catalog (to stdout; this is the\n  // requested output, not an error).\n  if (parsed.list || parsed.positionals.length === 0) {\n    out(formatCatalog(root) + \"\\n\");\n    return 0;\n  }\n\n  const [kind, nameOrUrl] = parsed.positionals;\n\n  try {\n    const resolved = resolveBlueprint({ kind, nameOrUrl, root });\n    out(\n      resolved.markdown.endsWith(\"\\n\")\n        ? resolved.markdown\n        : resolved.markdown + \"\\n\",\n    );\n    return 0;\n  } catch (e) {\n    if (e instanceof AddResolutionError) {\n      err(e.message + \"\\n\");\n      return 1;\n    }\n    throw e;\n  }\n}\n"]}

package/dist/cli/connect.d.ts

@@ -5,7 +5,7 @@
  * browser device-code flow: open the verification URL, approve in the browser,
  * and the minted HTTP MCP server entry is written idempotently.
  *
- *   agent-native connect <url> [--client all|claude-code|claude-code-cli|
+ *   agent-native connect <url> [--client all|claude-code|
  *                               codex|cowork|cursor|opencode|github-copilot]
  *                               [--scope user|project]
  *                               [--name <serverName>]
@@ -35,7 +35,7 @@ export interface ParsedConnectArgs {
     mode?: "dev" | "prod" | "reauth" | "reconnect";
     /** Positional URL (the deployed app origin). Undefined for `--all`. */
     url?: string;
-    /** all | claude-code | claude-code-cli | codex | cowork | cursor | opencode | github-copilot (default "all"). */
+    /** all | claude-code | codex | cowork | cursor | opencode | github-copilot (default "all"). claude-code-cli is accepted as a legacy alias for claude-code. */
     client: string;
     /** True when the user passed --client explicitly, so we skip the picker. */
     clientExplicit: boolean;

package/dist/cli/connect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/cli/connect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/cli/connect.ts"],"names":[],"mappings":"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"}

package/dist/cli/connect.js

@@ -5,7 +5,7 @@
  * browser device-code flow: open the verification URL, approve in the browser,
  * and the minted HTTP MCP server entry is written idempotently.
  *
- *   agent-native connect <url> [--client all|claude-code|claude-code-cli|
+ *   agent-native connect <url> [--client all|claude-code|
  *                               codex|cowork|cursor|opencode|github-copilot]
  *                               [--scope user|project]
  *                               [--name <serverName>]
@@ -185,11 +185,15 @@ export function normalizeUrl(raw) {
     const base = `${parsed.origin}${parsed.pathname}`.replace(/\/+$/, "");
     return base;
 }
+// Clients offered in the interactive picker and expanded by "all". Excludes
+// the `claude-code-cli` alias so users only ever see a single "Claude Code"
+// option (it still works if passed explicitly via --client).
+const SELECTABLE_CLIENTS = CLIENTS.filter((c) => c !== "claude-code-cli");
 /** Resolve the requested clients list. "all" → every supported client. */
 export function resolveClients(client) {
     const c = normalizeClientAlias(client ?? "all");
     if (c === "all" || c === "")
-        return [...CLIENTS];
+        return [...SELECTABLE_CLIENTS];
     if (c.includes(",")) {
         const clients = normalizeClientIds(c.split(",").map((part) => part.trim()));
         if (clients.length > 0)
@@ -201,7 +205,12 @@ export function resolveClients(client) {
 }
 function normalizeClientAlias(value) {
     const id = value.trim().toLowerCase();
-    if (id === "claude" || id === "claude-code-desktop")
+    // The Claude Code CLI and desktop share ~/.claude.json, so they are one
+    // client. `claude-code-cli` stays accepted for back-compat but collapses to
+    // the single "Claude Code" option everywhere it surfaces.
+    if (id === "claude" ||
+        id === "claude-code-desktop" ||
+        id === "claude-code-cli")
         return "claude-code";
     if (id === "copilot" || id === "vscode" || id === "vs-code") {
         return "github-copilot";
@@ -252,7 +261,7 @@ export function writeConnectClientPreferences(clients, file = connectPreferences
     }, null, 2) + "\n", "utf-8");
 }
 function clientPromptOptions() {
-    return CLIENTS.map((client) => ({
+    return SELECTABLE_CLIENTS.map((client) => ({
         value: client,
         label: CLIENT_LABELS[client],
         hint: CLIENT_HINTS[client],
@@ -591,26 +600,43 @@ export async function runDeviceFlow(baseUrl, appSlug, clientArg, deps = {}, opti
     const sleep = deps.sleep ?? realSleep;
     const open = deps.openBrowser ?? openInBrowser;
     const now = deps.now ?? (() => Date.now());
-    let start;
-    try {
-        const { status, json } = await postJson(fetchImpl, `${baseUrl}${DEVICE_START_PATH}`, {
-            client: clientArg,
-            app: appSlug,
-            ...(options.fullCatalog ? { fullCatalog: true } : {}),
-        });
-        if (status < 200 || status >= 300 || !json?.device_code) {
+    let start = null;
+    // A cold/propagating Plan instance can briefly 404/5xx before its connect
+    // route is registered (async plugin init). Retry a few times so a recoverable
+    // blip doesn't kill the connect before polling even begins.
+    const START_ATTEMPTS = 4;
+    for (let attempt = 0; attempt < START_ATTEMPTS; attempt++) {
+        try {
+            const { status, json } = await postJson(fetchImpl, `${baseUrl}${DEVICE_START_PATH}`, {
+                client: clientArg,
+                app: appSlug,
+                ...(options.fullCatalog ? { fullCatalog: true } : {}),
+            });
+            if (status >= 200 && status < 300 && json?.device_code) {
+                start = json;
+                break;
+            }
+            if ((status === 404 || status >= 500) && attempt < START_ATTEMPTS - 1) {
+                await sleep(1000 * (attempt + 1));
+                continue;
+            }
             logErr(`  Could not start the connect flow on ${baseUrl} ` +
                 `(HTTP ${status}). Is this an agent-native app, and is it ` +
                 `deployed with the connect endpoint enabled?`);
             return null;
         }
-        start = json;
+        catch (err) {
+            if (attempt < START_ATTEMPTS - 1) {
+                await sleep(1000 * (attempt + 1));
+                continue;
+            }
+            logErr(`  Could not reach ${baseUrl} (${err?.message ?? err}). ` +
+                `Check the URL and your network.`);
+            return null;
+        }
     }
-    catch (err) {
-        logErr(`  Could not reach ${baseUrl} (${err?.message ?? err}). ` +
-            `Check the URL and your network.`);
+    if (!start)
         return null;
-    }
     const interval = Math.max(1, Number(start.interval) || 5);
     const expiresIn = Math.max(interval, Number(start.expires_in) || 600);
     const deadline = now() + expiresIn * 1000;
@@ -623,23 +649,59 @@ export async function runDeviceFlow(baseUrl, appSlug, clientArg, deps = {}, opti
     logOut("  Approve in the browser to finish. Opening it now…");
     open(start.verification_uri_complete);
     let spin = 0;
+    let transientStreak = 0;
+    // Ride out brief cold-instance blips, but don't poll a persistently-dead
+    // endpoint forever: give up after this many consecutive transient (404/5xx
+    // or network-error) polls. Reset as soon as one poll responds normally.
+    const MAX_TRANSIENT_POLLS = 20;
     const isTTY = !!process.stdout.isTTY;
     while (now() < deadline) {
         let poll;
+        let transient = false;
         try {
             const { status, json } = await postJson(fetchImpl, `${baseUrl}${DEVICE_POLL_PATH}`, { device_code: start.device_code });
             if (status < 200 || status >= 300) {
+                if (isTerminalPollBody(json)) {
+                    poll = json;
+                }
+                else if (status === 404 || status >= 500) {
+                    // Transient: a cold/propagating Plan instance can briefly serve a
+                    // bare 404 (the MCP route isn't registered until async plugin init
+                    // settles) or a 5xx before it's healthy. The next poll usually lands
+                    // on a warm instance, so keep polling until the deadline instead of
+                    // hard-failing the whole connect on a recoverable blip. (This is the
+                    // recurring "Cannot find any route matching [POST] .../mcp" case.)
+                    poll = { status: "pending" };
+                    transient = true;
+                }
+                else {
+                    if (isTTY)
+                        process.stdout.write("\r\x1b[K");
+                    logErr(`  Connect polling failed (HTTP ${status}): ` +
+                        responseMessage(json, "server returned an error."));
+                    return null;
+                }
+            }
+            else {
+                poll = (json ?? { status: "pending" });
+            }
+        }
+        catch {
+            // Transient network error — keep polling.
+            poll = { status: "pending" };
+            transient = true;
+        }
+        if (transient) {
+            if (++transientStreak > MAX_TRANSIENT_POLLS) {
                 if (isTTY)
                     process.stdout.write("\r\x1b[K");
-                logErr(`  Connect polling failed (HTTP ${status}): ` +
-                    responseMessage(json, "server returned an error."));
+                logErr("  Connect endpoint is not responding (repeated 404/5xx). It may be " +
+                    "mid-deploy — wait a minute and run the command again.");
                 return null;
             }
-            poll = (json ?? { status: "pending" });
         }
-        catch {
-            // Transient network error — keep polling until the deadline.
-            poll = { status: "pending" };
+        else {
+            transientStreak = 0;
         }
         if (poll.status === "approved") {
             if (isTTY)
@@ -687,6 +749,12 @@ export async function runDeviceFlow(baseUrl, appSlug, clientArg, deps = {}, opti
     logErr("  Timed out waiting for approval. Run the command again to retry.");
     return null;
 }
+function isTerminalPollBody(json) {
+    return (json?.status === "not_found" ||
+        json?.status === "error" ||
+        json?.status === "expired" ||
+        json?.status === "consumed");
+}
 // ---------------------------------------------------------------------------
 // Writing config(s)
 // ---------------------------------------------------------------------------
@@ -1849,7 +1917,7 @@ Developer:
   npx @agent-native/core@latest connect prod [--apps mail,calendar] [--client <c>]
       Restore production MCP entries saved before the dev switch.
 
-Clients:  all (default), claude-code, claude-code-cli, codex, cowork, cursor, opencode, github-copilot
+Clients:  all (default), claude-code, codex, cowork, cursor, opencode, github-copilot
 Scope:    user (default, ~/.claude.json) or project (.mcp.json)`;
 /**
  * `agent-native connect` entry point. `deps` is injectable for tests; the