@stigmer/plugin-package 3.15.3-dev.20260916211208

package/messages.js

@@ -0,0 +1,135 @@
+/**
+ * The one sentence for every finding kind, and the collector that composes
+ * findings from a kind and its context.
+ *
+ * Copy lives here and nowhere else: the CLI and the server print these
+ * sentences verbatim, so a plugin refused offline is refused by the server
+ * with the same words, and a consumer never composes refusal copy of its
+ * own. Every sentence says what is wrong and, where the fix is not obvious,
+ * what Stigmer needs instead. Identifiers are single-quoted (the ts-server
+ * quoting rule for new copy). The `Record` types are exhaustive over the
+ * kind unions, so a kind without a sentence does not compile.
+ */
+/** The canonical `$schema` identifiers the open format pins per version. */
+export const AGENT_PLUGINS_MANIFEST_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+export const AGENT_PLUGINS_MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
+/** The four manifest locations, in the precedence the reader applies when there is no root manifest. */
+export const MANIFEST_LOCATIONS = {
+    "agent-plugins": "plugin.json",
+    claude: ".claude-plugin/plugin.json",
+    cursor: ".cursor-plugin/plugin.json",
+    codex: ".codex-plugin/plugin.json",
+};
+const q = (value) => `'${value ?? ""}'`;
+const at = (path) => (path === undefined ? "" : ` in ${q(path)}`);
+const ERROR_MESSAGES = {
+    "no-manifest": () => `no plugin manifest found: expected one of ${Object.values(MANIFEST_LOCATIONS)
+        .map((p) => q(p))
+        .join(", ")}`,
+    "manifest-unreadable": (c) => `manifest ${q(c.path)} is not valid JSON: ${c.detail ?? "parse error"}`,
+    "manifest-schema-missing": (c) => `manifest ${q(c.path)} is missing the required '$schema' field; an Agent Plugins manifest declares ${q(AGENT_PLUGINS_MANIFEST_SCHEMA)}`,
+    "manifest-schema-unsupported": (c) => `manifest ${q(c.path)} declares an unsupported '$schema' ${q(c.detail)}; this reader supports ${q(AGENT_PLUGINS_MANIFEST_SCHEMA)}`,
+    "manifest-name-missing": (c) => `manifest ${q(c.path)} is missing the required 'name' field`,
+    "manifest-name-invalid": (c) => `plugin name ${q(c.subject)}${at(c.path)} is invalid: 1 to 64 characters of lowercase letters, digits, hyphens and periods, starting and ending alphanumeric, with no '--' or '..'`,
+    "manifest-name-conflict": (c) => `manifests disagree on the plugin name: ${q(c.subject)} in ${q(c.path)} versus ${c.detail ?? "another manifest"}`,
+    "manifest-field-type": (c) => `field ${q(c.subject)}${at(c.path)} has the wrong type: expected ${c.detail ?? "a different type"}`,
+    "path-not-relative": (c) => `path ${q(c.subject)}${at(c.path)} must be plugin-relative and begin with './'`,
+    "path-escapes-root": (c) => `path ${q(c.subject)}${at(c.path)} escapes the plugin root`,
+    "path-glob-unsupported": (c) => `path ${q(c.subject)}${at(c.path)} is a glob pattern; declare directories and files by path`,
+    "path-uncontained": (c) => `the reader listed a path outside the plugin root: ${q(c.path)}`,
+    "document-too-large": (c) => `${q(c.path)} is ${c.subject ?? "too many"} bytes, over the ${c.detail ?? ""}-byte limit for this kind of document`,
+    "skill-frontmatter-missing": (c) => `${q(c.path)} must start with YAML frontmatter ('---')`,
+    "skill-frontmatter-unclosed": (c) => `${q(c.path)} frontmatter is not closed (missing the closing '---')`,
+    "skill-frontmatter-unreadable": (c) => `${q(c.path)} frontmatter is not valid YAML: ${c.detail ?? "parse error"}`,
+    "skill-name-invalid": (c) => `skill name ${q(c.subject)}${at(c.path)} is invalid: lowercase letters, digits and hyphens, optionally dot-scoped, with every segment alphanumeric`,
+    "skill-name-duplicate": (c) => `skill name ${q(c.subject)} appears more than once (again${at(c.path)})`,
+    "mcp-config-unreadable": (c) => `MCP configuration ${q(c.path)} is not valid JSON: ${c.detail ?? "parse error"}`,
+    "mcp-config-shape": (c) => `MCP configuration ${q(c.path)} must be an object with an 'mcpServers' object`,
+    "mcp-config-schema-missing": (c) => `MCP configuration ${q(c.path)} is missing the required '$schema' field; an Agent Plugins configuration declares ${q(AGENT_PLUGINS_MCP_SCHEMA)}`,
+    "mcp-config-schema-unsupported": (c) => `MCP configuration ${q(c.path)} declares an unsupported '$schema' ${q(c.detail)}; this reader supports ${q(AGENT_PLUGINS_MCP_SCHEMA)}`,
+    "mcp-config-field-unknown": (c) => `MCP configuration ${q(c.path)} has an unexpected top-level field ${q(c.subject)}; only '$schema' and 'mcpServers' are allowed`,
+    "mcp-server-shape": (c) => `MCP server ${q(c.subject)}${at(c.path)} must be an object`,
+    "mcp-server-type-missing": (c) => `MCP server ${q(c.subject)}${at(c.path)} is missing the 'type' field the Agent Plugins format requires ('stdio', 'streamable-http' or 'sse')`,
+    "mcp-server-transport-unknown": (c) => `MCP server ${q(c.subject)}${at(c.path)} has no 'type' and neither a 'command' nor a 'url' to infer it from`,
+    "mcp-server-type-ambiguous": (c) => `MCP server ${q(c.subject)}${at(c.path)} declares both 'command' and 'url'; a server is either stdio or HTTP`,
+    "mcp-server-type-unknown": (c) => `MCP server ${q(c.subject)}${at(c.path)} has an unknown 'type' ${q(c.detail)}; expected 'stdio', 'http', 'streamable-http' or 'sse'`,
+    "mcp-server-field-unknown": (c) => `MCP server ${q(c.subject)}${at(c.path)} has a field ${q(c.detail)} that its transport does not define`,
+    "mcp-server-field-type": (c) => `MCP server ${q(c.subject)}${at(c.path)} field ${q(c.detail)} has the wrong type`,
+    "mcp-server-url-missing": (c) => `MCP server ${q(c.subject)}${at(c.path)} is missing the 'url' its HTTP transport requires`,
+    "mcp-server-url-invalid": (c) => `MCP server ${q(c.subject)}${at(c.path)} has an invalid 'url' ${q(c.detail)}: expected an absolute HTTPS URL (HTTP only for localhost) with no user information or fragment`,
+    "mcp-server-url-variable": (c) => `MCP server ${q(c.subject)}${at(c.path)} has a variable in its 'url'; Stigmer sends the URL as written, so write the URL out and put variables in 'headers'`,
+    "mcp-server-command-missing": (c) => `MCP server ${q(c.subject)}${at(c.path)} is missing the 'command' its stdio transport requires`,
+    "mcp-server-command-invalid": (c) => `MCP server ${q(c.subject)}${at(c.path)} has a 'command' that is not a single executable name; put arguments in 'args'`,
+    "mcp-server-command-relative": (c) => `MCP server ${q(c.subject)}${at(c.path)} runs a command bundled in the plugin ${q(c.detail)}; Stigmer runs only commands on the runner's PATH (for example 'npx' or 'uvx')`,
+    "mcp-server-plugin-root-reference": (c) => `MCP server ${q(c.subject)}${at(c.path)} references the plugin's own files through ${q(c.detail)}; Stigmer does not mount plugin files into the runner`,
+    "mcp-server-cwd-unsupported": (c) => `MCP server ${q(c.subject)}${at(c.path)} sets a working directory; Stigmer does not mount plugin files, so a bundled directory cannot be reached`,
+    "mcp-server-env-literal": (c) => `MCP server ${q(c.subject)}${at(c.path)} sets environment variable ${q(c.detail)} to a literal value; Stigmer passes declared variables by name, so write ${q(`${c.detail ?? "KEY"}: "\${${c.detail ?? "KEY"}}"`)} and declare the variable`,
+    "mcp-server-env-rename": (c) => `MCP server ${q(c.subject)}${at(c.path)} maps environment variable ${q(c.detail)} to a differently named variable; Stigmer passes declared variables by name, so use the same name on both sides`,
+    "mcp-server-name-duplicate": (c) => `MCP server name ${q(c.subject)} appears more than once (again${at(c.path)})`,
+    "mcp-server-header-duplicate": (c) => `MCP server ${q(c.subject)}${at(c.path)} declares header ${q(c.detail)} more than once (header names are case-insensitive)`,
+    "mcp-server-header-invalid": (c) => `MCP server ${q(c.subject)}${at(c.path)} has an invalid header name ${q(c.detail)}`,
+    "sub-agent-frontmatter-unreadable": (c) => `${q(c.path)} frontmatter is not valid YAML: ${c.detail ?? "parse error"}`,
+    "sub-agent-instructions-short": (c) => `sub-agent ${q(c.subject)}${at(c.path)} has instructions under ${c.detail ?? ""} characters; the body of the file is the sub-agent's prompt`,
+    "sub-agent-name-duplicate": (c) => `sub-agent name ${q(c.subject)} appears more than once (again${at(c.path)})`,
+    "variable-name-invalid": (c) => `variable name ${q(c.subject)}${at(c.path)} is invalid: an environment variable name is letters, digits and underscores, not starting with a digit`,
+    "overlay-server-unknown": (c) => `${q(c.path)} overlays MCP server ${q(c.subject)}, which the plugin does not declare`,
+    "overlay-document-unknown": (c) => `${q(c.path)} is not a document Stigmer reads; the 'ai.stigmer/' folder holds 'agent.yaml', 'workflows/<name>.yaml' and 'mcp-servers/<server>.yaml'`,
+};
+const WARNING_MESSAGES = {
+    "manifest-field-unknown": (c) => `manifest ${q(c.path)} has an unknown field ${q(c.subject)}, ignored`,
+    "manifest-extensions-invalid": (c) => `manifest ${q(c.path)} has an 'extensions' field that is not an object, ignored`,
+    "path-missing": (c) => `path ${q(c.subject)} declared${at(c.path)} does not exist in the plugin`,
+    "skill-name-defaulted": (c) => `${q(c.path)} has no 'name' in its frontmatter; the skill is named after its directory, ${q(c.subject)}`,
+    "skill-name-differs-from-directory": (c) => `skill ${q(c.subject)}${at(c.path)} is named differently from its directory ${q(c.detail)}`,
+    "skill-description-missing": (c) => `skill ${q(c.subject)}${at(c.path)} has no 'description'`,
+    "mcp-config-field-ignored": (c) => `MCP configuration ${q(c.path)} has a top-level field ${q(c.subject)} Stigmer does not read, ignored`,
+    "mcp-server-sse-mapped": (c) => `MCP server ${q(c.subject)}${at(c.path)} declares the legacy 'sse' transport; Stigmer connects over Streamable HTTP and falls back to SSE only when the server rejects it`,
+    "mcp-server-field-ignored": (c) => `MCP server ${q(c.subject)}${at(c.path)} has a field ${q(c.detail)} Stigmer does not read, ignored`,
+    "mcp-server-auth-ignored": (c) => `MCP server ${q(c.subject)}${at(c.path)} has an 'auth' block Stigmer does not read; OAuth for a server is declared in 'ai.stigmer/mcp-servers/${c.subject ?? "<server>"}.yaml'`,
+    "variable-inferred": (c) => `variable ${q(c.subject)} is referenced by MCP server ${q(c.detail)} but not declared; it is declared as a required secret`,
+    "variable-unreferenced": (c) => `variable ${q(c.subject)}${at(c.path)} is declared but no MCP server references it`,
+    "variable-default-dropped": (c) => `variable ${q(c.subject)}${at(c.path)} has a default value, which Stigmer does not carry; the user supplies the value`,
+    "variable-type-narrowed": (c) => `variable ${q(c.subject)}${at(c.path)} is typed ${q(c.detail)}; Stigmer variables are strings`,
+    "variable-option-dropped": (c) => `variable ${q(c.subject)}${at(c.path)} has a ${q(c.detail)} constraint, which Stigmer does not carry`,
+    "sub-agent-name-defaulted": (c) => `${q(c.path)} has no 'name' in its frontmatter; the sub-agent is named after the file, ${q(c.subject)}`,
+    "sub-agent-skill-unknown": (c) => `sub-agent ${q(c.subject)}${at(c.path)} asks for skill ${q(c.detail)}, which the plugin does not ship`,
+    "sub-agent-model-unknown": (c) => `sub-agent ${q(c.subject)}${at(c.path)} names model ${q(c.detail)}, which Stigmer cannot map; the sub-agent runs on the session's model`,
+    "sub-agent-field-ignored": (c) => `sub-agent ${q(c.subject)}${at(c.path)} has a field ${q(c.detail)} Stigmer does not read, ignored`,
+};
+export function errorMessage(kind, ctx) {
+    return ERROR_MESSAGES[kind](ctx);
+}
+export function warningMessage(kind, ctx) {
+    return WARNING_MESSAGES[kind](ctx);
+}
+/** True for the kinds that refuse a package. */
+export function isErrorKind(kind) {
+    return kind in ERROR_MESSAGES;
+}
+/**
+ * Collects findings while a read proceeds. The reader never throws on a
+ * plugin's content: every problem becomes a finding here, and the read
+ * continues so the outcome carries them all.
+ */
+export class Findings {
+    errors = [];
+    warnings = [];
+    error(kind, ctx = {}) {
+        this.errors.push(compose(kind, ctx, errorMessage(kind, ctx)));
+    }
+    warn(kind, ctx = {}) {
+        this.warnings.push(compose(kind, ctx, warningMessage(kind, ctx)));
+    }
+}
+// Optional fields are omitted rather than set to `undefined` so a finding
+// serialises to JSON without `null`s and compares structurally in tests.
+function compose(kind, ctx, message) {
+    return {
+        kind,
+        ...(ctx.path !== undefined && { path: ctx.path }),
+        ...(ctx.subject !== undefined && { subject: ctx.subject }),
+        ...(ctx.detail !== undefined && { detail: ctx.detail }),
+        message,
+    };
+}
+//# sourceMappingURL=messages.js.map

package/messages.js.map

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

package/normalise/ignored.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The components Stigmer reads past, found on disk.
+ *
+ * Every dialect ships things that configure the IDE rather than describe
+ * knowledge or tools: rules, hooks, slash commands, canvases, output styles,
+ * themes, monitors, LSP servers, Codex apps, bundled binaries, a settings
+ * file, a logo. Stigmer installs none of them, and says so once per
+ * component (a directory or a file, never per file inside), so an author
+ * knows what an install leaves behind. Manifest fields that name the same
+ * components are recorded by the dialect readers; the two lists are merged
+ * and deduplicated by kind and path in `read-plugin-package.ts`.
+ *
+ * `agents/` joins the list only when no vendor manifest is present: the
+ * open format defines no sub-agent component, so a root-manifest-only
+ * plugin with an `agents/` folder is told the folder is not read rather
+ * than having semantics assigned to it. `README`, `CHANGELOG`, `LICENSE`
+ * and dotfiles are not components and pass silently.
+ */
+import type { PluginFileIndex } from "../files.js";
+import type { IgnoredComponent } from "../types.js";
+export declare function ignoredOnDisk(index: PluginFileIndex, readsAgents: boolean): readonly IgnoredComponent[];
+/** One entry per (kind, path), in first-seen order. */
+export declare function dedupeIgnored(lists: readonly (readonly IgnoredComponent[])[]): readonly IgnoredComponent[];
+//# sourceMappingURL=ignored.d.ts.map

package/normalise/ignored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored.d.ts","sourceRoot":"","sources":["../../src/normalise/ignored.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAsB1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,SAAS,gBAAgB,EAAE,CAYvG;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,gBAAgB,EAAE,CAAC,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAY1G"}

package/normalise/ignored.js

@@ -0,0 +1,68 @@
+/**
+ * The components Stigmer reads past, found on disk.
+ *
+ * Every dialect ships things that configure the IDE rather than describe
+ * knowledge or tools: rules, hooks, slash commands, canvases, output styles,
+ * themes, monitors, LSP servers, Codex apps, bundled binaries, a settings
+ * file, a logo. Stigmer installs none of them, and says so once per
+ * component (a directory or a file, never per file inside), so an author
+ * knows what an install leaves behind. Manifest fields that name the same
+ * components are recorded by the dialect readers; the two lists are merged
+ * and deduplicated by kind and path in `read-plugin-package.ts`.
+ *
+ * `agents/` joins the list only when no vendor manifest is present: the
+ * open format defines no sub-agent component, so a root-manifest-only
+ * plugin with an `agents/` folder is told the folder is not read rather
+ * than having semantics assigned to it. `README`, `CHANGELOG`, `LICENSE`
+ * and dotfiles are not components and pass silently.
+ */
+const IGNORED_DIRECTORIES = {
+    rules: "rules",
+    hooks: "hooks",
+    commands: "commands",
+    canvases: "canvases",
+    workflows: "workflows",
+    "output-styles": "output-styles",
+    themes: "themes",
+    monitors: "monitors",
+    bin: "bin",
+    assets: "assets",
+    evals: "evals",
+};
+const IGNORED_FILES = {
+    ".lsp.json": "lsp-servers",
+    "settings.json": "settings",
+    ".app.json": "apps",
+};
+export function ignoredOnDisk(index, readsAgents) {
+    const ignored = [];
+    for (const dir of index.childDirectories("")) {
+        const kind = IGNORED_DIRECTORIES[dir];
+        if (kind !== undefined)
+            ignored.push({ kind, path: `${dir}/` });
+        if (dir === "agents" && !readsAgents)
+            ignored.push({ kind: "agents", path: `${dir}/` });
+    }
+    for (const file of index.childFiles("")) {
+        const kind = IGNORED_FILES[file];
+        if (kind !== undefined)
+            ignored.push({ kind, path: file });
+    }
+    return ignored;
+}
+/** One entry per (kind, path), in first-seen order. */
+export function dedupeIgnored(lists) {
+    const seen = new Set();
+    const out = [];
+    for (const list of lists) {
+        for (const component of list) {
+            const key = `${component.kind}\u0000${component.path}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(component);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=ignored.js.map

package/normalise/ignored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored.js","sourceRoot":"","sources":["../../src/normalise/ignored.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,mBAAmB,GAAmD;IAC1E,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,eAAe;IAChC,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,aAAa,GAAmD;IACpE,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,UAAU;IAC3B,WAAW,EAAE,MAAM;CACpB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,KAAsB,EAAE,WAAoB;IACxE,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;QAChE,IAAI,GAAG,KAAK,QAAQ,IAAI,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,KAA+C;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,IAAI,SAAS,SAAS,CAAC,IAAI,EAAE,CAAC;YACvD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/normalise/mcp-servers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MCP server entries, from every configuration source, into the two shapes
+ * `McpServerSpec` takes.
+ *
+ * The open format and the vendor dialects differ on strictness and the
+ * source's dialect decides: an open `mcp.json` requires `type` and closes
+ * each transport's field set (an unknown field refuses the entry), while a
+ * vendor `.mcp.json` infers the transport from `command` or `url` and
+ * carries fields Stigmer does not read as warnings (Cursor's undocumented
+ * `auth` block has its own, because OAuth on Stigmer has its own home in the
+ * `ai.stigmer/` overlay). `streamable-http` and `http` are one transport;
+ * the legacy `sse` maps to it with a warning, because the runner connects
+ * both with Streamable HTTP and its adapter falls back to SSE when the
+ * server rejects that.
+ *
+ * Four refusals are facts about the runner, not preferences: it mounts no
+ * plugin files (so a `./`-relative command, any plugin-root placeholder,
+ * and any `cwd` can never resolve); it sends a server's `url` as written
+ * (so a `${VAR}` there would be sent literally); and it hands a stdio
+ * subprocess exactly the variables the spec declares, by name (so an `env`
+ * entry is representable only as `KEY: "${KEY}"`).
+ *
+ * Every `${VAR}` in a header, an argument, an `env` value or an `auth` value
+ * is a reference to the caller's Environment, listed on the server's `env`;
+ * the variables module declares the undeclared ones. Claude's
+ * `${user_config.KEY}` is rewritten to `${KEY}` before anything is scanned.
+ */
+import type { McpConfigSource } from "../dialects/manifest.js";
+import type { PluginFileIndex } from "../files.js";
+import { type Findings } from "../messages.js";
+import type { PluginMcpServer } from "../types.js";
+export interface McpServersResult {
+    readonly servers: readonly PluginMcpServer[];
+    /**
+     * How many entries were refused. The variables stage reads it: a refused
+     * server's references are unknown, so "declared but unreferenced" would be
+     * a consequence of the refusal rather than advice, and is not warned.
+     */
+    readonly refused: number;
+    /**
+     * Every server name the sources declared, accepted or refused. The overlay
+     * checks against this, so a refused server's overlay is not a second refusal.
+     */
+    readonly declaredNames: ReadonlySet<string>;
+}
+export declare function normaliseMcpServers(index: PluginFileIndex, sources: readonly McpConfigSource[], findings: Findings): McpServersResult;
+//# sourceMappingURL=mcp-servers.d.ts.map

package/normalise/mcp-servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-servers.d.ts","sourceRoot":"","sources":["../../src/normalise/mcp-servers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAA4B,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AASzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAanD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAuBrI"}