daycare-cli 0.0.1

package/dist/engine/skills/skillResolve.js

@@ -0,0 +1,194 @@
+import path from "node:path";
+import { constants as fsConstants, promises as fs } from "node:fs";
+import { getLogger } from "../../log.js";
+import { SKILL_FILENAME } from "./skillConstants.js";
+const logger = getLogger("engine.skills");
+/**
+ * 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 async function skillResolve(filePath, source, root) {
+    const resolvedPath = path.resolve(filePath);
+    const readable = await skillFileReadable(resolvedPath);
+    if (!readable) {
+        logger.warn({ path: resolvedPath }, "Skill file not readable; skipping");
+        return null;
+    }
+    let content = "";
+    try {
+        content = await fs.readFile(resolvedPath, "utf8");
+    }
+    catch (error) {
+        logger.warn({ path: resolvedPath, error }, "Skill file not readable; skipping");
+        return null;
+    }
+    const metadata = skillFrontmatterParse(content);
+    const name = metadata.name?.trim().length ? metadata.name.trim() : skillNameFormat(resolvedPath);
+    const description = metadata.description?.trim().length ? metadata.description.trim() : null;
+    const id = skillIdBuild(resolvedPath, source, root);
+    return {
+        id,
+        name,
+        description,
+        path: resolvedPath,
+        source: source.source,
+        pluginId: source.source === "plugin" ? source.pluginId : undefined
+    };
+}
+async function skillFileReadable(filePath) {
+    try {
+        const stats = await fs.stat(filePath);
+        if (!stats.isFile()) {
+            return false;
+        }
+        await fs.access(filePath, fsConstants.R_OK);
+        return true;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT" || code === "EACCES") {
+            return false;
+        }
+        throw error;
+    }
+}
+function skillFrontmatterParse(content) {
+    const lines = content.split(/\r?\n/);
+    const firstLine = lines[0] ?? "";
+    if (lines.length === 0 || firstLine.trim() !== "---") {
+        return {};
+    }
+    const frontmatter = [];
+    for (let i = 1; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        if (line.trim() === "---" || line.trim() === "...") {
+            break;
+        }
+        frontmatter.push(line);
+    }
+    if (frontmatter.length === 0) {
+        return {};
+    }
+    return skillYamlFrontmatterParse(frontmatter);
+}
+function skillYamlFrontmatterParse(lines) {
+    const result = {};
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        if (!line || line.trim().length === 0 || line.trim().startsWith("#")) {
+            continue;
+        }
+        const match = line.match(/^([A-Za-z0-9_-]+)\s*:\s*(.*)$/);
+        if (!match) {
+            continue;
+        }
+        const key = match[1];
+        let value = match[2] ?? "";
+        if (value === "|" || value === ">" || value.trim().length === 0) {
+            const block = skillYamlBlockCollect(lines, i + 1);
+            i = block.nextIndex - 1;
+            value = value === ">" ? block.value.replace(/\n/g, " ") : block.value;
+        }
+        else {
+            value = value.trim();
+        }
+        const normalized = skillYamlValueNormalize(value);
+        if (key === "name") {
+            result.name = normalized;
+        }
+        if (key === "description") {
+            result.description = normalized;
+        }
+    }
+    return result;
+}
+function skillYamlBlockCollect(lines, startIndex) {
+    const blockLines = [];
+    let minIndent = null;
+    let index = startIndex;
+    for (; index < lines.length; index += 1) {
+        const line = lines[index] ?? "";
+        if (line.trim().length === 0) {
+            blockLines.push("");
+            continue;
+        }
+        const match = line.match(/^(\s+)/);
+        if (!match) {
+            break;
+        }
+        const indentMatch = match[1];
+        if (!indentMatch) {
+            break;
+        }
+        const indent = indentMatch.length;
+        if (minIndent === null || indent < minIndent) {
+            minIndent = indent;
+        }
+        blockLines.push(line);
+    }
+    if (blockLines.length === 0) {
+        return { value: "", nextIndex: index };
+    }
+    const trimmed = blockLines.map((line) => {
+        if (minIndent && line.length >= minIndent) {
+            return line.slice(minIndent);
+        }
+        return line.trim();
+    });
+    return { value: trimmed.join("\n").trimEnd(), nextIndex: index };
+}
+function skillYamlValueNormalize(value) {
+    if (value.length === 0) {
+        return value;
+    }
+    if (value.startsWith('"') && value.endsWith('"')) {
+        return skillYamlDoubleUnescape(value.slice(1, -1));
+    }
+    if (value.startsWith("'") && value.endsWith("'")) {
+        return value.slice(1, -1).replace(/''/g, "'");
+    }
+    return value;
+}
+function skillYamlDoubleUnescape(value) {
+    return value
+        .replace(/\\n/g, "\n")
+        .replace(/\\t/g, "\t")
+        .replace(/\\r/g, "\r")
+        .replace(/\\"/g, '"')
+        .replace(/\\\\/g, "\\");
+}
+function skillIdBuild(filePath, source, root) {
+    const fileName = path.basename(filePath).toLowerCase();
+    let slug = "";
+    if (fileName === SKILL_FILENAME) {
+        if (root) {
+            slug = path.relative(root, path.dirname(filePath));
+        }
+        else {
+            slug = path.basename(path.dirname(filePath));
+        }
+    }
+    else {
+        slug = path.basename(filePath, path.extname(filePath));
+    }
+    const normalized = slug.length > 0 ? slug.split(path.sep).join("/") : "skill";
+    if (source.source === "plugin") {
+        return `plugin:${source.pluginId}/${normalized}`;
+    }
+    if (source.source === "config") {
+        return `config:${normalized}`;
+    }
+    return `core:${normalized}`;
+}
+function skillNameFormat(filePath) {
+    const fileName = path.basename(filePath).toLowerCase();
+    if (fileName === SKILL_FILENAME) {
+        return skillNameNormalize(path.basename(path.dirname(filePath)));
+    }
+    return skillNameNormalize(path.basename(filePath, path.extname(filePath)));
+}
+function skillNameNormalize(value) {
+    return value.replace(/[-_]+/g, " ").trim();
+}
+//# sourceMappingURL=skillResolve.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { AgentSkill } from "./skillTypes.js";
+/**
+ * Orders skills by display name and path for stable prompt output.
+ *
+ * Expects: skills is any array; returns a new array sorted by name then path.
+ */
+export declare function skillSort(skills: AgentSkill[]): AgentSkill[];
+//# sourceMappingURL=skillSort.d.ts.map

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

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

package/dist/engine/skills/skillSort.js

@@ -0,0 +1,15 @@
+/**
+ * Orders skills by display name and path for stable prompt output.
+ *
+ * Expects: skills is any array; returns a new array sorted by name then path.
+ */
+export function skillSort(skills) {
+    return [...skills].sort((a, b) => {
+        const nameSort = a.name.localeCompare(b.name);
+        if (nameSort !== 0) {
+            return nameSort;
+        }
+        return a.path.localeCompare(b.path);
+    });
+}
+//# sourceMappingURL=skillSort.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skillSort.js","sourceRoot":"","sources":["../../../sources/engine/skills/skillSort.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Skill metadata exposed to agents and system prompts.
+ */
+export type AgentSkill = {
+    id: string;
+    name: string;
+    description?: string | null;
+    path: string;
+    source: "core" | "config" | "plugin";
+    pluginId?: string;
+};
+/**
+ * Plugin registration entry for skills bundled by a plugin.
+ */
+export type PluginSkillRegistration = {
+    pluginId: string;
+    path: string;
+};
+/**
+ * Source metadata for a skill lookup.
+ */
+export type SkillSource = {
+    source: "core";
+    root?: string;
+} | {
+    source: "config";
+    root?: string;
+} | {
+    source: "plugin";
+    pluginId: string;
+};
+//# sourceMappingURL=skillTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skillTypes.d.ts","sourceRoot":"","sources":["../../../sources/engine/skills/skillTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/engine/skills/skillTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skillTypes.js.map

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

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

package/dist/files/store.d.ts

@@ -0,0 +1,24 @@
+import type { StoredFile } from "./types.js";
+import type { Config } from "@/types";
+export declare class FileStore {
+    private basePath;
+    constructor(config: Config);
+    resolvePath(): string;
+    ensureDir(): Promise<void>;
+    saveBuffer(options: {
+        name: string;
+        mimeType: string;
+        data: Buffer;
+        source: string;
+    }): Promise<StoredFile>;
+    saveFromPath(options: {
+        name: string;
+        mimeType: string;
+        source: string;
+        path: string;
+    }): Promise<StoredFile>;
+    get(id: string): Promise<StoredFile | null>;
+    private metadataPath;
+    private writeMetadata;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/files/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../sources/files/store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,MAAM;IAI1B,WAAW,IAAI,MAAM;IAIf,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,UAAU,CAAC,OAAO,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBjB,YAAY,CAAC,OAAO,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBjB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAYjD,OAAO,CAAC,YAAY;YAIN,aAAa;CAI5B"}

package/dist/files/store.js

@@ -0,0 +1,74 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { createId } from "@paralleldrive/cuid2";
+import { sanitizeFilename } from "../util/filename.js";
+export class FileStore {
+    basePath;
+    constructor(config) {
+        this.basePath = config.filesDir;
+    }
+    resolvePath() {
+        return path.resolve(this.basePath);
+    }
+    async ensureDir() {
+        await fs.mkdir(this.resolvePath(), { recursive: true });
+    }
+    async saveBuffer(options) {
+        await this.ensureDir();
+        const id = createId();
+        const filename = `${id}__${sanitizeFilename(options.name)}`;
+        const filePath = path.join(this.resolvePath(), filename);
+        await fs.writeFile(filePath, options.data);
+        const stats = await fs.stat(filePath);
+        const record = {
+            id,
+            name: options.name,
+            path: filePath,
+            mimeType: options.mimeType,
+            size: stats.size,
+            source: options.source,
+            createdAt: new Date().toISOString()
+        };
+        await this.writeMetadata(record);
+        return record;
+    }
+    async saveFromPath(options) {
+        await this.ensureDir();
+        const id = createId();
+        const filename = `${id}__${sanitizeFilename(options.name)}`;
+        const filePath = path.join(this.resolvePath(), filename);
+        await fs.copyFile(options.path, filePath);
+        const stats = await fs.stat(filePath);
+        const record = {
+            id,
+            name: options.name,
+            path: filePath,
+            mimeType: options.mimeType,
+            size: stats.size,
+            source: options.source,
+            createdAt: new Date().toISOString()
+        };
+        await this.writeMetadata(record);
+        return record;
+    }
+    async get(id) {
+        try {
+            const content = await fs.readFile(this.metadataPath(id), "utf8");
+            return JSON.parse(content);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    metadataPath(id) {
+        return path.join(this.resolvePath(), `${id}.json`);
+    }
+    async writeMetadata(record) {
+        const payload = `${JSON.stringify(record, null, 2)}\n`;
+        await fs.writeFile(this.metadataPath(record.id), payload, "utf8");
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/files/store.js.map

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

package/dist/files/types.d.ts

@@ -0,0 +1,17 @@
+export type StoredFile = {
+    id: string;
+    name: string;
+    path: string;
+    mimeType: string;
+    size: number;
+    source: string;
+    createdAt: string;
+};
+export type FileReference = {
+    id: string;
+    name: string;
+    mimeType: string;
+    size: number;
+    path: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/files/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sources/files/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/files/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/files/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../sources/files/types.ts"],"names":[],"mappings":""}

package/dist/log.d.ts

@@ -0,0 +1,15 @@
+import { type Logger } from "pino";
+export type LogFormat = "pretty" | "json";
+export type LogDestination = "stdout" | "stderr" | string;
+export type LogConfig = {
+    level: string;
+    format: LogFormat;
+    destination: LogDestination;
+    redact: string[];
+    service: string;
+    environment: string;
+};
+export declare function initLogging(overrides?: Partial<LogConfig>): Logger;
+export declare function getLogger(moduleName?: string): Logger;
+export declare function resetLogging(): void;
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../sources/log.ts"],"names":[],"mappings":"AAEA,OAAa,EAEX,KAAK,MAAM,EAEZ,MAAM,MAAM,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC1C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,cAAc,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAqBF,wBAAgB,WAAW,CAAC,SAAS,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,MAAM,CAQtE;AAED,wBAAgB,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}