@stigmer/plugin-package 3.15.3-dev.20260916211208

package/src/testing.ts

@@ -0,0 +1,258 @@
+/**
+ * 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 };
+
+/** A plugin as files: plugin-relative path -> content. */
+export type PluginFixture = Map<string, string | Uint8Array>;
+
+export interface SkillFixture {
+  /** The frontmatter `name`; also the directory name unless `dir` says otherwise. */
+  readonly name: string;
+  readonly description?: string;
+  /** Directory under `skills/` (or the declared skills root); defaults to `name`. */
+  readonly dir?: string;
+  /** Extra frontmatter fields, or `null` for a `SKILL.md` with no frontmatter at all. */
+  readonly frontmatter?: Readonly<Record<string, unknown>> | null;
+  readonly body?: string;
+  /** Extra files inside the skill directory, relative to it. */
+  readonly files?: Readonly<Record<string, string>>;
+}
+
+export interface AgentFixture {
+  /** File name under `agents/`, without `.md`. */
+  readonly file: string;
+  /** Frontmatter fields, or `null` for a bare prompt with no frontmatter. */
+  readonly frontmatter?: Readonly<Record<string, unknown>> | null;
+  readonly body?: string;
+}
+
+interface CommonFixture {
+  readonly name?: string;
+  readonly version?: string;
+  readonly description?: string;
+  /** Extra or overriding manifest fields, merged last. */
+  readonly manifest?: Readonly<Record<string, unknown>>;
+  readonly skills?: readonly SkillFixture[];
+  /** Extra files anywhere in the plugin. */
+  readonly files?: Readonly<Record<string, string | Uint8Array>>;
+}
+
+export interface OpenPluginFixture extends CommonFixture {
+  /** The manifest `$schema`; `null` omits it. Defaults to the canonical 1.0.0 identifier. */
+  readonly schema?: string | null;
+  /** The `mcpServers` map for `mcp.json`; absent means no `mcp.json`. */
+  readonly mcpServers?: Readonly<Record<string, unknown>>;
+  /** The `mcp.json` `$schema`; `null` omits it. */
+  readonly mcpSchema?: string | null;
+  /** Extra top-level `mcp.json` fields. */
+  readonly mcpConfig?: Readonly<Record<string, unknown>>;
+}
+
+export interface ClaudePluginFixture extends CommonFixture {
+  readonly agents?: readonly AgentFixture[];
+  /** The `mcpServers` map for `.mcp.json`; absent means no `.mcp.json`. */
+  readonly mcpServers?: Readonly<Record<string, unknown>>;
+  readonly userConfig?: Readonly<Record<string, unknown>>;
+}
+
+export interface CursorPluginFixture extends CommonFixture {
+  readonly agents?: readonly AgentFixture[];
+  /** The `mcpServers` map for `mcp.json`, declared as `"mcpServers": "./mcp.json"`. */
+  readonly mcpServers?: Readonly<Record<string, unknown>>;
+  /** The `variables` JSON Schema: property name -> `{ type, title, description }`. */
+  readonly variables?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+  readonly required?: readonly string[];
+}
+
+export interface CodexPluginFixture extends CommonFixture {
+  /** The `mcpServers` map for `.mcp.json`, declared as `"mcpServers": "./.mcp.json"`. */
+  readonly mcpServers?: Readonly<Record<string, unknown>>;
+  /** The `apps` map for `.app.json`. */
+  readonly apps?: Readonly<Record<string, unknown>>;
+}
+
+const DEFAULT_NAME = "example";
+
+/** An Agent Plugins 1.0.0 package. */
+export function openPlugin(fixture: OpenPluginFixture = {}): PluginFixture {
+  const files: PluginFixture = new Map();
+  const manifest: Record<string, unknown> = {
+    ...(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: ClaudePluginFixture = {}): PluginFixture {
+  const files: PluginFixture = new Map();
+  const manifest: Record<string, unknown> = {
+    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: CursorPluginFixture = {}): PluginFixture {
+  const files: PluginFixture = new Map();
+  const manifest: Record<string, unknown> = {
+    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: CodexPluginFixture = {}): PluginFixture {
+  const files: PluginFixture = new Map();
+  const manifest: Record<string, unknown> = {
+    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: PluginFixture, path: string, content: string | Uint8Array): PluginFixture {
+  const copy = new Map(files);
+  copy.set(path, content);
+  return copy;
+}
+
+/** A copy of `files` without `path`. */
+export function withoutFile(files: PluginFixture, path: string): PluginFixture {
+  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: PluginFixture, manifestPath: string, field: string, value: unknown): PluginFixture {
+  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) as Record<string, unknown>;
+  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: SkillFixture): string {
+  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: AgentFixture): string {
+  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: PluginFixture, root: string, skills: readonly SkillFixture[] | undefined): void {
+  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: PluginFixture, root: string, agents: readonly AgentFixture[] | undefined): void {
+  for (const agent of agents ?? []) files.set(`${root}/${agent.file}.md`, agentMarkdown(agent));
+}
+
+function writeExtra(files: PluginFixture, extra: Readonly<Record<string, string | Uint8Array>> | undefined): void {
+  for (const [path, content] of Object.entries(extra ?? {})) files.set(path, content);
+}
+
+function json(value: unknown): string {
+  return `${JSON.stringify(value, null, 2)}\n`;
+}

package/src/types.ts

@@ -0,0 +1,189 @@
+/**
+ * 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[];
+}

package/testing.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 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 { inMemoryPluginFiles } from "./files.js";
+export { inMemoryPluginFiles };
+/** A plugin as files: plugin-relative path -> content. */
+export type PluginFixture = Map<string, string | Uint8Array>;
+export interface SkillFixture {
+    /** The frontmatter `name`; also the directory name unless `dir` says otherwise. */
+    readonly name: string;
+    readonly description?: string;
+    /** Directory under `skills/` (or the declared skills root); defaults to `name`. */
+    readonly dir?: string;
+    /** Extra frontmatter fields, or `null` for a `SKILL.md` with no frontmatter at all. */
+    readonly frontmatter?: Readonly<Record<string, unknown>> | null;
+    readonly body?: string;
+    /** Extra files inside the skill directory, relative to it. */
+    readonly files?: Readonly<Record<string, string>>;
+}
+export interface AgentFixture {
+    /** File name under `agents/`, without `.md`. */
+    readonly file: string;
+    /** Frontmatter fields, or `null` for a bare prompt with no frontmatter. */
+    readonly frontmatter?: Readonly<Record<string, unknown>> | null;
+    readonly body?: string;
+}
+interface CommonFixture {
+    readonly name?: string;
+    readonly version?: string;
+    readonly description?: string;
+    /** Extra or overriding manifest fields, merged last. */
+    readonly manifest?: Readonly<Record<string, unknown>>;
+    readonly skills?: readonly SkillFixture[];
+    /** Extra files anywhere in the plugin. */
+    readonly files?: Readonly<Record<string, string | Uint8Array>>;
+}
+export interface OpenPluginFixture extends CommonFixture {
+    /** The manifest `$schema`; `null` omits it. Defaults to the canonical 1.0.0 identifier. */
+    readonly schema?: string | null;
+    /** The `mcpServers` map for `mcp.json`; absent means no `mcp.json`. */
+    readonly mcpServers?: Readonly<Record<string, unknown>>;
+    /** The `mcp.json` `$schema`; `null` omits it. */
+    readonly mcpSchema?: string | null;
+    /** Extra top-level `mcp.json` fields. */
+    readonly mcpConfig?: Readonly<Record<string, unknown>>;
+}
+export interface ClaudePluginFixture extends CommonFixture {
+    readonly agents?: readonly AgentFixture[];
+    /** The `mcpServers` map for `.mcp.json`; absent means no `.mcp.json`. */
+    readonly mcpServers?: Readonly<Record<string, unknown>>;
+    readonly userConfig?: Readonly<Record<string, unknown>>;
+}
+export interface CursorPluginFixture extends CommonFixture {
+    readonly agents?: readonly AgentFixture[];
+    /** The `mcpServers` map for `mcp.json`, declared as `"mcpServers": "./mcp.json"`. */
+    readonly mcpServers?: Readonly<Record<string, unknown>>;
+    /** The `variables` JSON Schema: property name -> `{ type, title, description }`. */
+    readonly variables?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+    readonly required?: readonly string[];
+}
+export interface CodexPluginFixture extends CommonFixture {
+    /** The `mcpServers` map for `.mcp.json`, declared as `"mcpServers": "./.mcp.json"`. */
+    readonly mcpServers?: Readonly<Record<string, unknown>>;
+    /** The `apps` map for `.app.json`. */
+    readonly apps?: Readonly<Record<string, unknown>>;
+}
+/** An Agent Plugins 1.0.0 package. */
+export declare function openPlugin(fixture?: OpenPluginFixture): PluginFixture;
+/** A Claude Code plugin. */
+export declare function claudePlugin(fixture?: ClaudePluginFixture): PluginFixture;
+/** A Cursor plugin, declaring its components the way the published catalogue does. */
+export declare function cursorPlugin(fixture?: CursorPluginFixture): PluginFixture;
+/** The legacy Codex compatibility layout (`.codex-plugin/plugin.json`, `.mcp.json`, `.app.json`). */
+export declare function codexPlugin(fixture?: CodexPluginFixture): PluginFixture;
+/** A copy of `files` with `path` set to `content`. */
+export declare function withFile(files: PluginFixture, path: string, content: string | Uint8Array): PluginFixture;
+/** A copy of `files` without `path`. */
+export declare function withoutFile(files: PluginFixture, path: string): PluginFixture;
+/**
+ * A copy of `files` with one top-level field of the JSON document at
+ * `manifestPath` set (or removed, when `value` is `undefined`).
+ */
+export declare function withManifestField(files: PluginFixture, manifestPath: string, field: string, value: unknown): PluginFixture;
+/** A `SKILL.md` document from a fixture description. */
+export declare function skillMarkdown(skill: SkillFixture): string;
+/** A sub-agent document from a fixture description. */
+export declare function agentMarkdown(agent: AgentFixture): string;
+//# sourceMappingURL=testing.d.ts.map

package/testing.d.ts.map

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