@thantos66/claude-context-mcp 0.1.0

package/dist/schemas/mcp-config.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+/**
+ * Shape of one entry in `mcpServers`. Two forms:
+ *  - stdio: `command` + optional `args`/`env`
+ *  - http:  `url`     + optional `headers`
+ *
+ * We allow extra unknown fields to pass through (the spec is evolving),
+ * but we validate the known ones strictly.
+ */
+export const StdioServerSchema = z
+    .object({
+    command: z.string().min(1),
+    args: z.array(z.string()).optional(),
+    env: z.record(z.string()).optional(),
+    cwd: z.string().optional(),
+    disabled: z.boolean().optional(),
+})
+    .passthrough();
+export const HttpServerSchema = z
+    .object({
+    url: z.string().url(),
+    headers: z.record(z.string()).optional(),
+    disabled: z.boolean().optional(),
+})
+    .passthrough();
+export const McpServerEntrySchema = z.union([StdioServerSchema, HttpServerSchema]);
+/** The full top-level file shape — both claude_desktop_config.json and .mcp.json
+ *  only use the `mcpServers` key; anything else is passed through untouched. */
+export const McpConfigFileSchema = z
+    .object({
+    mcpServers: z.record(McpServerEntrySchema).optional(),
+})
+    .passthrough();
+/** Type guard: stdio vs http entry. */
+export function isStdioServer(entry) {
+    return typeof entry.command === "string";
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/schemas/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../src/schemas/mcp-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEnF;gFACgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC;KACD,WAAW,EAAE,CAAC;AAOjB,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,KAAqB;IACjD,OAAO,OAAQ,KAAqB,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC5D,CAAC"}

package/dist/schemas/settings.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+/**
+ * Claude Code `settings.json` shape — we only validate the `permissions` key
+ * and `defaultMode`; everything else (hooks, model, env) passes through.
+ */
+export declare const DefaultModeSchema: z.ZodEnum<["default", "acceptEdits", "plan", "auto", "dontAsk", "bypassPermissions"]>;
+export declare const PermissionsBlockSchema: z.ZodObject<{
+    allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const SettingsFileSchema: z.ZodObject<{
+    permissions: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    defaultMode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "plan", "auto", "dontAsk", "bypassPermissions"]>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    permissions: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    defaultMode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "plan", "auto", "dontAsk", "bypassPermissions"]>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    permissions: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    defaultMode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "plan", "auto", "dontAsk", "bypassPermissions"]>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type DefaultMode = z.infer<typeof DefaultModeSchema>;
+export type PermissionsBlock = z.infer<typeof PermissionsBlockSchema>;
+export type SettingsFile = z.infer<typeof SettingsFileSchema>;
+export declare const PermissionListName: z.ZodEnum<["allow", "deny", "ask"]>;
+export type PermissionListName = z.infer<typeof PermissionListName>;

package/dist/schemas/settings.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/**
+ * Claude Code `settings.json` shape — we only validate the `permissions` key
+ * and `defaultMode`; everything else (hooks, model, env) passes through.
+ */
+export const DefaultModeSchema = z.enum([
+    "default",
+    "acceptEdits",
+    "plan",
+    "auto",
+    "dontAsk",
+    "bypassPermissions",
+]);
+export const PermissionsBlockSchema = z
+    .object({
+    allow: z.array(z.string()).optional(),
+    deny: z.array(z.string()).optional(),
+    ask: z.array(z.string()).optional(),
+})
+    .passthrough();
+export const SettingsFileSchema = z
+    .object({
+    permissions: PermissionsBlockSchema.optional(),
+    defaultMode: DefaultModeSchema.optional(),
+})
+    .passthrough();
+export const PermissionListName = z.enum(["allow", "deny", "ask"]);
+//# sourceMappingURL=settings.js.map

package/dist/schemas/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/schemas/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,SAAS;IACT,aAAa;IACb,MAAM;IACN,MAAM;IACN,SAAS;IACT,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,WAAW,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC9C,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;CAC1C,CAAC;KACD,WAAW,EAAE,CAAC;AAMjB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC"}

package/dist/schemas/skill-frontmatter.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+/**
+ * Claude Code skill (SKILL.md) frontmatter schema.
+ *
+ * Official fields per code.claude.com/docs/en/skills:
+ *   name, description, allowed-tools, disable-model-invocation,
+ *   user-invocable, model, effort, context, paths
+ */
+export declare const SkillEffortSchema: z.ZodEnum<["low", "medium", "high", "max"]>;
+export declare const SkillContextSchema: z.ZodEnum<["fork"]>;
+export declare const SkillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    "allowed-tools": z.ZodOptional<z.ZodString>;
+    "disable-model-invocation": z.ZodOptional<z.ZodBoolean>;
+    "user-invocable": z.ZodOptional<z.ZodBoolean>;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+    context: z.ZodOptional<z.ZodEnum<["fork"]>>;
+    paths: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name: z.ZodString;
+    description: z.ZodString;
+    "allowed-tools": z.ZodOptional<z.ZodString>;
+    "disable-model-invocation": z.ZodOptional<z.ZodBoolean>;
+    "user-invocable": z.ZodOptional<z.ZodBoolean>;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+    context: z.ZodOptional<z.ZodEnum<["fork"]>>;
+    paths: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name: z.ZodString;
+    description: z.ZodString;
+    "allowed-tools": z.ZodOptional<z.ZodString>;
+    "disable-model-invocation": z.ZodOptional<z.ZodBoolean>;
+    "user-invocable": z.ZodOptional<z.ZodBoolean>;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "max"]>>;
+    context: z.ZodOptional<z.ZodEnum<["fork"]>>;
+    paths: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type SkillFrontmatter = z.infer<typeof SkillFrontmatterSchema>;

package/dist/schemas/skill-frontmatter.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+/**
+ * Claude Code skill (SKILL.md) frontmatter schema.
+ *
+ * Official fields per code.claude.com/docs/en/skills:
+ *   name, description, allowed-tools, disable-model-invocation,
+ *   user-invocable, model, effort, context, paths
+ */
+export const SkillEffortSchema = z.enum(["low", "medium", "high", "max"]);
+export const SkillContextSchema = z.enum(["fork"]); // only documented value
+export const SkillFrontmatterSchema = z
+    .object({
+    name: z
+        .string()
+        .regex(/^[a-z0-9][a-z0-9-]*$/, "skill name must be lowercase alphanumeric + hyphens")
+        .max(64),
+    description: z.string().min(1),
+    "allowed-tools": z.string().optional(),
+    "disable-model-invocation": z.boolean().optional(),
+    "user-invocable": z.boolean().optional(),
+    model: z.string().optional(),
+    effort: SkillEffortSchema.optional(),
+    context: SkillContextSchema.optional(),
+    paths: z.union([z.string(), z.array(z.string())]).optional(),
+})
+    .passthrough();
+//# sourceMappingURL=skill-frontmatter.js.map

package/dist/schemas/skill-frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-frontmatter.js","sourceRoot":"","sources":["../../src/schemas/skill-frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,wBAAwB;AAE5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,sBAAsB,EAAE,qDAAqD,CAAC;SACpF,GAAG,CAAC,EAAE,CAAC;IACV,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClD,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/services/agents.d.ts

@@ -0,0 +1,56 @@
+import { type AgentFrontmatter } from "../schemas/agent-frontmatter.js";
+export interface AgentRecord {
+    scope: "user" | "project";
+    name: string;
+    path: string;
+    frontmatter: AgentFrontmatter;
+    body: string;
+}
+export interface AgentWriteResult {
+    path: string;
+    backup: string | null;
+    dryRun: boolean;
+    preview?: string;
+}
+/** List all agent markdown files in a scope. */
+export declare function listAgents(scope: "user" | "project", projectPath?: string): Promise<AgentRecord[]>;
+/** Read one agent file (by agent name, not file name). */
+export declare function getAgent(params: {
+    scope: "user" | "project";
+    name: string;
+    projectPath?: string;
+}): Promise<AgentRecord | null>;
+/** Serialize an agent record back to the on-disk SKILL.md format. */
+export declare function serializeAgent(frontmatter: AgentFrontmatter, body: string): string;
+/** Create a new agent file. Fails if it already exists (unless overwrite). */
+export declare function createAgent(params: {
+    scope: "user" | "project";
+    name: string;
+    description: string;
+    model?: string;
+    tools?: string | string[];
+    color?: string;
+    body?: string;
+    projectPath?: string;
+    overwrite?: boolean;
+    dryRun?: boolean;
+}): Promise<AgentWriteResult>;
+/** Patch frontmatter fields and/or replace the body of an existing agent. */
+export declare function updateAgent(params: {
+    scope: "user" | "project";
+    name: string;
+    description?: string;
+    model?: string;
+    tools?: string | string[];
+    color?: string;
+    body?: string;
+    projectPath?: string;
+    dryRun?: boolean;
+}): Promise<AgentWriteResult>;
+/** Delete an agent file. */
+export declare function deleteAgent(params: {
+    scope: "user" | "project";
+    name: string;
+    projectPath?: string;
+    dryRun?: boolean;
+}): Promise<AgentWriteResult>;

package/dist/services/agents.js

@@ -0,0 +1,155 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import matter from "gray-matter";
+import { AgentFrontmatterSchema, normalizeTools, } from "../schemas/agent-frontmatter.js";
+import { atomicWriteFile } from "./atomic-write.js";
+import { backupFile } from "./backup.js";
+import { agentsDirFor } from "./paths.js";
+/** List all agent markdown files in a scope. */
+export async function listAgents(scope, projectPath) {
+    const dir = agentsDirFor(scope, projectPath);
+    let names;
+    try {
+        names = await fs.readdir(dir);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const results = [];
+    for (const name of names) {
+        if (!name.endsWith(".md"))
+            continue;
+        const filePath = path.join(dir, name);
+        try {
+            const rec = await readAgentFile(scope, filePath);
+            results.push(rec);
+        }
+        catch {
+            // Skip malformed agent files rather than failing the whole list.
+            continue;
+        }
+    }
+    return results;
+}
+/** Read one agent file (by agent name, not file name). */
+export async function getAgent(params) {
+    const dir = agentsDirFor(params.scope, params.projectPath);
+    const filePath = path.join(dir, `${params.name}.md`);
+    try {
+        return await readAgentFile(params.scope, filePath);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+async function readAgentFile(scope, filePath) {
+    const raw = await fs.readFile(filePath, "utf8");
+    const parsed = matter(raw);
+    const frontmatter = AgentFrontmatterSchema.parse(parsed.data);
+    return {
+        scope,
+        name: frontmatter.name,
+        path: filePath,
+        frontmatter,
+        body: parsed.content.trimStart(),
+    };
+}
+/** Serialize an agent record back to the on-disk SKILL.md format. */
+export function serializeAgent(frontmatter, body) {
+    // gray-matter writes the fields in insertion order, so construct deliberately.
+    const ordered = {
+        name: frontmatter.name,
+        description: frontmatter.description,
+    };
+    if (frontmatter.model !== undefined)
+        ordered.model = frontmatter.model;
+    if (frontmatter.tools !== undefined)
+        ordered.tools = frontmatter.tools;
+    if (frontmatter.color !== undefined)
+        ordered.color = frontmatter.color;
+    for (const [k, v] of Object.entries(frontmatter)) {
+        if (v === undefined)
+            continue;
+        if (!(k in ordered))
+            ordered[k] = v;
+    }
+    const bodyText = body.endsWith("\n") ? body : body + "\n";
+    return matter.stringify(bodyText, ordered);
+}
+/** Create a new agent file. Fails if it already exists (unless overwrite). */
+export async function createAgent(params) {
+    const frontmatter = AgentFrontmatterSchema.parse({
+        name: params.name,
+        description: params.description,
+        model: params.model,
+        tools: normalizeTools(params.tools),
+        color: params.color,
+    });
+    const body = params.body ?? "";
+    const dir = agentsDirFor(params.scope, params.projectPath);
+    const filePath = path.join(dir, `${frontmatter.name}.md`);
+    if (!params.overwrite) {
+        try {
+            await fs.access(filePath);
+            throw new Error(`Agent "${frontmatter.name}" already exists at ${filePath}. Pass overwrite: true to replace.`);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+        }
+    }
+    const contents = serializeAgent(frontmatter, body);
+    if (params.dryRun) {
+        return { path: filePath, backup: null, dryRun: true, preview: contents };
+    }
+    await fs.mkdir(dir, { recursive: true });
+    const backup = await backupFile(filePath);
+    await atomicWriteFile(filePath, contents);
+    return { path: filePath, backup, dryRun: false };
+}
+/** Patch frontmatter fields and/or replace the body of an existing agent. */
+export async function updateAgent(params) {
+    const current = await getAgent({
+        scope: params.scope,
+        name: params.name,
+        projectPath: params.projectPath,
+    });
+    if (!current)
+        throw new Error(`Agent "${params.name}" not found in scope ${params.scope}.`);
+    const merged = AgentFrontmatterSchema.parse({
+        ...current.frontmatter,
+        ...(params.description !== undefined && { description: params.description }),
+        ...(params.model !== undefined && { model: params.model }),
+        ...(params.tools !== undefined && { tools: normalizeTools(params.tools) }),
+        ...(params.color !== undefined && { color: params.color }),
+    });
+    const body = params.body ?? current.body;
+    const contents = serializeAgent(merged, body);
+    if (params.dryRun) {
+        return { path: current.path, backup: null, dryRun: true, preview: contents };
+    }
+    const backup = await backupFile(current.path);
+    await atomicWriteFile(current.path, contents);
+    return { path: current.path, backup, dryRun: false };
+}
+/** Delete an agent file. */
+export async function deleteAgent(params) {
+    const current = await getAgent({
+        scope: params.scope,
+        name: params.name,
+        projectPath: params.projectPath,
+    });
+    if (!current)
+        throw new Error(`Agent "${params.name}" not found in scope ${params.scope}.`);
+    if (params.dryRun) {
+        return { path: current.path, backup: null, dryRun: true };
+    }
+    const backup = await backupFile(current.path);
+    await fs.unlink(current.path);
+    return { path: current.path, backup, dryRun: false };
+}
+//# sourceMappingURL=agents.js.map

package/dist/services/agents.js.map

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

package/dist/services/atomic-write.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Atomically write `contents` to `target`:
+ *   1. ensure parent dir exists
+ *   2. write to a sibling temp file
+ *   3. fsync + rename over target (atomic on POSIX)
+ * If any step fails, the temp file is cleaned up and the target is untouched.
+ */
+export declare function atomicWriteFile(target: string, contents: string): Promise<void>;
+/** Serialize JSON with 2-space indent and a trailing newline. */
+export declare function stringifyJson(value: unknown): string;

package/dist/services/atomic-write.js

@@ -0,0 +1,46 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+/**
+ * Atomically write `contents` to `target`:
+ *   1. ensure parent dir exists
+ *   2. write to a sibling temp file
+ *   3. fsync + rename over target (atomic on POSIX)
+ * If any step fails, the temp file is cleaned up and the target is untouched.
+ */
+export async function atomicWriteFile(target, contents) {
+    const dir = path.dirname(target);
+    await fs.mkdir(dir, { recursive: true });
+    const tmp = path.join(dir, `.${path.basename(target)}.${crypto.randomBytes(6).toString("hex")}.tmp`);
+    let handle = null;
+    try {
+        handle = await fs.open(tmp, "w", 0o600);
+        await handle.writeFile(contents, "utf8");
+        await handle.sync();
+        await handle.close();
+        handle = null;
+        await fs.rename(tmp, target);
+    }
+    catch (err) {
+        if (handle) {
+            try {
+                await handle.close();
+            }
+            catch {
+                /* swallow */
+            }
+        }
+        try {
+            await fs.unlink(tmp);
+        }
+        catch {
+            /* swallow */
+        }
+        throw err;
+    }
+}
+/** Serialize JSON with 2-space indent and a trailing newline. */
+export function stringifyJson(value) {
+    return JSON.stringify(value, null, 2) + "\n";
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/services/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/services/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,GAAG,EACH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CACzE,CAAC;IACF,IAAI,MAAM,GAAyB,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa;YACf,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC/C,CAAC"}

package/dist/services/backup.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Snapshot a file to ~/.claude/backups/<basename>.<iso-timestamp>.bak
+ * before any destructive/mutating write.
+ *
+ * No-ops silently if the source doesn't exist yet (first-time write).
+ * Returns the absolute path of the backup file, or `null` if skipped.
+ */
+export declare function backupFile(source: string): Promise<string | null>;
+/**
+ * Snapshot a *directory* recursively (for skill folders). Preserves relative
+ * layout under ~/.claude/backups/<basename>.<iso-timestamp>.bak.d/.
+ */
+export declare function backupDir(source: string): Promise<string | null>;

package/dist/services/backup.js

@@ -0,0 +1,52 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { backupsDir } from "../constants.js";
+/**
+ * Snapshot a file to ~/.claude/backups/<basename>.<iso-timestamp>.bak
+ * before any destructive/mutating write.
+ *
+ * No-ops silently if the source doesn't exist yet (first-time write).
+ * Returns the absolute path of the backup file, or `null` if skipped.
+ */
+export async function backupFile(source) {
+    let data;
+    try {
+        data = await fs.readFile(source);
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return null;
+        throw err;
+    }
+    const dir = backupsDir();
+    await fs.mkdir(dir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const dest = path.join(dir, `${path.basename(source)}.${stamp}.bak`);
+    await fs.writeFile(dest, data, { mode: 0o600 });
+    return dest;
+}
+/**
+ * Snapshot a *directory* recursively (for skill folders). Preserves relative
+ * layout under ~/.claude/backups/<basename>.<iso-timestamp>.bak.d/.
+ */
+export async function backupDir(source) {
+    try {
+        await fs.access(source);
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return null;
+        throw err;
+    }
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const dest = path.join(backupsDir(), `${path.basename(source)}.${stamp}.bak.d`);
+    await fs.cp(source, dest, { recursive: true });
+    return dest;
+}
+function isEnoent(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+//# sourceMappingURL=backup.js.map

package/dist/services/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/services/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc;IAC7C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACrE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CACpB,UAAU,EAAE,EACZ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAC1C,CAAC;IACF,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACZ,GAAyB,CAAC,IAAI,KAAK,QAAQ,CAC7C,CAAC;AACJ,CAAC"}

package/dist/services/mcp-config.d.ts

@@ -0,0 +1,72 @@
+import { type McpConfigFile, type McpServerEntry } from "../schemas/mcp-config.js";
+import type { Scope } from "../constants.js";
+export interface WriteResult {
+    path: string;
+    backup: string | null;
+    dryRun: boolean;
+    diff?: string;
+}
+/** Load an MCP config file, returning `{ mcpServers: {} }` if absent. */
+export declare function loadMcpConfig(path: string): Promise<McpConfigFile>;
+/**
+ * Write an MCP config file: backup → atomic write.
+ * When `dryRun: true`, returns a diff and leaves disk untouched.
+ */
+export declare function saveMcpConfig(path: string, next: McpConfigFile, { dryRun }?: {
+    dryRun?: boolean;
+}): Promise<WriteResult>;
+export interface ListEntry {
+    scope: Scope;
+    name: string;
+    path: string;
+    entry: McpServerEntry;
+}
+/** List servers across one scope. Redacts secrets by default. */
+export declare function listServers(scope: Scope, opts?: {
+    projectPath?: string;
+    revealSecrets?: boolean;
+}): Promise<ListEntry[]>;
+/** Add or replace a server entry in a scope. */
+export declare function addServer(params: {
+    scope: Scope;
+    name: string;
+    entry: McpServerEntry;
+    projectPath?: string;
+    dryRun?: boolean;
+    overwrite?: boolean;
+}): Promise<WriteResult>;
+/** Patch individual fields of an existing server entry. */
+export declare function updateServer(params: {
+    scope: Scope;
+    name: string;
+    patch: Partial<McpServerEntry>;
+    projectPath?: string;
+    dryRun?: boolean;
+}): Promise<WriteResult>;
+/** Remove a server by name. */
+export declare function removeServer(params: {
+    scope: Scope;
+    name: string;
+    projectPath?: string;
+    dryRun?: boolean;
+}): Promise<WriteResult>;
+/** Toggle the `disabled` flag on an existing server entry. */
+export declare function setServerDisabled(params: {
+    scope: Scope;
+    name: string;
+    disabled: boolean;
+    projectPath?: string;
+    dryRun?: boolean;
+}): Promise<WriteResult>;
+/** Get a single server entry. */
+export declare function getServer(params: {
+    scope: Scope;
+    name: string;
+    projectPath?: string;
+    revealSecrets?: boolean;
+}): Promise<ListEntry | null>;
+/**
+ * Minimal unified diff for dry-run output. Not a full diff engine — just
+ * enough to read at a glance in tool responses.
+ */
+export declare function makeUnifiedDiff(a: string, b: string, label: string): string;