@oh-my-pi/pi-coding-agent 2.3.1337 → 3.1.1337

package/docs/skills.md

@@ -1,10 +1,10 @@
-> pi can create skills. Ask it to build one for your use case.
+> omp can create skills. Ask it to build one for your use case.
 
 # Skills
 
 Skills are self-contained capability packages that the agent loads on-demand. A skill provides specialized workflows, setup instructions, helper scripts, and reference documentation for specific tasks.
 
-Pi implements the [Agent Skills standard](https://agentskills.io/specification).
+OMP implements the [Agent Skills standard](https://agentskills.io/specification).
 
 **Example use cases:**
 - Web search and content extraction (Brave Search API)
@@ -144,12 +144,12 @@ Skills are discovered from these locations (later wins on name collision):
 1. `~/.codex/skills/**/SKILL.md` (Codex CLI, recursive)
 2. `~/.claude/skills/*/SKILL.md` (Claude Code user, one level)
 3. `<cwd>/.claude/skills/*/SKILL.md` (Claude Code project, one level)
-4. `~/.pi/agent/skills/**/SKILL.md` (Pi user, recursive)
-5. `<cwd>/.pi/skills/**/SKILL.md` (Pi project, recursive)
+4. `~/.omp/agent/skills/**/SKILL.md` (OMP user, recursive)
+5. `<cwd>/.omp/skills/**/SKILL.md` (OMP project, recursive)
 
 ## Configuration
 
-Configure skill loading in `~/.pi/agent/settings.json`:
+Configure skill loading in `~/.omp/agent/settings.json`:
 
 ```json
 {
@@ -173,8 +173,8 @@ Configure skill loading in `~/.pi/agent/settings.json`:
 | `enableCodexUser` | `true` | Load from `~/.codex/skills/` |
 | `enableClaudeUser` | `true` | Load from `~/.claude/skills/` |
 | `enableClaudeProject` | `true` | Load from `<cwd>/.claude/skills/` |
-| `enablePiUser` | `true` | Load from `~/.pi/agent/skills/` |
-| `enablePiProject` | `true` | Load from `<cwd>/.pi/skills/` |
+| `enableOmpUser` | `true` | Load from `~/.omp/agent/skills/` |
+| `enableOmpProject` | `true` | Load from `<cwd>/.omp/skills/` |
 | `customDirectories` | `[]` | Additional directories to scan (supports `~` expansion) |
 | `ignoredSkills` | `[]` | Glob patterns to exclude (e.g., `["deprecated-*", "test-skill"]`) |
 | `includeSkills` | `[]` | Glob patterns to include (empty = all; e.g., `["git-*", "docker"]`) |
@@ -187,20 +187,20 @@ Use `--skills` to filter skills for a specific invocation:
 
 ```bash
 # Only load specific skills
-pi --skills git,docker
+omp --skills git,docker
 
 # Glob patterns
-pi --skills "git-*,docker-*"
+omp --skills "git-*,docker-*"
 
 # All skills matching a prefix
-pi --skills "aws-*"
+omp --skills "aws-*"
 ```
 
 This overrides the `includeSkills` setting for the current session.
 
 ## How Skills Work
 
-1. At startup, pi scans skill locations and extracts names + descriptions
+1. At startup, omp scans skill locations and extracts names + descriptions
 2. The system prompt includes available skills in XML format
 3. When a task matches, the agent uses `read` to load the full SKILL.md
 4. The agent follows the instructions, using relative paths to reference scripts/assets
@@ -209,7 +209,7 @@ This is progressive disclosure: only descriptions are always in context, full in
 
 ## Validation Warnings
 
-Pi validates skills against the Agent Skills standard and warns (but still loads) non-compliant skills:
+OMP validates skills against the Agent Skills standard and warns (but still loads) non-compliant skills:
 
 - Name doesn't match parent directory
 - Name exceeds 64 characters
@@ -260,9 +260,9 @@ cd /path/to/brave-search && npm install
 
 ## Compatibility
 
-**Claude Code**: Pi reads skills from `~/.claude/skills/*/SKILL.md`. The `allowed-tools` and `model` frontmatter fields are ignored.
+**Claude Code**: OMP reads skills from `~/.claude/skills/*/SKILL.md`. The `allowed-tools` and `model` frontmatter fields are ignored.
 
-**Codex CLI**: Pi reads skills from `~/.codex/skills/` recursively. Hidden files/directories and symlinks are skipped.
+**Codex CLI**: OMP reads skills from `~/.codex/skills/` recursively. Hidden files/directories and symlinks are skipped.
 
 ## Skill Repositories
 
@@ -275,10 +275,10 @@ For inspiration and ready-to-use skills:
 
 CLI:
 ```bash
-pi --no-skills
+omp --no-skills
 ```
 
-Settings (`~/.pi/agent/settings.json`):
+Settings (`~/.omp/agent/settings.json`):
 ```json
 {
   "skills": {

package/docs/theme.md

@@ -1,6 +1,6 @@
-> pi can create themes. Ask it to build one for your use case.
+> omp can create themes. Ask it to build one for your use case.
 
-# Pi Coding Agent Themes
+# OMP Coding Agent Themes
 
 Themes allow you to customize the colors used throughout the coding agent TUI.
 
@@ -205,7 +205,7 @@ This is useful for:
 
 ## Built-in Themes
 
-Pi comes with two built-in themes:
+OMP comes with two built-in themes:
 
 ### `dark` (default)
 
@@ -227,26 +227,26 @@ Themes are configured in the settings (accessible via `/settings`):
 
 Or use the `/theme` command interactively.
 
-On first run, Pi detects your terminal's background and sets a sensible default (`dark` or `light`).
+On first run, OMP detects your terminal's background and sets a sensible default (`dark` or `light`).
 
 ## Custom Themes
 
 ### Theme Locations
 
-Custom themes are loaded from `~/.pi/agent/themes/*.json`.
+Custom themes are loaded from `~/.omp/agent/themes/*.json`.
 
 ### Creating a Custom Theme
 
 1. **Create theme directory:**
 
    ```bash
-   mkdir -p ~/.pi/agent/themes
+   mkdir -p ~/.omp/agent/themes
    ```
 
 2. **Create theme file:**
 
    ```bash
-   vim ~/.pi/agent/themes/my-theme.json
+   vim ~/.omp/agent/themes/my-theme.json
    ```
 
 3. **Define all colors:**
@@ -411,14 +411,14 @@ Example usage:
 
 ### Terminal Compatibility
 
-Pi uses 24-bit RGB colors (`\x1b[38;2;R;G;Bm`). Most modern terminals support this:
+OMP uses 24-bit RGB colors (`\x1b[38;2;R;G;Bm`). Most modern terminals support this:
 
 - ✅ iTerm2, Alacritty, Kitty, WezTerm
 - ✅ Windows Terminal
 - ✅ VS Code integrated terminal
 - ✅ Modern GNOME Terminal, Konsole
 
-For older terminals with only 256-color support, Pi automatically falls back to the nearest 256-color approximation.
+For older terminals with only 256-color support, OMP automatically falls back to the nearest 256-color approximation.
 
 To check if your terminal supports truecolor:
 

package/docs/tui.md

@@ -1,4 +1,4 @@
-> pi can create TUI components. Ask it to build one for your use case.
+> omp can create TUI components. Ask it to build one for your use case.
 
 # TUI Components
 

package/examples/README.md

@@ -1,6 +1,6 @@
 # Examples
 
-Example code for pi-coding-agent SDK, hooks, and custom tools.
+Example code for omp-coding-agent SDK, hooks, and custom tools.
 
 ## Directories
 

package/examples/custom-tools/README.md

@@ -1,6 +1,6 @@
 # Custom Tools Examples
 
-Example custom tools for pi-coding-agent.
+Example custom tools for omp-coding-agent.
 
 ## Examples
 
@@ -38,13 +38,13 @@ See [subagent/README.md](subagent/README.md) for full documentation.
 
 ```bash
 # Test directly (can point to any .ts file)
-pi --tool examples/custom-tools/todo/index.ts
+omp --tool examples/custom-tools/todo/index.ts
 
 # Or copy entire folder to tools directory for persistent use
-cp -r todo ~/.pi/agent/tools/
+cp -r todo ~/.omp/agent/tools/
 ```
 
-Then in pi:
+Then in omp:
 
 ```
 > add a todo "test custom tools"

package/examples/custom-tools/subagent/README.md

@@ -4,7 +4,7 @@ Delegate tasks to specialized subagents with isolated context windows.
 
 ## Features
 
-- **Isolated context**: Each subagent runs in a separate `pi` process
+- **Isolated context**: Each subagent runs in a separate `omp` process
 - **Streaming output**: See tool calls and progress as they happen
 - **Parallel streaming**: All parallel tasks stream updates simultaneously
 - **Markdown rendering**: Final output rendered with proper formatting (expanded view)
@@ -35,30 +35,30 @@ From the repository root, symlink the files:
 
 ```bash
 # Symlink the tool (must be in a subdirectory with index.ts)
-mkdir -p ~/.pi/agent/tools/subagent
-ln -sf "$(pwd)/packages/coding-agent/examples/custom-tools/subagent/subagent.ts" ~/.pi/agent/tools/subagent/index.ts
-ln -sf "$(pwd)/packages/coding-agent/examples/custom-tools/subagent/agents.ts" ~/.pi/agent/tools/subagent/agents.ts
+mkdir -p ~/.omp/agent/tools/subagent
+ln -sf "$(pwd)/packages/coding-agent/examples/custom-tools/subagent/subagent.ts" ~/.omp/agent/tools/subagent/index.ts
+ln -sf "$(pwd)/packages/coding-agent/examples/custom-tools/subagent/agents.ts" ~/.omp/agent/tools/subagent/agents.ts
 
 # Symlink agents
-mkdir -p ~/.pi/agent/agents
+mkdir -p ~/.omp/agent/agents
 for f in packages/coding-agent/examples/custom-tools/subagent/agents/*.md; do
-  ln -sf "$(pwd)/$f" ~/.pi/agent/agents/$(basename "$f")
+  ln -sf "$(pwd)/$f" ~/.omp/agent/agents/$(basename "$f")
 done
 
 # Symlink workflow commands
-mkdir -p ~/.pi/agent/commands
+mkdir -p ~/.omp/agent/commands
 for f in packages/coding-agent/examples/custom-tools/subagent/commands/*.md; do
-  ln -sf "$(pwd)/$f" ~/.pi/agent/commands/$(basename "$f")
+  ln -sf "$(pwd)/$f" ~/.omp/agent/commands/$(basename "$f")
 done
 ```
 
 ## Security Model
 
-This tool executes a separate `pi` subprocess with a delegated system prompt and tool/model configuration.
+This tool executes a separate `omp` subprocess with a delegated system prompt and tool/model configuration.
 
-**Project-local agents** (`.pi/agents/*.md`) are repo-controlled prompts that can instruct the model to read files, run bash commands, etc.
+**Project-local agents** (`.omp/agents/*.md`) are repo-controlled prompts that can instruct the model to read files, run bash commands, etc.
 
-**Default behavior:** Only loads **user-level agents** from `~/.pi/agent/agents`.
+**Default behavior:** Only loads **user-level agents** from `~/.omp/agent/agents`.
 
 To enable project-local agents, pass `agentScope: "both"` (or `"project"`). Only do this for repositories you trust.
 
@@ -136,8 +136,8 @@ System prompt for the agent goes here.
 ```
 
 **Locations:**
-- `~/.pi/agent/agents/*.md` - User-level (always loaded)
-- `.pi/agents/*.md` - Project-level (only with `agentScope: "project"` or `"both"`)
+- `~/.omp/agent/agents/*.md` - User-level (always loaded)
+- `.omp/agents/*.md` - Project-level (only with `agentScope: "project"` or `"both"`)
 
 Project agents override user agents with the same name when `agentScope: "both"`.
 

package/examples/custom-tools/subagent/agents.ts

@@ -115,7 +115,7 @@ function isDirectory(p: string): boolean {
 function findNearestProjectAgentsDir(cwd: string): string | null {
 	let currentDir = cwd;
 	while (true) {
-		const candidate = path.join(currentDir, ".pi", "agents");
+		const candidate = path.join(currentDir, ".omp", "agents");
 		if (isDirectory(candidate)) return candidate;
 
 		const parentDir = path.dirname(currentDir);
@@ -125,7 +125,7 @@ function findNearestProjectAgentsDir(cwd: string): string | null {
 }
 
 export function discoverAgents(cwd: string, scope: AgentScope): AgentDiscoveryResult {
-	const userDir = path.join(os.homedir(), ".pi", "agent", "agents");
+	const userDir = path.join(os.homedir(), ".omp", "agent", "agents");
 	const projectAgentsDir = findNearestProjectAgentsDir(cwd);
 
 	const userAgents = scope === "project" ? [] : loadAgentsFromDir(userDir, "user");

package/examples/custom-tools/subagent/index.ts

@@ -1,7 +1,7 @@
 /**
  * Subagent Tool - Delegate tasks to specialized agents
  *
- * Spawns a separate `pi` process for each subagent invocation,
+ * Spawns a separate `omp` process for each subagent invocation,
  * giving it an isolated context window.
  *
  * Supports three modes:
@@ -205,7 +205,7 @@ async function mapWithConcurrencyLimit<TIn, TOut>(
 }
 
 function writePromptToTempFile(agentName: string, prompt: string): { dir: string; filePath: string } {
-	const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-subagent-"));
+	const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "omp-subagent-"));
 	const safeName = agentName.replace(/[^\w.-]+/g, "_");
 	const filePath = path.join(tmpDir, `prompt-${safeName}.md`);
 	fs.writeFileSync(filePath, prompt, { encoding: "utf-8", mode: 0o600 });
@@ -280,7 +280,7 @@ async function runSingleAgent(
 		let wasAborted = false;
 
 		const exitCode = await new Promise<number>((resolve) => {
-			const proc = Bun.spawn(["pi", ...args], {
+			const proc = Bun.spawn(["omp", ...args], {
 				cwd: cwd ?? pi.cwd,
 				stdin: "ignore",
 				stdout: "pipe",
@@ -440,8 +440,8 @@ const factory: CustomToolFactory = (pi) => {
 			return [
 				"Delegate tasks to specialized subagents with isolated context.",
 				"Modes: single (agent + task), parallel (tasks array), chain (sequential with {previous} placeholder).",
-				'Default agent scope is "user" (from ~/.pi/agent/agents).',
-				'To enable project-local agents in .pi/agents, set agentScope: "both" (or "project").',
+				'Default agent scope is "user" (from ~/.omp/agent/agents).',
+				'To enable project-local agents in .omp/agents, set agentScope: "both" (or "project").',
 				`User agents: ${userList.text}${userSuffix}.`,
 				`Project agents${projectDirNote}: ${projectList.text}${projectSuffix}.`,
 			].join(" ");

package/examples/hooks/README.md

@@ -1,15 +1,15 @@
 # Hooks Examples
 
-Example hooks for pi-coding-agent.
+Example hooks for omp-coding-agent.
 
 ## Usage
 
 ```bash
 # Load a hook with --hook flag
-pi --hook examples/hooks/permission-gate.ts
+omp --hook examples/hooks/permission-gate.ts
 
 # Or copy to hooks directory for auto-discovery
-cp permission-gate.ts ~/.pi/agent/hooks/
+cp permission-gate.ts ~/.omp/agent/hooks/
 ```
 
 ## Examples

package/examples/hooks/auto-commit-on-exit.ts

@@ -36,7 +36,7 @@ export default function (pi: HookAPI) {
 
 		// Generate a simple commit message
 		const firstLine = lastAssistantText.split("\n")[0] || "Work in progress";
-		const commitMessage = `[pi] ${firstLine.slice(0, 50)}${firstLine.length > 50 ? "..." : ""}`;
+		const commitMessage = `[omp] ${firstLine.slice(0, 50)}${firstLine.length > 50 ? "..." : ""}`;
 
 		// Stage and commit
 		await pi.exec("git", ["add", "-A"]);

package/examples/hooks/custom-compaction.ts

@@ -10,7 +10,7 @@
  * which can be cheaper/faster than the main conversation model.
  *
  * Usage:
- *   pi --hook examples/hooks/custom-compaction.ts
+ *   omp --hook examples/hooks/custom-compaction.ts
  */
 
 import { complete, getModel } from "@oh-my-pi/pi-ai";

package/examples/sdk/01-minimal.ts

@@ -2,7 +2,7 @@
  * Minimal SDK Usage
  *
  * Uses all defaults: discovers skills, hooks, tools, context files
- * from cwd and ~/.pi/agent. Model chosen from settings or first available.
+ * from cwd and ~/.omp/agent. Model chosen from settings or first available.
  */
 
 import { createAgentSession } from "@oh-my-pi/pi-coding-agent";

package/examples/sdk/04-skills.ts

@@ -7,7 +7,7 @@
 
 import { createAgentSession, discoverSkills, SessionManager, type Skill } from "@oh-my-pi/pi-coding-agent";
 
-// Discover all skills from cwd/.pi/skills, ~/.pi/agent/skills, etc.
+// Discover all skills from cwd/.omp/skills, ~/.omp/agent/skills, etc.
 const allSkills = discoverSkills();
 console.log(
 	"Discovered skills:",

package/examples/sdk/05-tools.ts

@@ -82,7 +82,7 @@ session.subscribe((event) => {
 await session.prompt("What's the weather in Tokyo?");
 console.log();
 
-// Merge with discovered tools from cwd/.pi/tools and ~/.pi/agent/tools:
+// Merge with discovered tools from cwd/.omp/tools and ~/.omp/agent/tools:
 // const discovered = await discoverCustomTools();
 // customTools: [...discovered, { tool: myTool }]
 

package/examples/sdk/08-slash-commands.ts

@@ -11,7 +11,7 @@ import {
 	SessionManager,
 } from "@oh-my-pi/pi-coding-agent";
 
-// Discover commands from cwd/.pi/commands/ and ~/.pi/agent/commands/
+// Discover commands from cwd/.omp/commands/ and ~/.omp/agent/commands/
 const discovered = discoverSlashCommands();
 console.log("Discovered slash commands:");
 for (const cmd of discovered) {

package/examples/sdk/09-api-keys-and-oauth.ts

@@ -13,8 +13,8 @@ import {
 	SessionManager,
 } from "@oh-my-pi/pi-coding-agent";
 
-// Default: discoverAuthStorage() uses ~/.pi/agent/auth.json
-// discoverModels() loads built-in + custom models from ~/.pi/agent/models.json
+// Default: discoverAuthStorage() uses ~/.omp/agent/auth.json
+// discoverModels() loads built-in + custom models from ~/.omp/agent/models.json
 const authStorage = discoverAuthStorage();
 const modelRegistry = discoverModels(authStorage);
 

package/examples/sdk/README.md

@@ -1,6 +1,6 @@
 # SDK Examples
 
-Programmatic usage of pi-coding-agent via `createAgentSession()`.
+Programmatic usage of omp-coding-agent via `createAgentSession()`.
 
 ## Examples
 
@@ -115,7 +115,7 @@ await session.prompt("Hello");
 | `authStorage`               | `discoverAuthStorage()`       | Credential storage                |
 | `modelRegistry`             | `discoverModels(authStorage)` | Model registry                    |
 | `cwd`                       | `process.cwd()`               | Working directory                 |
-| `agentDir`                  | `~/.pi/agent`                 | Config directory                  |
+| `agentDir`                  | `~/.omp/agent`                | Config directory                  |
 | `model`                     | From settings/first available | Model to use                      |
 | `thinkingLevel`             | From settings/"off"           | off, low, medium, high            |
 | `systemPrompt`              | Discovered                    | String or `(default) => modified` |

package/package.json

@@ -1,14 +1,14 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "2.3.1337",
+	"version": "3.1.1337",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
-	"piConfig": {
-		"name": "pi",
-		"configDir": ".pi"
+	"ompConfig": {
+		"name": "omp",
+		"configDir": ".omp"
 	},
 	"bin": {
-		"pi": "src/cli.ts"
+		"omp": "src/cli.ts"
 	},
 	"main": "./src/index.ts",
 	"types": "./src/index.ts",
@@ -32,20 +32,19 @@
 		"check": "tsgo --noEmit",
 		"clean": "rm -rf dist",
 		"build": "tsgo -p tsconfig.build.json && chmod +x dist/cli.js",
-		"build:binary": "bun build --compile ./src/cli.ts --outfile dist/pi",
+		"build:binary": "bun build --compile ./src/cli.ts --outfile dist/omp",
 		"generate-template": "bun scripts/generate-template.ts",
 		"postinstall": "[ -f scripts/generate-template.ts ] && bun run generate-template || true",
 		"test": "bun test",
 		"prepublishOnly": "bun run generate-template && bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-agent-core": "2.3.1337",
-		"@oh-my-pi/pi-ai": "2.3.1337",
-		"@oh-my-pi/pi-tui": "2.3.1337",
+		"@oh-my-pi/pi-agent-core": "3.1.1337",
+		"@oh-my-pi/pi-ai": "3.1.1337",
+		"@oh-my-pi/pi-tui": "3.1.1337",
 		"@sinclair/typebox": "^0.34.46",
 		"ajv": "^8.17.1",
 		"chalk": "^5.5.0",
-		"node-html-parser": "^6.1.13",
 		"cli-highlight": "^2.1.11",
 		"diff": "^8.0.2",
 		"file-type": "^21.1.1",
@@ -53,9 +52,12 @@
 		"highlight.js": "^11.11.1",
 		"marked": "^15.0.12",
 		"minimatch": "^10.1.1",
+		"node-html-parser": "^6.1.13",
+		"smol-toml": "^1.6.0",
 		"strip-ansi": "^7.1.2",
 		"winston": "^3.17.0",
-		"winston-daily-rotate-file": "^5.0.0"
+		"winston-daily-rotate-file": "^5.0.0",
+		"yaml": "^2.8.2"
 	},
 	"devDependencies": {
 		"@types/diff": "^7.0.2",

package/src/capability/context-file.ts

@@ -0,0 +1,40 @@
+/**
+ * Context Files Capability
+ *
+ * System instruction files (CLAUDE.md, AGENTS.md, GEMINI.md, etc.) that provide
+ * persistent guidance to the agent.
+ */
+
+import { defineCapability } from "./index";
+import type { SourceMeta } from "./types";
+
+/**
+ * A context file that provides persistent instructions to the agent.
+ */
+export interface ContextFile {
+	/** Absolute path to the file */
+	path: string;
+	/** File content */
+	content: string;
+	/** Which level this came from */
+	level: "user" | "project";
+	/** Distance from cwd (0 = in cwd, 1 = parent, etc.) for project files */
+	depth?: number;
+	/** Source metadata */
+	_source: SourceMeta;
+}
+
+export const contextFileCapability = defineCapability<ContextFile>({
+	id: "context-files",
+	displayName: "Context Files",
+	description: "Persistent instruction files (CLAUDE.md, AGENTS.md, etc.) that guide agent behavior",
+	// Deduplicate by level: one user-level file, one project-level file
+	// Higher-priority providers shadow lower-priority ones at the same scope
+	key: (file) => file.level,
+	validate: (file) => {
+		if (!file.path) return "Missing path";
+		if (file.content === undefined) return "Missing content";
+		if (file.level !== "user" && file.level !== "project") return "Invalid level: must be 'user' or 'project'";
+		return undefined;
+	},
+});

package/src/capability/extension.ts

@@ -0,0 +1,48 @@
+/**
+ * Extensions Capability
+ *
+ * Gemini-style extensions that provide MCP servers, tools, and context.
+ */
+
+import { defineCapability } from "./index";
+import type { MCPServer } from "./mcp";
+import type { SourceMeta } from "./types";
+
+/**
+ * Extension manifest structure.
+ */
+export interface ExtensionManifest {
+	name?: string;
+	description?: string;
+	mcpServers?: Record<string, Omit<MCPServer, "name" | "_source">>;
+	tools?: unknown[];
+	context?: unknown;
+}
+
+/**
+ * A loaded extension.
+ */
+export interface Extension {
+	/** Extension name (from manifest.name or directory name) */
+	name: string;
+	/** Absolute path to extension directory */
+	path: string;
+	/** Parsed manifest data */
+	manifest: ExtensionManifest;
+	/** Source level */
+	level: "user" | "project";
+	/** Source metadata */
+	_source: SourceMeta;
+}
+
+export const extensionCapability = defineCapability<Extension>({
+	id: "extensions",
+	displayName: "Extensions",
+	description: "Gemini-style extensions providing MCP servers, tools, and context",
+	key: (ext) => ext.name,
+	validate: (ext) => {
+		if (!ext.name) return "Missing extension name";
+		if (!ext.path) return "Missing extension path";
+		return undefined;
+	},
+});

package/src/capability/hook.ts

@@ -0,0 +1,40 @@
+/**
+ * Hooks Capability
+ *
+ * Pre/post tool execution hooks defined as shell scripts.
+ */
+
+import { defineCapability } from "./index";
+import type { SourceMeta } from "./types";
+
+/**
+ * A hook script.
+ */
+export interface Hook {
+	/** Hook name (filename without extension) */
+	name: string;
+	/** Absolute path to hook file */
+	path: string;
+	/** Hook type (pre/post) and associated tool */
+	type: "pre" | "post";
+	/** Tool this hook applies to, or "*" for all */
+	tool: string;
+	/** Source level */
+	level: "user" | "project";
+	/** Source metadata */
+	_source: SourceMeta;
+}
+
+export const hookCapability = defineCapability<Hook>({
+	id: "hooks",
+	displayName: "Hooks",
+	description: "Pre/post tool execution hooks",
+	key: (hook) => `${hook.type}:${hook.tool}:${hook.name}`,
+	validate: (hook) => {
+		if (!hook.name) return "Missing name";
+		if (!hook.path) return "Missing path";
+		if (hook.type !== "pre" && hook.type !== "post") return "Invalid type (must be 'pre' or 'post')";
+		if (!hook.tool) return "Missing tool";
+		return undefined;
+	},
+});