agentx-sdk 0.1.0

package/dist/memory/memory-scanner.js

@@ -0,0 +1,99 @@
+/**
+ * Memory directory scanning — reads .md files, parses frontmatter,
+ * returns headers sorted by mtime (newest first), capped at MAX_MEMORY_FILES.
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { parseMemoryType, ENTRYPOINT_NAME, MAX_MEMORY_FILES, } from './memory-types.js';
+const FRONTMATTER_MAX_LINES = 30;
+/**
+ * Parse YAML frontmatter from markdown content.
+ * Handles name, description, type fields. Robust against special
+ * characters in values (colons, braces, globs, etc).
+ */
+export function parseFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match?.[1])
+        return {};
+    const yaml = match[1];
+    const result = {};
+    for (const line of yaml.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        if (key !== 'name' && key !== 'description' && key !== 'type')
+            continue;
+        let value = line.slice(colonIdx + 1).trim();
+        // Strip matching quotes (single or double)
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        // Handle YAML special characters that may have been escaped
+        value = value.replace(/\\"/g, '"').replace(/\\'/g, "'");
+        if (key === 'name')
+            result.name = value;
+        if (key === 'description')
+            result.description = value;
+        if (key === 'type')
+            result.type = value;
+    }
+    return result;
+}
+/**
+ * Scan a memory directory for .md files, read their frontmatter, and return
+ * a header list sorted newest-first (capped at MAX_MEMORY_FILES).
+ */
+export async function scanMemoryFiles(memoryDir, signal) {
+    try {
+        const entries = await readdir(memoryDir, { recursive: true });
+        const mdFiles = entries.filter(f => f.endsWith('.md')
+            && basename(f) !== ENTRYPOINT_NAME
+            && !f.startsWith('threads/') && !f.startsWith('threads\\'));
+        const headerResults = await Promise.allSettled(mdFiles.map(async (relativePath) => {
+            if (signal?.aborted)
+                throw new Error('Aborted');
+            const filePath = join(memoryDir, relativePath);
+            const [fileContent, fileStat] = await Promise.all([
+                readFile(filePath, 'utf-8'),
+                stat(filePath),
+            ]);
+            // Only parse first N lines for frontmatter
+            const lines = fileContent.split('\n').slice(0, FRONTMATTER_MAX_LINES);
+            const frontmatter = parseFrontmatter(lines.join('\n'));
+            return {
+                filename: relativePath,
+                filePath,
+                mtimeMs: fileStat.mtimeMs,
+                name: frontmatter.name ?? null,
+                description: frontmatter.description ?? null,
+                type: parseMemoryType(frontmatter.type),
+            };
+        }));
+        return headerResults
+            .filter((r) => r.status === 'fulfilled')
+            .map(r => r.value)
+            .sort((a, b) => b.mtimeMs - a.mtimeMs)
+            .slice(0, MAX_MEMORY_FILES);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Format memory headers as a text manifest: one line per file with
+ * [type] filename (timestamp): description.
+ */
+export function formatMemoryManifest(memories) {
+    return memories
+        .map(m => {
+        const tag = m.type ? `[${m.type}] ` : '';
+        const ts = new Date(m.mtimeMs).toISOString();
+        return m.description
+            ? `- ${tag}${m.filename} (${ts}): ${m.description}`
+            : `- ${tag}${m.filename} (${ts})`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=memory-scanner.js.map

package/dist/memory/memory-scanner.js.map

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

package/dist/memory/memory-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Memory tools for the forked extraction agent.
+ *
+ * These tools give the extraction subagent the ability to read, write,
+ * edit, and delete memory files — just like old_src's forked agent had
+ * FileRead/FileEdit/FileWrite restricted to the memory directory.
+ *
+ * All tools are path-constrained: they only operate within the resolved
+ * memory directory (global or thread-scoped).
+ */
+import type { AgentTool } from '../contracts/entities/agent-tool.js';
+/**
+ * Create memory tools scoped to a specific directory (global or thread).
+ */
+export declare function createMemoryTools(memoryDir: string, threadId?: string): AgentTool[];
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/memory/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../src/memory/memory-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AA4BrE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAyInF"}

package/dist/memory/memory-tools.js

@@ -0,0 +1,196 @@
+/**
+ * Memory tools for the forked extraction agent.
+ *
+ * These tools give the extraction subagent the ability to read, write,
+ * edit, and delete memory files — just like old_src's forked agent had
+ * FileRead/FileEdit/FileWrite restricted to the memory directory.
+ *
+ * All tools are path-constrained: they only operate within the resolved
+ * memory directory (global or thread-scoped).
+ */
+import { z } from 'zod';
+import { readFile, writeFile, unlink } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { ENTRYPOINT_NAME } from './memory-types.js';
+import { scanMemoryFiles, formatMemoryManifest, parseFrontmatter } from './memory-scanner.js';
+import { sanitizeFilename } from './memory-paths.js';
+const THREADS_DIR = 'threads';
+/**
+ * Resolve the effective directory for memory operations.
+ */
+function resolveDir(memoryDir, threadId) {
+    if (!threadId)
+        return memoryDir;
+    return join(memoryDir, THREADS_DIR, threadId);
+}
+/**
+ * Validate a filename: must be .md, not MEMORY.md, no path traversal.
+ */
+function validateFilename(filename) {
+    if (!filename || filename.includes('\0'))
+        return 'Invalid filename';
+    if (filename.includes('/') || filename.includes('\\') || filename.includes('..')) {
+        return 'Path traversal not allowed';
+    }
+    if (basename(filename) === ENTRYPOINT_NAME)
+        return 'Cannot access MEMORY.md directly — it is managed automatically';
+    if (!filename.endsWith('.md'))
+        return 'Filename must end with .md';
+    return null;
+}
+/**
+ * Create memory tools scoped to a specific directory (global or thread).
+ */
+export function createMemoryTools(memoryDir, threadId) {
+    const dir = resolveDir(memoryDir, threadId);
+    const memoryList = {
+        name: 'memory_list',
+        description: 'List all existing memory files with their name, type, description, and last modified date. Use this FIRST to see what memories already exist before creating new ones.',
+        parameters: z.object({}),
+        isConcurrencySafe: true,
+        isReadOnly: true,
+        execute: async () => {
+            const memories = await scanMemoryFiles(dir);
+            if (memories.length === 0)
+                return 'No memory files found.';
+            return formatMemoryManifest(memories);
+        },
+    };
+    const memoryRead = {
+        name: 'memory_read',
+        description: 'Read the full content of a memory file by filename. Use this to check existing memory content before deciding to update or skip.',
+        parameters: z.object({
+            filename: z.string().describe('The filename to read (e.g. "user-role.md")'),
+        }),
+        isConcurrencySafe: true,
+        isReadOnly: true,
+        execute: async (rawArgs) => {
+            const { filename } = rawArgs;
+            const err = validateFilename(filename);
+            if (err)
+                return { content: err, isError: true };
+            try {
+                const content = await readFile(join(dir, filename), 'utf-8');
+                return content;
+            }
+            catch {
+                return { content: `File not found: ${filename}`, isError: true };
+            }
+        },
+    };
+    const memoryWrite = {
+        name: 'memory_write',
+        description: 'Create a NEW memory file. Only use this when no existing memory covers this topic — otherwise use memory_edit to update the existing file.',
+        parameters: z.object({
+            name: z.string().describe('Short name for the memory (2-4 words)'),
+            description: z.string().describe('One-line description for indexing'),
+            type: z.enum(['user', 'feedback', 'project', 'reference']).describe('Memory type'),
+            content: z.string().describe('The memory content (markdown)'),
+        }),
+        execute: async (rawArgs) => {
+            const args = rawArgs;
+            const filename = sanitizeFilename(args.name);
+            const fileContent = [
+                '---',
+                `name: ${args.name}`,
+                `description: ${args.description}`,
+                `type: ${args.type}`,
+                '---',
+                '',
+                args.content,
+                '',
+            ].join('\n');
+            await writeFile(join(dir, filename), fileContent, 'utf-8');
+            await addToIndex(dir, filename, args.description);
+            return `Memory saved: ${filename}`;
+        },
+    };
+    const memoryEdit = {
+        name: 'memory_edit',
+        description: 'Update an existing memory file. Preserves the filename and type. Use this instead of memory_write when the memory already exists.',
+        parameters: z.object({
+            filename: z.string().describe('The filename to edit (e.g. "user-role.md")'),
+            content: z.string().describe('The new content (replaces existing body)'),
+            name: z.string().optional().describe('Updated name (optional)'),
+            description: z.string().optional().describe('Updated description (optional)'),
+        }),
+        execute: async (rawArgs) => {
+            const args = rawArgs;
+            const err = validateFilename(args.filename);
+            if (err)
+                return { content: err, isError: true };
+            const filePath = join(dir, args.filename);
+            // Read existing to preserve frontmatter fields
+            let existingContent;
+            try {
+                existingContent = await readFile(filePath, 'utf-8');
+            }
+            catch {
+                return { content: `File not found: ${args.filename}`, isError: true };
+            }
+            const frontmatter = parseFrontmatter(existingContent);
+            const name = args.name ?? frontmatter.name ?? args.filename.replace('.md', '');
+            const description = args.description ?? frontmatter.description ?? '';
+            const type = frontmatter.type ?? 'user';
+            const fileContent = [
+                '---',
+                `name: ${name}`,
+                `description: ${description}`,
+                `type: ${type}`,
+                '---',
+                '',
+                args.content,
+                '',
+            ].join('\n');
+            await writeFile(filePath, fileContent, 'utf-8');
+            return `Memory updated: ${args.filename}`;
+        },
+    };
+    const memoryDelete = {
+        name: 'memory_delete',
+        description: 'Delete a memory file and remove it from the index. Use when a memory is outdated or wrong.',
+        parameters: z.object({
+            filename: z.string().describe('The filename to delete (e.g. "old-info.md")'),
+        }),
+        isDestructive: true,
+        execute: async (rawArgs) => {
+            const { filename } = rawArgs;
+            const err = validateFilename(filename);
+            if (err)
+                return { content: err, isError: true };
+            try {
+                await unlink(join(dir, filename));
+            }
+            catch {
+                return { content: `File not found: ${filename}`, isError: true };
+            }
+            await removeFromIndex(dir, filename);
+            return `Memory deleted: ${filename}`;
+        },
+    };
+    return [memoryList, memoryRead, memoryWrite, memoryEdit, memoryDelete];
+}
+// --- Index helpers (mirror FileMemorySystem's private methods) ---
+async function addToIndex(dir, filename, description) {
+    const entrypoint = join(dir, ENTRYPOINT_NAME);
+    let existing = '';
+    try {
+        existing = await readFile(entrypoint, 'utf-8');
+    }
+    catch { /* File doesn't exist yet */ }
+    if (existing.includes(`(${filename})`))
+        return;
+    const newEntry = `- [${description}](${filename}) — ${description}`;
+    const updated = existing ? `${existing.trimEnd()}\n${newEntry}\n` : `${newEntry}\n`;
+    await writeFile(entrypoint, updated, 'utf-8');
+}
+async function removeFromIndex(dir, filename) {
+    const entrypoint = join(dir, ENTRYPOINT_NAME);
+    try {
+        const content = await readFile(entrypoint, 'utf-8');
+        const lines = content.split('\n').filter(line => !line.includes(`(${filename})`));
+        await writeFile(entrypoint, lines.join('\n'), 'utf-8');
+    }
+    catch { /* Index doesn't exist */ }
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/memory/memory-tools.js.map

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

package/dist/memory/memory-types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Memory type taxonomy — file-based memory system.
+ *
+ * Memories are constrained to four types capturing context NOT derivable
+ * from the current project state. Code patterns, architecture, git history,
+ * and file structure are derivable (via grep/git) and should NOT be saved.
+ */
+export declare const MEMORY_TYPES: readonly ["user", "feedback", "project", "reference"];
+export type MemoryType = (typeof MEMORY_TYPES)[number];
+/**
+ * Parse a raw frontmatter value into a MemoryType.
+ * Invalid or missing values return undefined — legacy files without a
+ * `type:` field keep working, files with unknown types degrade gracefully.
+ */
+export declare function parseMemoryType(raw: unknown): MemoryType | undefined;
+/** Header from scanning a memory file (frontmatter only, no body) */
+export interface MemoryHeader {
+    filename: string;
+    filePath: string;
+    mtimeMs: number;
+    name: string | null;
+    description: string | null;
+    type: MemoryType | undefined;
+}
+/** Full memory file including body content */
+export interface MemoryFile extends MemoryHeader {
+    content: string;
+}
+/** Frontmatter fields for a memory file */
+export interface MemoryFrontmatter {
+    name?: string;
+    description?: string;
+    type?: string;
+}
+/** Input for saving a new memory */
+export interface SaveMemoryInput {
+    name: string;
+    description: string;
+    type: MemoryType;
+    content: string;
+}
+/** Constants */
+export declare const ENTRYPOINT_NAME = "MEMORY.md";
+export declare const MAX_MEMORY_FILES = 200;
+export declare const MAX_ENTRYPOINT_LINES = 200;
+export declare const MAX_ENTRYPOINT_BYTES = 25000;
+//# sourceMappingURL=memory-types.d.ts.map

package/dist/memory/memory-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.d.ts","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,uDAAwD,CAAC;AAElF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAGpE;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9B;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gBAAgB;AAChB,eAAO,MAAM,eAAe,cAAc,CAAC;AAC3C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,QAAS,CAAC"}

package/dist/memory/memory-types.js

@@ -0,0 +1,24 @@
+/**
+ * Memory type taxonomy — file-based memory system.
+ *
+ * Memories are constrained to four types capturing context NOT derivable
+ * from the current project state. Code patterns, architecture, git history,
+ * and file structure are derivable (via grep/git) and should NOT be saved.
+ */
+export const MEMORY_TYPES = ['user', 'feedback', 'project', 'reference'];
+/**
+ * Parse a raw frontmatter value into a MemoryType.
+ * Invalid or missing values return undefined — legacy files without a
+ * `type:` field keep working, files with unknown types degrade gracefully.
+ */
+export function parseMemoryType(raw) {
+    if (typeof raw !== 'string')
+        return undefined;
+    return MEMORY_TYPES.find(t => t === raw);
+}
+/** Constants */
+export const ENTRYPOINT_NAME = 'MEMORY.md';
+export const MAX_MEMORY_FILES = 200;
+export const MAX_ENTRYPOINT_LINES = 200;
+export const MAX_ENTRYPOINT_BYTES = 25_000;
+//# sourceMappingURL=memory-types.js.map

package/dist/memory/memory-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.js","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAU,CAAC;AAIlF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AAC3C,CAAC;AAgCD,gBAAgB;AAChB,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Argument substitution engine for skill prompts.
+ *
+ * Supports:
+ * - $argName → positional argument value (based on argNames array)
+ * - ${VARIABLE} → variable from the variables map
+ * - Unmatched placeholders are left as-is (no silent removal)
+ */
+/**
+ * Split raw argument string into positional tokens.
+ * Respects quoted strings (single and double quotes).
+ */
+export declare function splitArgs(raw: string): string[];
+/**
+ * Substitute argument placeholders in skill content.
+ *
+ * @param content  — the skill prompt template
+ * @param rawArgs  — raw argument string from user (e.g. "file.ts production")
+ * @param argNames — named placeholders (e.g. ["file", "env"])
+ * @param variables — additional variables (e.g. { SKILL_DIR: "/path", THREAD_ID: "t1" })
+ */
+export declare function substituteArgs(content: string, rawArgs: string, argNames?: string[], variables?: Record<string, string>): string;
+//# sourceMappingURL=skill-args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-args.d.ts","sourceRoot":"","sources":["../../src/skills/skill-args.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB/C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,MAAM,CA0BR"}

package/dist/skills/skill-args.js

@@ -0,0 +1,77 @@
+/**
+ * Argument substitution engine for skill prompts.
+ *
+ * Supports:
+ * - $argName → positional argument value (based on argNames array)
+ * - ${VARIABLE} → variable from the variables map
+ * - Unmatched placeholders are left as-is (no silent removal)
+ */
+/**
+ * Split raw argument string into positional tokens.
+ * Respects quoted strings (single and double quotes).
+ */
+export function splitArgs(raw) {
+    const tokens = [];
+    let current = '';
+    let inQuote = null;
+    for (const ch of raw) {
+        if (inQuote) {
+            if (ch === inQuote) {
+                inQuote = null;
+            }
+            else {
+                current += ch;
+            }
+        }
+        else if (ch === '"' || ch === "'") {
+            inQuote = ch;
+        }
+        else if (ch === ' ' || ch === '\t') {
+            if (current) {
+                tokens.push(current);
+                current = '';
+            }
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current)
+        tokens.push(current);
+    return tokens;
+}
+/**
+ * Substitute argument placeholders in skill content.
+ *
+ * @param content  — the skill prompt template
+ * @param rawArgs  — raw argument string from user (e.g. "file.ts production")
+ * @param argNames — named placeholders (e.g. ["file", "env"])
+ * @param variables — additional variables (e.g. { SKILL_DIR: "/path", THREAD_ID: "t1" })
+ */
+export function substituteArgs(content, rawArgs, argNames, variables) {
+    let result = content;
+    // 1. Named positional arguments: $argName
+    if (argNames && argNames.length > 0) {
+        const tokens = splitArgs(rawArgs);
+        for (let i = 0; i < argNames.length; i++) {
+            const name = argNames[i];
+            const value = tokens[i] ?? '';
+            // Replace $argName (word boundary aware — don't replace $argNameExtra)
+            result = result.replace(new RegExp(`\\$${name}(?![a-zA-Z0-9_])`, 'g'), value);
+        }
+        // Also make remaining args available as $ARGS (everything after named args)
+        const remaining = tokens.slice(argNames.length).join(' ');
+        result = result.replace(/\$ARGS(?![a-zA-Z0-9_])/g, remaining);
+    }
+    // 2. Variable substitution: ${VARIABLE}
+    if (variables) {
+        for (const [key, value] of Object.entries(variables)) {
+            result = result.replace(new RegExp(`\\$\\{${escapeRegex(key)}\\}`, 'g'), value);
+        }
+    }
+    return result;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=skill-args.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-args.js","sourceRoot":"","sources":["../../src/skills/skill-args.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO,GAAkB,IAAI,CAAC;IAElC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;gBACnB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACpC,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,OAAe,EACf,QAAmB,EACnB,SAAkC;IAElC,IAAI,MAAM,GAAG,OAAO,CAAC;IAErB,0CAA0C;IAC1C,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9B,uEAAuE;YACvE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,kBAAkB,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAChF,CAAC;QAED,4EAA4E;QAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IAED,wCAAwC;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,SAAS,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Minimal glob matcher — supports *, **, and ? patterns.
+ * No external dependencies. Converts globs to regex internally.
+ */
+/**
+ * Convert a glob pattern to a RegExp.
+ *
+ * Supported syntax:
+ * - `*`   matches any characters except `/`
+ * - `**`  matches any characters including `/` (recursive)
+ * - `?`   matches exactly one character except `/`
+ * - All other characters are escaped for literal matching.
+ */
+export declare function globToRegex(pattern: string): RegExp;
+/**
+ * Test if a file path matches a glob pattern.
+ * Both pattern and path use forward slashes.
+ */
+export declare function matchGlob(pattern: string, filePath: string): boolean;
+/**
+ * Test if a file path matches any of the given glob patterns.
+ */
+export declare function matchAnyGlob(patterns: string[], filePath: string): boolean;
+//# sourceMappingURL=skill-glob.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-glob.d.ts","sourceRoot":"","sources":["../../src/skills/skill-glob.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA8BnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/skills/skill-glob.js

@@ -0,0 +1,60 @@
+/**
+ * Minimal glob matcher — supports *, **, and ? patterns.
+ * No external dependencies. Converts globs to regex internally.
+ */
+/**
+ * Convert a glob pattern to a RegExp.
+ *
+ * Supported syntax:
+ * - `*`   matches any characters except `/`
+ * - `**`  matches any characters including `/` (recursive)
+ * - `?`   matches exactly one character except `/`
+ * - All other characters are escaped for literal matching.
+ */
+export function globToRegex(pattern) {
+    let regex = '';
+    let i = 0;
+    while (i < pattern.length) {
+        const ch = pattern[i];
+        if (ch === '*') {
+            if (pattern[i + 1] === '*') {
+                // ** — match anything including path separators
+                // Skip optional trailing /
+                i += 2;
+                if (pattern[i] === '/')
+                    i++;
+                regex += '.*';
+            }
+            else {
+                // * — match anything except /
+                regex += '[^/]*';
+                i++;
+            }
+        }
+        else if (ch === '?') {
+            regex += '[^/]';
+            i++;
+        }
+        else {
+            // Escape regex special characters
+            regex += ch.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+            i++;
+        }
+    }
+    return new RegExp(`^${regex}$`);
+}
+/**
+ * Test if a file path matches a glob pattern.
+ * Both pattern and path use forward slashes.
+ */
+export function matchGlob(pattern, filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    return globToRegex(pattern).test(normalized);
+}
+/**
+ * Test if a file path matches any of the given glob patterns.
+ */
+export function matchAnyGlob(patterns, filePath) {
+    return patterns.some(p => matchGlob(p, filePath));
+}
+//# sourceMappingURL=skill-glob.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-glob.js","sourceRoot":"","sources":["../../src/skills/skill-glob.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAEvB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,gDAAgD;gBAChD,2BAA2B;gBAC3B,CAAC,IAAI,CAAC,CAAC;gBACP,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;oBAAE,CAAC,EAAE,CAAC;gBAC5B,KAAK,IAAI,IAAI,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,KAAK,IAAI,OAAO,CAAC;gBACjB,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,IAAI,MAAM,CAAC;YAChB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,CAAC;YACN,kCAAkC;YAClC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,QAAgB;IACzD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,QAAgB;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC"}