@agent-native/core 0.51.15 → 0.53.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

@@ -1,12 +1,13 @@
 /**
- * `agent-native connect <url>` — wire your local Claude Code / Codex / Cowork
+ * `agent-native connect <url>` — wire your local MCP-capable coding agent
  * to a DEPLOYED agent-native app. OAuth-capable clients receive a standard
  * remote MCP URL entry and authenticate in the host. Fallback clients use the
  * 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|
- *                               codex|cowork] [--scope user|project]
+ *   agent-native connect <url> [--client all|claude-code|
+ *                               codex|cowork|cursor|opencode|github-copilot]
+ *                               [--scope user|project]
  *                               [--name <serverName>]
  *   agent-native reconnect [<url>] [--client ...] [--name <serverName>]
  *   agent-native connect <url> --token <token>   (no-browser fallback)
@@ -34,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 (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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH,OAAO,EAEL,QAAQ,EAMT,MAAM,yBAAyB,CAAC;AAsEjC,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC/C,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,GAAG,EAAE,OAAO,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAwClE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqChD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAWzD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAkBD,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,MAAiC,GACtC,QAAQ,EAAE,GAAG,IAAI,CAUnB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,QAAQ,EAAE,EACnB,IAAI,GAAE,MAAiC,GACtC,IAAI,CAiBN;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,OAAO,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AA0ID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEhE;AA8JD,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,wEAAwE;IACxE,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,CACjB,OAAO,EAAE,8BAA8B,KACpC,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9B,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAsHD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,WAAgB,EACtB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,IAAI,CAAC,CAyHR;AAWD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,QAAQ,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAyB,EAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAetC;AAiCD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAosCD,8EAA8E;AAC9E,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAQxC;AAoFD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CA8FlB;AAgED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAyEf"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/cli/connect.ts"],"names":[],"mappings":"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"}