@sentry/dotagents 0.3.0 → 0.4.0

package/README.md

@@ -6,7 +6,7 @@ A package manager for `.agents` directories. Declare agent skill dependencies in
 
 **One source of truth.** Skills live in `.agents/skills/` and symlink into `.claude/skills/`, `.cursor/skills/`, or wherever your tools expect them. No copy-pasting between directories.
 
-**Reproducible.** `agents.lock` pins exact commits and integrity hashes. `dotagents install --frozen` in CI guarantees everyone runs the same skills.
+**Reproducible.** `agents.lock` pins exact commits and integrity hashes. `npx @sentry/dotagents install --frozen` in CI guarantees everyone runs the same skills.
 
 **Shareable.** Skills are just directories with a `SKILL.md`. Host them in any git repo, discover them automatically, install with one command.
 
@@ -14,13 +14,13 @@ A package manager for `.agents` directories. Declare agent skill dependencies in
 
 ```bash
 # Initialize a new project
-npx dotagents init
+npx @sentry/dotagents init
 
 # Add a skill from a GitHub repo
-npx dotagents add getsentry/skills --name find-bugs
+npx @sentry/dotagents add getsentry/skills --name find-bugs
 
 # Install all declared skills
-npx dotagents install
+npx @sentry/dotagents install
 ```
 
 This creates an `agents.toml`:
@@ -28,6 +28,7 @@ This creates an `agents.toml`:
 ```toml
 version = 1
 gitignore = false
+agents = ["claude"]
 
 [[skills]]
 name = "find-bugs"
@@ -40,13 +41,13 @@ And a lockfile (`agents.lock`) pinning the exact commit and integrity hash.
 
 | Command | Description |
 |---------|-------------|
-| `dotagents init` | Create `agents.toml` and `.agents/skills/` |
-| `dotagents add <source>` | Add a skill dependency |
-| `dotagents remove <name>` | Remove a skill |
-| `dotagents install` | Install all dependencies from `agents.toml` |
-| `dotagents update [name]` | Update skills to latest versions |
-| `dotagents list` | Show installed skills and their status |
-| `dotagents sync` | Reconcile gitignore, symlinks, and verify state |
+| `init` | Create `agents.toml` and `.agents/skills/` |
+| `add <source>` | Add a skill dependency |
+| `remove <name>` | Remove a skill |
+| `install` | Install all dependencies from `agents.toml` |
+| `update [name]` | Update skills to latest versions |
+| `list` | Show installed skills and their status |
+| `sync` | Reconcile gitignore, symlinks, and verify state |
 
 ## Source Formats
 
@@ -68,19 +69,76 @@ name = "local"
 source = "path:./my-skills/local-skill"   # Local directory
 ```
 
+## Agent Targets
+
+The `agents` field tells dotagents which tools to configure. It handles skills symlinks, MCP config files, and hook config files for each agent.
+
+```toml
+agents = ["claude", "cursor"]
+```
+
+Supported agents: `claude`, `cursor`, `codex`, `vscode`, `opencode`.
+
+## MCP Servers
+
+Declare MCP servers once in `agents.toml` and dotagents generates the correct config file for each agent during `install` and `sync`.
+
+```toml
+agents = ["claude", "cursor"]
+
+# Stdio transport
+[[mcp]]
+name = "github"
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-github"]
+env = ["GITHUB_TOKEN"]
+
+# HTTP transport
+[[mcp]]
+name = "remote-api"
+url = "https://mcp.example.com/sse"
+headers = { Authorization = "Bearer tok" }
+```
+
+Each server uses either `command` (stdio) or `url` (HTTP), not both. The `env` field lists environment variable names to pass through from the user's environment.
+
+## Hooks
+
+Declare hooks once in `agents.toml` and dotagents writes the correct hook config for each agent that supports them.
+
+```toml
+agents = ["claude"]
+
+[[hooks]]
+event = "PreToolUse"
+matcher = "Bash"
+command = "my-lint-check"
+
+[[hooks]]
+event = "Stop"
+command = "notify-done"
+```
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `event` | Yes | `PreToolUse`, `PostToolUse`, `UserPromptSubmit`, or `Stop` |
+| `matcher` | No | Filter to specific tool names (e.g. `Bash`, `Write`) |
+| `command` | Yes | Shell command to run when the hook fires |
+
 ## How It Works
 
 1. Skills are declared in `agents.toml` at the project root
-2. `dotagents install` clones repos, discovers skills by convention, and copies them into `.agents/skills/`
+2. `install` clones repos, discovers skills by convention, and copies them into `.agents/skills/`
 3. `agents.lock` records the resolved commit and a SHA-256 integrity hash
 4. By default (`gitignore = false`), skills are checked into git so collaborators get them immediately. Set `gitignore = true` to auto-generate `.agents/.gitignore` and exclude managed skills instead.
-5. Symlinks connect `.agents/skills/` to wherever your tools look (configured via `symlinks.targets`)
+5. Symlinks connect `.agents/skills/` to wherever your tools look (configured via the `agents` field)
+6. MCP and hook configs are generated for each declared agent
 
 ## Checking In Skills
 
-By default, `dotagents init` sets `gitignore = false` so installed skills are committed to git. This means anyone cloning the repo gets skills immediately — they only need dotagents when adding or updating skills.
+By default, `init` sets `gitignore = false` so installed skills are committed to git. This means anyone cloning the repo gets skills immediately — they only need dotagents when adding or updating skills.
 
-To gitignore managed skills instead (collaborators must run `dotagents install`), set `gitignore = true` in `agents.toml` or remove the field entirely (it defaults to `true` when absent for backward compatibility).
+To gitignore managed skills instead (collaborators must run `install`), set `gitignore = true` in `agents.toml` or remove the field entirely (it defaults to `true` when absent for backward compatibility).
 
 ## Contributing
 

package/dist/agents/definitions/claude.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition } from "../types.js";
+declare const claude: AgentDefinition;
+export default claude;
+//# sourceMappingURL=claude.d.ts.map

package/dist/agents/definitions/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,QAAA,MAAM,MAAM,EAAE,eAuBb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/agents/definitions/claude.js

@@ -0,0 +1,28 @@
+import { envRecord, httpServer, serializeClaudeHooks } from "./helpers.js";
+const claude = {
+    id: "claude",
+    displayName: "Claude Code",
+    configDir: ".claude",
+    skillsParentDir: ".claude",
+    mcp: {
+        filePath: ".mcp.json",
+        rootKey: "mcpServers",
+        format: "json",
+        shared: false,
+    },
+    serializeServer(s) {
+        if (s.url)
+            return httpServer(s);
+        const env = envRecord(s.env, (k) => `\${${k}}`);
+        return [s.name, { command: s.command, args: s.args ?? [], ...(env && { env }) }];
+    },
+    hooks: {
+        filePath: ".claude/settings.json",
+        rootKey: "hooks",
+        format: "json",
+        shared: true,
+    },
+    serializeHooks: serializeClaudeHooks,
+};
+export default claude;
+//# sourceMappingURL=claude.js.map

package/dist/agents/definitions/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/agents/definitions/claude.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,GAAoB;IAC9B,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,GAAG,EAAE;QACH,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,KAAK;KACd;IACD,eAAe,CAAC,CAAC;QACf,IAAI,CAAC,CAAC,GAAG;YAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChD,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;KACb;IACD,cAAc,EAAE,oBAAoB;CACrC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/agents/definitions/codex.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition } from "../types.js";
+declare const codex: AgentDefinition;
+export default codex;
+//# sourceMappingURL=codex.d.ts.map

package/dist/agents/definitions/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,QAAA,MAAM,KAAK,EAAE,eAgBZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/agents/definitions/codex.js

@@ -0,0 +1,21 @@
+import { UnsupportedFeature } from "../errors.js";
+import claude from "./claude.js";
+const codex = {
+    ...claude,
+    id: "codex",
+    displayName: "Codex",
+    configDir: ".codex",
+    skillsParentDir: ".codex",
+    mcp: {
+        filePath: ".codex/config.toml",
+        rootKey: "mcp_servers",
+        format: "toml",
+        shared: true,
+    },
+    hooks: undefined,
+    serializeHooks() {
+        throw new UnsupportedFeature("codex", "hooks");
+    },
+};
+export default codex;
+//# sourceMappingURL=codex.js.map

package/dist/agents/definitions/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/agents/definitions/codex.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,KAAK,GAAoB;IAC7B,GAAG,MAAM;IACT,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,OAAO;IACpB,SAAS,EAAE,QAAQ;IACnB,eAAe,EAAE,QAAQ;IACzB,GAAG,EAAE;QACH,QAAQ,EAAE,oBAAoB;QAC9B,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;KACb;IACD,KAAK,EAAE,SAAS;IAChB,cAAc;QACZ,MAAM,IAAI,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/agents/definitions/cursor.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition } from "../types.js";
+declare const cursor: AgentDefinition;
+export default cursor;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/agents/definitions/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,aAAa,CAAC;AAepE,QAAA,MAAM,MAAM,EAAE,eA+Bb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/agents/definitions/cursor.js

@@ -0,0 +1,45 @@
+import claude from "./claude.js";
+/**
+ * Maps universal hook events to Cursor event names.
+ * PreToolUse maps to both beforeShellExecution and beforeMCPExecution.
+ */
+const CURSOR_EVENT_MAP = {
+    PreToolUse: ["beforeShellExecution", "beforeMCPExecution"],
+    PostToolUse: ["afterFileEdit"],
+    UserPromptSubmit: ["beforeSubmitPrompt"],
+    Stop: ["stop"],
+};
+const cursor = {
+    ...claude,
+    id: "cursor",
+    displayName: "Cursor",
+    configDir: ".cursor",
+    skillsParentDir: ".cursor",
+    mcp: {
+        filePath: ".cursor/mcp.json",
+        rootKey: "mcpServers",
+        format: "json",
+        shared: false,
+    },
+    hooks: {
+        filePath: ".cursor/hooks.json",
+        rootKey: "hooks",
+        format: "json",
+        shared: false,
+        extraFields: { version: 1 },
+    },
+    serializeHooks(hooks) {
+        const result = {};
+        for (const h of hooks) {
+            const cursorEvents = CURSOR_EVENT_MAP[h.event];
+            for (const ce of cursorEvents) {
+                const list = result[ce] ?? [];
+                list.push({ command: h.command });
+                result[ce] = list;
+            }
+        }
+        return result;
+    },
+};
+export default cursor;
+//# sourceMappingURL=cursor.js.map

package/dist/agents/definitions/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/agents/definitions/cursor.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;GAGG;AACH,MAAM,gBAAgB,GAAgC;IACpD,UAAU,EAAE,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;IAC1D,WAAW,EAAE,CAAC,eAAe,CAAC;IAC9B,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;IACxC,IAAI,EAAE,CAAC,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,GAAoB;IAC9B,GAAG,MAAM;IACT,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,QAAQ;IACrB,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,GAAG,EAAE;QACH,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,KAAK;KACd;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,oBAAoB;QAC9B,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;KAC5B;IACD,cAAc,CAAC,KAAwB;QACrC,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC/C,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;gBAC9B,MAAM,IAAI,GAAI,MAAM,CAAC,EAAE,CAAe,IAAI,EAAE,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/agents/definitions/helpers.d.ts

@@ -0,0 +1,14 @@
+import type { McpDeclaration, HookDeclaration } from "../types.js";
+export declare function envRecord(env: string[] | undefined, template: (key: string) => string): Record<string, string> | undefined;
+export declare function httpServer(s: McpDeclaration, type?: string): [string, unknown];
+/**
+ * Serialize hooks into Claude Code / VS Code settings.json format.
+ *
+ * Output shape:
+ * {
+ *   "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "..." }] }],
+ *   "Stop": [{ "hooks": [{ "type": "command", "command": "..." }] }]
+ * }
+ */
+export declare function serializeClaudeHooks(hooks: HookDeclaration[]): Record<string, unknown>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/agents/definitions/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,EACzB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAKpC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAS9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUtF"}

package/dist/agents/definitions/helpers.js

@@ -0,0 +1,39 @@
+export function envRecord(env, template) {
+    if (!env || env.length === 0)
+        return undefined;
+    const rec = {};
+    for (const key of env)
+        rec[key] = template(key);
+    return rec;
+}
+export function httpServer(s, type) {
+    return [
+        s.name,
+        {
+            ...(type && { type }),
+            url: s.url,
+            ...(s.headers && { headers: s.headers }),
+        },
+    ];
+}
+/**
+ * Serialize hooks into Claude Code / VS Code settings.json format.
+ *
+ * Output shape:
+ * {
+ *   "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "..." }] }],
+ *   "Stop": [{ "hooks": [{ "type": "command", "command": "..." }] }]
+ * }
+ */
+export function serializeClaudeHooks(hooks) {
+    const result = {};
+    for (const h of hooks) {
+        const entry = {
+            ...(h.matcher && { matcher: h.matcher }),
+            hooks: [{ type: "command", command: h.command }],
+        };
+        (result[h.event] ??= []).push(entry);
+    }
+    return result;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/agents/definitions/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/agents/definitions/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CACvB,GAAyB,EACzB,QAAiC;IAEjC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,GAAG;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAiB,EAAE,IAAa;IACzD,OAAO;QACL,CAAC,CAAC,IAAI;QACN;YACE,GAAG,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACrB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SACzC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAwB;IAC3D,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG;YACZ,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACxC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SACjD,CAAC;QACF,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/agents/definitions/opencode.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition } from "../types.js";
+declare const opencode: AgentDefinition;
+export default opencode;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/agents/definitions/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,QAAA,MAAM,QAAQ,EAAE,eA2Bf,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/agents/definitions/opencode.js

@@ -0,0 +1,33 @@
+import { UnsupportedFeature } from "../errors.js";
+import { envRecord, httpServer } from "./helpers.js";
+const opencode = {
+    id: "opencode",
+    displayName: "OpenCode",
+    configDir: ".claude",
+    skillsParentDir: ".claude",
+    mcp: {
+        filePath: "opencode.json",
+        rootKey: "mcp",
+        format: "json",
+        shared: true,
+    },
+    serializeServer(s) {
+        if (s.url)
+            return httpServer(s, "remote");
+        const env = envRecord(s.env, (k) => `\${${k}}`);
+        return [
+            s.name,
+            {
+                type: "local",
+                command: [s.command, ...(s.args ?? [])],
+                ...(env && { environment: env }),
+            },
+        ];
+    },
+    hooks: undefined,
+    serializeHooks() {
+        throw new UnsupportedFeature("opencode", "hooks");
+    },
+};
+export default opencode;
+//# sourceMappingURL=opencode.js.map

package/dist/agents/definitions/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/agents/definitions/opencode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,QAAQ,GAAoB;IAChC,EAAE,EAAE,UAAU;IACd,WAAW,EAAE,UAAU;IACvB,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,GAAG,EAAE;QACH,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;KACb;IACD,eAAe,CAAC,CAAC;QACf,IAAI,CAAC,CAAC,GAAG;YAAE,OAAO,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChD,OAAO;YACL,CAAC,CAAC,IAAI;YACN;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,CAAC,CAAC,CAAC,OAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBACxC,GAAG,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;aACjC;SACF,CAAC;IACJ,CAAC;IACD,KAAK,EAAE,SAAS;IAChB,cAAc;QACZ,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CACF,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/agents/definitions/vscode.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition } from "../types.js";
+declare const vscode: AgentDefinition;
+export default vscode;
+//# sourceMappingURL=vscode.d.ts.map

package/dist/agents/definitions/vscode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/vscode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,QAAA,MAAM,MAAM,EAAE,eA0Bb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/agents/definitions/vscode.js

@@ -0,0 +1,31 @@
+import { envRecord, httpServer, serializeClaudeHooks } from "./helpers.js";
+const vscode = {
+    id: "vscode",
+    displayName: "VS Code Copilot",
+    configDir: ".vscode",
+    skillsParentDir: ".vscode",
+    mcp: {
+        filePath: ".vscode/mcp.json",
+        rootKey: "servers",
+        format: "json",
+        shared: false,
+    },
+    serializeServer(s) {
+        if (s.url)
+            return httpServer(s, "sse");
+        const env = envRecord(s.env, (k) => `\${input:${k}}`);
+        return [
+            s.name,
+            { type: "stdio", command: s.command, args: s.args ?? [], ...(env && { env }) },
+        ];
+    },
+    hooks: {
+        filePath: ".claude/settings.json",
+        rootKey: "hooks",
+        format: "json",
+        shared: true,
+    },
+    serializeHooks: serializeClaudeHooks,
+};
+export default vscode;
+//# sourceMappingURL=vscode.js.map

package/dist/agents/definitions/vscode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.js","sourceRoot":"","sources":["../../../src/agents/definitions/vscode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,GAAoB;IAC9B,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,GAAG,EAAE;QACH,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,KAAK;KACd;IACD,eAAe,CAAC,CAAC;QACf,IAAI,CAAC,CAAC,GAAG;YAAE,OAAO,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO;YACL,CAAC,CAAC,IAAI;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE;SAC/E,CAAC;IACJ,CAAC;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;KACb;IACD,cAAc,EAAE,oBAAoB;CACrC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/agents/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Thrown when an agent does not support a requested feature (e.g. hooks).
+ */
+export declare class UnsupportedFeature extends Error {
+    readonly agentId: string;
+    readonly feature: string;
+    constructor(agentId: string, feature: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/agents/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,OAAO,EAAE,MAAM;aACf,OAAO,EAAE,MAAM;gBADf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM;CAKlC"}

package/dist/agents/errors.js

@@ -0,0 +1,14 @@
+/**
+ * Thrown when an agent does not support a requested feature (e.g. hooks).
+ */
+export class UnsupportedFeature extends Error {
+    agentId;
+    feature;
+    constructor(agentId, feature) {
+        super(`Agent "${agentId}" does not support ${feature}`);
+        this.agentId = agentId;
+        this.feature = feature;
+        this.name = "UnsupportedFeature";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/agents/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEzB;IACA;IAFlB,YACkB,OAAe,EACf,OAAe;QAE/B,KAAK,CAAC,UAAU,OAAO,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAHxC,YAAO,GAAP,OAAO,CAAQ;QACf,YAAO,GAAP,OAAO,CAAQ;QAG/B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/agents/hook-writer.d.ts

@@ -0,0 +1,26 @@
+import type { HookDeclaration } from "./types.js";
+import type { HookConfig } from "../config/schema.js";
+/**
+ * Convert HookConfig entries (from agents.toml) to universal HookDeclarations.
+ */
+export declare function toHookDeclarations(configs: HookConfig[]): HookDeclaration[];
+export interface HookWriteWarning {
+    agent: string;
+    message: string;
+}
+/**
+ * Write hook config files for each agent.
+ * - Dedicated files (shared=false): written fresh each time.
+ * - Shared files (shared=true): read existing, merge hooks under the root key, write back.
+ * - Agents that don't support hooks: collected as warnings.
+ */
+export declare function writeHookConfigs(projectRoot: string, agentIds: string[], hooks: HookDeclaration[]): Promise<HookWriteWarning[]>;
+/**
+ * Verify hook configs exist and contain expected hook data.
+ * Returns a list of issues found.
+ */
+export declare function verifyHookConfigs(projectRoot: string, agentIds: string[], hooks: HookDeclaration[]): Promise<{
+    agent: string;
+    issue: string;
+}[]>;
+//# sourceMappingURL=hook-writer.d.ts.map

package/dist/agents/hook-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-writer.d.ts","sourceRoot":"","sources":["../../src/agents/hook-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAM3E;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,eAAe,EAAE,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA+B7B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,eAAe,EAAE,GACvB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAmC7C"}

package/dist/agents/hook-writer.js

@@ -0,0 +1,105 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { getAgent } from "./registry.js";
+/**
+ * Convert HookConfig entries (from agents.toml) to universal HookDeclarations.
+ */
+export function toHookDeclarations(configs) {
+    return configs.map((h) => ({
+        event: h.event,
+        ...(h.matcher && { matcher: h.matcher }),
+        command: h.command,
+    }));
+}
+/**
+ * Write hook config files for each agent.
+ * - Dedicated files (shared=false): written fresh each time.
+ * - Shared files (shared=true): read existing, merge hooks under the root key, write back.
+ * - Agents that don't support hooks: collected as warnings.
+ */
+export async function writeHookConfigs(projectRoot, agentIds, hooks) {
+    const warnings = [];
+    if (hooks.length === 0)
+        return warnings;
+    const seen = new Set();
+    for (const id of agentIds) {
+        const agent = getAgent(id);
+        if (!agent)
+            continue;
+        if (!agent.hooks) {
+            warnings.push({ agent: id, message: `Agent "${agent.displayName}" does not support hooks` });
+            continue;
+        }
+        const serialized = agent.serializeHooks(hooks);
+        const spec = agent.hooks;
+        if (seen.has(spec.filePath))
+            continue;
+        seen.add(spec.filePath);
+        const filePath = join(projectRoot, spec.filePath);
+        await mkdir(dirname(filePath), { recursive: true });
+        if (spec.shared) {
+            await mergeWrite(filePath, spec, serialized);
+        }
+        else {
+            await freshWrite(filePath, spec, serialized);
+        }
+    }
+    return warnings;
+}
+/**
+ * Verify hook configs exist and contain expected hook data.
+ * Returns a list of issues found.
+ */
+export async function verifyHookConfigs(projectRoot, agentIds, hooks) {
+    if (hooks.length === 0)
+        return [];
+    const issues = [];
+    const seen = new Set();
+    for (const id of agentIds) {
+        const agent = getAgent(id);
+        if (!agent)
+            continue;
+        // Skip agents that don't support hooks
+        if (!agent.hooks)
+            continue;
+        const spec = agent.hooks;
+        if (seen.has(spec.filePath))
+            continue;
+        seen.add(spec.filePath);
+        const filePath = join(projectRoot, spec.filePath);
+        if (!existsSync(filePath)) {
+            issues.push({ agent: id, issue: `Hook config missing: ${spec.filePath}` });
+            continue;
+        }
+        try {
+            const existing = await readExisting(filePath);
+            const hooksSection = existing[spec.rootKey];
+            if (!hooksSection || typeof hooksSection !== "object") {
+                issues.push({ agent: id, issue: `Hook config missing "${spec.rootKey}" key in ${spec.filePath}` });
+            }
+        }
+        catch {
+            issues.push({ agent: id, issue: `Failed to read hook config: ${spec.filePath}` });
+        }
+    }
+    return issues;
+}
+// --- Internal helpers ---
+async function freshWrite(filePath, spec, serialized) {
+    const doc = {
+        ...spec.extraFields,
+        [spec.rootKey]: serialized,
+    };
+    await writeFile(filePath, JSON.stringify(doc, null, 2) + "\n", "utf-8");
+}
+async function mergeWrite(filePath, spec, serialized) {
+    const existing = existsSync(filePath) ? await readExisting(filePath) : {};
+    existing[spec.rootKey] = serialized;
+    await writeFile(filePath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+}
+async function readExisting(filePath) {
+    const raw = await readFile(filePath, "utf-8");
+    return JSON.parse(raw);
+}
+//# sourceMappingURL=hook-writer.js.map

package/dist/agents/hook-writer.js.map

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

package/dist/agents/hook-writer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hook-writer.test.d.ts.map

package/dist/agents/hook-writer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-writer.test.d.ts","sourceRoot":"","sources":["../../src/agents/hook-writer.test.ts"],"names":[],"mappings":""}