daemora 1.0.0-alpha.0

package/dist/tools/core/sessionSearch.d.ts

@@ -0,0 +1,62 @@
+/**
+ * session_search — find relevant past conversations by keyword, then
+ * summarize the top sessions with a cheap model. Hermes pattern.
+ *
+ * Flow:
+ *   1. FTS5 bm25 keyword search across all session_messages.
+ *   2. Resolve each hit's session to its root parent (delegation /
+ *      compaction chain).
+ *   3. Dedupe by root parent, keep top N (default 3) distinct sessions.
+ *   4. For each, load the full conversation, window text around the
+ *      query matches, and ask the cheap model for a focused summary.
+ *   5. Run summaries in parallel with a concurrency semaphore.
+ *   6. Return structured results.
+ *
+ * Fallback: empty query returns recent session metadata (no LLM calls).
+ */
+import { z } from "zod";
+import type { ModelRouter } from "../../models/ModelRouter.js";
+import type { SessionStore } from "../../memory/SessionStore.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    query: string;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+type SessionSearchResult = {
+    success: true;
+    query: string;
+    results: readonly {
+        session_id: string;
+        title: string;
+        started_at: number;
+        match_count: number;
+        summary: string;
+    }[];
+} | {
+    success: true;
+    mode: "recent";
+    sessions: readonly {
+        id: string;
+        title: string;
+        started_at: number;
+        message_count: number;
+    }[];
+} | {
+    success: false;
+    error: string;
+};
+export interface SessionSearchDeps {
+    readonly sessions: SessionStore;
+    readonly models: ModelRouter;
+    /** Called-on session ID so the current conversation is excluded. */
+    readonly currentSessionId?: string;
+}
+export declare function makeSessionSearchTool(deps: SessionSearchDeps): ToolDef<typeof inputSchema, SessionSearchResult>;
+export {};
+//# sourceMappingURL=sessionSearch.d.ts.map

package/dist/tools/core/sessionSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionSearch.d.ts","sourceRoot":"","sources":["../../../src/tools/core/sessionSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,QAAA,MAAM,WAAW;;;;;;;;;EAKf,CAAC;AAEH,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;CACL,GAAG;IACF,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/F,GAAG;IACF,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAKF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,WAAW,EAAE,mBAAmB,CAAC,CAoElD"}

package/dist/tools/core/sessionSearch.js

@@ -0,0 +1,154 @@
+/**
+ * session_search — find relevant past conversations by keyword, then
+ * summarize the top sessions with a cheap model. Hermes pattern.
+ *
+ * Flow:
+ *   1. FTS5 bm25 keyword search across all session_messages.
+ *   2. Resolve each hit's session to its root parent (delegation /
+ *      compaction chain).
+ *   3. Dedupe by root parent, keep top N (default 3) distinct sessions.
+ *   4. For each, load the full conversation, window text around the
+ *      query matches, and ask the cheap model for a focused summary.
+ *   5. Run summaries in parallel with a concurrency semaphore.
+ *   6. Return structured results.
+ *
+ * Fallback: empty query returns recent session metadata (no LLM calls).
+ */
+import { generateText } from "ai";
+import { z } from "zod";
+import { createLogger } from "../../util/logger.js";
+import { msgText } from "../../util/msgText.js";
+const log = createLogger("tools.session_search");
+const inputSchema = z.object({
+    query: z.string().max(500).describe("Keywords for FTS5 search across past conversations. Empty string returns recent sessions."),
+    limit: z.number().int().min(1).max(10).default(3),
+});
+const MAX_CONVERSATION_CHARS = 12_000;
+const CONCURRENCY = 3;
+export function makeSessionSearchTool(deps) {
+    return {
+        name: "session_search",
+        description: "Search past conversations for relevant context. Use when the user references a previous " +
+            "task, decision, or fact. Returns focused summaries of matching sessions — not raw transcripts.",
+        category: "data",
+        source: { kind: "core" },
+        alwaysOn: true,
+        inputSchema,
+        async execute({ query, limit }) {
+            const q = query.trim();
+            if (!q)
+                return listRecent(deps, limit);
+            const hits = deps.sessions.searchMessages(q, { limit: 50 });
+            if (hits.length === 0) {
+                return { success: true, query: q, results: [] };
+            }
+            const byRoot = new Map();
+            for (const h of hits) {
+                const root = deps.sessions.resolveToParent(h.sessionId);
+                if (deps.currentSessionId && root === deps.currentSessionId)
+                    continue;
+                const prev = byRoot.get(root);
+                if (prev) {
+                    prev.matches += 1;
+                }
+                else {
+                    byRoot.set(root, { matches: 1, firstSeq: h.seq });
+                }
+                if (byRoot.size >= Math.max(limit * 3, 6))
+                    break;
+            }
+            const ranked = [...byRoot.entries()]
+                .sort((a, b) => b[1].matches - a[1].matches)
+                .slice(0, limit);
+            if (ranked.length === 0) {
+                return { success: true, query: q, results: [] };
+            }
+            const cheap = await deps.models.getCheap().catch((e) => {
+                log.warn({ err: e.message }, "cheap model unavailable for summarization");
+                return null;
+            });
+            const results = await runWithConcurrency(ranked.map(([sessionId, info]) => async () => {
+                const session = deps.sessions.getSession(sessionId);
+                const messages = deps.sessions.getMessagesAsConversation(sessionId);
+                const transcript = formatTranscript(messages, q);
+                const summary = cheap
+                    ? await summariseSession(cheap.model, transcript, q, session?.title ?? "")
+                        .catch((e) => `(summary failed: ${e.message})`)
+                    : transcript.slice(0, 2000);
+                return {
+                    session_id: sessionId,
+                    title: session?.title ?? "(untitled)",
+                    started_at: session?.createdAt ?? 0,
+                    match_count: info.matches,
+                    summary,
+                };
+            }), CONCURRENCY);
+            return { success: true, query: q, results };
+        },
+    };
+}
+function listRecent(deps, limit) {
+    const sessions = deps.sessions.listSessions({ limit });
+    return {
+        success: true,
+        mode: "recent",
+        sessions: sessions.map((s) => ({
+            id: s.id, title: s.title, started_at: s.createdAt, message_count: s.messageCount,
+        })),
+    };
+}
+function formatTranscript(messages, query) {
+    const rendered = messages
+        .map((m) => `[${m.role}] ${msgText(m.content)}`.slice(0, 1500))
+        .join("\n---\n");
+    if (rendered.length <= MAX_CONVERSATION_CHARS)
+        return rendered;
+    // Windowed around the query matches — keep 60% head around first hit
+    // and 40% tail around last hit.
+    const q = query.toLowerCase();
+    const first = rendered.toLowerCase().indexOf(q);
+    if (first < 0)
+        return rendered.slice(0, MAX_CONVERSATION_CHARS) + "\n…[truncated]";
+    const windowStart = Math.max(0, first - Math.floor(MAX_CONVERSATION_CHARS * 0.3));
+    return rendered.slice(windowStart, windowStart + MAX_CONVERSATION_CHARS) + "\n…[truncated]";
+}
+async function summariseSession(model, transcript, query, title) {
+    const system = [
+        "You are reviewing a past conversation transcript. Summarise with focus on the SEARCH TOPIC.",
+        "Include: what the user wanted, actions taken, outcomes, key decisions, specific paths / commands,",
+        "and anything left unresolved. Be thorough but concise. Preserve technical details.",
+    ].join(" ");
+    const prompt = [
+        `Search topic: ${query}`,
+        `Session title: ${title}`,
+        "",
+        "TRANSCRIPT:",
+        transcript,
+        "",
+        `Summarise with focus on: ${query}`,
+    ].join("\n");
+    const { text } = await generateText({
+        model,
+        system,
+        prompt,
+        temperature: 0.1,
+    });
+    return text.trim();
+}
+async function runWithConcurrency(fns, concurrency) {
+    const out = new Array(fns.length);
+    let i = 0;
+    const workers = Array.from({ length: Math.min(concurrency, fns.length) }, async () => {
+        while (true) {
+            const idx = i++;
+            if (idx >= fns.length)
+                return;
+            const fn = fns[idx];
+            if (fn)
+                out[idx] = await fn();
+        }
+    });
+    await Promise.all(workers);
+    return out;
+}
+//# sourceMappingURL=sessionSearch.js.map

package/dist/tools/core/sessionSearch.js.map

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

package/dist/tools/core/skillManage.d.ts

@@ -0,0 +1,71 @@
+/**
+ * skill_manage — create / edit / patch / delete skills from the agent.
+ *
+ * This is the write half of hermes-pattern skill learning: when the
+ * agent discovers a non-trivial reusable approach, it saves it as a
+ * SKILL.md so future turns can reuse it.
+ *
+ * Safety:
+ *   - Atomic writes: temp file + fsync + rename, rollback on security
+ *     scan failure.
+ *   - Name validation: lowercase / slug / max 64 chars / globally unique.
+ *   - Frontmatter validation: must parse + have name + description.
+ *   - Security scan on body via SecurityScanner before persist.
+ *   - Only operates under the skills root — no escape.
+ */
+import { z } from "zod";
+import type { EventBus } from "../../events/eventBus.js";
+import type { SkillRegistry } from "../../skills/SkillRegistry.js";
+import type { SkillLoader } from "../../skills/SkillLoader.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    action: z.ZodEnum<["create", "edit", "patch", "delete", "write_file", "remove_file"]>;
+    name: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    file_path: z.ZodOptional<z.ZodString>;
+    file_content: z.ZodOptional<z.ZodString>;
+    old_string: z.ZodOptional<z.ZodString>;
+    new_string: z.ZodOptional<z.ZodString>;
+    replace_all: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    action: "delete" | "create" | "write_file" | "patch" | "edit" | "remove_file";
+    replace_all: boolean;
+    content?: string | undefined;
+    old_string?: string | undefined;
+    new_string?: string | undefined;
+    category?: string | undefined;
+    file_path?: string | undefined;
+    file_content?: string | undefined;
+}, {
+    name: string;
+    action: "delete" | "create" | "write_file" | "patch" | "edit" | "remove_file";
+    content?: string | undefined;
+    old_string?: string | undefined;
+    new_string?: string | undefined;
+    replace_all?: boolean | undefined;
+    category?: string | undefined;
+    file_path?: string | undefined;
+    file_content?: string | undefined;
+}>;
+type SkillManageResult = {
+    success: true;
+    message: string;
+    path?: string;
+    hint?: string;
+} | {
+    success: false;
+    error: string;
+};
+export interface SkillManageDeps {
+    readonly registry: SkillRegistry;
+    readonly loader: SkillLoader;
+    readonly skillsRoot: string;
+    readonly bus?: EventBus;
+    /** Called after any mutation; the registry should be rebuilt. */
+    onChange?: () => Promise<void> | void;
+}
+export declare function makeSkillManageTool(deps: SkillManageDeps): ToolDef<typeof inputSchema, SkillManageResult>;
+export {};
+//# sourceMappingURL=skillManage.d.ts.map

package/dist/tools/core/skillManage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillManage.d.ts","sourceRoot":"","sources":["../../../src/tools/core/skillManage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAS3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUf,CAAC;AAEH,KAAK,iBAAiB,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,OAAO,WAAW,EAAE,iBAAiB,CAAC,CAsChD"}

package/dist/tools/core/skillManage.js

@@ -0,0 +1,353 @@
+/**
+ * skill_manage — create / edit / patch / delete skills from the agent.
+ *
+ * This is the write half of hermes-pattern skill learning: when the
+ * agent discovers a non-trivial reusable approach, it saves it as a
+ * SKILL.md so future turns can reuse it.
+ *
+ * Safety:
+ *   - Atomic writes: temp file + fsync + rename, rollback on security
+ *     scan failure.
+ *   - Name validation: lowercase / slug / max 64 chars / globally unique.
+ *   - Frontmatter validation: must parse + have name + description.
+ *   - Security scan on body via SecurityScanner before persist.
+ *   - Only operates under the skills root — no escape.
+ */
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, normalize, relative, resolve } from "node:path";
+import matter from "gray-matter";
+import { z } from "zod";
+import { scanContent } from "../../skills/SecurityScanner.js";
+import { skillFrontmatterSchema } from "../../skills/types.js";
+import { createLogger } from "../../util/logger.js";
+const log = createLogger("tools.skill_manage");
+const NAME_RE = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+const MAX_CONTENT_CHARS = 100_000;
+const MAX_FILE_CHARS = 100_000;
+const LINKED_PREFIXES = ["references/", "templates/", "scripts/", "assets/"];
+const inputSchema = z.object({
+    action: z.enum(["create", "edit", "patch", "delete", "write_file", "remove_file"]),
+    name: z.string().min(1).max(64),
+    content: z.string().max(MAX_CONTENT_CHARS).optional(),
+    category: z.string().max(64).optional(),
+    file_path: z.string().max(256).optional(),
+    file_content: z.string().max(MAX_FILE_CHARS).optional(),
+    old_string: z.string().optional(),
+    new_string: z.string().optional(),
+    replace_all: z.boolean().default(false),
+});
+export function makeSkillManageTool(deps) {
+    return {
+        name: "skill_manage",
+        description: "Create, edit, patch, or delete skills (your procedural memory). " +
+            "Use action='create' for a brand-new skill, 'patch' for find/replace edits, " +
+            "'edit' for full rewrites, 'delete' to remove. Use 'write_file'/'remove_file' for supporting files " +
+            "under references/, templates/, scripts/, or assets/.",
+        category: "agent",
+        source: { kind: "core" },
+        alwaysOn: true,
+        destructive: true,
+        inputSchema,
+        async execute(input) {
+            try {
+                let result;
+                switch (input.action) {
+                    case "create":
+                        result = await createSkill(deps, input);
+                        break;
+                    case "edit":
+                        result = await editSkill(deps, input);
+                        break;
+                    case "patch":
+                        result = await patchSkill(deps, input);
+                        break;
+                    case "delete":
+                        result = await deleteSkill(deps, input);
+                        break;
+                    case "write_file":
+                        result = await writeSkillFile(deps, input);
+                        break;
+                    case "remove_file":
+                        result = await removeSkillFile(deps, input);
+                        break;
+                }
+                if (result.success) {
+                    if (deps.onChange)
+                        await deps.onChange();
+                    if (deps.bus) {
+                        if (input.action === "create")
+                            deps.bus.emit("skill:created", { skillId: input.name, path: result.path ?? "" });
+                        else if (input.action === "delete")
+                            deps.bus.emit("skill:deleted", { skillId: input.name });
+                        else
+                            deps.bus.emit("skill:updated", { skillId: input.name });
+                    }
+                }
+                return result;
+            }
+            catch (e) {
+                return { success: false, error: e.message };
+            }
+        },
+    };
+}
+function validateName(name) {
+    if (!NAME_RE.test(name))
+        return `name must match ${NAME_RE} (lowercase, [a-z0-9._-], starts with letter/digit, ≤64 chars)`;
+    return null;
+}
+function resolveSkillDir(root, name, category) {
+    if (category) {
+        const err = validateCategory(category);
+        if (err)
+            throw new Error(err);
+        return join(root, category, name);
+    }
+    return join(root, name);
+}
+function validateCategory(category) {
+    if (category.includes("..") || category.includes("/") || category.includes("\\")) {
+        return "category must be a single directory name (no slashes, no ..)";
+    }
+    if (!/^[a-z0-9][a-z0-9._-]{0,63}$/.test(category)) {
+        return "category must match [a-z0-9._-], start with letter/digit, ≤64 chars";
+    }
+    return null;
+}
+async function atomicWrite(targetPath, content) {
+    await mkdir(dirname(targetPath), { recursive: true });
+    const tmp = join(dirname(targetPath), `.${randomUUID()}.tmp`);
+    try {
+        await writeFile(tmp, content, { encoding: "utf-8" });
+        await rename(tmp, targetPath);
+    }
+    catch (e) {
+        try {
+            await unlink(tmp);
+        }
+        catch { }
+        throw e;
+    }
+}
+function parseAndValidateFrontmatter(body) {
+    if (!body.startsWith("---"))
+        return { ok: false, error: "content must start with YAML frontmatter (---)" };
+    let parsed;
+    try {
+        parsed = matter(body);
+    }
+    catch (e) {
+        return { ok: false, error: `frontmatter parse error: ${e.message}` };
+    }
+    if (!parsed.data || Object.keys(parsed.data).length === 0) {
+        return { ok: false, error: "frontmatter missing" };
+    }
+    const r = skillFrontmatterSchema.safeParse(parsed.data);
+    if (!r.success)
+        return { ok: false, error: `invalid frontmatter: ${r.error.message.slice(0, 300)}` };
+    if (!parsed.data["name"])
+        return { ok: false, error: "frontmatter must include `name`" };
+    if (!parsed.data["description"])
+        return { ok: false, error: "frontmatter must include `description`" };
+    if (parsed.content.trim().length === 0)
+        return { ok: false, error: "body content must not be empty" };
+    return { ok: true };
+}
+function assertInsideRoot(root, target) {
+    const r = resolve(root);
+    const t = resolve(target);
+    const rel = relative(r, t);
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        throw new Error("path escapes skills root");
+    }
+}
+async function createSkill(deps, input) {
+    if (!input.content)
+        return { success: false, error: "content is required for create" };
+    const nameErr = validateName(input.name);
+    if (nameErr)
+        return { success: false, error: nameErr };
+    // Uniqueness check
+    if (deps.registry.get(input.name)) {
+        return { success: false, error: `skill '${input.name}' already exists — use action='edit' or 'patch'` };
+    }
+    const fm = parseAndValidateFrontmatter(input.content);
+    if (!fm.ok)
+        return { success: false, error: fm.error };
+    const scan = scanContent(input.content);
+    if (scan.blocked)
+        return { success: false, error: `security scan rejected content: ${scan.reason}` };
+    const skillDir = resolveSkillDir(deps.skillsRoot, input.name, input.category);
+    assertInsideRoot(deps.skillsRoot, skillDir);
+    try {
+        const s = await stat(skillDir);
+        if (s.isDirectory())
+            return { success: false, error: `skill directory already exists: ${skillDir}` };
+    }
+    catch { /* good, doesn't exist */ }
+    const skillMd = join(skillDir, "SKILL.md");
+    try {
+        await atomicWrite(skillMd, input.content);
+    }
+    catch (e) {
+        return { success: false, error: `write failed: ${e.message}` };
+    }
+    log.info({ name: input.name, path: skillMd }, "skill created");
+    return {
+        success: true,
+        message: `Skill '${input.name}' created.`,
+        path: relative(deps.skillsRoot, skillMd),
+        hint: "To add reference files, call skill_manage(action='write_file', name, file_path='references/x.md', file_content=...).",
+    };
+}
+async function editSkill(deps, input) {
+    if (!input.content)
+        return { success: false, error: "content is required for edit" };
+    const skill = deps.registry.get(input.name);
+    if (!skill)
+        return { success: false, error: `skill '${input.name}' not found` };
+    const fm = parseAndValidateFrontmatter(input.content);
+    if (!fm.ok)
+        return { success: false, error: fm.error };
+    const scan = scanContent(input.content);
+    if (scan.blocked)
+        return { success: false, error: `security scan rejected content: ${scan.reason}` };
+    assertInsideRoot(deps.skillsRoot, skill.file);
+    // Backup for rollback
+    let backup = null;
+    try {
+        backup = await readFile(skill.file, "utf-8");
+    }
+    catch { }
+    try {
+        await atomicWrite(skill.file, input.content);
+    }
+    catch (e) {
+        if (backup !== null) {
+            try {
+                await atomicWrite(skill.file, backup);
+            }
+            catch { }
+        }
+        return { success: false, error: `write failed: ${e.message}` };
+    }
+    return {
+        success: true,
+        message: `Skill '${input.name}' rewritten.`,
+        path: relative(deps.skillsRoot, skill.file),
+    };
+}
+async function patchSkill(deps, input) {
+    if (input.old_string === undefined || input.new_string === undefined) {
+        return { success: false, error: "old_string and new_string are required for patch" };
+    }
+    const skill = deps.registry.get(input.name);
+    if (!skill)
+        return { success: false, error: `skill '${input.name}' not found` };
+    const targetPath = input.file_path
+        ? join(skill.dir, normalize(input.file_path))
+        : skill.file;
+    assertInsideRoot(deps.skillsRoot, targetPath);
+    let original;
+    try {
+        original = await readFile(targetPath, "utf-8");
+    }
+    catch (e) {
+        return { success: false, error: `unable to read target: ${e.message}` };
+    }
+    if (!original.includes(input.old_string)) {
+        return { success: false, error: "old_string not found in target file" };
+    }
+    const updated = input.replace_all
+        ? original.split(input.old_string).join(input.new_string)
+        : original.replace(input.old_string, input.new_string);
+    // If patching SKILL.md, re-validate + scan
+    if (targetPath === skill.file) {
+        const fm = parseAndValidateFrontmatter(updated);
+        if (!fm.ok)
+            return { success: false, error: fm.error };
+    }
+    const scan = scanContent(updated);
+    if (scan.blocked)
+        return { success: false, error: `security scan rejected content: ${scan.reason}` };
+    try {
+        await atomicWrite(targetPath, updated);
+    }
+    catch (e) {
+        return { success: false, error: `write failed: ${e.message}` };
+    }
+    return {
+        success: true,
+        message: `Skill '${input.name}' patched${input.file_path ? ` (${input.file_path})` : ""}.`,
+        path: relative(deps.skillsRoot, targetPath),
+    };
+}
+async function deleteSkill(deps, input) {
+    const skill = deps.registry.get(input.name);
+    if (!skill)
+        return { success: false, error: `skill '${input.name}' not found` };
+    assertInsideRoot(deps.skillsRoot, skill.dir);
+    try {
+        await rm(skill.dir, { recursive: true, force: true });
+    }
+    catch (e) {
+        return { success: false, error: `delete failed: ${e.message}` };
+    }
+    return { success: true, message: `Skill '${input.name}' deleted.` };
+}
+async function writeSkillFile(deps, input) {
+    if (!input.file_path || input.file_content === undefined) {
+        return { success: false, error: "file_path and file_content are required" };
+    }
+    const skill = deps.registry.get(input.name);
+    if (!skill)
+        return { success: false, error: `skill '${input.name}' not found` };
+    const normalized = normalize(input.file_path);
+    if (normalized.startsWith("..") || normalized.includes("..") || isAbsolute(normalized)) {
+        return { success: false, error: "file_path must be a relative path inside the skill dir" };
+    }
+    if (!LINKED_PREFIXES.some((p) => normalized.startsWith(p))) {
+        return { success: false, error: `file_path must start with one of: ${LINKED_PREFIXES.join(", ")}` };
+    }
+    const scan = scanContent(input.file_content);
+    if (scan.blocked)
+        return { success: false, error: `security scan rejected content: ${scan.reason}` };
+    const full = join(skill.dir, normalized);
+    assertInsideRoot(deps.skillsRoot, full);
+    try {
+        await atomicWrite(full, input.file_content);
+    }
+    catch (e) {
+        return { success: false, error: `write failed: ${e.message}` };
+    }
+    return {
+        success: true,
+        message: `File '${normalized}' written to skill '${input.name}'.`,
+        path: relative(deps.skillsRoot, full),
+    };
+}
+async function removeSkillFile(deps, input) {
+    if (!input.file_path)
+        return { success: false, error: "file_path is required" };
+    const skill = deps.registry.get(input.name);
+    if (!skill)
+        return { success: false, error: `skill '${input.name}' not found` };
+    const normalized = normalize(input.file_path);
+    if (normalized.startsWith("..") || normalized.includes("..") || isAbsolute(normalized)) {
+        return { success: false, error: "file_path must be a relative path inside the skill dir" };
+    }
+    if (!LINKED_PREFIXES.some((p) => normalized.startsWith(p))) {
+        return { success: false, error: `file_path must start with one of: ${LINKED_PREFIXES.join(", ")}` };
+    }
+    const full = join(skill.dir, normalized);
+    assertInsideRoot(deps.skillsRoot, full);
+    try {
+        await unlink(full);
+    }
+    catch (e) {
+        return { success: false, error: `delete failed: ${e.message}` };
+    }
+    return { success: true, message: `File '${normalized}' removed from skill '${input.name}'.` };
+}
+//# sourceMappingURL=skillManage.js.map