@farazirfan/costar-server-executor 1.0.0

package/dist/skills/index.js

@@ -0,0 +1,26 @@
+/**
+ * CoStar Server Executor - Skills System
+ * AgentSkills.io compatible skills framework
+ *
+ * Based on:
+ * - OpenClaw skills system
+ * - AgentSkills.io specification (https://agentskills.io/specification)
+ *
+ * Skills are modular capabilities defined in SKILL.md files with:
+ * - YAML frontmatter (metadata)
+ * - Markdown body (instructions for agent)
+ *
+ * Features:
+ * - Load skills from multiple directories
+ * - Check requirements (bins, env, config, OS)
+ * - Enable/disable skills
+ * - Build status reports
+ * - Progressive disclosure (load only relevant skills)
+ */
+// Loader
+export { parseSkillFile, scanSkillsDirectory, loadSkills } from "./loader.js";
+// Status
+export { hasBinary, buildSkillStatus, buildSkillStatusEntry, buildSkillsStatusReport, getEligibleSkills, } from "./status.js";
+// Manager
+export { SkillsManager, createSkillsManager } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgBH,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9E,SAAS;AACT,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CoStar Server Executor - Skills Loader
+ * Loads and parses SKILL.md files from directories
+ */
+import type { SkillEntry } from "./types.js";
+/**
+ * Parse a SKILL.md file
+ */
+export declare function parseSkillFile(filePath: string, source: string): Promise<SkillEntry | null>;
+/**
+ * Scan a directory for SKILL.md files
+ */
+export declare function scanSkillsDirectory(directory: string, source: string): Promise<SkillEntry[]>;
+/**
+ * Load skills from multiple directories
+ *
+ * Precedence (later overrides earlier by name):
+ * 1. Extra directories (lowest)
+ * 2. Bundled skills (shipped with package)
+ * 3. Managed skills (~/.costar/skills/ - shared across agents)
+ * 4. Workspace skills (<workspace>/skills/ - highest precedence)
+ */
+export declare function loadSkills(options: {
+    bundledDir?: string;
+    managedDir?: string;
+    workspaceDir?: string;
+    extraDirs?: string[];
+}): Promise<SkillEntry[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAmC,MAAM,YAAY,CAAC;AAgD9E;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgD5B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CAuCvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CxB"}

package/dist/skills/loader.js

@@ -0,0 +1,176 @@
+/**
+ * CoStar Server Executor - Skills Loader
+ * Loads and parses SKILL.md files from directories
+ */
+import { readdir, readFile, stat } from "fs/promises";
+import { join, basename } from "path";
+import { parse as parseYaml } from "yaml";
+const SKILL_FILENAME = "SKILL.md";
+/**
+ * Extract YAML frontmatter from markdown
+ */
+function extractFrontmatter(content) {
+    const lines = content.split("\n");
+    // Check for YAML frontmatter (starts with ---)
+    if (!lines[0]?.trim().startsWith("---")) {
+        return { frontmatter: null, body: content };
+    }
+    // Find closing ---
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i]?.trim() === "---") {
+            endIndex = i;
+            break;
+        }
+    }
+    if (endIndex === -1) {
+        return { frontmatter: null, body: content };
+    }
+    // Parse YAML
+    const yamlContent = lines.slice(1, endIndex).join("\n");
+    let frontmatter = null;
+    try {
+        frontmatter = parseYaml(yamlContent);
+    }
+    catch (error) {
+        console.error(`[SKILLS] Error parsing YAML frontmatter:`, error);
+        return { frontmatter: null, body: content };
+    }
+    // Extract body (everything after closing ---)
+    const body = lines.slice(endIndex + 1).join("\n").trim();
+    return { frontmatter, body };
+}
+/**
+ * Parse a SKILL.md file
+ */
+export async function parseSkillFile(filePath, source) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        const { frontmatter, body } = extractFrontmatter(content);
+        if (!frontmatter) {
+            console.warn(`[SKILLS] No frontmatter in ${filePath}`);
+            return null;
+        }
+        // Validate required fields
+        const name = frontmatter.name;
+        const description = frontmatter.description;
+        if (!name || !description) {
+            console.warn(`[SKILLS] Missing name or description in ${filePath}`);
+            return null;
+        }
+        // Extract metadata
+        const metadata = frontmatter.metadata || null;
+        const homepage = frontmatter.homepage;
+        // Build frontmatter object
+        const parsedFrontmatter = {
+            name,
+            description,
+            homepage,
+            metadata: metadata || undefined,
+        };
+        // Build skill entry
+        const baseDir = join(filePath, "..");
+        return {
+            name,
+            description,
+            source,
+            filePath,
+            baseDir,
+            frontmatter: parsedFrontmatter,
+            metadata,
+            content: body,
+        };
+    }
+    catch (error) {
+        console.error(`[SKILLS] Error parsing skill file ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Scan a directory for SKILL.md files
+ */
+export async function scanSkillsDirectory(directory, source) {
+    const skills = [];
+    try {
+        // Check if directory exists first
+        try {
+            await stat(directory);
+        }
+        catch {
+            // Directory doesn't exist - silently skip
+            return skills;
+        }
+        const entries = await readdir(directory, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillPath = join(directory, entry.name, SKILL_FILENAME);
+            try {
+                await stat(skillPath);
+                const skill = await parseSkillFile(skillPath, source);
+                if (skill) {
+                    skills.push(skill);
+                }
+            }
+            catch {
+                // Skill file doesn't exist, skip
+                continue;
+            }
+        }
+    }
+    catch (error) {
+        // Only log if it's not a "directory doesn't exist" error
+        const code = error.code;
+        if (code !== "ENOENT") {
+            console.error(`[SKILLS] Error scanning directory ${directory}:`, error);
+        }
+    }
+    return skills;
+}
+/**
+ * Load skills from multiple directories
+ *
+ * Precedence (later overrides earlier by name):
+ * 1. Extra directories (lowest)
+ * 2. Bundled skills (shipped with package)
+ * 3. Managed skills (~/.costar/skills/ - shared across agents)
+ * 4. Workspace skills (<workspace>/skills/ - highest precedence)
+ */
+export async function loadSkills(options) {
+    const allSkills = [];
+    // 1. Load extra directories (lowest precedence)
+    if (options.extraDirs) {
+        for (const dir of options.extraDirs) {
+            console.log(`[SKILLS] Loading skills from ${dir}`);
+            const extra = await scanSkillsDirectory(dir, `extra-${basename(dir)}`);
+            allSkills.push(...extra);
+        }
+    }
+    // 2. Load bundled skills
+    if (options.bundledDir) {
+        console.log(`[SKILLS] Loading bundled skills from ${options.bundledDir}`);
+        const bundled = await scanSkillsDirectory(options.bundledDir, "bundled");
+        allSkills.push(...bundled);
+    }
+    // 3. Load managed skills (~/.costar/skills/)
+    if (options.managedDir) {
+        console.log(`[SKILLS] Loading managed skills from ${options.managedDir}`);
+        const managed = await scanSkillsDirectory(options.managedDir, "managed");
+        allSkills.push(...managed);
+    }
+    // 4. Load workspace skills (highest precedence)
+    if (options.workspaceDir) {
+        console.log(`[SKILLS] Loading workspace skills from ${options.workspaceDir}`);
+        const workspace = await scanSkillsDirectory(options.workspaceDir, "workspace");
+        allSkills.push(...workspace);
+    }
+    // Merge by name: later sources override earlier ones
+    const skillMap = new Map();
+    for (const skill of allSkills) {
+        skillMap.set(skill.name, skill);
+    }
+    const merged = Array.from(skillMap.values());
+    console.log(`[SKILLS] Loaded ${merged.length} skills (from ${allSkills.length} entries across all sources)`);
+    return merged;
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * CoStar Server Executor - Skills Manager
+ * Manages skills loading, configuration, and execution context
+ */
+import type { SkillEntry, SkillsConfig, SkillsStatusReport } from "./types.js";
+/**
+ * Skills Manager - Central skills system API
+ *
+ * Loads skills from 4 sources with precedence (later overrides earlier):
+ * 1. Extra directories (lowest)
+ * 2. Bundled skills (shipped with package)
+ * 3. Managed skills (~/.costar/skills/)
+ * 4. Workspace skills (<workspace>/skills/) - highest precedence
+ */
+export declare class SkillsManager {
+    private skills;
+    private config;
+    private workspaceDir;
+    private bundledDir;
+    private managedDir;
+    constructor(options: {
+        workspaceDir: string;
+        bundledDir?: string;
+        managedDir?: string;
+        config?: SkillsConfig;
+    });
+    /**
+     * Load all skills from configured directories
+     */
+    load(): Promise<void>;
+    /**
+     * Get all loaded skills
+     */
+    getSkills(): SkillEntry[];
+    /**
+     * Get eligible skills (ready to use)
+     */
+    getEligibleSkills(): SkillEntry[];
+    /**
+     * Get skill by name or key
+     */
+    getSkill(nameOrKey: string): SkillEntry | undefined;
+    /**
+     * Build status report for all skills
+     */
+    getStatusReport(): SkillsStatusReport;
+    /**
+     * Enable a skill
+     */
+    enableSkill(skillKey: string): void;
+    /**
+     * Disable a skill
+     */
+    disableSkill(skillKey: string): void;
+    /**
+     * Set skill API key
+     */
+    setSkillApiKey(skillKey: string, apiKey: string): void;
+    /**
+     * Get current config
+     */
+    getConfig(): SkillsConfig;
+    /**
+     * Update config
+     */
+    updateConfig(newConfig: Partial<SkillsConfig>): void;
+    /**
+     * Get skill instructions for agent context
+     * Returns markdown content for eligible skills
+     */
+    getSkillInstructions(skillNames?: string[]): string;
+    /**
+     * Get skill summary for agent (names + descriptions only)
+     */
+    getSkillSummary(): string;
+}
+/**
+ * Create skills manager instance
+ */
+export declare function createSkillsManager(options: {
+    workspaceDir: string;
+    bundledDir?: string;
+    config?: SkillsConfig;
+}): SkillsManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/skills/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/skills/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAepB;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB;IAOD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;OAEG;IACH,SAAS,IAAI,UAAU,EAAE;IAIzB;;OAEG;IACH,iBAAiB,IAAI,UAAU,EAAE;IAIjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQnD;;OAEG;IACH,eAAe,IAAI,kBAAkB;IASrC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWnC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWpC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAWtD;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAIpD;;;OAGG;IACH,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAmCnD;;OAEG;IACH,eAAe,IAAI,MAAM;CAiB1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,aAAa,CAEhB"}

package/dist/skills/manager.js

@@ -0,0 +1,179 @@
+/**
+ * CoStar Server Executor - Skills Manager
+ * Manages skills loading, configuration, and execution context
+ */
+import { join } from "path";
+import os from "os";
+import { loadSkills } from "./loader.js";
+import { buildSkillsStatusReport, getEligibleSkills } from "./status.js";
+/**
+ * Resolve the managed skills directory (~/.costar/skills/)
+ * This is shared across all agents on the machine.
+ */
+function resolveManagedSkillsDir() {
+    return join(process.env.COSTAR_STATE_DIR || join(os.homedir(), ".costar"), "skills");
+}
+/**
+ * Skills Manager - Central skills system API
+ *
+ * Loads skills from 4 sources with precedence (later overrides earlier):
+ * 1. Extra directories (lowest)
+ * 2. Bundled skills (shipped with package)
+ * 3. Managed skills (~/.costar/skills/)
+ * 4. Workspace skills (<workspace>/skills/) - highest precedence
+ */
+export class SkillsManager {
+    skills = [];
+    config;
+    workspaceDir;
+    bundledDir;
+    managedDir;
+    constructor(options) {
+        this.workspaceDir = options.workspaceDir;
+        this.bundledDir = options.bundledDir || null;
+        this.managedDir = options.managedDir || resolveManagedSkillsDir();
+        this.config = options.config || {};
+    }
+    /**
+     * Load all skills from configured directories
+     */
+    async load() {
+        console.log("[SKILLS] Loading skills...");
+        this.skills = await loadSkills({
+            bundledDir: this.bundledDir || undefined,
+            managedDir: this.managedDir,
+            workspaceDir: join(this.workspaceDir, "skills"),
+            extraDirs: this.config.extraDirs,
+        });
+        console.log(`[SKILLS] Loaded ${this.skills.length} total skills`);
+    }
+    /**
+     * Get all loaded skills
+     */
+    getSkills() {
+        return this.skills;
+    }
+    /**
+     * Get eligible skills (ready to use)
+     */
+    getEligibleSkills() {
+        return getEligibleSkills(this.skills, this.config);
+    }
+    /**
+     * Get skill by name or key
+     */
+    getSkill(nameOrKey) {
+        return this.skills.find((skill) => skill.name === nameOrKey ||
+            skill.metadata?.skillKey === nameOrKey);
+    }
+    /**
+     * Build status report for all skills
+     */
+    getStatusReport() {
+        return buildSkillsStatusReport(this.skills, this.config, this.workspaceDir, this.bundledDir);
+    }
+    /**
+     * Enable a skill
+     */
+    enableSkill(skillKey) {
+        if (!this.config.entries) {
+            this.config.entries = {};
+        }
+        if (!this.config.entries[skillKey]) {
+            this.config.entries[skillKey] = {};
+        }
+        this.config.entries[skillKey].enabled = true;
+        console.log(`[SKILLS] Enabled skill: ${skillKey}`);
+    }
+    /**
+     * Disable a skill
+     */
+    disableSkill(skillKey) {
+        if (!this.config.entries) {
+            this.config.entries = {};
+        }
+        if (!this.config.entries[skillKey]) {
+            this.config.entries[skillKey] = {};
+        }
+        this.config.entries[skillKey].enabled = false;
+        console.log(`[SKILLS] Disabled skill: ${skillKey}`);
+    }
+    /**
+     * Set skill API key
+     */
+    setSkillApiKey(skillKey, apiKey) {
+        if (!this.config.entries) {
+            this.config.entries = {};
+        }
+        if (!this.config.entries[skillKey]) {
+            this.config.entries[skillKey] = {};
+        }
+        this.config.entries[skillKey].apiKey = apiKey;
+        console.log(`[SKILLS] Set API key for skill: ${skillKey}`);
+    }
+    /**
+     * Get current config
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Update config
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+    }
+    /**
+     * Get skill instructions for agent context
+     * Returns markdown content for eligible skills
+     */
+    getSkillInstructions(skillNames) {
+        const eligible = this.getEligibleSkills();
+        // Filter by skill names if provided
+        const filtered = skillNames
+            ? eligible.filter((skill) => skillNames.includes(skill.name))
+            : eligible;
+        if (filtered.length === 0) {
+            return "";
+        }
+        const instructions = [];
+        instructions.push("# Available Skills");
+        instructions.push("");
+        instructions.push("You have access to the following skills. Use them to accomplish tasks.");
+        instructions.push("");
+        for (const skill of filtered) {
+            instructions.push(`## ${skill.metadata?.emoji || "📦"} ${skill.name}`);
+            instructions.push("");
+            instructions.push(skill.description);
+            instructions.push("");
+            instructions.push(skill.content);
+            instructions.push("");
+            instructions.push("---");
+            instructions.push("");
+        }
+        return instructions.join("\n");
+    }
+    /**
+     * Get skill summary for agent (names + descriptions only)
+     */
+    getSkillSummary() {
+        const eligible = this.getEligibleSkills();
+        if (eligible.length === 0) {
+            return "No skills available.";
+        }
+        const lines = [];
+        lines.push(`Available skills (${eligible.length}):`);
+        for (const skill of eligible) {
+            const emoji = skill.metadata?.emoji || "📦";
+            lines.push(`- ${emoji} **${skill.name}**: ${skill.description}`);
+        }
+        return lines.join("\n");
+    }
+}
+/**
+ * Create skills manager instance
+ */
+export function createSkillsManager(options) {
+    return new SkillsManager(options);
+}
+//# sourceMappingURL=manager.js.map

package/dist/skills/manager.js.map

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

package/dist/skills/status.d.ts

@@ -0,0 +1,26 @@
+/**
+ * CoStar Server Executor - Skills Status
+ * Checks skill requirements and builds status reports
+ */
+import type { SkillEntry, SkillsConfig, SkillStatus, SkillStatusEntry, SkillsStatusReport } from "./types.js";
+/**
+ * Check if a binary exists in PATH
+ */
+export declare function hasBinary(bin: string): boolean;
+/**
+ * Build skill status (check requirements, eligibility)
+ */
+export declare function buildSkillStatus(entry: SkillEntry, config?: SkillsConfig): SkillStatus;
+/**
+ * Build skill status entry for reporting
+ */
+export declare function buildSkillStatusEntry(status: SkillStatus, config?: SkillsConfig): SkillStatusEntry;
+/**
+ * Build skills status report
+ */
+export declare function buildSkillsStatusReport(skills: SkillEntry[], config: SkillsConfig | undefined, workspaceDir: string, managedSkillsDir: string | null): SkillsStatusReport;
+/**
+ * Get eligible skills (ready to use)
+ */
+export declare function getEligibleSkills(skills: SkillEntry[], config?: SkillsConfig): SkillEntry[];
+//# sourceMappingURL=status.d.ts.map

package/dist/skills/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/skills/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,UAAU,EAEV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO9C;AAsCD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,YAAY,GACpB,WAAW,CA8Eb;AAyED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,YAAY,GACpB,gBAAgB,CA0BlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,EAAE,EACpB,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,kBAAkB,CAkBpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,EAAE,CAK3F"}