@stigmer/plugin-package 3.15.3-dev.20260916211208

package/testing.js

@@ -0,0 +1,182 @@
+/**
+ * In-memory plugin builders for tests (exported as
+ * `@stigmer/plugin-package/testing`).
+ *
+ * One builder per dialect, each writing the exact file layout that
+ * dialect's tools produce: `openPlugin` a root `plugin.json` with the
+ * canonical `$schema` and an `mcp.json` beside it; `claudePlugin` a
+ * `.claude-plugin/plugin.json` with `.mcp.json`; `cursorPlugin` a
+ * `.cursor-plugin/plugin.json` declaring `./skills/`, `./agents/` and
+ * `./mcp.json` the way every published Cursor plugin does; `codexPlugin`
+ * the legacy `.codex-plugin/plugin.json` compatibility layout. The
+ * adversarial suite starts from a valid plugin and breaks exactly one
+ * thing with the mutators (`withFile`, `withoutFile`,
+ * `withManifestField`), so each test reads as "this plugin, minus this",
+ * and the consumers' tests (the CLI's, the server's) craft their fixtures
+ * from the same source so the shapes never drift apart.
+ *
+ * Builders return a path -> content map; `inMemoryPluginFiles` turns one
+ * into the `PluginFiles` the reader takes. Zipping a fixture for an
+ * archive-based consumer is `@stigmer/zip-structure/testing`'s job.
+ */
+import { stringify as stringifyYaml } from "yaml";
+import { inMemoryPluginFiles } from "./files.js";
+import { AGENT_PLUGINS_MANIFEST_SCHEMA, AGENT_PLUGINS_MCP_SCHEMA, MANIFEST_LOCATIONS } from "./messages.js";
+export { inMemoryPluginFiles };
+const DEFAULT_NAME = "example";
+/** An Agent Plugins 1.0.0 package. */
+export function openPlugin(fixture = {}) {
+    const files = new Map();
+    const manifest = {
+        ...(fixture.schema !== null && { $schema: fixture.schema ?? AGENT_PLUGINS_MANIFEST_SCHEMA }),
+        name: fixture.name ?? DEFAULT_NAME,
+        ...(fixture.version !== undefined && { version: fixture.version }),
+        ...(fixture.description !== undefined && { description: fixture.description }),
+        ...fixture.manifest,
+    };
+    files.set(MANIFEST_LOCATIONS["agent-plugins"], json(manifest));
+    if (fixture.mcpServers !== undefined) {
+        files.set("mcp.json", json({
+            ...(fixture.mcpSchema !== null && { $schema: fixture.mcpSchema ?? AGENT_PLUGINS_MCP_SCHEMA }),
+            mcpServers: fixture.mcpServers,
+            ...fixture.mcpConfig,
+        }));
+    }
+    writeSkills(files, "skills", fixture.skills);
+    writeExtra(files, fixture.files);
+    return files;
+}
+/** A Claude Code plugin. */
+export function claudePlugin(fixture = {}) {
+    const files = new Map();
+    const manifest = {
+        name: fixture.name ?? DEFAULT_NAME,
+        ...(fixture.version !== undefined && { version: fixture.version }),
+        ...(fixture.description !== undefined && { description: fixture.description }),
+        ...(fixture.userConfig !== undefined && { userConfig: fixture.userConfig }),
+        ...fixture.manifest,
+    };
+    files.set(MANIFEST_LOCATIONS.claude, json(manifest));
+    if (fixture.mcpServers !== undefined)
+        files.set(".mcp.json", json({ mcpServers: fixture.mcpServers }));
+    writeSkills(files, "skills", fixture.skills);
+    writeAgents(files, "agents", fixture.agents);
+    writeExtra(files, fixture.files);
+    return files;
+}
+/** A Cursor plugin, declaring its components the way the published catalogue does. */
+export function cursorPlugin(fixture = {}) {
+    const files = new Map();
+    const manifest = {
+        name: fixture.name ?? DEFAULT_NAME,
+        ...(fixture.version !== undefined && { version: fixture.version }),
+        ...(fixture.description !== undefined && { description: fixture.description }),
+        ...(fixture.skills !== undefined && { skills: "./skills/" }),
+        ...(fixture.agents !== undefined && { agents: "./agents/" }),
+        ...(fixture.variables !== undefined && {
+            variables: {
+                type: "object",
+                properties: fixture.variables,
+                ...(fixture.required !== undefined && { required: fixture.required }),
+            },
+        }),
+        ...(fixture.mcpServers !== undefined && { mcpServers: "./mcp.json" }),
+        ...fixture.manifest,
+    };
+    files.set(MANIFEST_LOCATIONS.cursor, json(manifest));
+    if (fixture.mcpServers !== undefined)
+        files.set("mcp.json", json({ mcpServers: fixture.mcpServers }));
+    writeSkills(files, "skills", fixture.skills);
+    writeAgents(files, "agents", fixture.agents);
+    writeExtra(files, fixture.files);
+    return files;
+}
+/** The legacy Codex compatibility layout (`.codex-plugin/plugin.json`, `.mcp.json`, `.app.json`). */
+export function codexPlugin(fixture = {}) {
+    const files = new Map();
+    const manifest = {
+        name: fixture.name ?? DEFAULT_NAME,
+        ...(fixture.version !== undefined && { version: fixture.version }),
+        ...(fixture.description !== undefined && { description: fixture.description }),
+        ...(fixture.skills !== undefined && { skills: "./skills/" }),
+        ...(fixture.mcpServers !== undefined && { mcpServers: "./.mcp.json" }),
+        ...(fixture.apps !== undefined && { apps: "./.app.json" }),
+        ...fixture.manifest,
+    };
+    files.set(MANIFEST_LOCATIONS.codex, json(manifest));
+    if (fixture.mcpServers !== undefined)
+        files.set(".mcp.json", json({ mcpServers: fixture.mcpServers }));
+    if (fixture.apps !== undefined)
+        files.set(".app.json", json({ apps: fixture.apps }));
+    writeSkills(files, "skills", fixture.skills);
+    writeExtra(files, fixture.files);
+    return files;
+}
+/** A copy of `files` with `path` set to `content`. */
+export function withFile(files, path, content) {
+    const copy = new Map(files);
+    copy.set(path, content);
+    return copy;
+}
+/** A copy of `files` without `path`. */
+export function withoutFile(files, path) {
+    const copy = new Map(files);
+    copy.delete(path);
+    return copy;
+}
+/**
+ * A copy of `files` with one top-level field of the JSON document at
+ * `manifestPath` set (or removed, when `value` is `undefined`).
+ */
+export function withManifestField(files, manifestPath, field, value) {
+    const current = files.get(manifestPath);
+    if (current === undefined)
+        throw new Error(`fixture has no document at '${manifestPath}'`);
+    const text = typeof current === "string" ? current : new TextDecoder().decode(current);
+    const document = JSON.parse(text);
+    if (value === undefined)
+        delete document[field];
+    else
+        document[field] = value;
+    return withFile(files, manifestPath, json(document));
+}
+/** A `SKILL.md` document from a fixture description. */
+export function skillMarkdown(skill) {
+    const body = skill.body ?? `# ${skill.name}\n\nInstructions for the ${skill.name} skill.\n`;
+    if (skill.frontmatter === null)
+        return body;
+    const frontmatter = {
+        name: skill.name,
+        ...(skill.description !== undefined && { description: skill.description }),
+        ...skill.frontmatter,
+    };
+    return `---\n${stringifyYaml(frontmatter)}---\n${body}`;
+}
+/** A sub-agent document from a fixture description. */
+export function agentMarkdown(agent) {
+    const body = agent.body ?? `You are the ${agent.file} sub-agent. Do the task thoroughly and report back.\n`;
+    if (agent.frontmatter === null)
+        return body;
+    const frontmatter = { name: agent.file, ...agent.frontmatter };
+    return `---\n${stringifyYaml(frontmatter)}---\n${body}`;
+}
+function writeSkills(files, root, skills) {
+    for (const skill of skills ?? []) {
+        const dir = `${root}/${skill.dir ?? skill.name}`;
+        files.set(`${dir}/SKILL.md`, skillMarkdown(skill));
+        for (const [path, content] of Object.entries(skill.files ?? {}))
+            files.set(`${dir}/${path}`, content);
+    }
+}
+function writeAgents(files, root, agents) {
+    for (const agent of agents ?? [])
+        files.set(`${root}/${agent.file}.md`, agentMarkdown(agent));
+}
+function writeExtra(files, extra) {
+    for (const [path, content] of Object.entries(extra ?? {}))
+        files.set(path, content);
+}
+function json(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+//# sourceMappingURL=testing.js.map

package/testing.js.map

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

package/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * The normalised description of a plugin: what Stigmer would install from a
+ * package, whatever dialect the package was written in.
+ *
+ * These are the library's own plain types, deliberately not the protos. The
+ * library describes the plugin FORMAT; the server maps this description onto
+ * resources when it installs, and the CLI validates offline without pulling
+ * the resource schemas in for a parse. Field names still mirror the protos
+ * (`SubAgent.name/description/instructions/model_override`,
+ * `EnvVarDeclaration.is_secret/description/optional`, the
+ * `McpServerSpec` `stdio`/`http` variants) so the server's mapping is one
+ * function per kind and a proto rename is a visible edit here.
+ *
+ * Every path in this description is plugin-relative, POSIX, with no leading
+ * `./`: one path vocabulary for the whole package, whichever reader produced
+ * the files.
+ */
+/** The manifest that gave the plugin its identity. */
+export type PluginDialect = "agent-plugins" | "claude" | "cursor" | "codex";
+export interface PluginAuthor {
+    readonly name?: string;
+    readonly email?: string;
+    readonly url?: string;
+}
+/**
+ * One skill: a directory holding `SKILL.md`. `files` lists every file under
+ * `dir` (plugin-relative), so an installer can build the skill's own archive
+ * without walking the package again; `SKILL.md` is among them. For a plugin
+ * that IS a single skill (a root `SKILL.md`, the Claude Code layout) `dir` is
+ * the empty string and `files` is the whole package.
+ */
+export interface PluginSkill {
+    readonly name: string;
+    readonly description?: string;
+    readonly dir: string;
+    readonly files: readonly string[];
+}
+/**
+ * One MCP server in the shape `McpServerSpec` takes. `env` is the list of
+ * variable NAMES the server references (in headers, arguments or its stdio
+ * environment), which is what `McpServerSpec.env` declares; values never
+ * appear anywhere in this library.
+ */
+export type PluginMcpServer = {
+    readonly name: string;
+    readonly transport: "http";
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly env: readonly string[];
+} | {
+    readonly name: string;
+    readonly transport: "stdio";
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: readonly string[];
+};
+/**
+ * A dialect's `model` value classified into an alias the server resolves
+ * against its model registry. The library never names a Stigmer model id:
+ * the runner drops a sub-agent whose `model_override` is unregistered, so an
+ * id the parser could not verify would silently remove sub-agents at run
+ * time. `inherit` and an absent `model` both mean "no override"; `unknown`
+ * carries the raw text for the server's warning.
+ */
+export type ModelAlias = "fast" | "sonnet" | "opus" | "haiku" | "inherit" | "unknown";
+export interface ModelHint {
+    readonly raw: string;
+    readonly alias: ModelAlias;
+}
+/** One sub-agent file (`agents/*.md`) in the shape `SubAgent` takes. */
+export interface PluginSubAgent {
+    readonly name: string;
+    readonly description?: string;
+    readonly instructions: string;
+    /** Plugin skill names this sub-agent asked for (Claude `skills:`), resolved to `skill_refs` by the installer. */
+    readonly skillNames: readonly string[];
+    readonly modelHint?: ModelHint;
+    /** The agent file, for messages that point at it. */
+    readonly path: string;
+}
+/**
+ * One variable in the shape `EnvVarDeclaration` takes. `declaredBy` says
+ * where the declaration came from: a Cursor `variables` schema, a Claude
+ * `userConfig` entry, or inference from an undeclared `${VAR}` reference,
+ * which the library declares as a required secret because the runner hands a
+ * server only the variables its spec declares.
+ */
+export interface PluginVariable {
+    readonly name: string;
+    readonly description?: string;
+    readonly isSecret: boolean;
+    readonly optional: boolean;
+    readonly declaredBy: "cursor" | "claude" | "inferred";
+}
+/**
+ * A document under `ai.stigmer/`, handed over as bytes. The library locates
+ * these and checks they name things the plugin declares; parsing them into
+ * resources is the installer's, where the resource schemas live.
+ */
+export interface OverlayDocument {
+    readonly path: string;
+    readonly bytes: Uint8Array;
+}
+export interface OverlayNamedDocument extends OverlayDocument {
+    /** The file stem, the workflow's name. */
+    readonly name: string;
+}
+export interface OverlayServerDocument extends OverlayDocument {
+    /** The MCP server (a `mcpServers` key) this overlay layers over. */
+    readonly server: string;
+}
+export interface StigmerOverlay {
+    /** `ai.stigmer/agent.yaml`: the Agent that replaces the composed default. */
+    readonly agent?: OverlayDocument;
+    /** `ai.stigmer/workflows/<name>.yaml`. */
+    readonly workflows: readonly OverlayNamedDocument[];
+    /** `ai.stigmer/mcp-servers/<server>.yaml`: the richer `McpServer` overlay. */
+    readonly mcpServers: readonly OverlayServerDocument[];
+}
+/**
+ * The component kinds Stigmer reads past without carrying. Recorded once per
+ * component (a directory, a file or a manifest field), never per file, so
+ * an author sees "hooks/ is not installed" once.
+ */
+export type IgnoredComponentKind = "agents" | "apps" | "assets" | "bin" | "canvases" | "channels" | "commands" | "default-enabled" | "dependencies" | "evals" | "extension" | "hooks" | "logo" | "lsp-servers" | "min-client-versions" | "monitors" | "output-styles" | "rules" | "settings" | "themes" | "workflows";
+export interface IgnoredComponent {
+    readonly kind: IgnoredComponentKind;
+    /** The directory, file, or `<manifest path>#<field>` the component came from. */
+    readonly path: string;
+}
+/** What Stigmer would install from the package. */
+export interface PluginPackage {
+    readonly name: string;
+    /** As written; Semantic Versioning is recommended by the format, not enforced. */
+    readonly version?: string;
+    readonly description?: string;
+    readonly author?: PluginAuthor;
+    readonly homepage?: string;
+    readonly repository?: string;
+    readonly license?: string;
+    readonly keywords: readonly string[];
+    readonly dialect: PluginDialect;
+    /** Every manifest the reader consulted, identity first. */
+    readonly manifestsFound: readonly string[];
+    readonly skills: readonly PluginSkill[];
+    readonly mcpServers: readonly PluginMcpServer[];
+    readonly subAgents: readonly PluginSubAgent[];
+    readonly variables: readonly PluginVariable[];
+    readonly overlay: StigmerOverlay;
+    readonly ignored: readonly IgnoredComponent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

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

package/types.js

@@ -0,0 +1,19 @@
+/**
+ * The normalised description of a plugin: what Stigmer would install from a
+ * package, whatever dialect the package was written in.
+ *
+ * These are the library's own plain types, deliberately not the protos. The
+ * library describes the plugin FORMAT; the server maps this description onto
+ * resources when it installs, and the CLI validates offline without pulling
+ * the resource schemas in for a parse. Field names still mirror the protos
+ * (`SubAgent.name/description/instructions/model_override`,
+ * `EnvVarDeclaration.is_secret/description/optional`, the
+ * `McpServerSpec` `stdio`/`http` variants) so the server's mapping is one
+ * function per kind and a proto rename is a visible edit here.
+ *
+ * Every path in this description is plugin-relative, POSIX, with no leading
+ * `./`: one path vocabulary for the whole package, whichever reader produced
+ * the files.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}