opencode-skill-autodiscovery 1.1.4 → 1.3.0

package/README.md

@@ -1,10 +1,11 @@
 # opencode-skill-autodiscovery
 
 An [opencode](https://opencode.ai) plugin that auto-discovers skills installed by
-VS Code agent plugins and Claude Code plugins on the current machine, and
-registers them with opencode's `skills.paths` so they appear in every session.
-Each discovered skill is also exposed as a `/skill-name` slash command that
-loads the skill and routes the rest of your message through it.
+VS Code agent plugins, Claude Code plugins, and [Agent Plugins
+1.0.0](https://agent-plugins.org) conformant packages on the current machine,
+and registers them with opencode's `skills.paths` so they appear in every
+session. Each discovered skill is also exposed as a `/skill-name` slash command
+that loads the skill and routes the rest of your message through it.
 
 ## Why
 
@@ -26,10 +27,63 @@ setup:
 - Claude Code plugins: `~/.claude/plugins/installed_plugins.json`
 - Claude Code plugins on a remote host (SSH/remote sessions):
   `~/.claude/remote/plugins/installed_plugins.json`
+- **Agent Plugins 1.0.0 packages** distributed via npm. opencode installs npm
+  plugins into its own cache (`~/.cache/opencode/packages/...`), not the
+  project's `node_modules`, and a `skills.paths` entry relative to the project
+  dir silently resolves to nothing. This plugin scans both the opencode plugin
+  cache and the project's `node_modules` for packages carrying a root
+  `plugin.json` whose `$schema` is `https://agent-plugins.org/schemas/...`,
+  and registers their `skills/` with **absolute** paths — so an npm-distributed
+  Agent Plugins package (e.g. `@dodopayments/opencode-plugin`) just works with
+  `"plugin": ["opencode-skill-autodiscovery"]` and nothing else.
 
 Each points at plugin directories that contain `SKILL.md` files. This plugin
 reads the manifests (including the remote `cache.json` LRU), resolves each
 entry to its on-disk skill directories, and registers them with opencode.
+When a discovered package carries a conformant root `plugin.json`, that manifest
+is preferred (its `skills/` children are registered as-is); otherwise the plugin
+falls back to a tree walk so legacy layouts keep working.
+
+### MCP servers (opt-in)
+
+With the `mcp` option, the plugin also reads each discovered package's `mcp.json`
+and maps it onto opencode's `config.mcp`:
+
+| Agent Plugins server | opencode entry |
+|---|---|
+| `{ "type": "stdio", "command", "args", "env" }` | `{ "type": "local", "command": [...], "environment": {...} }` |
+| `{ "type": "streamable-http", "url" }` | `{ "type": "remote", "url" }` |
+| `{ "type": "sse" }` | skipped (opencode has no SSE transport) |
+
+`${PLUGIN_ROOT}` and `${PLUGIN_DATA}` placeholders are expanded in `args`/`env`,
+and both variables are injected into each stdio server's environment
+(`PLUGIN_DATA` points at
+`{opencode state}/plugin-data/{packageName}`). Invalid entries are skipped
+per-entry, never fatally. `sse` servers and stdio `cwd` (which opencode cannot
+represent) are dropped with a log line.
+
+### Agents (opt-in)
+
+Agent Plugins 1.0.0 has no portable "agents" component type (only skills and
+MCP servers), so agents are contributed through the spec's client-extension
+mechanism. With the `agents` option, the plugin reads agents from three
+sources, in order:
+
+1. `plugin.json` → `extensions["dev.opencode"].agents` (a map of agent name →
+   opencode `agent` config).
+2. A `dev.opencode/agents/<name>.json` extension directory (one opencode agent
+   config per file).
+3. A legacy Claude Code plugin shim: `.claude-plugin/plugin.json` `agents`,
+   mapping `description` and `systemPrompt` (or the `agents/<name>/AGENTS.md`
+   body) onto an opencode agent.
+
+Discovered agents are registered as `config.agent.<name>` with the same rules
+as commands: user-defined agents are never overwritten, same-source mirrors are
+collapsed, and cross-source collisions become `<package>-<agent>`.
+
+**Trust note:** a package-supplied `permission` block is always dropped — agent
+permissions are too powerful to inherit from a package by default. If you need
+one, define the agent yourself in `opencode.json` (which always wins).
 
 ### Slash commands
 
@@ -45,7 +99,8 @@ Context: $ARGUMENTS
 
 So `/spec plan the migration` loads the `spec` skill and runs it against
 `plan the migration`. The command's description is taken from the skill's
-frontmatter; existing commands with the same name are left untouched.
+frontmatter; existing commands with the same name are never overwritten (a
+colliding skill from a different source is registered as `/package-skill`).
 
 ## Install
 
@@ -57,20 +112,33 @@ Add the package name to the `plugin` array in your `opencode.json`:
 }
 ```
 
-Use the tuple form to add extra root directories to scan (e.g. a non-standard
-VS Code data location on a remote host):
+Use the tuple form to configure options:
 
 ```json
 {
   "plugin": [
     [
       "opencode-skill-autodiscovery",
-      { "extraRoots": ["/home/user/.vscode-server"] }
+      {
+        "extraRoots": ["/home/user/.vscode-server"],
+        "scanCache": true,
+        "scanNodeModules": true,
+        "mcp": false,
+        "agents": false
+      }
     ]
   ]
 }
 ```
 
+| Option | Default | Meaning |
+|---|---|---|
+| `extraRoots` | `[]` | Extra root directories to scan (e.g. a non-standard VS Code data location on a remote host). |
+| `scanCache` | `true` | Scan opencode's plugin cache (`~/.cache/opencode/packages/*`) for Agent Plugins packages. |
+| `scanNodeModules` | `true` | Scan the project's `node_modules` (incl. `@scope/*`) for Agent Plugins packages. |
+| `mcp` | `false` | Also register MCP servers from discovered packages' `mcp.json`. |
+| `agents` | `false` | Also register agents from packages (see "Agents" above). |
+
 ## Notes
 
 - Discovery is inherently **machine-local**: it reads manifests from the home
@@ -89,14 +157,23 @@ VS Code data location on a remote host):
   cloned-but-uninstalled marketplaces on setups that do have a manifest.
 - VS Code account sync only syncs your marketplace extension list; each machine
   still has its own `installed.json`/`cache.json` that this plugin reads.
-- The plugin is a no-op when no VS Code or Claude plugin manifests exist, or
-  when they contain no skills.
+- A package is only treated as an Agent Plugins package when its root
+  `plugin.json` declares a `$schema` under `https://agent-plugins.org/schemas/`.
+  Everything else is ignored by the cache/node_modules scanners and falls back
+  to the tree walk elsewhere.
+- The same plugin can be materialised in several VS Code layouts at once
+  (local clone + synced bundle + marketplace clone). `skills.paths` keeps all
+  paths; slash commands and MCP servers are de-duplicated so mirrors don't
+  create a wall of `/mirror-of-...` junk.
+- The plugin is a no-op when no manifests or conformant packages exist, or when
+  they contain no skills.
 
 ## Development
 
 ```sh
 npm install
 npm run build   # tsc -> dist/
+npm test        # build + node --test (fixture-based unit tests)
 ```
 
 Publish:

package/dist/agents.d.ts

@@ -0,0 +1,18 @@
+import type { PluginPackage } from "./discovery.js";
+export type AgentConfig = {
+    model?: string;
+    temperature?: number;
+    top_p?: number;
+    prompt?: string;
+    tools?: Record<string, boolean>;
+    disable?: boolean;
+    description?: string;
+    mode?: "subagent" | "primary" | "all";
+    color?: string;
+    maxSteps?: number;
+};
+export declare function readAgents(pkg: PluginPackage): Array<{
+    name: string;
+    agent: AgentConfig;
+}>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA4EF,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC,CA0D7C"}

package/dist/agents.js

@@ -0,0 +1,143 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { log } from "./log.js";
+// Reverse-DNS namespace this plugin (and opencode, by convention) owns for
+// client-specific manifest data and extension directories (Agent Plugins 5.6/8).
+const OPENCODE_NS = "dev.opencode";
+const MODES = new Set(["subagent", "primary", "all"]);
+function asRecord(value) {
+    return typeof value === "object" && value !== null
+        ? value
+        : null;
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+// Converts a raw, package-supplied agent object into an opencode AgentConfig.
+// `permission` blocks are dropped (too powerful to inherit by default) and
+// unknown/mistyped keys are ignored. Returns null when nothing usable is left.
+function toAgentConfig(raw) {
+    const src = asRecord(raw);
+    if (!src)
+        return null;
+    const agent = {};
+    const stringValue = (key) => typeof src[key] === "string" ? src[key] : undefined;
+    const numberValue = (key) => typeof src[key] === "number" && Number.isFinite(src[key])
+        ? src[key]
+        : undefined;
+    const model = stringValue("model");
+    const prompt = stringValue("prompt");
+    const description = stringValue("description");
+    const color = stringValue("color");
+    const temperature = numberValue("temperature");
+    const topP = numberValue("top_p");
+    const maxSteps = numberValue("maxSteps");
+    if (model)
+        agent.model = model;
+    if (prompt)
+        agent.prompt = prompt;
+    if (description)
+        agent.description = description;
+    if (color)
+        agent.color = color;
+    if (temperature !== undefined)
+        agent.temperature = temperature;
+    if (topP !== undefined)
+        agent.top_p = topP;
+    if (maxSteps !== undefined)
+        agent.maxSteps = maxSteps;
+    if (typeof src.disable === "boolean")
+        agent.disable = src.disable;
+    if (typeof src.mode === "string" && MODES.has(src.mode)) {
+        agent.mode = src.mode;
+    }
+    const tools = asRecord(src.tools);
+    if (tools) {
+        const filtered = {};
+        for (const [name, value] of Object.entries(tools)) {
+            if (typeof value === "boolean")
+                filtered[name] = value;
+        }
+        agent.tools = filtered;
+    }
+    if (src.permission !== undefined) {
+        log("dropping permission block from a package-supplied agent: too powerful to inherit");
+    }
+    if (!agent.description && !agent.prompt)
+        return null;
+    return agent;
+}
+// Discovers agents contributed by a package, in order:
+//   1. plugin.json `extensions["dev.opencode"].agents` (Agent Plugins 5.6)
+//   2. a `dev.opencode/agents/<name>.json` extension directory (Agent Plugins 8.2)
+//   3. a legacy Claude Code plugin shim: `.claude-plugin/plugin.json` `agents`
+//      plus `agents/<name>/AGENTS.md` when no systemPrompt is declared.
+// Returns a stable, de-duplicated list keyed by agent name.
+export function readAgents(pkg) {
+    const out = new Map();
+    const manifest = asRecord(readJson(join(pkg.root, "plugin.json")));
+    const extensions = asRecord(manifest?.extensions);
+    const opencodeExt = asRecord(extensions?.[OPENCODE_NS]);
+    const manifestAgents = asRecord(opencodeExt?.agents);
+    if (manifestAgents) {
+        for (const [name, raw] of Object.entries(manifestAgents)) {
+            if (out.has(name))
+                continue;
+            const agent = toAgentConfig(raw);
+            if (agent)
+                out.set(name, agent);
+        }
+    }
+    const extDir = join(pkg.root, OPENCODE_NS, "agents");
+    let extEntries = [];
+    try {
+        extEntries = readdirSync(extDir);
+    }
+    catch {
+        extEntries = [];
+    }
+    for (const entry of extEntries) {
+        if (!entry.endsWith(".json"))
+            continue;
+        const name = entry.slice(0, -".json".length);
+        if (out.has(name))
+            continue;
+        const agent = toAgentConfig(readJson(join(extDir, entry)));
+        if (agent)
+            out.set(name, agent);
+    }
+    const claudeManifest = asRecord(readJson(join(pkg.root, ".claude-plugin", "plugin.json")));
+    const claudeAgents = asRecord(claudeManifest?.agents);
+    if (claudeAgents) {
+        for (const [name, raw] of Object.entries(claudeAgents)) {
+            if (out.has(name))
+                continue;
+            const src = asRecord(raw);
+            if (!src || typeof src.description !== "string")
+                continue;
+            const agent = { description: src.description };
+            if (typeof src.systemPrompt === "string" && src.systemPrompt) {
+                agent.prompt = src.systemPrompt;
+            }
+            else {
+                try {
+                    agent.prompt = readFileSync(join(pkg.root, "agents", name, "AGENTS.md"), "utf8");
+                }
+                catch {
+                    // No prompt file; the description alone is enough to register.
+                }
+            }
+            if (typeof src.model === "string")
+                agent.model = src.model;
+            if (agent.prompt || agent.description)
+                out.set(name, agent);
+        }
+    }
+    return [...out.entries()].map(([name, agent]) => ({ name, agent }));
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAkB/B,2EAA2E;AAC3E,iFAAiF;AACjF,MAAM,WAAW,GAAG,cAAc,CAAC;AAEnC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AAEtD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAChD,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,SAAS,aAAa,CAAC,GAAY;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,MAAM,WAAW,GAAG,CAAC,GAAiD,EAAsB,EAAE,CAC5F,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,GAAG,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,WAAW,GAAG,CAAC,GAAyC,EAAsB,EAAE,CACpF,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAW,CAAC;QACjE,CAAC,CAAE,GAAG,CAAC,GAAG,CAAY;QACtB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IAC/B,IAAI,MAAM;QAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IAClC,IAAI,WAAW;QAAE,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IACjD,IAAI,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IAC/B,IAAI,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAC/D,IAAI,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACtD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAClE,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,IAA2B,CAAC;IAC/C,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;IACzB,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACjC,GAAG,CAAC,kFAAkF,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uDAAuD;AACvD,2EAA2E;AAC3E,mFAAmF;AACnF,+EAA+E;AAC/E,wEAAwE;AACxE,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CACxB,GAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACzD,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,KAAK;gBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,UAAU,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,EAAE,CAAC;IAClB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,KAAK;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,CAC7B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAC1D,CAAC;IACF,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACvD,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ;gBAAE,SAAS;YAC1D,MAAM,KAAK,GAAgB,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;YAC5D,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBAC7D,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,KAAK,CAAC,MAAM,GAAG,YAAY,CACzB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,EAC3C,MAAM,CACP,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;oBACP,+DAA+D;gBACjE,CAAC;YACH,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;gBAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YAC3D,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW;gBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/discovery.d.ts

@@ -0,0 +1,71 @@
+import type { AgentConfig } from "./agents.js";
+import type { McpEntry } from "./mcp.js";
+export { readAgents } from "./agents.js";
+export type { AgentConfig } from "./agents.js";
+export { readMcp } from "./mcp.js";
+export type { McpEntry } from "./mcp.js";
+export type PackageSource = "claude" | "vscode" | "opencode-cache" | "node_modules" | "extra";
+export type PluginPackage = {
+    source: PackageSource;
+    name: string;
+    root: string;
+    skillDirs: string[];
+    mcpPath?: string;
+    /** Agent Plugins version declared by plugin.json, e.g. "1.0.0". */
+    schemaVersion?: string;
+};
+export type SkillInfo = {
+    dir: string;
+    name: string;
+    description: string;
+};
+export type ConfigPatch = {
+    skillPaths: string[];
+    commands: Array<{
+        name: string;
+        description: string;
+        template: string;
+    }>;
+    mcp: Array<{
+        key: string;
+        entry: McpEntry;
+    }>;
+    agents: Array<{
+        name: string;
+        agent: AgentConfig;
+    }>;
+};
+export type ConfigLike = {
+    skills?: {
+        paths?: string[];
+    };
+    command?: Record<string, {
+        description?: string;
+        template: string;
+    }>;
+    mcp?: Record<string, McpEntry>;
+    agent?: Record<string, AgentConfig | undefined>;
+};
+export declare function contains(parent: string, child: string): boolean;
+export declare function readSkillInfo(dir: string): SkillInfo | null;
+export declare function readPackage(root: string, source: PackageSource): PluginPackage | null;
+export declare function findSkillDirs(root: string, out: Set<string>, seen: Set<string>): void;
+export declare function packageFromDir(root: string, source: PackageSource): PluginPackage | null;
+export declare function collectVscodeManifest(out: PluginPackage[], installedJson: string): void;
+export declare function collectVscodeCache(out: PluginPackage[], cacheJson: string): void;
+export declare function collectVscode(out: PluginPackage[], extra: string[]): void;
+export declare function collectClaudeManifest(out: PluginPackage[], installedJson: string): void;
+export declare function collectClaude(out: PluginPackage[]): void;
+export declare function opencodeCacheRoot(): string;
+export declare function collectOpencodeCache(packagesRoot: string, out: PluginPackage[]): void;
+export declare function collectNodeModules(nodeModulesRoot: string, out: PluginPackage[]): void;
+export declare function planConfig(packages: PluginPackage[], taken?: {
+    commands?: Iterable<string>;
+    mcp?: Iterable<string>;
+    agents?: Iterable<string>;
+}): ConfigPatch;
+export declare function applyConfigPatch(config: ConfigLike, plan: ConfigPatch, enabled: {
+    mcp: boolean;
+    agents: boolean;
+}): void;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

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