agentx-sdk 0.1.0

package/dist/skills/skill-loader.d.ts

@@ -0,0 +1,49 @@
+/**
+ * File-based skill loader — scans directories for SKILL.md files.
+ *
+ * Mirrors the memory-scanner pattern: read .md files with YAML frontmatter,
+ * parse metadata, return typed AgentSkill objects.
+ *
+ * Supported directory layouts:
+ *   skillsDir/skill-name/SKILL.md     (preferred — each skill in its own folder)
+ *   skillsDir/skill-name.md           (flat — single file per skill)
+ */
+import type { AgentSkill } from '../contracts/entities/agent-skill.js';
+export interface SkillFrontmatter {
+    name?: string;
+    description?: string;
+    whenToUse?: string;
+    triggerPrefix?: string;
+    aliases?: string[];
+    argNames?: string[];
+    allowedTools?: string[];
+    model?: string;
+    context?: 'inline';
+    paths?: string[];
+    effort?: number;
+    exclusive?: boolean;
+    priority?: number;
+    modelInvocable?: boolean;
+}
+/**
+ * Parse YAML-like frontmatter from markdown content.
+ * Only handles simple key: value and key: [array] — no nested objects.
+ */
+export declare function parseSkillFrontmatter(content: string): SkillFrontmatter;
+/**
+ * Extract body content (after frontmatter).
+ */
+export declare function extractBody(content: string): string;
+/**
+ * Load a single SKILL.md file into an AgentSkill.
+ */
+export declare function loadSkillFile(filePath: string): Promise<AgentSkill | null>;
+/**
+ * Scan a directory for skill files and return AgentSkill objects.
+ *
+ * Supports two layouts:
+ *   dir/skill-name/SKILL.md   (subdirectory per skill)
+ *   dir/skill-name.md         (flat file per skill)
+ */
+export declare function scanSkillFiles(dir: string): Promise<AgentSkill[]>;
+//# sourceMappingURL=skill-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/skills/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAUvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAqDvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAMD;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAkDhF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA+BvE"}

package/dist/skills/skill-loader.js

@@ -0,0 +1,197 @@
+/**
+ * File-based skill loader — scans directories for SKILL.md files.
+ *
+ * Mirrors the memory-scanner pattern: read .md files with YAML frontmatter,
+ * parse metadata, return typed AgentSkill objects.
+ *
+ * Supported directory layouts:
+ *   skillsDir/skill-name/SKILL.md     (preferred — each skill in its own folder)
+ *   skillsDir/skill-name.md           (flat — single file per skill)
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, basename, dirname } from 'node:path';
+import { substituteArgs } from './skill-args.js';
+const SKILL_FILENAME = 'SKILL.md';
+const FRONTMATTER_MAX_LINES = 40;
+/**
+ * Parse YAML-like frontmatter from markdown content.
+ * Only handles simple key: value and key: [array] — no nested objects.
+ */
+export function parseSkillFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const yaml = match[1];
+    const result = {};
+    for (const line of yaml.split('\n').slice(0, FRONTMATTER_MAX_LINES)) {
+        const kv = line.match(/^(\w[\w-]*):\s*(.*)/);
+        if (!kv)
+            continue;
+        const key = kv[1];
+        let value = kv[2].trim();
+        // Parse inline arrays: [a, b, c]
+        if (typeof value === 'string' && value.startsWith('[') && value.endsWith(']')) {
+            value = value.slice(1, -1).split(',').map(s => s.trim().replace(/^["']|["']$/g, ''));
+        }
+        // Parse booleans
+        else if (value === 'true')
+            value = true;
+        else if (value === 'false')
+            value = false;
+        // Parse numbers
+        else if (typeof value === 'string' && /^\d+$/.test(value))
+            value = parseInt(value, 10);
+        // Unquote strings
+        else if (typeof value === 'string')
+            value = value.replace(/^["']|["']$/g, '');
+        result[key] = value;
+    }
+    // Normalize kebab-case keys to camelCase
+    const fm = {};
+    fm.name = str(result['name']);
+    fm.description = str(result['description']);
+    fm.whenToUse = str(result['whenToUse'] ?? result['when-to-use'] ?? result['when_to_use']);
+    fm.triggerPrefix = str(result['triggerPrefix'] ?? result['trigger-prefix']);
+    fm.aliases = arr(result['aliases']);
+    fm.argNames = arr(result['argNames'] ?? result['arg-names'] ?? result['arguments']);
+    fm.allowedTools = arr(result['allowedTools'] ?? result['allowed-tools']);
+    fm.model = str(result['model']);
+    fm.paths = arr(result['paths']);
+    fm.effort = typeof result['effort'] === 'number' ? result['effort'] : undefined;
+    fm.exclusive = typeof result['exclusive'] === 'boolean' ? result['exclusive'] : undefined;
+    fm.priority = typeof result['priority'] === 'number' ? result['priority'] : undefined;
+    fm.modelInvocable = typeof result['modelInvocable'] === 'boolean'
+        ? result['modelInvocable']
+        : typeof result['model-invocable'] === 'boolean'
+            ? result['model-invocable']
+            : undefined;
+    const ctx = str(result['context']);
+    if (ctx === 'inline')
+        fm.context = ctx;
+    return fm;
+}
+/**
+ * Extract body content (after frontmatter).
+ */
+export function extractBody(content) {
+    const match = content.match(/^---\s*\n[\s\S]*?\n---\s*\n?([\s\S]*)/);
+    return match?.[1]?.trim() ?? content.trim();
+}
+// ---------------------------------------------------------------------------
+// Skill file loading
+// ---------------------------------------------------------------------------
+/**
+ * Load a single SKILL.md file into an AgentSkill.
+ */
+export async function loadSkillFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const fm = parseSkillFrontmatter(content);
+        const body = extractBody(content);
+        if (!body && !fm.description)
+            return null;
+        const skillDir = dirname(filePath);
+        const fallbackName = basename(skillDir);
+        const name = fm.name || fallbackName;
+        const skill = {
+            name,
+            description: fm.description || name,
+            instructions: body,
+            source: 'directory',
+            skillDir,
+        };
+        // Apply optional frontmatter fields
+        if (fm.whenToUse)
+            skill.whenToUse = fm.whenToUse;
+        if (fm.triggerPrefix)
+            skill.triggerPrefix = fm.triggerPrefix;
+        if (fm.aliases)
+            skill.aliases = fm.aliases;
+        if (fm.argNames)
+            skill.argNames = fm.argNames;
+        if (fm.allowedTools)
+            skill.allowedTools = fm.allowedTools;
+        if (fm.model)
+            skill.model = fm.model;
+        if (fm.context)
+            skill.context = fm.context;
+        if (fm.paths)
+            skill.paths = fm.paths;
+        if (fm.effort !== undefined)
+            skill.effort = fm.effort;
+        if (fm.exclusive !== undefined)
+            skill.exclusive = fm.exclusive;
+        if (fm.priority !== undefined)
+            skill.priority = fm.priority;
+        if (fm.modelInvocable !== undefined)
+            skill.modelInvocable = fm.modelInvocable;
+        // If skill has argNames, wrap instructions in a getPrompt that does substitution
+        if (fm.argNames && fm.argNames.length > 0) {
+            const argNames = fm.argNames;
+            skill.getPrompt = (args, ctx) => {
+                return substituteArgs(body, args, argNames, {
+                    SKILL_DIR: ctx.skillDir ?? skillDir,
+                    THREAD_ID: ctx.threadId,
+                    TRACE_ID: ctx.traceId,
+                });
+            };
+        }
+        return skill;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Scan a directory for skill files and return AgentSkill objects.
+ *
+ * Supports two layouts:
+ *   dir/skill-name/SKILL.md   (subdirectory per skill)
+ *   dir/skill-name.md         (flat file per skill)
+ */
+export async function scanSkillFiles(dir) {
+    const skills = [];
+    try {
+        const entries = await readdir(dir);
+        for (const entry of entries) {
+            const entryPath = join(dir, entry);
+            try {
+                const entryStat = await stat(entryPath);
+                if (entryStat.isDirectory()) {
+                    // Subdirectory layout: skill-name/SKILL.md
+                    const skillFile = join(entryPath, SKILL_FILENAME);
+                    const skill = await loadSkillFile(skillFile);
+                    if (skill)
+                        skills.push(skill);
+                }
+                else if (entry.endsWith('.md') && entry !== 'README.md') {
+                    // Flat layout: skill-name.md
+                    const skill = await loadSkillFile(entryPath);
+                    if (skill)
+                        skills.push(skill);
+                }
+            }
+            catch {
+                // Skip entries that can't be read
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+    }
+    return skills;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function str(v) {
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+function arr(v) {
+    if (Array.isArray(v))
+        return v.filter(x => typeof x === 'string');
+    if (typeof v === 'string')
+        return v.split(/\s+/).filter(Boolean);
+    return undefined;
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/skills/skill-loader.js.map

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

package/dist/skills/skill-manager.d.ts

@@ -0,0 +1,83 @@
+import type { AgentSkill, SkillPromptContext } from '../contracts/entities/agent-skill.js';
+import type { EmbeddingService } from '../knowledge/embedding-service.js';
+export interface SkillMatchResult {
+    skill: AgentSkill;
+    matchType: 'prefix' | 'alias' | 'custom' | 'semantic' | 'sticky';
+    score: number;
+}
+/**
+ * Registers skills, matches them against user input, manages conditional
+ * activation, and provides budget-aware skill listings for model discovery.
+ *
+ * Matching hierarchy: prefix > alias > custom match() > semantic similarity.
+ */
+export declare class SkillManager {
+    /** All registered skills (unconditional — always eligible for matching) */
+    private readonly skills;
+    /** Skills with `paths` — waiting for file touch to activate */
+    private readonly conditionalSkills;
+    /** Skills activated via path matching (moved from conditionalSkills) */
+    private readonly activatedSkills;
+    /** Tracks which skills have been invoked in this session */
+    private readonly invokedSkills;
+    /** Sticky skill sessions per thread — outer key: threadId, inner key: skillName */
+    private readonly stickySessions;
+    private readonly embeddingService?;
+    private readonly maxActiveSkills;
+    constructor(options?: {
+        embeddingService?: EmbeddingService;
+        maxActiveSkills?: number;
+    });
+    register(skill: AgentSkill): void;
+    unregister(name: string): boolean;
+    /** All skills (unconditional + activated conditional) */
+    listSkills(): AgentSkill[];
+    /** All skills including pending conditional ones */
+    listAllSkills(): AgentSkill[];
+    /**
+     * Load skills from a directory containing SKILL.md files.
+     * Returns the number of skills loaded.
+     */
+    loadFromDirectory(dir: string): Promise<number>;
+    /**
+     * Activate conditional skills whose `paths` match any of the given file paths.
+     * Returns the names of newly activated skills.
+     */
+    activateForPaths(filePaths: string[]): string[];
+    /**
+     * Matches skills against input. Returns top skills sorted by priority.
+     */
+    match(input: string, context: {
+        threadId: string;
+    }): Promise<AgentSkill[]>;
+    /**
+     * Resolve the final instructions for a matched skill.
+     * If `getPrompt` exists, calls it with args and context.
+     * Otherwise uses static `instructions` with argument substitution.
+     */
+    resolveInstructions(skill: AgentSkill, args: string, context: SkillPromptContext): Promise<string>;
+    /**
+     * Build a formatted listing of available skills for model context.
+     * Truncates to fit within the given character budget.
+     */
+    buildSkillListing(budgetChars: number): string;
+    markInvoked(name: string): void;
+    getInvokedSkills(): string[];
+    /** Remove a single sticky skill from a thread */
+    clearStickySkill(threadId: string, skillName: string): void;
+    /** Remove all sticky skills for a thread (e.g. on clearHistory) */
+    clearStickySkills(threadId: string): void;
+    /** Remove all sticky sessions across all threads (e.g. on destroy) */
+    clearAllStickySessions(): void;
+    private activateStickySession;
+    private decrementStickySessions;
+    /** Get all skills eligible for matching (unconditional + activated) */
+    private getEligibleSkills;
+    /**
+     * Returns true if any eligible skill lacks both triggerPrefix, aliases, and match(),
+     * meaning it can only be activated via semantic matching.
+     */
+    private hasSkillsNeedingSemantic;
+    private semanticMatch;
+}
+//# sourceMappingURL=skill-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/skills/skill-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAK1E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE,KAAK,EAAE,MAAM,CAAC;CACf;AAWD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IACnE,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACjE,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiD;IAEhF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE;IASvF,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMjC,yDAAyD;IACzD,UAAU,IAAI,UAAU,EAAE;IAI1B,oDAAoD;IACpD,aAAa,IAAI,UAAU,EAAE;IAY7B;;;OAGG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYrD;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAoB/C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA+FhF;;;;OAIG;IACG,mBAAmB,CACvB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC;IAqBlB;;;OAGG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAoC9C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,gBAAgB,IAAI,MAAM,EAAE;IAQ5B,iDAAiD;IACjD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3D,mEAAmE;IACnE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIzC,sEAAsE;IACtE,sBAAsB,IAAI,IAAI;IAQ9B,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,uBAAuB;IAU/B,uEAAuE;IACvE,OAAO,CAAC,iBAAiB;IAazB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;YAIlB,aAAa;CA0B5B"}