@agent-native/skills 0.0.0-beta-20260819155526

package/README.md

@@ -0,0 +1,49 @@
+# @agent-native/skills
+
+Install BuilderIO skill folders into Codex and Claude skill directories.
+
+```bash
+npx @agent-native/skills@latest add
+npx @agent-native/skills@latest add --skill quick-recap --client codex --scope project --update-instructions
+npx @agent-native/skills@latest add --skill visual-recap --client all --with-github-action
+npx @agent-native/skills@latest add --skill visualize-repo --mode local-files
+npx @agent-native/skills@latest add --skill visual-plan --mode local-files
+npx @agent-native/skills@latest add --skill content --mode local-files --scope project
+npx @agent-native/skills@latest update scaffold --project
+```
+
+Use `--skill <name>` one or more times to select specific skills, or omit it in
+an interactive terminal to choose from a prompt. The prompt puts `visual-plan`
+`visual-recap`, and `visualize-repo` first and preselects those by default. Use
+`--client codex`, `--client claude-code`, or `--client all` to choose install
+targets; omitted `--client` defaults to all supported clients. For
+`visual-plan`, `visual-recap`, `visualize-repo`, and `content`, use
+`--mode hosted`, `--mode local-files`, or
+`--mode self-hosted --mcp-url <url>` to choose hosted sharing, local-file
+workflows, or your own app. Add `--update-instructions` to append an idempotent
+managed block to `AGENTS.md` and/or `CLAUDE.md` for instruction-style skills.
+
+On first run, `npx` itself may be quiet while it downloads the package before
+this CLI can print anything. For unattended installs, pass explicit flags such
+as `--skill`, `--client`, `--scope`, and `--no-connect` to skip prompts and
+leave MCP authentication for a later `connect` command.
+
+Skill content comes from `BuilderIO/skills@main` at install/list time for plain
+skill installs. Explicit app-backed installs such as `visual-plan`,
+`visual-recap`, `visualize-repo`, and `content` delegate to
+`@agent-native/core` so mode selection, MCP registration, and local-files
+instructions stay in one framework-owned flow.
+
+Generated Agent Native apps and workspaces can refresh their framework-provided
+`.agents/skills` from the latest installed CLI with:
+
+```bash
+npm run skills:update
+# or
+npx @agent-native/core@latest skills update scaffold --project
+```
+
+`AGENTS.md` and `.agents/skills` are the canonical files. The scaffold command
+also repairs Claude compatibility links (`CLAUDE.md` and `.claude/skills`) when
+the host filesystem supports them, with copy fallback where symlinks are
+blocked.

package/dist/built-in-apps.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Canonical "built-in agent-native app -> MCP server" descriptor registry.
+ *
+ * This is a dependency-free mirror of the manifest data encoded in
+ * `@agent-native/core`'s `BUILT_IN_APP_SKILLS` object
+ * (`packages/core/src/cli/skills.ts`, around line 1711+). The standalone
+ * `@agent-native/skills` installer uses this to know which skill name maps to
+ * which hosted MCP server without importing the (much heavier) core CLI module.
+ *
+ * IMPORTANT: every URL / serverName / alias / authMode below MUST stay byte-for-byte
+ * identical to core's `BUILT_IN_APP_SKILLS`. The provenance of each value is noted
+ * inline as `packages/core/src/cli/skills.ts:<line>`. If core changes, update here too
+ * (a future sync guard test should compare the two).
+ */
+/** Auth modes mirrored from core's `auth.mode` on each app-skill manifest. */
+export type BuiltInAppAuthMode = "oauth" | "device" | "none";
+/**
+ * Descriptor for a single built-in agent-native app and the hosted MCP server
+ * its skills connect to.
+ */
+export interface BuiltInAppMcp {
+    /** Stable app id (matches the manifest `id` in core). */
+    appId: string;
+    /** Human-facing display name. */
+    displayName: string;
+    /** Skill names this app exports (a skill name resolves back to this app). */
+    skillNames: string[];
+    /** MCP server name used when registering the connector. */
+    serverName: string;
+    /** Hosted MCP endpoint URL (`hosted.mcpUrl`). */
+    mcpUrl: string;
+    /** Hosted app base URL (`hosted.url`). */
+    hostedUrl: string;
+    /** Alternate server names accepted for this app (`mcp.aliases`). */
+    aliases?: string[];
+    /** Auth mode for connecting the MCP server (`auth.mode`). */
+    authMode: BuiltInAppAuthMode;
+    /** True when the app ships only as a local command (no remote refresh). */
+    localOnly?: boolean;
+    /** True when the app provides a PR Visual Recap GitHub Action workflow. */
+    hasGithubAction?: boolean;
+}
+/**
+ * The built-in app -> MCP registry.
+ *
+ * Each entry's values are copied verbatim from core. Provenance per field is
+ * cited inline using the `packages/core/src/cli/skills.ts` line numbers.
+ */
+export declare const BUILT_IN_APP_MCP: BuiltInAppMcp[];
+/**
+ * Resolve the built-in app whose `skillNames` contains `skillName`
+ * (case-insensitive). Returns `undefined` when no built-in app exports it.
+ */
+export declare function resolveAppForSkill(skillName: string): BuiltInAppMcp | undefined;
+/**
+ * True when the given skill name maps to a built-in app with a hosted MCP
+ * server.
+ */
+export declare function appHasMcp(skillName: string): boolean;
+//# sourceMappingURL=built-in-apps.d.ts.map

package/dist/built-in-apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-apps.d.ts","sourceRoot":"","sources":["../src/built-in-apps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAAa,EA2E3C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,SAAS,CAM3B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/built-in-apps.js

@@ -0,0 +1,114 @@
+/**
+ * Canonical "built-in agent-native app -> MCP server" descriptor registry.
+ *
+ * This is a dependency-free mirror of the manifest data encoded in
+ * `@agent-native/core`'s `BUILT_IN_APP_SKILLS` object
+ * (`packages/core/src/cli/skills.ts`, around line 1711+). The standalone
+ * `@agent-native/skills` installer uses this to know which skill name maps to
+ * which hosted MCP server without importing the (much heavier) core CLI module.
+ *
+ * IMPORTANT: every URL / serverName / alias / authMode below MUST stay byte-for-byte
+ * identical to core's `BUILT_IN_APP_SKILLS`. The provenance of each value is noted
+ * inline as `packages/core/src/cli/skills.ts:<line>`. If core changes, update here too
+ * (a future sync guard test should compare the two).
+ */
+/**
+ * The built-in app -> MCP registry.
+ *
+ * Each entry's values are copied verbatim from core. Provenance per field is
+ * cited inline using the `packages/core/src/cli/skills.ts` line numbers.
+ */
+export const BUILT_IN_APP_MCP = [
+    {
+        // core skills.ts:1822 (id), :1823 (displayName)
+        appId: "visual-plans",
+        displayName: "Agent-Native Plan",
+        // core skills.ts:2867 (skillName "visual-plan") + extraSkills
+        skillNames: ["visual-plan", "visual-recap", "visualize-repo"],
+        // core skills.ts:1830 (mcp.serverName + mcp.aliases)
+        serverName: "plan",
+        aliases: ["agent-native-plans"],
+        // core skills.ts:1828 (hosted.mcpUrl)
+        mcpUrl: "https://plan.agent-native.com/mcp",
+        // core skills.ts:1827 (hosted.url)
+        hostedUrl: "https://plan.agent-native.com",
+        // core skills.ts:1832 (auth.mode)
+        authMode: "oauth",
+        // core skills.ts:3321-3322 (githubActionPath gated on knownTarget === "visual-plans")
+        hasGithubAction: true,
+    },
+    {
+        // core skills.ts:1716 (id), :1717 (displayName)
+        appId: "assets",
+        displayName: "Assets",
+        // core skills.ts:1713 (skillName)
+        skillNames: ["assets"],
+        // core skills.ts:1724 (mcp.serverName)
+        serverName: "agent-native-assets",
+        // core skills.ts:1722 (hosted.mcpUrl)
+        mcpUrl: "https://assets.agent-native.com/mcp",
+        // core skills.ts:1721 (hosted.url)
+        hostedUrl: "https://assets.agent-native.com",
+        // core skills.ts:1726 (auth.mode)
+        authMode: "oauth",
+    },
+    {
+        appId: "content",
+        displayName: "Content",
+        skillNames: ["content"],
+        serverName: "agent-native-content",
+        mcpUrl: "https://content.agent-native.com/mcp",
+        hostedUrl: "https://content.agent-native.com",
+        authMode: "oauth",
+    },
+    {
+        // core skills.ts:1762 (id), :1763 (displayName)
+        appId: "design",
+        displayName: "Design",
+        // core skills.ts:1759 (skillName) + Design extraSkills
+        skillNames: ["design-exploration", "visual-edit"],
+        // core skills.ts:1770 (mcp.serverName)
+        serverName: "agent-native-design",
+        // core skills.ts:1768 (hosted.mcpUrl)
+        mcpUrl: "https://design.agent-native.com/mcp",
+        // core skills.ts:1767 (hosted.url)
+        hostedUrl: "https://design.agent-native.com",
+        // core skills.ts:1772 (auth.mode)
+        authMode: "oauth",
+    },
+    {
+        // core skills.ts:1881 (id), :1882 (displayName)
+        appId: "context-xray",
+        displayName: "Context X-Ray",
+        // core skills.ts:1877 (skillName)
+        skillNames: ["context-xray"],
+        // core skills.ts:1889 (mcp.serverName)
+        serverName: "agent-native-context-xray",
+        // core skills.ts:1887 (hosted.mcpUrl)
+        mcpUrl: "https://context-xray.agent-native.com/mcp",
+        // core skills.ts:1886 (hosted.url)
+        hostedUrl: "https://context-xray.agent-native.com",
+        // core skills.ts:1890 (auth.mode)
+        authMode: "none",
+        // core skills.ts:1878 (localOnly: true)
+        localOnly: true,
+    },
+];
+/**
+ * Resolve the built-in app whose `skillNames` contains `skillName`
+ * (case-insensitive). Returns `undefined` when no built-in app exports it.
+ */
+export function resolveAppForSkill(skillName) {
+    const needle = skillName.trim().toLowerCase();
+    if (!needle)
+        return undefined;
+    return BUILT_IN_APP_MCP.find((app) => app.skillNames.some((name) => name.toLowerCase() === needle));
+}
+/**
+ * True when the given skill name maps to a built-in app with a hosted MCP
+ * server.
+ */
+export function appHasMcp(skillName) {
+    return resolveAppForSkill(skillName) !== undefined;
+}
+//# sourceMappingURL=built-in-apps.js.map

package/dist/built-in-apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-apps.js","sourceRoot":"","sources":["../src/built-in-apps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgCH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C;QACE,gDAAgD;QAChD,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,mBAAmB;QAChC,8DAA8D;QAC9D,UAAU,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,gBAAgB,CAAC;QAC7D,qDAAqD;QACrD,UAAU,EAAE,MAAM;QAClB,OAAO,EAAE,CAAC,oBAAoB,CAAC;QAC/B,sCAAsC;QACtC,MAAM,EAAE,mCAAmC;QAC3C,mCAAmC;QACnC,SAAS,EAAE,+BAA+B;QAC1C,kCAAkC;QAClC,QAAQ,EAAE,OAAO;QACjB,sFAAsF;QACtF,eAAe,EAAE,IAAI;KACtB;IACD;QACE,gDAAgD;QAChD,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,QAAQ;QACrB,kCAAkC;QAClC,UAAU,EAAE,CAAC,QAAQ,CAAC;QACtB,uCAAuC;QACvC,UAAU,EAAE,qBAAqB;QACjC,sCAAsC;QACtC,MAAM,EAAE,qCAAqC;QAC7C,mCAAmC;QACnC,SAAS,EAAE,iCAAiC;QAC5C,kCAAkC;QAClC,QAAQ,EAAE,OAAO;KAClB;IACD;QACE,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,CAAC,SAAS,CAAC;QACvB,UAAU,EAAE,sBAAsB;QAClC,MAAM,EAAE,sCAAsC;QAC9C,SAAS,EAAE,kCAAkC;QAC7C,QAAQ,EAAE,OAAO;KAClB;IACD;QACE,gDAAgD;QAChD,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,QAAQ;QACrB,uDAAuD;QACvD,UAAU,EAAE,CAAC,oBAAoB,EAAE,aAAa,CAAC;QACjD,uCAAuC;QACvC,UAAU,EAAE,qBAAqB;QACjC,sCAAsC;QACtC,MAAM,EAAE,qCAAqC;QAC7C,mCAAmC;QACnC,SAAS,EAAE,iCAAiC;QAC5C,kCAAkC;QAClC,QAAQ,EAAE,OAAO;KAClB;IACD;QACE,gDAAgD;QAChD,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,eAAe;QAC5B,kCAAkC;QAClC,UAAU,EAAE,CAAC,cAAc,CAAC;QAC5B,uCAAuC;QACvC,UAAU,EAAE,2BAA2B;QACvC,sCAAsC;QACtC,MAAM,EAAE,2CAA2C;QACnD,mCAAmC;QACnC,SAAS,EAAE,uCAAuC;QAClD,kCAAkC;QAClC,QAAQ,EAAE,MAAM;QAChB,wCAAwC;QACxC,SAAS,EAAE,IAAI;KAChB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB;IAEjB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACnC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,kBAAkB,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;AACrD,CAAC","sourcesContent":["/**\n * Canonical \"built-in agent-native app -> MCP server\" descriptor registry.\n *\n * This is a dependency-free mirror of the manifest data encoded in\n * `@agent-native/core`'s `BUILT_IN_APP_SKILLS` object\n * (`packages/core/src/cli/skills.ts`, around line 1711+). The standalone\n * `@agent-native/skills` installer uses this to know which skill name maps to\n * which hosted MCP server without importing the (much heavier) core CLI module.\n *\n * IMPORTANT: every URL / serverName / alias / authMode below MUST stay byte-for-byte\n * identical to core's `BUILT_IN_APP_SKILLS`. The provenance of each value is noted\n * inline as `packages/core/src/cli/skills.ts:<line>`. If core changes, update here too\n * (a future sync guard test should compare the two).\n */\n\n/** Auth modes mirrored from core's `auth.mode` on each app-skill manifest. */\nexport type BuiltInAppAuthMode = \"oauth\" | \"device\" | \"none\";\n\n/**\n * Descriptor for a single built-in agent-native app and the hosted MCP server\n * its skills connect to.\n */\nexport interface BuiltInAppMcp {\n  /** Stable app id (matches the manifest `id` in core). */\n  appId: string;\n  /** Human-facing display name. */\n  displayName: string;\n  /** Skill names this app exports (a skill name resolves back to this app). */\n  skillNames: string[];\n  /** MCP server name used when registering the connector. */\n  serverName: string;\n  /** Hosted MCP endpoint URL (`hosted.mcpUrl`). */\n  mcpUrl: string;\n  /** Hosted app base URL (`hosted.url`). */\n  hostedUrl: string;\n  /** Alternate server names accepted for this app (`mcp.aliases`). */\n  aliases?: string[];\n  /** Auth mode for connecting the MCP server (`auth.mode`). */\n  authMode: BuiltInAppAuthMode;\n  /** True when the app ships only as a local command (no remote refresh). */\n  localOnly?: boolean;\n  /** True when the app provides a PR Visual Recap GitHub Action workflow. */\n  hasGithubAction?: boolean;\n}\n\n/**\n * The built-in app -> MCP registry.\n *\n * Each entry's values are copied verbatim from core. Provenance per field is\n * cited inline using the `packages/core/src/cli/skills.ts` line numbers.\n */\nexport const BUILT_IN_APP_MCP: BuiltInAppMcp[] = [\n  {\n    // core skills.ts:1822 (id), :1823 (displayName)\n    appId: \"visual-plans\",\n    displayName: \"Agent-Native Plan\",\n    // core skills.ts:2867 (skillName \"visual-plan\") + extraSkills\n    skillNames: [\"visual-plan\", \"visual-recap\", \"visualize-repo\"],\n    // core skills.ts:1830 (mcp.serverName + mcp.aliases)\n    serverName: \"plan\",\n    aliases: [\"agent-native-plans\"],\n    // core skills.ts:1828 (hosted.mcpUrl)\n    mcpUrl: \"https://plan.agent-native.com/mcp\",\n    // core skills.ts:1827 (hosted.url)\n    hostedUrl: \"https://plan.agent-native.com\",\n    // core skills.ts:1832 (auth.mode)\n    authMode: \"oauth\",\n    // core skills.ts:3321-3322 (githubActionPath gated on knownTarget === \"visual-plans\")\n    hasGithubAction: true,\n  },\n  {\n    // core skills.ts:1716 (id), :1717 (displayName)\n    appId: \"assets\",\n    displayName: \"Assets\",\n    // core skills.ts:1713 (skillName)\n    skillNames: [\"assets\"],\n    // core skills.ts:1724 (mcp.serverName)\n    serverName: \"agent-native-assets\",\n    // core skills.ts:1722 (hosted.mcpUrl)\n    mcpUrl: \"https://assets.agent-native.com/mcp\",\n    // core skills.ts:1721 (hosted.url)\n    hostedUrl: \"https://assets.agent-native.com\",\n    // core skills.ts:1726 (auth.mode)\n    authMode: \"oauth\",\n  },\n  {\n    appId: \"content\",\n    displayName: \"Content\",\n    skillNames: [\"content\"],\n    serverName: \"agent-native-content\",\n    mcpUrl: \"https://content.agent-native.com/mcp\",\n    hostedUrl: \"https://content.agent-native.com\",\n    authMode: \"oauth\",\n  },\n  {\n    // core skills.ts:1762 (id), :1763 (displayName)\n    appId: \"design\",\n    displayName: \"Design\",\n    // core skills.ts:1759 (skillName) + Design extraSkills\n    skillNames: [\"design-exploration\", \"visual-edit\"],\n    // core skills.ts:1770 (mcp.serverName)\n    serverName: \"agent-native-design\",\n    // core skills.ts:1768 (hosted.mcpUrl)\n    mcpUrl: \"https://design.agent-native.com/mcp\",\n    // core skills.ts:1767 (hosted.url)\n    hostedUrl: \"https://design.agent-native.com\",\n    // core skills.ts:1772 (auth.mode)\n    authMode: \"oauth\",\n  },\n  {\n    // core skills.ts:1881 (id), :1882 (displayName)\n    appId: \"context-xray\",\n    displayName: \"Context X-Ray\",\n    // core skills.ts:1877 (skillName)\n    skillNames: [\"context-xray\"],\n    // core skills.ts:1889 (mcp.serverName)\n    serverName: \"agent-native-context-xray\",\n    // core skills.ts:1887 (hosted.mcpUrl)\n    mcpUrl: \"https://context-xray.agent-native.com/mcp\",\n    // core skills.ts:1886 (hosted.url)\n    hostedUrl: \"https://context-xray.agent-native.com\",\n    // core skills.ts:1890 (auth.mode)\n    authMode: \"none\",\n    // core skills.ts:1878 (localOnly: true)\n    localOnly: true,\n  },\n];\n\n/**\n * Resolve the built-in app whose `skillNames` contains `skillName`\n * (case-insensitive). Returns `undefined` when no built-in app exports it.\n */\nexport function resolveAppForSkill(\n  skillName: string,\n): BuiltInAppMcp | undefined {\n  const needle = skillName.trim().toLowerCase();\n  if (!needle) return undefined;\n  return BUILT_IN_APP_MCP.find((app) =>\n    app.skillNames.some((name) => name.toLowerCase() === needle),\n  );\n}\n\n/**\n * True when the given skill name maps to a built-in app with a hosted MCP\n * server.\n */\nexport function appHasMcp(skillName: string): boolean {\n  return resolveAppForSkill(skillName) !== undefined;\n}\n"]}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runSkillsCli } from "./index.js";
+runSkillsCli(process.argv.slice(2))
+    .then(() => {
+    process.exit(process.exitCode ?? 0);
+})
+    .catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAChC,IAAI,CAAC,GAAG,EAAE;IACT,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n\nimport { runSkillsCli } from \"./index.js\";\n\nrunSkillsCli(process.argv.slice(2))\n  .then(() => {\n    process.exit(process.exitCode ?? 0);\n  })\n  .catch((error) => {\n    console.error(error instanceof Error ? error.message : String(error));\n    process.exit(1);\n  });\n"]}

package/dist/connect.d.ts

@@ -0,0 +1,81 @@
+/**
+ * MCP-server registration + authentication for `@agent-native/skills`.
+ *
+ * This is a dependency-free port of the MCP-config-writing + device-code/OAuth
+ * flow that lives in `@agent-native/core`'s `cli/connect.ts`. The skills package
+ * ships standalone (no `@agent-native/core` dependency), so this module
+ * re-implements just the registration surface against the shared on-disk
+ * writers in `./mcp-config-writers.js`. It writes the SAME config and speaks the
+ * SAME device-code/OAuth protocol as core.
+ *
+ * Two client families, exactly as in core:
+ *   - OAuth-capable (Claude Code, Cursor, OpenCode, GitHub Copilot / VS Code):
+ *     get a URL-only HTTP MCP entry (no bearer headers). The user authenticates
+ *     in-host via standard remote MCP OAuth.
+ *   - Device-code (codex, cowork): run the browser device-code flow against the
+ *     descriptor's hosted URL, then write the entry WITH the minted bearer token
+ *     + headers. Non-interactive (or no TTY) skips writing device-code configs,
+ *     surfacing the exact `agent-native connect <url>` fallback command.
+ *
+ * Server contract (identical paths + JSON field names to core):
+ *   POST <hostedUrl>/mcp/connect/device/start  (no auth)
+ *     body { client?, app? }
+ *     → { device_code, user_code, verification_uri,
+ *         verification_uri_complete, interval, expires_in }
+ *   POST <hostedUrl>/mcp/connect/device/poll   (no auth)
+ *     body { device_code }
+ *     → { status: "pending" }
+ *     | { status: "approved", token, mcpUrl, serverName, mcpServerEntry }
+ *     | { status: "expired" } | { status: "consumed" }
+ *     | { status: "error" | "not_found", message? }
+ *
+ * Node-only. Node built-ins + global fetch only; no npm deps.
+ */
+import { ClientId } from "./mcp-config-writers.js";
+/**
+ * Describes one MCP server to register. `serverName` is the canonical config
+ * key; `aliases` are additional config keys that point at the same MCP URL
+ * (e.g. `plan` + `agent-native-plans`). `hostedUrl` is the deployed app origin
+ * the device-code flow authenticates against; `mcpUrl` is the resolved MCP
+ * endpoint written into the config (defaults to `<hostedUrl>/mcp`
+ * when only `hostedUrl` is supplied).
+ */
+export interface McpDescriptor {
+    serverName: string;
+    mcpUrl: string;
+    aliases?: string[];
+    authMode?: "oauth" | "device" | "none";
+    hostedUrl?: string;
+}
+export interface RegisterMcpOptions {
+    descriptor: McpDescriptor;
+    clients: ClientId[];
+    scope: "user" | "project";
+    baseDir: string;
+    interactive: boolean;
+    log?: (m: string) => void;
+    deviceFlowTimeoutMs?: number;
+    deps?: {
+        fetchImpl?: typeof fetch;
+        now?: () => number;
+        sleep?: (ms: number) => Promise<void>;
+    };
+}
+export interface RegisterMcpResult {
+    written: {
+        client: ClientId;
+        file: string;
+    }[];
+    authenticated: boolean;
+    guidance: string[];
+}
+export declare function supportsRemoteMcpOAuth(client: ClientId): boolean;
+/**
+ * Register an MCP server (plus aliases) into the requested client configs,
+ * authenticating device-code clients via the browser flow when interactive.
+ *
+ * Idempotent: re-running replaces the same named entries. Never throws on a
+ * single client/key failing — failures are collected into `guidance`.
+ */
+export declare function registerMcpServer(opts: RegisterMcpOptions): Promise<RegisterMcpResult>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,QAAQ,EAA2B,MAAM,yBAAyB,CAAC;AA8B5E;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;QACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA0CD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEhE;AA8XD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAyH5B"}