@skastr0/prism-linux-x64 0.1.1 → 0.1.2

package/types/lowerer-capabilities.d.ts

@@ -0,0 +1,559 @@
+import type { HarnessId } from "./types.js";
+export type GeneratedCanonicalToolSupport = "executable" | "unsupported";
+export type SkillPermissionSupport = "supported" | "unsupported";
+export type CompileSurfaceSupport = "supported" | "unsupported";
+export interface CompileTargetCapabilities {
+    readonly agents: CompileSurfaceSupport;
+    readonly generatedCanonicalTools: GeneratedCanonicalToolSupport;
+    readonly hooks: CompileSurfaceSupport;
+    readonly skillPermissions: SkillPermissionSupport;
+}
+export declare const LOWERER_SURFACE_IDS: readonly ["pluginBundle", "rules", "commands", "agents", "skills", "generatedTools", "hooks", "mcpConfig", "agentConfig"];
+export type LowererSurfaceId = (typeof LOWERER_SURFACE_IDS)[number];
+export declare const LOWERER_SURFACE_KINDS: readonly ["native-plugin-api", "native-plugin-bundle", "generated-mcp", "markdown-file", "direct-file", "config-patch", "unsupported"];
+export type LowererSurfaceKind = (typeof LOWERER_SURFACE_KINDS)[number];
+export type HarnessFamily = "coding-harness" | "claw-harness";
+export interface LowererSurfaceCapability {
+    readonly kind: LowererSurfaceKind;
+    readonly summary: string;
+    readonly path?: string;
+}
+export interface LowererCapabilityProfile {
+    readonly harness: HarnessId;
+    readonly family: HarnessFamily;
+    readonly compile: CompileTargetCapabilities;
+    readonly surfaces: Record<LowererSurfaceId, LowererSurfaceCapability>;
+    readonly notes?: readonly string[];
+}
+export declare const LOWERER_CAPABILITIES: {
+    readonly "claude-code": {
+        readonly harness: "claude-code";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<claude-root>/skills/prism-generated-<plugin>/";
+                readonly summary: "Compile emits Claude Code skills-directory plugin bundles with plugin metadata.";
+            };
+            readonly rules: {
+                readonly kind: "direct-file";
+                readonly path: "<claude-root>/CLAUDE.md";
+                readonly summary: "Install appends managed sections to the native instructions file.";
+            };
+            readonly commands: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/commands/";
+                readonly summary: "Install compiles markdown command files into the generated plugin bundle.";
+            };
+            readonly agents: {
+                readonly kind: "markdown-file";
+                readonly path: "<generated-plugin>/agents/";
+                readonly summary: "Compile writes Claude-style subagent markdown inside the plugin bundle.";
+            };
+            readonly skills: {
+                readonly kind: "markdown-file";
+                readonly path: "<generated-plugin>/skills/";
+                readonly summary: "Compile bundles targeted skills and orbit skills as Agent Skills.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<prism-home>/runtime/mcp/<plugin>/server.mjs";
+                readonly summary: "Canonical tools lower to the canonical PRISM_HOME union MCP server referenced from the plugin .mcp.json.";
+            };
+            readonly hooks: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/hooks/hooks.json";
+                readonly summary: "Hooks are bundled in Claude Code's plugin hook layout.";
+            };
+            readonly mcpConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/.mcp.json";
+                readonly summary: "MCP config is plugin-local, not a global settings patch.";
+            };
+            readonly agentConfig: LowererSurfaceCapability;
+        };
+    };
+    readonly opencode: {
+        readonly harness: "opencode";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<opencode-root>/plugins/prism-generated-<plugin>/";
+                readonly summary: "Compile emits an OpenCode plugin using @opencode-ai/plugin APIs.";
+            };
+            readonly rules: {
+                readonly kind: "direct-file";
+                readonly path: "<opencode-root>/AGENTS.md";
+                readonly summary: "Install appends managed sections to the native instructions file.";
+            };
+            readonly commands: {
+                readonly kind: "direct-file";
+                readonly path: "<opencode-root>/commands/";
+                readonly summary: "Install writes markdown command files.";
+            };
+            readonly agents: {
+                readonly kind: "markdown-file";
+                readonly path: "<opencode-root>/agents/";
+                readonly summary: "Compile writes OpenCode agent markdown files.";
+            };
+            readonly skills: {
+                readonly kind: "markdown-file";
+                readonly path: "<opencode-root>/skills/";
+                readonly summary: "Install and compile write Agent Skill folders.";
+            };
+            readonly generatedTools: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-plugin>/dist/server.mjs";
+                readonly summary: "Canonical tools lower to OpenCode plugin tools.";
+            };
+            readonly hooks: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-plugin>/dist/server.mjs";
+                readonly summary: "Hooks lower through the OpenCode plugin API.";
+            };
+            readonly mcpConfig: LowererSurfaceCapability;
+            readonly agentConfig: {
+                readonly kind: "config-patch";
+                readonly path: "<opencode-root>/opencode.json#agent.<name>";
+                readonly summary: "Compile patches compiler-owned agent keys and plugin entries.";
+            };
+        };
+    };
+    readonly openclaw: {
+        readonly harness: "openclaw";
+        readonly family: "claw-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: LowererSurfaceCapability;
+            readonly rules: LowererSurfaceCapability;
+            readonly commands: LowererSurfaceCapability;
+            readonly agents: LowererSurfaceCapability;
+            readonly skills: {
+                readonly kind: "direct-file";
+                readonly path: "<openclaw-root>/skills/";
+                readonly summary: "Install writes Agent Skill folders only.";
+            };
+            readonly generatedTools: LowererSurfaceCapability;
+            readonly hooks: LowererSurfaceCapability;
+            readonly mcpConfig: LowererSurfaceCapability;
+            readonly agentConfig: LowererSurfaceCapability;
+        };
+        readonly notes: readonly ["OpenClaw remains Prism skills-only for now."];
+    };
+    readonly hermes: {
+        readonly harness: "hermes";
+        readonly family: "claw-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: LowererSurfaceCapability;
+            readonly rules: LowererSurfaceCapability;
+            readonly commands: LowererSurfaceCapability;
+            readonly agents: LowererSurfaceCapability;
+            readonly skills: {
+                readonly kind: "markdown-file";
+                readonly path: "<hermes-root>/skills/";
+                readonly summary: "Install and compile write Hermes skill folders.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<prism-home>/runtime/mcp/<plugin>/server.mjs";
+                readonly summary: "Canonical tools lower to the canonical PRISM_HOME union MCP server referenced from config.yaml.";
+            };
+            readonly hooks: LowererSurfaceCapability;
+            readonly mcpConfig: {
+                readonly kind: "config-patch";
+                readonly path: "<hermes-root>/config.yaml#mcp_servers";
+                readonly summary: "Compile patches the Hermes MCP server map.";
+            };
+            readonly agentConfig: LowererSurfaceCapability;
+        };
+    };
+    readonly "codex-cli": {
+        readonly harness: "codex-cli";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: LowererSurfaceCapability;
+            readonly rules: {
+                readonly kind: "direct-file";
+                readonly path: "<codex-root>/AGENTS.md";
+                readonly summary: "Install appends managed sections to the native instructions file.";
+            };
+            readonly commands: {
+                readonly kind: "direct-file";
+                readonly path: "<codex-root>/prompts/";
+                readonly summary: "Install writes prompt markdown files.";
+            };
+            readonly agents: {
+                readonly kind: "direct-file";
+                readonly path: "<codex-root>/agents/<name>.toml";
+                readonly summary: "Compile writes Codex agent TOML files.";
+            };
+            readonly skills: {
+                readonly kind: "markdown-file";
+                readonly path: "<codex-root>/skills/";
+                readonly summary: "Install and compile write Agent Skill folders.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<prism-home>/runtime/mcp/<plugin>/server.mjs";
+                readonly summary: "Canonical tools lower to the canonical PRISM_HOME union MCP server referenced from config.toml.";
+            };
+            readonly hooks: {
+                readonly kind: "config-patch";
+                readonly path: "<codex-root>/config.toml#hooks";
+                readonly summary: "Compile patches managed Codex hook entries and wrapper files.";
+            };
+            readonly mcpConfig: {
+                readonly kind: "config-patch";
+                readonly path: "<codex-root>/config.toml#mcp_servers";
+                readonly summary: "Compile patches generated MCP server tables.";
+            };
+            readonly agentConfig: {
+                readonly kind: "direct-file";
+                readonly path: "<codex-root>/agents/<name>.toml";
+                readonly summary: "Codex agent settings live in generated TOML files.";
+            };
+        };
+    };
+    readonly "antigravity-cli": {
+        readonly harness: "antigravity-cli";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<antigravity-root>/plugins/prism-generated-<plugin>/";
+                readonly summary: "Compile emits Antigravity plugin bundles with plugin.json.";
+            };
+            readonly rules: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/rules/";
+                readonly summary: "Rules are bundled into Antigravity plugins.";
+            };
+            readonly commands: LowererSurfaceCapability;
+            readonly agents: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/agents/";
+                readonly summary: "Compile writes subagent markdown inside the Antigravity plugin bundle.";
+            };
+            readonly skills: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/";
+                readonly summary: "Compile bundles targeted skills and orbit skills.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<prism-home>/runtime/mcp/<plugin>/server.mjs";
+                readonly summary: "Canonical tools lower to the canonical PRISM_HOME union MCP server referenced by plugin config.";
+            };
+            readonly hooks: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/hooks.json";
+                readonly summary: "Hooks are bundled in Antigravity plugin format.";
+            };
+            readonly mcpConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/mcp_config.json";
+                readonly summary: "MCP config is plugin-local for generated plugin bundles.";
+            };
+            readonly agentConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/agents/";
+                readonly summary: "Agent settings live in generated frontmatter.";
+            };
+        };
+    };
+    readonly "kimi-code": {
+        readonly harness: "kimi-code";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<kimi-root>/plugins/managed/prism-generated-<plugin>/";
+                readonly summary: "Compile emits a Kimi plugin bundle with kimi.plugin.json and registers it in plugins/installed.json.";
+            };
+            readonly rules: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/prism-context/SKILL.md";
+                readonly summary: "Rules lower into a sessionStart skill because Kimi plugins inject Markdown skills, not arbitrary rule files.";
+            };
+            readonly commands: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/prism-command-<name>/SKILL.md";
+                readonly summary: "Command-like workflows lower as manual Kimi flow skills.";
+            };
+            readonly agents: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/prism-agent-<name>/SKILL.md";
+                readonly summary: "Compiled agents lower honestly as role/workflow skills; Kimi subagents are runtime dispatches, not custom agent files.";
+            };
+            readonly skills: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/";
+                readonly summary: "Compile bundles targeted plugin skills and orbit skills into the generated Kimi plugin.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<prism-home>/runtime/mcp/<plugin>/server.mjs";
+                readonly summary: "Canonical tools lower to the canonical PRISM_HOME union MCP server declared by the Kimi plugin manifest.";
+            };
+            readonly hooks: {
+                readonly kind: "config-patch";
+                readonly path: "<kimi-root>/config.toml#hooks";
+                readonly summary: "Hooks lower to managed [[hooks]] config entries plus generated wrapper scripts.";
+            };
+            readonly mcpConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/kimi.plugin.json#mcpServers + <kimi-root>/plugins/installed.json";
+                readonly summary: "MCP config is plugin-local and enabled through Kimi's installed plugin record; Prism patches config.toml only for hooks.";
+            };
+            readonly agentConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/prism-agent-<name>/SKILL.md";
+                readonly summary: "Agent role settings and instructions live in generated Kimi role skills.";
+            };
+        };
+        readonly notes: readonly ["The active Kimi Code target uses ~/.kimi-code exclusively.", "Kimi Code plugins are user-scoped in official docs; Prism keeps project scope unsupported for this lowerer.", "Current Moonshot-hosted Kimi Code CLI docs also document project-local .kimi-code/skills and .kimi-code/mcp.json, but Prism does not mix those direct project surfaces with generated user-scoped plugin bundles yet.", "Kimi Code subagents are runtime dispatches, so Prism compiled agents lower as role skills rather than native subagent definitions."];
+    };
+    readonly "amp-code": {
+        readonly harness: "amp-code";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<amp-root>/plugins/prism-generated-<plugin>.ts";
+                readonly summary: "Compile emits a TypeScript Amp plugin using @ampcode/plugin APIs.";
+            };
+            readonly rules: {
+                readonly kind: "direct-file";
+                readonly path: "<amp-root>/AGENTS.md";
+                readonly summary: "Install appends managed sections to the native instructions file.";
+            };
+            readonly commands: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-plugin>.ts";
+                readonly summary: "Commands lower to Amp registerCommand definitions that append Prism command prompts to the active thread.";
+            };
+            readonly agents: {
+                readonly kind: "markdown-file";
+                readonly path: "<amp-root>/skills/prism-agent-<name>/SKILL.md";
+                readonly summary: "Compiled agents lower as generated role skills; Prism does not claim a native Amp custom-agent surface yet.";
+            };
+            readonly skills: {
+                readonly kind: "markdown-file";
+                readonly path: "<amp-root>/skills/";
+                readonly summary: "Install and compile write Agent Skill folders.";
+            };
+            readonly generatedTools: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-plugin>.ts";
+                readonly summary: "Canonical tools lower to Amp registerTool definitions.";
+            };
+            readonly hooks: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-plugin>.ts";
+                readonly summary: "Supported Prism hooks lower to Amp amp.on(...) plugin event handlers; session.end fails closed because Amp has no native session-end event.";
+            };
+            readonly mcpConfig: LowererSurfaceCapability;
+            readonly agentConfig: LowererSurfaceCapability;
+        };
+        readonly notes: readonly ["Amp generated commands, tools, and supported hooks use the native plugin API; compiled agents currently lower as role-skill guidance.", "Amp exposes session.start, tool.call, tool.result, agent.start, and agent.end plugin events; Prism does not map portable session.end to agent.end."];
+    };
+    readonly cursor: {
+        readonly harness: "cursor";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<cursor-root>/plugins/local/prism-generated-<plugin>/";
+                readonly summary: "Install emits local Cursor plugin bundles for Prism-managed command components.";
+            };
+            readonly rules: {
+                readonly kind: "direct-file";
+                readonly path: "<cursor-root>/.cursorrules or rules/";
+                readonly summary: "Install writes Cursor rules files.";
+            };
+            readonly commands: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/commands/";
+                readonly summary: "Install writes Cursor commands inside the generated local plugin bundle.";
+            };
+            readonly agents: LowererSurfaceCapability;
+            readonly skills: {
+                readonly kind: "direct-file";
+                readonly path: "<cursor-root>/skills/";
+                readonly summary: "Install writes Agent Skill folders.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<prism-home>/runtime/mcp/<plugin>/server.mjs";
+                readonly summary: "Canonical tools lower to the canonical PRISM_HOME union MCP server referenced by Cursor mcp.json.";
+            };
+            readonly hooks: LowererSurfaceCapability;
+            readonly mcpConfig: {
+                readonly kind: "config-patch";
+                readonly path: "<cursor-root>/mcp.json#mcpServers";
+                readonly summary: "Compile patches a compiler-owned Cursor MCP server entry.";
+            };
+            readonly agentConfig: LowererSurfaceCapability;
+        };
+        readonly notes: readonly ["Cursor compile support is tools-only for now; compiled agents, orbits, hooks, and skill permission visibility remain unsupported.", "Cursor command artifacts install through a local plugin bundle under ~/.cursor/plugins/local so Prism uses Cursor's native command discovery instead of direct command files.", "Cursor Agent Skills are docs-backed under .cursor/skills and ~/.cursor/skills, so Prism keeps install-phase skills direct.", "Cursor IDE and CLI share the same mcp.json contract."];
+    };
+    readonly "factory-droid": {
+        readonly harness: "factory-droid";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<factory-root>/plugins/prism-generated-<plugin>/";
+                readonly summary: "Compile emits Factory plugin bundles with .factory-plugin/plugin.json.";
+            };
+            readonly rules: {
+                readonly kind: "direct-file";
+                readonly path: "<factory-root>/AGENTS.md or rules/";
+                readonly summary: "Install writes Factory instruction/rule files.";
+            };
+            readonly commands: {
+                readonly kind: "direct-file";
+                readonly path: "<factory-root>/commands/";
+                readonly summary: "Install writes Factory command markdown files.";
+            };
+            readonly agents: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/droids/";
+                readonly summary: "Compile writes generated droids inside the Factory plugin bundle.";
+            };
+            readonly skills: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/";
+                readonly summary: "Compiled bundles own targeted skills; skills-only plugins still install direct skills.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<prism-home>/runtime/mcp/<plugin>/server.mjs";
+                readonly summary: "Canonical tools lower to the canonical PRISM_HOME union MCP server referenced by the plugin mcp.json.";
+            };
+            readonly hooks: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/hooks/hooks.json";
+                readonly summary: "Hooks are bundled in Factory plugin format.";
+            };
+            readonly mcpConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/mcp.json";
+                readonly summary: "MCP config is plugin-local; Prism does not patch settings.json.";
+            };
+            readonly agentConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/droids/";
+                readonly summary: "Droid settings live in generated frontmatter.";
+            };
+        };
+    };
+    readonly pi: {
+        readonly harness: "pi";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<pi-root>/packages/prism-generated-<plugin>/";
+                readonly summary: "Compile emits a local Pi package and registers it through settings.json packages.";
+            };
+            readonly rules: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-package>/extensions/prism-extension.js";
+                readonly summary: "Rules lower as Pi before_agent_start context injection in the generated extension.";
+            };
+            readonly commands: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-package>/prompts/";
+                readonly summary: "Compile writes Prism command markdown as Pi prompt templates in the generated package.";
+            };
+            readonly agents: {
+                readonly kind: "markdown-file";
+                readonly path: "~/.pi/agents/<name>.md or .pi/agents/<name>.md";
+                readonly summary: "Compiled agents lower to the markdown files discovered by the pi-agents package.";
+            };
+            readonly skills: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-package>/skills/";
+                readonly summary: "Compile bundles targeted skills and concrete orbit skills into the generated Pi package.";
+            };
+            readonly generatedTools: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-package>/extensions/prism-extension.js";
+                readonly summary: "Canonical tools lower through Pi's extension registerTool API.";
+            };
+            readonly hooks: {
+                readonly kind: "native-plugin-api";
+                readonly path: "<generated-package>/extensions/prism-extension.js and <generated-package>/hooks/";
+                readonly summary: "Hooks lower through Pi extension events and generated wrapper files.";
+            };
+            readonly mcpConfig: LowererSurfaceCapability;
+            readonly agentConfig: {
+                readonly kind: "markdown-file";
+                readonly path: "~/.pi/agents/<name>.md or .pi/agents/<name>.md";
+                readonly summary: "Pi agent settings live in generated agent frontmatter.";
+            };
+        };
+        readonly notes: readonly ["Pi packages are referenced from settings.json#packages; project scope uses .pi/settings.json.", "Compiled Pi agents use pi-agents markdown discovery: ~/.pi/agents globally and nearest .pi/agents in project scope."];
+    };
+    readonly grok: {
+        readonly harness: "grok";
+        readonly family: "coding-harness";
+        readonly compile: CompileTargetCapabilities;
+        readonly surfaces: {
+            readonly pluginBundle: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<grok-root>/plugins/prism-generated-<plugin>/";
+                readonly summary: "Compile emits Grok plugin bundles.";
+            };
+            readonly rules: {
+                readonly kind: "direct-file";
+                readonly path: "<grok-root>/AGENTS.md";
+                readonly summary: "Install appends managed sections to the native instructions file.";
+            };
+            readonly commands: LowererSurfaceCapability;
+            readonly agents: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/agents/";
+                readonly summary: "Compile writes generated agents inside the Grok plugin bundle.";
+            };
+            readonly skills: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/skills/";
+                readonly summary: "Compile bundles targeted skills and orbit skills.";
+            };
+            readonly generatedTools: {
+                readonly kind: "generated-mcp";
+                readonly path: "<generated-plugin>/.mcp.json";
+                readonly summary: "Canonical tools lower through the shared Streamable HTTP MCP daemon.";
+            };
+            readonly hooks: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/hooks/hooks.json";
+                readonly summary: "Hooks are bundled in Grok plugin format.";
+            };
+            readonly mcpConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/.mcp.json";
+                readonly summary: "Generated plugin-local MCP config points at Prism's Streamable HTTP daemon.";
+            };
+            readonly agentConfig: {
+                readonly kind: "native-plugin-bundle";
+                readonly path: "<generated-plugin>/agents/";
+                readonly summary: "Agent settings live in generated frontmatter.";
+            };
+        };
+    };
+};
+export declare const getCompileTargetCapabilities: (harness: string) => CompileTargetCapabilities;

package/types/manifest.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Plugin manifest parsing and validation
+ */
+import type { HarnessId, AgentValidationResult, PluginArtifactType, PluginManifest, PluginTargetId, SkillFrontmatter, SkillValidationResult, UnifiedFrontmatter } from "./types.js";
+export interface ArtifactSourceFile {
+    relativePath: string;
+    sourcePath: string;
+    scope: "shared" | "harness";
+}
+export declare function collectArtifactSourceFiles(pluginPath: string, artifact: PluginArtifactType, harnessId?: HarnessId): Promise<ArtifactSourceFile[]>;
+/**
+ * Read and validate plugin manifest
+ */
+export declare function readManifest(pluginPath: string): Promise<PluginManifest>;
+export declare function resolveManifestTargets(targets: readonly PluginTargetId[]): HarnessId[];
+export declare function resolveManifestTargetsForArtifact(targets: readonly PluginTargetId[], artifact: PluginArtifactType): HarnessId[];
+export declare function getManifestArtifactTargets(manifest: PluginManifest, artifact: PluginArtifactType): HarnessId[];
+/**
+ * Check if manifest targets a specific harness for any artifact
+ */
+export declare function manifestTargetsHarness(manifest: PluginManifest, harnessId: HarnessId): boolean;
+/**
+ * Check if manifest targets a specific harness for one artifact type
+ */
+export declare function manifestTargetsArtifact(manifest: PluginManifest, artifact: PluginArtifactType, harnessId: HarnessId): boolean;
+export declare function manifestHasCompileTargets(manifest: PluginManifest, harnessId?: HarnessId): boolean;
+export declare function formatManifestTargets(manifest: PluginManifest): string;
+/**
+ * Parse markdown file with frontmatter
+ */
+export declare function parseMarkdownFile(filePath: string): Promise<{
+    frontmatter: UnifiedFrontmatter;
+    content: string;
+}>;
+/**
+ * Extract harness-specific frontmatter, merging with base frontmatter
+ */
+export declare function getHarnessFrontmatter(frontmatter: UnifiedFrontmatter, harnessId: HarnessId): Record<string, unknown>;
+/**
+ * Serialize frontmatter back to YAML format
+ */
+export declare function serializeFrontmatter(frontmatter: Record<string, unknown>): string;
+/**
+ * Reconstruct markdown file with new frontmatter
+ */
+export declare function reconstructMarkdown(frontmatter: Record<string, unknown>, content: string): string;
+/**
+ * Validate a skill name according to Anthropic's spec
+ */
+export declare function validateSkillName(name: unknown): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate a skill description according to Anthropic's spec
+ */
+export declare function validateSkillDescription(description: unknown): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate skill frontmatter keys (whitelist check)
+ */
+export declare function validateSkillFrontmatterKeys(frontmatter: Record<string, unknown>): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate optional skill fields (allowed-tools, metadata, license, compatibility)
+ */
+export declare function validateSkillOptionalFields(frontmatter: Record<string, unknown>): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Parse and validate a SKILL.md file
+ */
+export declare function parseSkillFile(filePath: string): Promise<{
+    frontmatter: SkillFrontmatter;
+    content: string;
+    lineCount: number;
+}>;
+/**
+ * Comprehensive skill validation
+ */
+export declare function validateSkill(skillPath: string, skillDirName?: string): Promise<SkillValidationResult>;
+/**
+ * Validate all skills in a plugin
+ */
+export declare function validatePluginSkills(pluginPath: string): Promise<SkillValidationResult[]>;
+/**
+ * Validate an agent description
+ */
+export declare function validateAgentDescription(description: unknown): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate an agent definition file
+ */
+export declare function validateAgent(agentPath: string): Promise<AgentValidationResult>;
+/**
+ * Validate all agents in a plugin
+ */
+export declare function validatePluginAgents(pluginPath: string): Promise<AgentValidationResult[]>;