daycare-cli 0.0.1

package/dist/engine/signals/signals.spec.js

@@ -0,0 +1,107 @@
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { EngineEventBus } from "../ipc/events.js";
+import { Signals } from "./signals.js";
+describe("Signals", () => {
+    it("persists and reads signal events", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-signals-"));
+        try {
+            const eventBus = new EngineEventBus();
+            const signals = new Signals({ eventBus, configDir: dir });
+            const events = [];
+            const unsubscribe = eventBus.onEvent((event) => {
+                events.push({ type: event.type, payload: event.payload });
+            });
+            await signals.ensureDir();
+            const signal = await signals.generate({
+                type: "build.completed",
+                source: { type: "process", id: "main-runtime" },
+                data: { ok: true }
+            });
+            unsubscribe();
+            expect(signal.id.length).toBeGreaterThan(0);
+            expect(signal.createdAt).toBeGreaterThan(0);
+            expect(signal.type).toBe("build.completed");
+            expect(signal.source).toEqual({ type: "process", id: "main-runtime" });
+            expect(signal.data).toEqual({ ok: true });
+            const generated = events.find((event) => event.type === "signal.generated");
+            expect(generated).toBeDefined();
+            expect(generated?.payload).toEqual(signal);
+            const filePath = path.join(dir, "signals", "events.jsonl");
+            const raw = await readFile(filePath, "utf8");
+            expect(raw.includes('"type":"build.completed"')).toBe(true);
+            const recent = await signals.listRecent(10);
+            expect(recent).toHaveLength(1);
+            expect(recent[0]?.id).toBe(signal.id);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("delivers only matching subscriptions", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-signals-"));
+        try {
+            const delivered = [];
+            const signals = new Signals({
+                eventBus: new EngineEventBus(),
+                configDir: dir,
+                onDeliver: (signal, subscriptions) => {
+                    delivered.push({
+                        signalType: signal.type,
+                        subscriptions: subscriptions.map((subscription) => ({
+                            agentId: subscription.agentId,
+                            pattern: subscription.pattern,
+                            silent: subscription.silent
+                        }))
+                    });
+                }
+            });
+            await signals.ensureDir();
+            signals.subscribe({ agentId: "agent-a", pattern: "build:*:done", silent: true });
+            signals.subscribe({ agentId: "agent-b", pattern: "build:*:done", silent: false });
+            signals.subscribe({ agentId: "agent-c", pattern: "other:*" });
+            await signals.generate({
+                type: "build:alpha:done",
+                source: { type: "system" }
+            });
+            expect(delivered).toHaveLength(1);
+            expect(delivered[0]?.signalType).toBe("build:alpha:done");
+            expect(delivered[0]?.subscriptions).toEqual([
+                { agentId: "agent-a", pattern: "build:*:done", silent: true },
+                { agentId: "agent-b", pattern: "build:*:done", silent: false }
+            ]);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("stops delivering after unsubscribe", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-signals-"));
+        try {
+            const delivered = [];
+            const signals = new Signals({
+                eventBus: new EngineEventBus(),
+                configDir: dir,
+                onDeliver: (_signal, subscriptions) => {
+                    delivered.push(...subscriptions.map((subscription) => subscription.agentId));
+                }
+            });
+            await signals.ensureDir();
+            signals.subscribe({ agentId: "agent-a", pattern: "build:*:done", silent: true });
+            const removed = signals.unsubscribe({ agentId: "agent-a", pattern: "build:*:done" });
+            expect(removed).toBe(true);
+            await signals.generate({
+                type: "build:alpha:done",
+                source: { type: "system" }
+            });
+            expect(delivered).toEqual([]);
+            expect(signals.unsubscribe({ agentId: "agent-a", pattern: "build:*:done" })).toBe(false);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=signals.spec.js.map

package/dist/engine/signals/signals.spec.js.map

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

package/dist/engine/skills/skillConstants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Canonical filename for skills on disk.
+ */
+export declare const SKILL_FILENAME = "skill.md";
+//# sourceMappingURL=skillConstants.d.ts.map

package/dist/engine/skills/skillConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillConstants.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillConstants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,aAAa,CAAC"}

package/dist/engine/skills/skillConstants.js

@@ -0,0 +1,5 @@
+/**
+ * Canonical filename for skills on disk.
+ */
+export const SKILL_FILENAME = "skill.md";
+//# sourceMappingURL=skillConstants.js.map

package/dist/engine/skills/skillConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillConstants.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillConstants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC"}

package/dist/engine/skills/skillListConfig.d.ts

@@ -0,0 +1,8 @@
+import type { AgentSkill } from "./skillTypes.js";
+/**
+ * Lists skills stored in a user-configurable skills root.
+ *
+ * Expects: root is a directory path; missing roots return an empty list.
+ */
+export declare function skillListConfig(root: string): Promise<AgentSkill[]>;
+//# sourceMappingURL=skillListConfig.d.ts.map

package/dist/engine/skills/skillListConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListConfig.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillListConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAEzE"}

package/dist/engine/skills/skillListConfig.js

@@ -0,0 +1,10 @@
+import { skillListFromRoot } from "./skillListFromRoot.js";
+/**
+ * Lists skills stored in a user-configurable skills root.
+ *
+ * Expects: root is a directory path; missing roots return an empty list.
+ */
+export async function skillListConfig(root) {
+    return skillListFromRoot(root, { source: "config", root });
+}
+//# sourceMappingURL=skillListConfig.js.map

package/dist/engine/skills/skillListConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListConfig.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillListConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,OAAO,iBAAiB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/engine/skills/skillListCore.d.ts

@@ -0,0 +1,8 @@
+import type { AgentSkill } from "./skillTypes.js";
+/**
+ * Lists Daycare core skills bundled with the package.
+ *
+ * Expects: packaged skills directory exists or is missing; missing returns an empty list.
+ */
+export declare function skillListCore(): Promise<AgentSkill[]>;
+//# sourceMappingURL=skillListCore.d.ts.map

package/dist/engine/skills/skillListCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListCore.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillListCore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAE3D"}

package/dist/engine/skills/skillListCore.js

@@ -0,0 +1,12 @@
+import { fileURLToPath } from "node:url";
+import { skillListFromRoot } from "./skillListFromRoot.js";
+const CORE_SKILLS_ROOT = fileURLToPath(new URL("../../skills", import.meta.url));
+/**
+ * Lists Daycare core skills bundled with the package.
+ *
+ * Expects: packaged skills directory exists or is missing; missing returns an empty list.
+ */
+export async function skillListCore() {
+    return skillListFromRoot(CORE_SKILLS_ROOT, { source: "core", root: CORE_SKILLS_ROOT });
+}
+//# sourceMappingURL=skillListCore.js.map

package/dist/engine/skills/skillListCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListCore.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillListCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEjF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,iBAAiB,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/engine/skills/skillListFromRoot.d.ts

@@ -0,0 +1,8 @@
+import type { AgentSkill, SkillSource } from "./skillTypes.js";
+/**
+ * Lists skills found under the given root directory.
+ *
+ * Expects: root can be missing or not a directory; those cases return an empty list.
+ */
+export declare function skillListFromRoot(root: string, source: SkillSource): Promise<AgentSkill[]>;
+//# sourceMappingURL=skillListFromRoot.d.ts.map

package/dist/engine/skills/skillListFromRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListFromRoot.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillListFromRoot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI/D;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAUvB"}

package/dist/engine/skills/skillListFromRoot.js

@@ -0,0 +1,57 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { getLogger } from "../../log.js";
+import { SKILL_FILENAME } from "./skillConstants.js";
+import { skillResolve } from "./skillResolve.js";
+import { skillSort } from "./skillSort.js";
+const logger = getLogger("engine.skills");
+/**
+ * Lists skills found under the given root directory.
+ *
+ * Expects: root can be missing or not a directory; those cases return an empty list.
+ */
+export async function skillListFromRoot(root, source) {
+    const files = await collectSkillFiles(root);
+    const skills = [];
+    for (const file of files) {
+        const skill = await skillResolve(file, source, root);
+        if (skill) {
+            skills.push(skill);
+        }
+    }
+    return skillSort(skills);
+}
+async function collectSkillFiles(root) {
+    let entries = [];
+    try {
+        entries = await fs.readdir(root, { withFileTypes: true });
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            logger.warn({ path: root }, "Skills root missing; skipping");
+            return [];
+        }
+        if (code === "ENOTDIR") {
+            logger.warn({ path: root }, "Skills root is not a directory; skipping");
+            return [];
+        }
+        throw error;
+    }
+    const results = [];
+    for (const entry of entries) {
+        const fullPath = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...(await collectSkillFiles(fullPath)));
+            continue;
+        }
+        if (!entry.isFile()) {
+            continue;
+        }
+        if (entry.name.toLowerCase() === SKILL_FILENAME) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=skillListFromRoot.js.map

package/dist/engine/skills/skillListFromRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListFromRoot.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillListFromRoot.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,MAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,IAAI,OAAO,GAAoC,EAAE,CAAC;IAClD,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,+BAA+B,CAAC,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,0CAA0C,CAAC,CAAC;YACxE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,cAAc,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/engine/skills/skillListFromRoot.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skillListFromRoot.spec.d.ts.map

package/dist/engine/skills/skillListFromRoot.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListFromRoot.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillListFromRoot.spec.ts"],"names":[],"mappings":""}

package/dist/engine/skills/skillListFromRoot.spec.js

@@ -0,0 +1,31 @@
+import os from "node:os";
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { describe, expect, it } from "vitest";
+import { skillListFromRoot } from "./skillListFromRoot.js";
+describe("skillListFromRoot", () => {
+    it("collects skill metadata from frontmatter", async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-skills-"));
+        try {
+            const coreRoot = path.join(baseDir, "core");
+            const coreSkillDir = path.join(coreRoot, "deploy");
+            await fs.mkdir(coreSkillDir, { recursive: true });
+            const coreSkillPath = path.join(coreSkillDir, "SKILL.md");
+            await fs.writeFile(coreSkillPath, "---\nname: deploy\ndescription: \"Use <cron>\"\n---\n\nCore skill");
+            const skills = await skillListFromRoot(coreRoot, {
+                source: "core",
+                root: coreRoot
+            });
+            expect(skills).toHaveLength(1);
+            const skill = skills[0];
+            expect(skill?.id).toBe("core:deploy");
+            expect(skill?.name).toBe("deploy");
+            expect(skill?.description).toBe("Use <cron>");
+            expect(skill?.path).toBe(path.resolve(coreSkillPath));
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=skillListFromRoot.spec.js.map

package/dist/engine/skills/skillListFromRoot.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListFromRoot.spec.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillListFromRoot.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACnD,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAElD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAC1D,MAAM,EAAE,CAAC,SAAS,CAChB,aAAa,EACb,mEAAmE,CACpE,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE;gBAC/C,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACtC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/skills/skillListRegistered.d.ts

@@ -0,0 +1,8 @@
+import type { AgentSkill, PluginSkillRegistration } from "./skillTypes.js";
+/**
+ * Lists skills registered by plugins, de-duping identical plugin/path entries.
+ *
+ * Expects: registration paths can be relative; they are resolved before lookup.
+ */
+export declare function skillListRegistered(registrations: PluginSkillRegistration[]): Promise<AgentSkill[]>;
+//# sourceMappingURL=skillListRegistered.d.ts.map

package/dist/engine/skills/skillListRegistered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListRegistered.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillListRegistered.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE3E;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,uBAAuB,EAAE,GACvC,OAAO,CAAC,UAAU,EAAE,CAAC,CAqBvB"}

package/dist/engine/skills/skillListRegistered.js

@@ -0,0 +1,29 @@
+import path from "node:path";
+import { skillResolve } from "./skillResolve.js";
+import { skillSort } from "./skillSort.js";
+/**
+ * Lists skills registered by plugins, de-duping identical plugin/path entries.
+ *
+ * Expects: registration paths can be relative; they are resolved before lookup.
+ */
+export async function skillListRegistered(registrations) {
+    const skills = [];
+    const seen = new Set();
+    for (const registration of registrations) {
+        const resolvedPath = path.resolve(registration.path);
+        const key = `${registration.pluginId}:${resolvedPath}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        const skill = await skillResolve(resolvedPath, {
+            source: "plugin",
+            pluginId: registration.pluginId
+        });
+        if (skill) {
+            skills.push(skill);
+        }
+    }
+    return skillSort(skills);
+}
+//# sourceMappingURL=skillListRegistered.js.map

package/dist/engine/skills/skillListRegistered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListRegistered.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillListRegistered.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,aAAwC;IAExC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,GAAG,YAAY,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE;YAC7C,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/dist/engine/skills/skillListRegistered.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skillListRegistered.spec.d.ts.map

package/dist/engine/skills/skillListRegistered.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListRegistered.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillListRegistered.spec.ts"],"names":[],"mappings":""}

package/dist/engine/skills/skillListRegistered.spec.js

@@ -0,0 +1,30 @@
+import os from "node:os";
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { describe, expect, it } from "vitest";
+import { skillListRegistered } from "./skillListRegistered.js";
+describe("skillListRegistered", () => {
+    it("dedupes registrations and tags plugin metadata", async () => {
+        const baseDir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-skills-"));
+        try {
+            const pluginSkillDir = path.join(baseDir, "plugin-skill");
+            await fs.mkdir(pluginSkillDir, { recursive: true });
+            const pluginSkillPath = path.join(pluginSkillDir, "SKILL.md");
+            await fs.writeFile(pluginSkillPath, "---\nname: plugin-skill\ndescription: Manage <xml> safely\n---\n\nPlugin skill");
+            const skills = await skillListRegistered([
+                { pluginId: "alpha", path: pluginSkillPath },
+                { pluginId: "alpha", path: pluginSkillPath }
+            ]);
+            expect(skills).toHaveLength(1);
+            const skill = skills[0];
+            expect(skill?.source).toBe("plugin");
+            expect(skill?.pluginId).toBe("alpha");
+            expect(skill?.id).toBe("plugin:alpha/plugin-skill");
+            expect(skill?.path).toBe(path.resolve(pluginSkillPath));
+        }
+        finally {
+            await fs.rm(baseDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=skillListRegistered.spec.js.map

package/dist/engine/skills/skillListRegistered.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillListRegistered.spec.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillListRegistered.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;YAC9D,MAAM,EAAE,CAAC,SAAS,CAChB,eAAe,EACf,gFAAgF,CACjF,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;gBACvC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE;gBAC5C,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE;aAC7C,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACpD,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;QAC1D,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/skills/skillPromptFormat.d.ts

@@ -0,0 +1,8 @@
+import type { AgentSkill } from "./skillTypes.js";
+/**
+ * Formats available skills into an XML prompt segment for the system prompt.
+ *
+ * Expects: skills may include duplicates; the first entry per path is used.
+ */
+export declare function skillPromptFormat(skills: AgentSkill[]): string;
+//# sourceMappingURL=skillPromptFormat.d.ts.map

package/dist/engine/skills/skillPromptFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillPromptFormat.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillPromptFormat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CA8C9D"}

package/dist/engine/skills/skillPromptFormat.js

@@ -0,0 +1,49 @@
+import { skillSort } from "./skillSort.js";
+import { xmlEscape } from "../../util/xmlEscape.js";
+/**
+ * Formats available skills into an XML prompt segment for the system prompt.
+ *
+ * Expects: skills may include duplicates; the first entry per path is used.
+ */
+export function skillPromptFormat(skills) {
+    const unique = new Map();
+    for (const skill of skills) {
+        if (!unique.has(skill.path)) {
+            unique.set(skill.path, skill);
+        }
+    }
+    const ordered = skillSort(Array.from(unique.values()));
+    if (ordered.length === 0) {
+        return "";
+    }
+    const lines = [
+        "## Skills (mandatory)",
+        "",
+        "Before replying, scan the skill descriptions below:",
+        "- If exactly one skill clearly applies: read its SKILL.md at the path shown, then follow it.",
+        "- If multiple could apply: choose the most specific one, then read/follow it.",
+        "- If none clearly apply: do not read any SKILL.md.",
+        "",
+        "Never read more than one skill up front; only read after selecting.",
+        "",
+        "<available_skills>"
+    ];
+    for (const skill of ordered) {
+        const sourceLabel = skill.source === "plugin"
+            ? `plugin:${skill.pluginId ?? "unknown"}`
+            : skill.source;
+        const name = xmlEscape(skill.name);
+        const description = skill.description ? xmlEscape(skill.description) : "";
+        lines.push("  <skill>");
+        lines.push(`    <name>${name}</name>`);
+        if (description.length > 0) {
+            lines.push(`    <description>${description}</description>`);
+        }
+        lines.push(`    <source>${xmlEscape(sourceLabel)}</source>`);
+        lines.push(`    <path>${xmlEscape(skill.path)}</path>`);
+        lines.push("  </skill>");
+    }
+    lines.push("</available_skills>");
+    return lines.join("\n");
+}
+//# sourceMappingURL=skillPromptFormat.js.map

package/dist/engine/skills/skillPromptFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillPromptFormat.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillPromptFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,uBAAuB;QACvB,EAAE;QACF,qDAAqD;QACrD,8FAA8F;QAC9F,+EAA+E;QAC/E,oDAAoD;QACpD,EAAE;QACF,qEAAqE;QACrE,EAAE;QACF,oBAAoB;KACrB,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,WAAW,GACf,KAAK,CAAC,MAAM,KAAK,QAAQ;YACvB,CAAC,CAAC,UAAU,KAAK,CAAC,QAAQ,IAAI,SAAS,EAAE;YACzC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QACnB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC,CAAC;QACvC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,oBAAoB,WAAW,gBAAgB,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/skills/skillPromptFormat.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skillPromptFormat.spec.d.ts.map

package/dist/engine/skills/skillPromptFormat.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillPromptFormat.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillPromptFormat.spec.ts"],"names":[],"mappings":""}

package/dist/engine/skills/skillPromptFormat.spec.js

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { skillPromptFormat } from "./skillPromptFormat.js";
+describe("skillPromptFormat", () => {
+    it("formats skills as escaped XML", () => {
+        const skills = [
+            {
+                id: "core:deploy",
+                name: "deploy",
+                description: "Use <cron> & heartbeat",
+                path: "/tmp/deploy/SKILL.md",
+                source: "core"
+            },
+            {
+                id: "plugin:alpha/tooling",
+                name: "tooling",
+                description: "Manage <xml>",
+                path: "/tmp/plugin/skill/SKILL.md",
+                source: "plugin",
+                pluginId: "alpha"
+            },
+            {
+                id: "core:deploy",
+                name: "deploy",
+                description: "Use <cron> & heartbeat",
+                path: "/tmp/deploy/SKILL.md",
+                source: "core"
+            }
+        ];
+        const prompt = skillPromptFormat(skills);
+        expect(prompt).toContain("## Skills (mandatory)");
+        expect(prompt).toContain("Before replying, scan the skill descriptions");
+        expect(prompt).toContain("<available_skills>");
+        expect(prompt).toContain("<name>deploy</name>");
+        expect(prompt).toContain("Use &lt;cron&gt; &amp; heartbeat");
+        expect(prompt).toContain("<source>plugin:alpha</source>");
+        expect(prompt).toContain("/tmp/deploy/SKILL.md");
+        expect(prompt.match(/<name>deploy<\/name>/g)).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=skillPromptFormat.spec.js.map

package/dist/engine/skills/skillPromptFormat.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillPromptFormat.spec.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillPromptFormat.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAiB;YAC3B;gBACE,EAAE,EAAE,aAAa;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;gBACrC,IAAI,EAAE,sBAAsB;gBAC5B,MAAM,EAAE,MAAM;aACf;YACD;gBACE,EAAE,EAAE,sBAAsB;gBAC1B,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,4BAA4B;gBAClC,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,OAAO;aAClB;YACD;gBACE,EAAE,EAAE,aAAa;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;gBACrC,IAAI,EAAE,sBAAsB;gBAC5B,MAAM,EAAE,MAAM;aACf;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8CAA8C,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/skills/skillResolve.d.ts

@@ -0,0 +1,8 @@
+import type { AgentSkill, SkillSource } from "./skillTypes.js";
+/**
+ * Loads a skill file, parses its frontmatter, and builds a normalized skill record.
+ *
+ * Expects: filePath points to a readable file; unreadable files return null.
+ */
+export declare function skillResolve(filePath: string, source: SkillSource, root?: string): Promise<AgentSkill | null>;
+//# sourceMappingURL=skillResolve.d.ts.map

package/dist/engine/skills/skillResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillResolve.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillResolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAS/D;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6B5B"}