edge-pi-cli 0.1.1

package/dist/prompts.js

@@ -0,0 +1,132 @@
+/**
+ * Prompt template loading and expansion.
+ *
+ * Loads prompt templates from:
+ * - ~/.pi/agent/prompts/ (user-level)
+ * - .pi/prompts/ (project-level)
+ *
+ * Prompt templates are markdown files with frontmatter containing a
+ * "description" field. The filename (without .md) becomes the command name.
+ * They are invoked via /name in the editor and expand to the file body.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { parseFrontmatter } from "./utils/frontmatter.js";
+const CONFIG_DIR_NAME = ".pi";
+function getDefaultAgentDir() {
+    const envDir = process.env.PI_CODING_AGENT_DIR;
+    if (envDir) {
+        if (envDir === "~")
+            return homedir();
+        if (envDir.startsWith("~/"))
+            return homedir() + envDir.slice(1);
+        return envDir;
+    }
+    return join(homedir(), CONFIG_DIR_NAME, "agent");
+}
+function loadPromptsFromDir(dir, source) {
+    const prompts = [];
+    const diagnostics = [];
+    if (!existsSync(dir)) {
+        return { prompts, diagnostics };
+    }
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || !entry.name.endsWith(".md"))
+                continue;
+            const fullPath = join(dir, entry.name);
+            let isFile = entry.isFile();
+            if (entry.isSymbolicLink()) {
+                try {
+                    isFile = statSync(fullPath).isFile();
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (!isFile)
+                continue;
+            try {
+                const rawContent = readFileSync(fullPath, "utf-8");
+                const { frontmatter, body } = parseFrontmatter(rawContent);
+                const name = basename(entry.name, ".md");
+                if (!frontmatter.description || frontmatter.description.trim() === "") {
+                    diagnostics.push({
+                        type: "warning",
+                        message: "prompt template missing description in frontmatter",
+                        path: fullPath,
+                    });
+                    continue;
+                }
+                prompts.push({
+                    name,
+                    description: frontmatter.description,
+                    filePath: fullPath,
+                    body: body.trim(),
+                    source,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "failed to parse prompt template";
+                diagnostics.push({ type: "warning", message, path: fullPath });
+            }
+        }
+    }
+    catch {
+        // directory not readable
+    }
+    return { prompts, diagnostics };
+}
+/**
+ * Load prompt templates from user and project directories.
+ * Project prompts override user prompts with the same name.
+ */
+export function loadPrompts(options = {}) {
+    const { cwd = process.cwd(), agentDir } = options;
+    const resolvedAgentDir = agentDir ?? getDefaultAgentDir();
+    const allDiagnostics = [];
+    const promptMap = new Map();
+    // Load user-level prompts first
+    const userResult = loadPromptsFromDir(join(resolvedAgentDir, "prompts"), "user");
+    allDiagnostics.push(...userResult.diagnostics);
+    for (const prompt of userResult.prompts) {
+        promptMap.set(prompt.name, prompt);
+    }
+    // Load project-level prompts (override user-level)
+    const projectResult = loadPromptsFromDir(resolve(cwd, CONFIG_DIR_NAME, "prompts"), "project");
+    allDiagnostics.push(...projectResult.diagnostics);
+    for (const prompt of projectResult.prompts) {
+        if (promptMap.has(prompt.name)) {
+            allDiagnostics.push({
+                type: "collision",
+                message: `prompt "${prompt.name}" overrides user-level prompt`,
+                path: prompt.filePath,
+            });
+        }
+        promptMap.set(prompt.name, prompt);
+    }
+    return {
+        prompts: Array.from(promptMap.values()),
+        diagnostics: allDiagnostics,
+    };
+}
+/**
+ * Expand prompt template references in user input.
+ * If the input starts with /name and matches a template, replace with the template body.
+ * Returns the original text if no template matches.
+ */
+export function expandPromptTemplate(text, templates) {
+    if (!text.startsWith("/"))
+        return text;
+    // Extract command name (first word after /)
+    const spaceIndex = text.indexOf(" ");
+    const commandName = spaceIndex === -1 ? text.slice(1) : text.slice(1, spaceIndex);
+    const remainder = spaceIndex === -1 ? "" : text.slice(spaceIndex);
+    const template = templates.find((t) => t.name === commandName);
+    if (!template)
+        return text;
+    return template.body + remainder;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Prompt template loading and expansion.\n *\n * Loads prompt templates from:\n * - ~/.pi/agent/prompts/ (user-level)\n * - .pi/prompts/ (project-level)\n *\n * Prompt templates are markdown files with frontmatter containing a\n * \"description\" field. The filename (without .md) becomes the command name.\n * They are invoked via /name in the editor and expand to the file body.\n */\n\nimport { existsSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { basename, join, resolve } from \"node:path\";\nimport { parseFrontmatter } from \"./utils/frontmatter.js\";\n\nconst CONFIG_DIR_NAME = \".pi\";\n\nexport interface PromptTemplate {\n\t/** Command name (filename without .md extension) */\n\tname: string;\n\t/** Description from frontmatter */\n\tdescription: string;\n\t/** Full file path */\n\tfilePath: string;\n\t/** The body content (after frontmatter) */\n\tbody: string;\n\t/** Source: \"user\" or \"project\" */\n\tsource: \"user\" | \"project\";\n}\n\nexport interface PromptFrontmatter {\n\tdescription?: string;\n\t[key: string]: unknown;\n}\n\nexport interface LoadPromptsResult {\n\tprompts: PromptTemplate[];\n\tdiagnostics: Array<{ type: \"warning\" | \"collision\"; message: string; path: string }>;\n}\n\nfunction getDefaultAgentDir(): string {\n\tconst envDir = process.env.PI_CODING_AGENT_DIR;\n\tif (envDir) {\n\t\tif (envDir === \"~\") return homedir();\n\t\tif (envDir.startsWith(\"~/\")) return homedir() + envDir.slice(1);\n\t\treturn envDir;\n\t}\n\treturn join(homedir(), CONFIG_DIR_NAME, \"agent\");\n}\n\nfunction loadPromptsFromDir(dir: string, source: \"user\" | \"project\"): LoadPromptsResult {\n\tconst prompts: PromptTemplate[] = [];\n\tconst diagnostics: LoadPromptsResult[\"diagnostics\"] = [];\n\n\tif (!existsSync(dir)) {\n\t\treturn { prompts, diagnostics };\n\t}\n\n\ttry {\n\t\tconst entries = readdirSync(dir, { withFileTypes: true });\n\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.name.startsWith(\".\") || !entry.name.endsWith(\".md\")) continue;\n\n\t\t\tconst fullPath = join(dir, entry.name);\n\n\t\t\tlet isFile = entry.isFile();\n\t\t\tif (entry.isSymbolicLink()) {\n\t\t\t\ttry {\n\t\t\t\t\tisFile = statSync(fullPath).isFile();\n\t\t\t\t} catch {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (!isFile) continue;\n\n\t\t\ttry {\n\t\t\t\tconst rawContent = readFileSync(fullPath, \"utf-8\");\n\t\t\t\tconst { frontmatter, body } = parseFrontmatter<PromptFrontmatter>(rawContent);\n\t\t\t\tconst name = basename(entry.name, \".md\");\n\n\t\t\t\tif (!frontmatter.description || frontmatter.description.trim() === \"\") {\n\t\t\t\t\tdiagnostics.push({\n\t\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\t\tmessage: \"prompt template missing description in frontmatter\",\n\t\t\t\t\t\tpath: fullPath,\n\t\t\t\t\t});\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tprompts.push({\n\t\t\t\t\tname,\n\t\t\t\t\tdescription: frontmatter.description,\n\t\t\t\t\tfilePath: fullPath,\n\t\t\t\t\tbody: body.trim(),\n\t\t\t\t\tsource,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : \"failed to parse prompt template\";\n\t\t\t\tdiagnostics.push({ type: \"warning\", message, path: fullPath });\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// directory not readable\n\t}\n\n\treturn { prompts, diagnostics };\n}\n\nexport interface LoadPromptsOptions {\n\t/** Working directory for project-local prompts. Default: process.cwd() */\n\tcwd?: string;\n\t/** Agent config directory. Default: ~/.pi/agent */\n\tagentDir?: string;\n}\n\n/**\n * Load prompt templates from user and project directories.\n * Project prompts override user prompts with the same name.\n */\nexport function loadPrompts(options: LoadPromptsOptions = {}): LoadPromptsResult {\n\tconst { cwd = process.cwd(), agentDir } = options;\n\tconst resolvedAgentDir = agentDir ?? getDefaultAgentDir();\n\n\tconst allDiagnostics: LoadPromptsResult[\"diagnostics\"] = [];\n\tconst promptMap = new Map<string, PromptTemplate>();\n\n\t// Load user-level prompts first\n\tconst userResult = loadPromptsFromDir(join(resolvedAgentDir, \"prompts\"), \"user\");\n\tallDiagnostics.push(...userResult.diagnostics);\n\tfor (const prompt of userResult.prompts) {\n\t\tpromptMap.set(prompt.name, prompt);\n\t}\n\n\t// Load project-level prompts (override user-level)\n\tconst projectResult = loadPromptsFromDir(resolve(cwd, CONFIG_DIR_NAME, \"prompts\"), \"project\");\n\tallDiagnostics.push(...projectResult.diagnostics);\n\tfor (const prompt of projectResult.prompts) {\n\t\tif (promptMap.has(prompt.name)) {\n\t\t\tallDiagnostics.push({\n\t\t\t\ttype: \"collision\",\n\t\t\t\tmessage: `prompt \"${prompt.name}\" overrides user-level prompt`,\n\t\t\t\tpath: prompt.filePath,\n\t\t\t});\n\t\t}\n\t\tpromptMap.set(prompt.name, prompt);\n\t}\n\n\treturn {\n\t\tprompts: Array.from(promptMap.values()),\n\t\tdiagnostics: allDiagnostics,\n\t};\n}\n\n/**\n * Expand prompt template references in user input.\n * If the input starts with /name and matches a template, replace with the template body.\n * Returns the original text if no template matches.\n */\nexport function expandPromptTemplate(text: string, templates: PromptTemplate[]): string {\n\tif (!text.startsWith(\"/\")) return text;\n\n\t// Extract command name (first word after /)\n\tconst spaceIndex = text.indexOf(\" \");\n\tconst commandName = spaceIndex === -1 ? text.slice(1) : text.slice(1, spaceIndex);\n\tconst remainder = spaceIndex === -1 ? \"\" : text.slice(spaceIndex);\n\n\tconst template = templates.find((t) => t.name === commandName);\n\tif (!template) return text;\n\n\treturn template.body + remainder;\n}\n"]}

package/dist/settings.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Settings persistence for edge-pi-cli.
+ *
+ * Stores user preferences (default provider/model, compaction settings)
+ * in ~/.pi/agent/settings.json. Follows the same file-based pattern
+ * as auth-storage.ts: load in constructor, save on mutation, create dir if needed.
+ */
+export interface CompactionSettings {
+    enabled?: boolean;
+    reserveTokens?: number;
+    keepRecentTokens?: number;
+}
+export interface SettingsData {
+    defaultProvider?: string;
+    defaultModel?: string;
+    compaction?: CompactionSettings;
+}
+export declare class SettingsManager {
+    private settingsPath;
+    private data;
+    private constructor();
+    static create(agentDir: string): SettingsManager;
+    private reload;
+    private save;
+    getDefaultProvider(): string | undefined;
+    setDefaultProvider(provider: string): void;
+    getDefaultModel(): string | undefined;
+    setDefaultModel(model: string): void;
+    getCompaction(): CompactionSettings | undefined;
+    getCompactionEnabled(): boolean;
+    setCompactionEnabled(enabled: boolean): void;
+    setDefaults(provider: string, model: string): void;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,kBAAkB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,qBAAa,eAAe;IAGP,OAAO,CAAC,YAAY;IAFxC,OAAO,CAAC,IAAI,CAAoB;IAEhC,OAAO,eAEN;IAED,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAG/C;IAED,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,IAAI;IAQZ,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGzC;IAED,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGnC;IAED,aAAa,IAAI,kBAAkB,GAAG,SAAS,CAE9C;IAED,oBAAoB,IAAI,OAAO,CAE9B;IAED,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAM3C;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjD;CACD","sourcesContent":["/**\n * Settings persistence for edge-pi-cli.\n *\n * Stores user preferences (default provider/model, compaction settings)\n * in ~/.pi/agent/settings.json. Follows the same file-based pattern\n * as auth-storage.ts: load in constructor, save on mutation, create dir if needed.\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nexport interface CompactionSettings {\n\tenabled?: boolean;\n\treserveTokens?: number;\n\tkeepRecentTokens?: number;\n}\n\nexport interface SettingsData {\n\tdefaultProvider?: string;\n\tdefaultModel?: string;\n\tcompaction?: CompactionSettings;\n}\n\nexport class SettingsManager {\n\tprivate data: SettingsData = {};\n\n\tprivate constructor(private settingsPath: string) {\n\t\tthis.reload();\n\t}\n\n\tstatic create(agentDir: string): SettingsManager {\n\t\tconst settingsPath = `${agentDir}/settings.json`;\n\t\treturn new SettingsManager(settingsPath);\n\t}\n\n\tprivate reload(): void {\n\t\tif (!existsSync(this.settingsPath)) {\n\t\t\tthis.data = {};\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tthis.data = JSON.parse(readFileSync(this.settingsPath, \"utf-8\"));\n\t\t} catch {\n\t\t\tthis.data = {};\n\t\t}\n\t}\n\n\tprivate save(): void {\n\t\tconst dir = dirname(this.settingsPath);\n\t\tif (!existsSync(dir)) {\n\t\t\tmkdirSync(dir, { recursive: true, mode: 0o700 });\n\t\t}\n\t\twriteFileSync(this.settingsPath, JSON.stringify(this.data, null, 2), \"utf-8\");\n\t}\n\n\tgetDefaultProvider(): string | undefined {\n\t\treturn this.data.defaultProvider;\n\t}\n\n\tsetDefaultProvider(provider: string): void {\n\t\tthis.data.defaultProvider = provider;\n\t\tthis.save();\n\t}\n\n\tgetDefaultModel(): string | undefined {\n\t\treturn this.data.defaultModel;\n\t}\n\n\tsetDefaultModel(model: string): void {\n\t\tthis.data.defaultModel = model;\n\t\tthis.save();\n\t}\n\n\tgetCompaction(): CompactionSettings | undefined {\n\t\treturn this.data.compaction;\n\t}\n\n\tgetCompactionEnabled(): boolean {\n\t\treturn this.data.compaction?.enabled ?? true;\n\t}\n\n\tsetCompactionEnabled(enabled: boolean): void {\n\t\tif (!this.data.compaction) {\n\t\t\tthis.data.compaction = {};\n\t\t}\n\t\tthis.data.compaction.enabled = enabled;\n\t\tthis.save();\n\t}\n\n\tsetDefaults(provider: string, model: string): void {\n\t\tthis.data.defaultProvider = provider;\n\t\tthis.data.defaultModel = model;\n\t\tthis.save();\n\t}\n}\n"]}

package/dist/settings.js

@@ -0,0 +1,73 @@
+/**
+ * Settings persistence for edge-pi-cli.
+ *
+ * Stores user preferences (default provider/model, compaction settings)
+ * in ~/.pi/agent/settings.json. Follows the same file-based pattern
+ * as auth-storage.ts: load in constructor, save on mutation, create dir if needed.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+export class SettingsManager {
+    settingsPath;
+    data = {};
+    constructor(settingsPath) {
+        this.settingsPath = settingsPath;
+        this.reload();
+    }
+    static create(agentDir) {
+        const settingsPath = `${agentDir}/settings.json`;
+        return new SettingsManager(settingsPath);
+    }
+    reload() {
+        if (!existsSync(this.settingsPath)) {
+            this.data = {};
+            return;
+        }
+        try {
+            this.data = JSON.parse(readFileSync(this.settingsPath, "utf-8"));
+        }
+        catch {
+            this.data = {};
+        }
+    }
+    save() {
+        const dir = dirname(this.settingsPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        }
+        writeFileSync(this.settingsPath, JSON.stringify(this.data, null, 2), "utf-8");
+    }
+    getDefaultProvider() {
+        return this.data.defaultProvider;
+    }
+    setDefaultProvider(provider) {
+        this.data.defaultProvider = provider;
+        this.save();
+    }
+    getDefaultModel() {
+        return this.data.defaultModel;
+    }
+    setDefaultModel(model) {
+        this.data.defaultModel = model;
+        this.save();
+    }
+    getCompaction() {
+        return this.data.compaction;
+    }
+    getCompactionEnabled() {
+        return this.data.compaction?.enabled ?? true;
+    }
+    setCompactionEnabled(enabled) {
+        if (!this.data.compaction) {
+            this.data.compaction = {};
+        }
+        this.data.compaction.enabled = enabled;
+        this.save();
+    }
+    setDefaults(provider, model) {
+        this.data.defaultProvider = provider;
+        this.data.defaultModel = model;
+        this.save();
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,MAAM,OAAO,eAAe;IAGC,YAAY;IAFhC,IAAI,GAAiB,EAAE,CAAC;IAEhC,YAA4B,YAAoB,EAAE;4BAAtB,YAAY;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;IAAA,CACd;IAED,MAAM,CAAC,MAAM,CAAC,QAAgB,EAAmB;QAChD,MAAM,YAAY,GAAG,GAAG,QAAQ,gBAAgB,CAAC;QACjD,OAAO,IAAI,eAAe,CAAC,YAAY,CAAC,CAAC;IAAA,CACzC;IAEO,MAAM,GAAS;QACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACf,OAAO;QACR,CAAC;QACD,IAAI,CAAC;YACJ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QAChB,CAAC;IAAA,CACD;IAEO,IAAI,GAAS;QACpB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAAA,CAC9E;IAED,kBAAkB,GAAuB;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;IAAA,CACjC;IAED,kBAAkB,CAAC,QAAgB,EAAQ;QAC1C,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;IAAA,CACZ;IAED,eAAe,GAAuB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IAAA,CAC9B;IAED,eAAe,CAAC,KAAa,EAAQ;QACpC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;IAAA,CACZ;IAED,aAAa,GAAmC;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IAAA,CAC5B;IAED,oBAAoB,GAAY;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,IAAI,IAAI,CAAC;IAAA,CAC7C;IAED,oBAAoB,CAAC,OAAgB,EAAQ;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;IAAA,CACZ;IAED,WAAW,CAAC,QAAgB,EAAE,KAAa,EAAQ;QAClD,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;IAAA,CACZ;CACD","sourcesContent":["/**\n * Settings persistence for edge-pi-cli.\n *\n * Stores user preferences (default provider/model, compaction settings)\n * in ~/.pi/agent/settings.json. Follows the same file-based pattern\n * as auth-storage.ts: load in constructor, save on mutation, create dir if needed.\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nexport interface CompactionSettings {\n\tenabled?: boolean;\n\treserveTokens?: number;\n\tkeepRecentTokens?: number;\n}\n\nexport interface SettingsData {\n\tdefaultProvider?: string;\n\tdefaultModel?: string;\n\tcompaction?: CompactionSettings;\n}\n\nexport class SettingsManager {\n\tprivate data: SettingsData = {};\n\n\tprivate constructor(private settingsPath: string) {\n\t\tthis.reload();\n\t}\n\n\tstatic create(agentDir: string): SettingsManager {\n\t\tconst settingsPath = `${agentDir}/settings.json`;\n\t\treturn new SettingsManager(settingsPath);\n\t}\n\n\tprivate reload(): void {\n\t\tif (!existsSync(this.settingsPath)) {\n\t\t\tthis.data = {};\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tthis.data = JSON.parse(readFileSync(this.settingsPath, \"utf-8\"));\n\t\t} catch {\n\t\t\tthis.data = {};\n\t\t}\n\t}\n\n\tprivate save(): void {\n\t\tconst dir = dirname(this.settingsPath);\n\t\tif (!existsSync(dir)) {\n\t\t\tmkdirSync(dir, { recursive: true, mode: 0o700 });\n\t\t}\n\t\twriteFileSync(this.settingsPath, JSON.stringify(this.data, null, 2), \"utf-8\");\n\t}\n\n\tgetDefaultProvider(): string | undefined {\n\t\treturn this.data.defaultProvider;\n\t}\n\n\tsetDefaultProvider(provider: string): void {\n\t\tthis.data.defaultProvider = provider;\n\t\tthis.save();\n\t}\n\n\tgetDefaultModel(): string | undefined {\n\t\treturn this.data.defaultModel;\n\t}\n\n\tsetDefaultModel(model: string): void {\n\t\tthis.data.defaultModel = model;\n\t\tthis.save();\n\t}\n\n\tgetCompaction(): CompactionSettings | undefined {\n\t\treturn this.data.compaction;\n\t}\n\n\tgetCompactionEnabled(): boolean {\n\t\treturn this.data.compaction?.enabled ?? true;\n\t}\n\n\tsetCompactionEnabled(enabled: boolean): void {\n\t\tif (!this.data.compaction) {\n\t\t\tthis.data.compaction = {};\n\t\t}\n\t\tthis.data.compaction.enabled = enabled;\n\t\tthis.save();\n\t}\n\n\tsetDefaults(provider: string, model: string): void {\n\t\tthis.data.defaultProvider = provider;\n\t\tthis.data.defaultModel = model;\n\t\tthis.save();\n\t}\n}\n"]}

package/dist/skills.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Skill loading and formatting for the system prompt.
+ * Implements the Agent Skills spec: https://agentskills.io/specification
+ *
+ * Standalone implementation - no dependency on the old SDK.
+ */
+export interface SkillFrontmatter {
+    name?: string;
+    description?: string;
+    "disable-model-invocation"?: boolean;
+    [key: string]: unknown;
+}
+export interface Skill {
+    name: string;
+    description: string;
+    filePath: string;
+    baseDir: string;
+    source: string;
+    disableModelInvocation: boolean;
+}
+export interface SkillDiagnostic {
+    type: "warning" | "collision";
+    message: string;
+    path: string;
+}
+export interface LoadSkillsResult {
+    skills: Skill[];
+    diagnostics: SkillDiagnostic[];
+}
+export interface LoadSkillsOptions {
+    /** Working directory for project-local skills. Default: process.cwd() */
+    cwd?: string;
+    /** Agent config directory for global skills. Default: ~/.pi/agent */
+    agentDir?: string;
+    /** Explicit skill paths (files or directories) */
+    skillPaths?: string[];
+    /** Include default skill directories. Default: true */
+    includeDefaults?: boolean;
+}
+/**
+ * Load skills from all configured locations.
+ */
+export declare function loadSkills(options?: LoadSkillsOptions): LoadSkillsResult;
+/**
+ * Format skills for inclusion in a system prompt.
+ * Uses XML format per Agent Skills standard.
+ *
+ * Skills with disableModelInvocation=true are excluded from the prompt.
+ */
+export declare function formatSkillsForPrompt(skills: Skill[]): string;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,EAAE,eAAe,EAAE,CAAC;CAC/B;AAiJD,MAAM,WAAW,iBAAiB;IACjC,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAyBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA0F5E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CA0B7D","sourcesContent":["/**\n * Skill loading and formatting for the system prompt.\n * Implements the Agent Skills spec: https://agentskills.io/specification\n *\n * Standalone implementation - no dependency on the old SDK.\n */\n\nimport { existsSync, readdirSync, readFileSync, realpathSync, statSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { basename, dirname, isAbsolute, join, resolve, sep } from \"node:path\";\nimport { parseFrontmatter } from \"./utils/frontmatter.js\";\n\nconst CONFIG_DIR_NAME = \".pi\";\n\nconst ALLOWED_FRONTMATTER_FIELDS = new Set([\n\t\"name\",\n\t\"description\",\n\t\"license\",\n\t\"compatibility\",\n\t\"metadata\",\n\t\"allowed-tools\",\n\t\"disable-model-invocation\",\n]);\n\nconst MAX_NAME_LENGTH = 64;\nconst MAX_DESCRIPTION_LENGTH = 1024;\n\nexport interface SkillFrontmatter {\n\tname?: string;\n\tdescription?: string;\n\t\"disable-model-invocation\"?: boolean;\n\t[key: string]: unknown;\n}\n\nexport interface Skill {\n\tname: string;\n\tdescription: string;\n\tfilePath: string;\n\tbaseDir: string;\n\tsource: string;\n\tdisableModelInvocation: boolean;\n}\n\nexport interface SkillDiagnostic {\n\ttype: \"warning\" | \"collision\";\n\tmessage: string;\n\tpath: string;\n}\n\nexport interface LoadSkillsResult {\n\tskills: Skill[];\n\tdiagnostics: SkillDiagnostic[];\n}\n\nfunction validateName(name: string, parentDirName: string): string[] {\n\tconst errors: string[] = [];\n\tif (name !== parentDirName) {\n\t\terrors.push(`name \"${name}\" does not match parent directory \"${parentDirName}\"`);\n\t}\n\tif (name.length > MAX_NAME_LENGTH) {\n\t\terrors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);\n\t}\n\tif (!/^[a-z0-9-]+$/.test(name)) {\n\t\terrors.push(`name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)`);\n\t}\n\tif (name.startsWith(\"-\") || name.endsWith(\"-\")) {\n\t\terrors.push(`name must not start or end with a hyphen`);\n\t}\n\tif (name.includes(\"--\")) {\n\t\terrors.push(`name must not contain consecutive hyphens`);\n\t}\n\treturn errors;\n}\n\nfunction validateDescription(description: string | undefined): string[] {\n\tconst errors: string[] = [];\n\tif (!description || description.trim() === \"\") {\n\t\terrors.push(\"description is required\");\n\t} else if (description.length > MAX_DESCRIPTION_LENGTH) {\n\t\terrors.push(`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`);\n\t}\n\treturn errors;\n}\n\nfunction validateFrontmatterFields(keys: string[]): string[] {\n\tconst errors: string[] = [];\n\tfor (const key of keys) {\n\t\tif (!ALLOWED_FRONTMATTER_FIELDS.has(key)) {\n\t\t\terrors.push(`unknown frontmatter field \"${key}\"`);\n\t\t}\n\t}\n\treturn errors;\n}\n\nfunction loadSkillFromFile(filePath: string, source: string): { skill: Skill | null; diagnostics: SkillDiagnostic[] } {\n\tconst diagnostics: SkillDiagnostic[] = [];\n\n\ttry {\n\t\tconst rawContent = readFileSync(filePath, \"utf-8\");\n\t\tconst { frontmatter } = parseFrontmatter<SkillFrontmatter>(rawContent);\n\t\tconst allKeys = Object.keys(frontmatter);\n\t\tconst skillDir = dirname(filePath);\n\t\tconst parentDirName = basename(skillDir);\n\n\t\tconst fieldErrors = validateFrontmatterFields(allKeys);\n\t\tfor (const error of fieldErrors) {\n\t\t\tdiagnostics.push({ type: \"warning\", message: error, path: filePath });\n\t\t}\n\n\t\tconst descErrors = validateDescription(frontmatter.description);\n\t\tfor (const error of descErrors) {\n\t\t\tdiagnostics.push({ type: \"warning\", message: error, path: filePath });\n\t\t}\n\n\t\tconst name = frontmatter.name || parentDirName;\n\n\t\tconst nameErrors = validateName(name, parentDirName);\n\t\tfor (const error of nameErrors) {\n\t\t\tdiagnostics.push({ type: \"warning\", message: error, path: filePath });\n\t\t}\n\n\t\tif (!frontmatter.description || frontmatter.description.trim() === \"\") {\n\t\t\treturn { skill: null, diagnostics };\n\t\t}\n\n\t\treturn {\n\t\t\tskill: {\n\t\t\t\tname,\n\t\t\t\tdescription: frontmatter.description,\n\t\t\t\tfilePath,\n\t\t\t\tbaseDir: skillDir,\n\t\t\t\tsource,\n\t\t\t\tdisableModelInvocation: frontmatter[\"disable-model-invocation\"] === true,\n\t\t\t},\n\t\t\tdiagnostics,\n\t\t};\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : \"failed to parse skill file\";\n\t\tdiagnostics.push({ type: \"warning\", message, path: filePath });\n\t\treturn { skill: null, diagnostics };\n\t}\n}\n\nfunction loadSkillsFromDirInternal(dir: string, source: string, includeRootFiles: boolean): LoadSkillsResult {\n\tconst skills: Skill[] = [];\n\tconst diagnostics: SkillDiagnostic[] = [];\n\n\tif (!existsSync(dir)) {\n\t\treturn { skills, diagnostics };\n\t}\n\n\ttry {\n\t\tconst entries = readdirSync(dir, { withFileTypes: true });\n\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.name.startsWith(\".\") || entry.name === \"node_modules\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst fullPath = join(dir, entry.name);\n\n\t\t\tlet isDirectory = entry.isDirectory();\n\t\t\tlet isFile = entry.isFile();\n\t\t\tif (entry.isSymbolicLink()) {\n\t\t\t\ttry {\n\t\t\t\t\tconst stats = statSync(fullPath);\n\t\t\t\t\tisDirectory = stats.isDirectory();\n\t\t\t\t\tisFile = stats.isFile();\n\t\t\t\t} catch {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isDirectory) {\n\t\t\t\tconst subResult = loadSkillsFromDirInternal(fullPath, source, false);\n\t\t\t\tskills.push(...subResult.skills);\n\t\t\t\tdiagnostics.push(...subResult.diagnostics);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!isFile) continue;\n\n\t\t\tconst isRootMd = includeRootFiles && entry.name.endsWith(\".md\");\n\t\t\tconst isSkillMd = !includeRootFiles && entry.name === \"SKILL.md\";\n\t\t\tif (!isRootMd && !isSkillMd) continue;\n\n\t\t\tconst result = loadSkillFromFile(fullPath, source);\n\t\t\tif (result.skill) {\n\t\t\t\tskills.push(result.skill);\n\t\t\t}\n\t\t\tdiagnostics.push(...result.diagnostics);\n\t\t}\n\t} catch {}\n\n\treturn { skills, diagnostics };\n}\n\nexport interface LoadSkillsOptions {\n\t/** Working directory for project-local skills. Default: process.cwd() */\n\tcwd?: string;\n\t/** Agent config directory for global skills. Default: ~/.pi/agent */\n\tagentDir?: string;\n\t/** Explicit skill paths (files or directories) */\n\tskillPaths?: string[];\n\t/** Include default skill directories. Default: true */\n\tincludeDefaults?: boolean;\n}\n\nfunction getDefaultAgentDir(): string {\n\tconst envDir = process.env.PI_CODING_AGENT_DIR;\n\tif (envDir) {\n\t\tif (envDir === \"~\") return homedir();\n\t\tif (envDir.startsWith(\"~/\")) return homedir() + envDir.slice(1);\n\t\treturn envDir;\n\t}\n\treturn join(homedir(), CONFIG_DIR_NAME, \"agent\");\n}\n\nfunction normalizePath(input: string): string {\n\tconst trimmed = input.trim();\n\tif (trimmed === \"~\") return homedir();\n\tif (trimmed.startsWith(\"~/\")) return join(homedir(), trimmed.slice(2));\n\tif (trimmed.startsWith(\"~\")) return join(homedir(), trimmed.slice(1));\n\treturn trimmed;\n}\n\nfunction resolveSkillPath(p: string, cwd: string): string {\n\tconst normalized = normalizePath(p);\n\treturn isAbsolute(normalized) ? normalized : resolve(cwd, normalized);\n}\n\n/**\n * Load skills from all configured locations.\n */\nexport function loadSkills(options: LoadSkillsOptions = {}): LoadSkillsResult {\n\tconst { cwd = process.cwd(), agentDir, skillPaths = [], includeDefaults = true } = options;\n\tconst resolvedAgentDir = agentDir ?? getDefaultAgentDir();\n\n\tconst skillMap = new Map<string, Skill>();\n\tconst realPathSet = new Set<string>();\n\tconst allDiagnostics: SkillDiagnostic[] = [];\n\tconst collisionDiagnostics: SkillDiagnostic[] = [];\n\n\tfunction addSkills(result: LoadSkillsResult) {\n\t\tallDiagnostics.push(...result.diagnostics);\n\t\tfor (const skill of result.skills) {\n\t\t\tlet realPath: string;\n\t\t\ttry {\n\t\t\t\trealPath = realpathSync(skill.filePath);\n\t\t\t} catch {\n\t\t\t\trealPath = skill.filePath;\n\t\t\t}\n\n\t\t\tif (realPathSet.has(realPath)) continue;\n\n\t\t\tconst existing = skillMap.get(skill.name);\n\t\t\tif (existing) {\n\t\t\t\tcollisionDiagnostics.push({\n\t\t\t\t\ttype: \"collision\",\n\t\t\t\t\tmessage: `name \"${skill.name}\" collision`,\n\t\t\t\t\tpath: skill.filePath,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tskillMap.set(skill.name, skill);\n\t\t\t\trealPathSet.add(realPath);\n\t\t\t}\n\t\t}\n\t}\n\n\tif (includeDefaults) {\n\t\taddSkills(loadSkillsFromDirInternal(join(resolvedAgentDir, \"skills\"), \"user\", true));\n\t\taddSkills(loadSkillsFromDirInternal(resolve(cwd, CONFIG_DIR_NAME, \"skills\"), \"project\", true));\n\t}\n\n\tconst userSkillsDir = join(resolvedAgentDir, \"skills\");\n\tconst projectSkillsDir = resolve(cwd, CONFIG_DIR_NAME, \"skills\");\n\n\tconst isUnderPath = (target: string, root: string): boolean => {\n\t\tconst normalizedRoot = resolve(root);\n\t\tif (target === normalizedRoot) return true;\n\t\tconst prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\treturn target.startsWith(prefix);\n\t};\n\n\tconst getSource = (resolvedPath: string): \"user\" | \"project\" | \"path\" => {\n\t\tif (!includeDefaults) {\n\t\t\tif (isUnderPath(resolvedPath, userSkillsDir)) return \"user\";\n\t\t\tif (isUnderPath(resolvedPath, projectSkillsDir)) return \"project\";\n\t\t}\n\t\treturn \"path\";\n\t};\n\n\tfor (const rawPath of skillPaths) {\n\t\tconst resolvedPath = resolveSkillPath(rawPath, cwd);\n\t\tif (!existsSync(resolvedPath)) {\n\t\t\tallDiagnostics.push({ type: \"warning\", message: \"skill path does not exist\", path: resolvedPath });\n\t\t\tcontinue;\n\t\t}\n\n\t\ttry {\n\t\t\tconst stats = statSync(resolvedPath);\n\t\t\tconst source = getSource(resolvedPath);\n\t\t\tif (stats.isDirectory()) {\n\t\t\t\taddSkills(loadSkillsFromDirInternal(resolvedPath, source, true));\n\t\t\t} else if (stats.isFile() && resolvedPath.endsWith(\".md\")) {\n\t\t\t\tconst result = loadSkillFromFile(resolvedPath, source);\n\t\t\t\tif (result.skill) {\n\t\t\t\t\taddSkills({ skills: [result.skill], diagnostics: result.diagnostics });\n\t\t\t\t} else {\n\t\t\t\t\tallDiagnostics.push(...result.diagnostics);\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tallDiagnostics.push({ type: \"warning\", message: \"skill path is not a markdown file\", path: resolvedPath });\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : \"failed to read skill path\";\n\t\t\tallDiagnostics.push({ type: \"warning\", message, path: resolvedPath });\n\t\t}\n\t}\n\n\treturn {\n\t\tskills: Array.from(skillMap.values()),\n\t\tdiagnostics: [...allDiagnostics, ...collisionDiagnostics],\n\t};\n}\n\n/**\n * Format skills for inclusion in a system prompt.\n * Uses XML format per Agent Skills standard.\n *\n * Skills with disableModelInvocation=true are excluded from the prompt.\n */\nexport function formatSkillsForPrompt(skills: Skill[]): string {\n\tconst visibleSkills = skills.filter((s) => !s.disableModelInvocation);\n\n\tif (visibleSkills.length === 0) {\n\t\treturn \"\";\n\t}\n\n\tconst lines = [\n\t\t\"\\n\\nThe following skills provide specialized instructions for specific tasks.\",\n\t\t\"Use the read tool to load a skill's file when the task matches its description.\",\n\t\t\"When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.\",\n\t\t\"\",\n\t\t\"<available_skills>\",\n\t];\n\n\tfor (const skill of visibleSkills) {\n\t\tlines.push(\"  <skill>\");\n\t\tlines.push(`    <name>${escapeXml(skill.name)}</name>`);\n\t\tlines.push(`    <description>${escapeXml(skill.description)}</description>`);\n\t\tlines.push(`    <location>${escapeXml(skill.filePath)}</location>`);\n\t\tlines.push(\"  </skill>\");\n\t}\n\n\tlines.push(\"</available_skills>\");\n\n\treturn lines.join(\"\\n\");\n}\n\nfunction escapeXml(str: string): string {\n\treturn str\n\t\t.replace(/&/g, \"&amp;\")\n\t\t.replace(/</g, \"&lt;\")\n\t\t.replace(/>/g, \"&gt;\")\n\t\t.replace(/\"/g, \"&quot;\")\n\t\t.replace(/'/g, \"&apos;\");\n}\n"]}

package/dist/skills.js

@@ -0,0 +1,304 @@
+/**
+ * Skill loading and formatting for the system prompt.
+ * Implements the Agent Skills spec: https://agentskills.io/specification
+ *
+ * Standalone implementation - no dependency on the old SDK.
+ */
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
+import { parseFrontmatter } from "./utils/frontmatter.js";
+const CONFIG_DIR_NAME = ".pi";
+const ALLOWED_FRONTMATTER_FIELDS = new Set([
+    "name",
+    "description",
+    "license",
+    "compatibility",
+    "metadata",
+    "allowed-tools",
+    "disable-model-invocation",
+]);
+const MAX_NAME_LENGTH = 64;
+const MAX_DESCRIPTION_LENGTH = 1024;
+function validateName(name, parentDirName) {
+    const errors = [];
+    if (name !== parentDirName) {
+        errors.push(`name "${name}" does not match parent directory "${parentDirName}"`);
+    }
+    if (name.length > MAX_NAME_LENGTH) {
+        errors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);
+    }
+    if (!/^[a-z0-9-]+$/.test(name)) {
+        errors.push(`name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)`);
+    }
+    if (name.startsWith("-") || name.endsWith("-")) {
+        errors.push(`name must not start or end with a hyphen`);
+    }
+    if (name.includes("--")) {
+        errors.push(`name must not contain consecutive hyphens`);
+    }
+    return errors;
+}
+function validateDescription(description) {
+    const errors = [];
+    if (!description || description.trim() === "") {
+        errors.push("description is required");
+    }
+    else if (description.length > MAX_DESCRIPTION_LENGTH) {
+        errors.push(`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`);
+    }
+    return errors;
+}
+function validateFrontmatterFields(keys) {
+    const errors = [];
+    for (const key of keys) {
+        if (!ALLOWED_FRONTMATTER_FIELDS.has(key)) {
+            errors.push(`unknown frontmatter field "${key}"`);
+        }
+    }
+    return errors;
+}
+function loadSkillFromFile(filePath, source) {
+    const diagnostics = [];
+    try {
+        const rawContent = readFileSync(filePath, "utf-8");
+        const { frontmatter } = parseFrontmatter(rawContent);
+        const allKeys = Object.keys(frontmatter);
+        const skillDir = dirname(filePath);
+        const parentDirName = basename(skillDir);
+        const fieldErrors = validateFrontmatterFields(allKeys);
+        for (const error of fieldErrors) {
+            diagnostics.push({ type: "warning", message: error, path: filePath });
+        }
+        const descErrors = validateDescription(frontmatter.description);
+        for (const error of descErrors) {
+            diagnostics.push({ type: "warning", message: error, path: filePath });
+        }
+        const name = frontmatter.name || parentDirName;
+        const nameErrors = validateName(name, parentDirName);
+        for (const error of nameErrors) {
+            diagnostics.push({ type: "warning", message: error, path: filePath });
+        }
+        if (!frontmatter.description || frontmatter.description.trim() === "") {
+            return { skill: null, diagnostics };
+        }
+        return {
+            skill: {
+                name,
+                description: frontmatter.description,
+                filePath,
+                baseDir: skillDir,
+                source,
+                disableModelInvocation: frontmatter["disable-model-invocation"] === true,
+            },
+            diagnostics,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "failed to parse skill file";
+        diagnostics.push({ type: "warning", message, path: filePath });
+        return { skill: null, diagnostics };
+    }
+}
+function loadSkillsFromDirInternal(dir, source, includeRootFiles) {
+    const skills = [];
+    const diagnostics = [];
+    if (!existsSync(dir)) {
+        return { skills, diagnostics };
+    }
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules") {
+                continue;
+            }
+            const fullPath = join(dir, entry.name);
+            let isDirectory = entry.isDirectory();
+            let isFile = entry.isFile();
+            if (entry.isSymbolicLink()) {
+                try {
+                    const stats = statSync(fullPath);
+                    isDirectory = stats.isDirectory();
+                    isFile = stats.isFile();
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (isDirectory) {
+                const subResult = loadSkillsFromDirInternal(fullPath, source, false);
+                skills.push(...subResult.skills);
+                diagnostics.push(...subResult.diagnostics);
+                continue;
+            }
+            if (!isFile)
+                continue;
+            const isRootMd = includeRootFiles && entry.name.endsWith(".md");
+            const isSkillMd = !includeRootFiles && entry.name === "SKILL.md";
+            if (!isRootMd && !isSkillMd)
+                continue;
+            const result = loadSkillFromFile(fullPath, source);
+            if (result.skill) {
+                skills.push(result.skill);
+            }
+            diagnostics.push(...result.diagnostics);
+        }
+    }
+    catch { }
+    return { skills, diagnostics };
+}
+function getDefaultAgentDir() {
+    const envDir = process.env.PI_CODING_AGENT_DIR;
+    if (envDir) {
+        if (envDir === "~")
+            return homedir();
+        if (envDir.startsWith("~/"))
+            return homedir() + envDir.slice(1);
+        return envDir;
+    }
+    return join(homedir(), CONFIG_DIR_NAME, "agent");
+}
+function normalizePath(input) {
+    const trimmed = input.trim();
+    if (trimmed === "~")
+        return homedir();
+    if (trimmed.startsWith("~/"))
+        return join(homedir(), trimmed.slice(2));
+    if (trimmed.startsWith("~"))
+        return join(homedir(), trimmed.slice(1));
+    return trimmed;
+}
+function resolveSkillPath(p, cwd) {
+    const normalized = normalizePath(p);
+    return isAbsolute(normalized) ? normalized : resolve(cwd, normalized);
+}
+/**
+ * Load skills from all configured locations.
+ */
+export function loadSkills(options = {}) {
+    const { cwd = process.cwd(), agentDir, skillPaths = [], includeDefaults = true } = options;
+    const resolvedAgentDir = agentDir ?? getDefaultAgentDir();
+    const skillMap = new Map();
+    const realPathSet = new Set();
+    const allDiagnostics = [];
+    const collisionDiagnostics = [];
+    function addSkills(result) {
+        allDiagnostics.push(...result.diagnostics);
+        for (const skill of result.skills) {
+            let realPath;
+            try {
+                realPath = realpathSync(skill.filePath);
+            }
+            catch {
+                realPath = skill.filePath;
+            }
+            if (realPathSet.has(realPath))
+                continue;
+            const existing = skillMap.get(skill.name);
+            if (existing) {
+                collisionDiagnostics.push({
+                    type: "collision",
+                    message: `name "${skill.name}" collision`,
+                    path: skill.filePath,
+                });
+            }
+            else {
+                skillMap.set(skill.name, skill);
+                realPathSet.add(realPath);
+            }
+        }
+    }
+    if (includeDefaults) {
+        addSkills(loadSkillsFromDirInternal(join(resolvedAgentDir, "skills"), "user", true));
+        addSkills(loadSkillsFromDirInternal(resolve(cwd, CONFIG_DIR_NAME, "skills"), "project", true));
+    }
+    const userSkillsDir = join(resolvedAgentDir, "skills");
+    const projectSkillsDir = resolve(cwd, CONFIG_DIR_NAME, "skills");
+    const isUnderPath = (target, root) => {
+        const normalizedRoot = resolve(root);
+        if (target === normalizedRoot)
+            return true;
+        const prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;
+        return target.startsWith(prefix);
+    };
+    const getSource = (resolvedPath) => {
+        if (!includeDefaults) {
+            if (isUnderPath(resolvedPath, userSkillsDir))
+                return "user";
+            if (isUnderPath(resolvedPath, projectSkillsDir))
+                return "project";
+        }
+        return "path";
+    };
+    for (const rawPath of skillPaths) {
+        const resolvedPath = resolveSkillPath(rawPath, cwd);
+        if (!existsSync(resolvedPath)) {
+            allDiagnostics.push({ type: "warning", message: "skill path does not exist", path: resolvedPath });
+            continue;
+        }
+        try {
+            const stats = statSync(resolvedPath);
+            const source = getSource(resolvedPath);
+            if (stats.isDirectory()) {
+                addSkills(loadSkillsFromDirInternal(resolvedPath, source, true));
+            }
+            else if (stats.isFile() && resolvedPath.endsWith(".md")) {
+                const result = loadSkillFromFile(resolvedPath, source);
+                if (result.skill) {
+                    addSkills({ skills: [result.skill], diagnostics: result.diagnostics });
+                }
+                else {
+                    allDiagnostics.push(...result.diagnostics);
+                }
+            }
+            else {
+                allDiagnostics.push({ type: "warning", message: "skill path is not a markdown file", path: resolvedPath });
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "failed to read skill path";
+            allDiagnostics.push({ type: "warning", message, path: resolvedPath });
+        }
+    }
+    return {
+        skills: Array.from(skillMap.values()),
+        diagnostics: [...allDiagnostics, ...collisionDiagnostics],
+    };
+}
+/**
+ * Format skills for inclusion in a system prompt.
+ * Uses XML format per Agent Skills standard.
+ *
+ * Skills with disableModelInvocation=true are excluded from the prompt.
+ */
+export function formatSkillsForPrompt(skills) {
+    const visibleSkills = skills.filter((s) => !s.disableModelInvocation);
+    if (visibleSkills.length === 0) {
+        return "";
+    }
+    const lines = [
+        "\n\nThe following skills provide specialized instructions for specific tasks.",
+        "Use the read tool to load a skill's file when the task matches its description.",
+        "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.",
+        "",
+        "<available_skills>",
+    ];
+    for (const skill of visibleSkills) {
+        lines.push("  <skill>");
+        lines.push(`    <name>${escapeXml(skill.name)}</name>`);
+        lines.push(`    <description>${escapeXml(skill.description)}</description>`);
+        lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);
+        lines.push("  </skill>");
+    }
+    lines.push("</available_skills>");
+    return lines.join("\n");
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+//# sourceMappingURL=skills.js.map