@kooka/agent-sdk 0.1.0

package/dist/llm/openaiCompatible.js

@@ -0,0 +1,91 @@
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { Agent, fetch as undiciFetch } from 'undici';
+import { combineAbortSignals } from '../abort.js';
+function normalizeBaseURL(input) {
+    return input.replace(/\/+$/, '');
+}
+function toHeaderRecord(initHeaders) {
+    const headers = {};
+    if (!initHeaders)
+        return headers;
+    if (Array.isArray(initHeaders)) {
+        for (const [k, v] of initHeaders)
+            headers[String(k)] = String(v);
+        return headers;
+    }
+    if (initHeaders instanceof Headers) {
+        for (const [k, v] of initHeaders.entries())
+            headers[k] = v;
+        return headers;
+    }
+    if (typeof initHeaders === 'object') {
+        Object.assign(headers, initHeaders);
+    }
+    return headers;
+}
+function createFetchWithStreamingDefaults(timeoutMs) {
+    const timeoutValue = typeof timeoutMs === 'number' && Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : 0;
+    const dispatcher = new Agent({ bodyTimeout: 0 });
+    const fetchFn = (input, init) => {
+        const headers = {};
+        Object.assign(headers, toHeaderRecord(init?.headers));
+        // Some OpenAI-compatible servers misbehave with compressed SSE streams.
+        if (!('accept-encoding' in headers) && !('Accept-Encoding' in headers)) {
+            headers['accept-encoding'] = 'identity';
+        }
+        const signals = [];
+        if (init?.signal)
+            signals.push(init.signal);
+        if (timeoutValue > 0) {
+            const timeoutFn = AbortSignal?.timeout;
+            if (typeof timeoutFn === 'function') {
+                signals.push(timeoutFn(timeoutValue));
+            }
+        }
+        const signal = signals.length > 0 ? combineAbortSignals(signals) : undefined;
+        return undiciFetch(input, { ...init, dispatcher, headers, signal });
+    };
+    return { fetch: fetchFn, dispose: () => dispatcher.close() };
+}
+export class OpenAICompatibleProvider {
+    id = 'openaiCompatible';
+    name;
+    baseURL;
+    apiKey;
+    defaultModelId;
+    timeoutMs;
+    provider;
+    fetchFn;
+    disposeFetch;
+    constructor(options) {
+        if (!options.baseURL?.trim()) {
+            throw new Error('OpenAICompatibleProvider requires baseURL');
+        }
+        this.baseURL = normalizeBaseURL(options.baseURL);
+        this.apiKey = options.apiKey;
+        this.defaultModelId = options.defaultModelId;
+        this.timeoutMs = options.timeoutMs;
+        this.name = options.name || 'OpenAI-Compatible';
+        const fetchWithDefaults = createFetchWithStreamingDefaults(this.timeoutMs);
+        this.fetchFn = fetchWithDefaults.fetch;
+        this.disposeFetch = fetchWithDefaults.dispose;
+        this.provider = createOpenAICompatible({
+            name: this.name,
+            baseURL: this.baseURL,
+            apiKey: this.apiKey,
+            fetch: this.fetchFn,
+            includeUsage: true,
+        });
+    }
+    async getModel(modelId) {
+        const resolved = modelId || this.defaultModelId;
+        if (!resolved) {
+            throw new Error('No model configured. Provide modelId (or defaultModelId).');
+        }
+        return this.provider.chatModel(resolved);
+    }
+    dispose() {
+        this.disposeFetch();
+    }
+}
+//# sourceMappingURL=openaiCompatible.js.map

package/dist/llm/openaiCompatible.js.map

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

package/dist/plugins/pluginManager.d.ts

@@ -0,0 +1,22 @@
+import type { LingyunHookName, LingyunHooks, LingyunPluginToolEntry } from './types.js';
+export declare class PluginManager {
+    private readonly options;
+    private loadedKey;
+    private loadedHooks;
+    private extraHooks;
+    private pluginTools;
+    constructor(options?: {
+        plugins?: string[];
+        autoDiscover?: boolean;
+        workspaceDirName?: string;
+        workspaceRoot?: string;
+        logger?: (message: string) => void;
+    });
+    registerHooks(id: string, hooks: LingyunHooks): {
+        dispose: () => void;
+    };
+    private loadPluginsIfNeeded;
+    getPluginTools(): Promise<LingyunPluginToolEntry[]>;
+    trigger<Name extends LingyunHookName, Output>(name: Name, input: unknown, output: Output): Promise<Output>;
+}
+//# sourceMappingURL=pluginManager.d.ts.map

package/dist/plugins/pluginManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginManager.d.ts","sourceRoot":"","sources":["../../src/plugins/pluginManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAA4C,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAmGlI,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,WAAW,CAAgC;gBAGhC,OAAO,GAAE;QACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAC/B;IAGR,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE;YAWzD,mBAAmB;IA4C3B,cAAc,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAKnD,OAAO,CAAC,IAAI,SAAS,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAejH"}

package/dist/plugins/pluginManager.js

@@ -0,0 +1,171 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { pathToFileURL } from 'url';
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function uniqueStrings(items) {
+    const out = [];
+    const seen = new Set();
+    for (const item of items) {
+        const v = String(item || '').trim();
+        if (!v || seen.has(v))
+            continue;
+        seen.add(v);
+        out.push(v);
+    }
+    return out;
+}
+async function exists(p) {
+    try {
+        await fs.stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function listPluginFiles(dir) {
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        return entries
+            .filter((ent) => ent.isFile())
+            .map((ent) => ent.name)
+            .filter((name) => /\.(cjs|mjs|js)$/i.test(name))
+            .map((name) => path.join(dir, name));
+    }
+    catch {
+        return [];
+    }
+}
+async function resolveWorkspacePluginPaths(params) {
+    if (!params.enabled)
+        return [];
+    if (!params.workspaceRoot)
+        return [];
+    const pluginDir = path.join(params.workspaceRoot, params.workspaceDirName, 'plugin');
+    if (!(await exists(pluginDir)))
+        return [];
+    return uniqueStrings(await listPluginFiles(pluginDir));
+}
+async function importPluginModule(spec, workspaceRoot) {
+    const trimmed = String(spec || '').trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith('file://')) {
+        return import(trimmed);
+    }
+    const looksPath = trimmed.startsWith('.') || trimmed.startsWith('/') || trimmed.includes(path.sep);
+    if (looksPath) {
+        const resolvedPath = path.resolve(workspaceRoot || process.cwd(), trimmed);
+        return import(pathToFileURL(resolvedPath).href);
+    }
+    // treat as module specifier resolvable by Node
+    return import(trimmed);
+}
+function extractHooksFromModule(moduleExports, input) {
+    if (!moduleExports)
+        return [];
+    const out = [];
+    const seen = new Set();
+    const entries = Object.entries(moduleExports);
+    for (const [name, value] of entries) {
+        if (seen.has(value))
+            continue;
+        if (typeof value === 'function') {
+            seen.add(value);
+            out.push({ id: name, hooks: value(input) });
+            continue;
+        }
+        if (isRecord(value)) {
+            seen.add(value);
+            out.push({ id: name, hooks: value });
+        }
+    }
+    if (entries.length === 0 && typeof moduleExports === 'function') {
+        out.push({ id: 'default', hooks: moduleExports(input) });
+    }
+    return out;
+}
+export class PluginManager {
+    options;
+    loadedKey = '';
+    loadedHooks = [];
+    extraHooks = [];
+    pluginTools = [];
+    constructor(options = {}) {
+        this.options = options;
+    }
+    registerHooks(id, hooks) {
+        const entry = { id, hooks };
+        this.extraHooks.push(entry);
+        return {
+            dispose: () => {
+                const idx = this.extraHooks.indexOf(entry);
+                if (idx >= 0)
+                    this.extraHooks.splice(idx, 1);
+            },
+        };
+    }
+    async loadPluginsIfNeeded() {
+        const plugins = this.options.plugins ?? [];
+        const autoDiscover = this.options.autoDiscover ?? false;
+        const workspaceDirName = this.options.workspaceDirName ?? '.lingyun';
+        const workspaceRoot = this.options.workspaceRoot;
+        const discovered = await resolveWorkspacePluginPaths({ enabled: autoDiscover, workspaceDirName, workspaceRoot });
+        const combined = uniqueStrings([...(plugins || []), ...discovered]);
+        const key = JSON.stringify({ combined, workspaceRoot: workspaceRoot || '' });
+        if (key === this.loadedKey)
+            return;
+        this.loadedKey = key;
+        this.loadedHooks = [];
+        this.pluginTools = [];
+        const input = {
+            workspaceRoot,
+        };
+        for (const spec of combined) {
+            try {
+                const module = await importPluginModule(spec, workspaceRoot);
+                const extracted = extractHooksFromModule(module, input);
+                for (const entry of extracted) {
+                    const hooks = await Promise.resolve(entry.hooks);
+                    if (!hooks)
+                        continue;
+                    const pluginId = `${spec}#${entry.id}`;
+                    this.loadedHooks.push({ id: pluginId, hooks });
+                    if (hooks.tool && isRecord(hooks.tool)) {
+                        for (const [toolId, tool] of Object.entries(hooks.tool)) {
+                            if (!toolId || !tool)
+                                continue;
+                            this.pluginTools.push({ pluginId, toolId, tool: tool });
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                this.options.logger?.(`LingYun SDK: Failed to load plugin ${spec}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    async getPluginTools() {
+        await this.loadPluginsIfNeeded();
+        return [...this.pluginTools];
+    }
+    async trigger(name, input, output) {
+        await this.loadPluginsIfNeeded();
+        const all = [...this.extraHooks, ...this.loadedHooks];
+        for (const entry of all) {
+            const fn = entry.hooks?.[name];
+            if (typeof fn !== 'function')
+                continue;
+            try {
+                await fn(input, output);
+            }
+            catch (error) {
+                this.options.logger?.(`LingYun SDK: plugin hook error ${entry.id}.${name}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return output;
+    }
+}
+//# sourceMappingURL=pluginManager.js.map

package/dist/plugins/pluginManager.js.map

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,97 @@
+import type { ToolContext, ToolDefinition, ToolResult } from '../types.js';
+export type LingyunHookName = 'experimental.chat.system.transform' | 'experimental.chat.complete' | 'chat.params' | 'experimental.chat.messages.transform' | 'permission.ask' | 'tool.execute.before' | 'tool.execute.after' | 'experimental.session.compacting' | 'experimental.text.complete';
+export type LingyunPluginInput = {
+    workspaceRoot?: string;
+    gitRoot?: string;
+    projectId?: string;
+    storagePath?: string;
+};
+export type LingyunPluginTool = {
+    name?: string;
+    description: string;
+    parameters: ToolDefinition['parameters'];
+    metadata?: ToolDefinition['metadata'];
+    execute: (args: Record<string, unknown>, context: ToolContext) => Promise<ToolResult | unknown>;
+};
+export type HookPermissionAskInput = {
+    tool: string;
+    sessionId?: string;
+    callId?: string;
+    message?: string;
+    patterns?: string[];
+    metadata?: Record<string, unknown>;
+};
+export type LingyunHooks = {
+    tool?: Record<string, LingyunPluginTool>;
+    'experimental.chat.system.transform'?: (input: {
+        sessionId?: string;
+        mode?: 'plan' | 'build';
+        modelId?: string;
+    }, output: {
+        system: string[];
+    }) => void | Promise<void>;
+    'experimental.chat.complete'?: (input: {
+        sessionId?: string;
+        mode?: 'plan' | 'build';
+        modelId?: string;
+        messageId: string;
+        assistantText: string;
+        returnedText: string;
+    }, output: Record<string, never>) => void | Promise<void>;
+    'chat.params'?: (input: {
+        sessionId?: string;
+        mode?: 'plan' | 'build';
+        modelId?: string;
+        message?: string;
+    }, output: {
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        options?: Record<string, unknown>;
+    }) => void | Promise<void>;
+    'experimental.chat.messages.transform'?: (input: {
+        sessionId?: string;
+        mode?: 'plan' | 'build';
+        modelId?: string;
+    }, output: {
+        messages: unknown[];
+    }) => void | Promise<void>;
+    'permission.ask'?: (input: HookPermissionAskInput, output: {
+        status: 'ask' | 'deny' | 'allow';
+    }) => void | Promise<void>;
+    'tool.execute.before'?: (input: {
+        tool: string;
+        sessionId?: string;
+        callId: string;
+    }, output: {
+        args: unknown;
+    }) => void | Promise<void>;
+    'tool.execute.after'?: (input: {
+        tool: string;
+        sessionId?: string;
+        callId: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: Record<string, unknown>;
+    }) => void | Promise<void>;
+    'experimental.session.compacting'?: (input: {
+        sessionId?: string;
+    }, output: {
+        context: string[];
+        prompt?: string;
+    }) => void | Promise<void>;
+    'experimental.text.complete'?: (input: {
+        sessionId?: string;
+        messageId: string;
+    }, output: {
+        text: string;
+    }) => void | Promise<void>;
+};
+export type LingyunPluginFactory = (input: LingyunPluginInput) => LingyunHooks | Promise<LingyunHooks>;
+export type LingyunPluginToolEntry = {
+    pluginId: string;
+    toolId: string;
+    tool: LingyunPluginTool;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/plugins/types.js

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

package/dist/plugins/types.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,28 @@
+export type SkillInfo = {
+    name: string;
+    description: string;
+    filePath: string;
+    dir: string;
+    source: 'workspace' | 'external';
+};
+export type SkillIndex = {
+    skills: SkillInfo[];
+    byName: Map<string, SkillInfo>;
+    scannedDirs: Array<{
+        input: string;
+        absPath: string;
+        status: 'ok' | 'missing' | 'skipped_external' | 'error';
+        reason?: string;
+    }>;
+    truncated?: boolean;
+};
+export declare function getSkillIndex(options: {
+    workspaceRoot?: string;
+    searchPaths: string[];
+    allowExternalPaths: boolean;
+    signal?: AbortSignal;
+}): Promise<SkillIndex>;
+export declare function loadSkillFile(skill: SkillInfo): Promise<{
+    content: 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":"AAKA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,WAAW,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,kBAAkB,GAAG,OAAO,CAAC;QACxD,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAkGF,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2GtB;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAOlF"}

package/dist/skills.js

@@ -0,0 +1,188 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { expandHome, isSubPath } from '@kooka/core';
+let cache;
+function resolveSkillDir(input, workspaceRoot) {
+    const expanded = expandHome(input);
+    const absPath = workspaceRoot && expanded && !path.isAbsolute(expanded)
+        ? path.resolve(workspaceRoot, expanded)
+        : path.resolve(expanded);
+    return {
+        absPath,
+        inWorkspace: workspaceRoot ? isSubPath(absPath, workspaceRoot) : false,
+    };
+}
+function parseFrontmatterBlock(text) {
+    const match = text.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n?/);
+    if (!match)
+        return null;
+    const frontmatter = match[1] ?? '';
+    const body = text.slice(match[0].length);
+    return { frontmatter, body };
+}
+function parseSimpleYaml(frontmatter) {
+    const out = {};
+    for (const rawLine of frontmatter.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const m = line.match(/^([A-Za-z0-9_.-]+)\s*:\s*(.*)$/);
+        if (!m)
+            continue;
+        const key = m[1];
+        let value = (m[2] ?? '').trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+function parseSkillMarkdown(text) {
+    const fm = parseFrontmatterBlock(text);
+    if (!fm)
+        return undefined;
+    const data = parseSimpleYaml(fm.frontmatter);
+    const name = (data.name || '').trim();
+    const description = (data.description || '').trim();
+    if (!name || !description)
+        return undefined;
+    return { name, description, body: fm.body.trim() };
+}
+async function scanForSkillFiles(rootDir, options) {
+    const results = [];
+    const maxFiles = options.maxFiles ?? 200;
+    const walk = async (dir) => {
+        if (options.signal?.aborted)
+            return;
+        if (results.length >= maxFiles)
+            return;
+        let entries;
+        try {
+            entries = await fs.promises.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (options.signal?.aborted)
+                return;
+            if (results.length >= maxFiles)
+                return;
+            if (entry.isSymbolicLink())
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+                continue;
+            }
+            if (entry.isFile() && entry.name === 'SKILL.md') {
+                results.push(full);
+            }
+        }
+    };
+    await walk(rootDir);
+    return results;
+}
+export async function getSkillIndex(options) {
+    const workspaceRoot = options.workspaceRoot ? path.resolve(options.workspaceRoot) : undefined;
+    const searchPaths = (Array.isArray(options.searchPaths) ? options.searchPaths : [])
+        .map((p) => (typeof p === 'string' ? p.trim() : ''))
+        .filter(Boolean);
+    const allowExternalPaths = !!options.allowExternalPaths;
+    const key = JSON.stringify({
+        workspaceRoot: workspaceRoot ?? '',
+        allowExternalPaths,
+        searchPaths,
+    });
+    if (cache && cache.key === key && !cache.invalidated && Date.now() - cache.builtAt < 3000) {
+        return cache.promise;
+    }
+    const build = async () => {
+        const scannedDirs = [];
+        const byName = new Map();
+        const maxSkills = 200;
+        let truncated = false;
+        for (const input of searchPaths) {
+            if (options.signal?.aborted)
+                break;
+            const resolved = resolveSkillDir(input, workspaceRoot);
+            const absPath = resolved.absPath;
+            const isExternalDir = workspaceRoot ? !isSubPath(absPath, workspaceRoot) : path.isAbsolute(absPath);
+            if (isExternalDir && !allowExternalPaths) {
+                scannedDirs.push({
+                    input,
+                    absPath,
+                    status: 'skipped_external',
+                    reason: 'External paths disabled',
+                });
+                continue;
+            }
+            let stat;
+            try {
+                stat = await fs.promises.stat(absPath);
+            }
+            catch {
+                scannedDirs.push({ input, absPath, status: 'missing' });
+                continue;
+            }
+            if (!stat.isDirectory()) {
+                scannedDirs.push({ input, absPath, status: 'error', reason: 'Not a directory' });
+                continue;
+            }
+            scannedDirs.push({ input, absPath, status: 'ok' });
+            const files = await scanForSkillFiles(absPath, { signal: options.signal, maxFiles: 1000 });
+            files.sort((a, b) => a.localeCompare(b));
+            for (const filePath of files) {
+                if (options.signal?.aborted)
+                    break;
+                if (byName.size >= maxSkills) {
+                    truncated = true;
+                    break;
+                }
+                let text;
+                try {
+                    text = await fs.promises.readFile(filePath, 'utf8');
+                }
+                catch {
+                    continue;
+                }
+                const parsed = parseSkillMarkdown(text);
+                if (!parsed)
+                    continue;
+                const source = workspaceRoot && isSubPath(filePath, workspaceRoot) ? 'workspace' : 'external';
+                const dir = path.dirname(filePath);
+                byName.set(parsed.name, {
+                    name: parsed.name,
+                    description: parsed.description,
+                    filePath,
+                    dir,
+                    source,
+                });
+            }
+        }
+        const skills = Array.from(byName.values()).sort((a, b) => a.name.localeCompare(b.name));
+        return {
+            skills,
+            byName,
+            scannedDirs,
+            ...(truncated ? { truncated: true } : {}),
+        };
+    };
+    cache = {
+        key,
+        builtAt: Date.now(),
+        promise: build(),
+        invalidated: false,
+    };
+    return cache.promise;
+}
+export async function loadSkillFile(skill) {
+    const text = await fs.promises.readFile(skill.filePath, 'utf8');
+    const parsed = parseSkillMarkdown(text);
+    if (!parsed) {
+        throw new Error('Invalid SKILL.md: missing frontmatter (name/description)');
+    }
+    return { content: parsed.body.trim() };
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/tools/builtin/bash.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition, ToolHandler } from '../../types.js';
+export declare const bashTool: ToolDefinition;
+export declare const bashHandler: ToolHandler;
+//# sourceMappingURL=bash.d.ts.map