skillshield 1.0.0

package/dist/index.js

@@ -0,0 +1,275 @@
+/**
+ * SkillKit — The open-source runtime for SKILL.md files
+ * Execute ClawHub's 10,700+ skills with any AI model, in any language, securely.
+ *
+ * @module skillkit
+ * @version 1.0.0
+ * @license MIT
+ * @author ArtefactForge <hello@artefactforge.ai>
+ * @see https://github.com/artefactforge/skillkit
+ */
+// ─── Internal imports for SkillKit facade class ─────────────────────────────
+import { parseSkillFile as _parseSkillFile, parseSkillContent as _parseSkillContent } from './core/parser.js';
+import { SkillRunner as _SkillRunner } from './core/runtime.js';
+import { getConfig as _getConfig } from './core/config.js';
+import { SkillGuard as _SkillGuard } from './guard/index.js';
+import { ToolRegistry as _ToolRegistry } from './tools/index.js';
+import { ChannelManager as _ChannelManager } from './channels/index.js';
+import { SandboxManager as _SandboxManager } from './sandbox/index.js';
+import { Logger as _Logger } from './utils/logger.js';
+import { ParseError as _ParseError, SecurityError as _SecurityError } from './utils/errors.js';
+import { fetchSkill as _fetchSkill, searchSkills as _searchSkills } from './hub/index.js';
+import { getInstalled as _getInstalled, installSkill as _registryInstallSkill, listInstalled as _listInstalled } from './hub/registry.js';
+import { setLocale as _setLocale } from './i18n/index.js';
+// ─── Core: Parser, Runtime, Types, Config ────────────────────────────────────
+export { parseSkillFile, parseSkillContent, validateSkill, } from './core/parser.js';
+export { SkillRunner, executeSkill, } from './core/runtime.js';
+export { ConfigManager, getConfig, initializeConfig, resetConfig, } from './core/config.js';
+export { ModelProvider, ThreatLevel, ChannelType, } from './core/types.js';
+// ─── Model Router ────────────────────────────────────────────────────────────
+export { ModelRouter, } from './router/index.js';
+export { PROVIDER_REGISTRY, getProvider, getModel, listFreeModels, getModelsByCapability, } from './router/providers.js';
+// ─── SkillGuard (Security Engine) ────────────────────────────────────────────
+export { SkillGuard, } from './guard/index.js';
+export { MALICIOUS_PATTERNS, getPatternsByCategory, getThreatLevel, } from './guard/patterns.js';
+// ─── ClawHub Client ──────────────────────────────────────────────────────────
+export { fetchSkill, searchSkills, listPopular, getSkillMetadata, clearCache, } from './hub/index.js';
+export { installSkill as registryInstallSkill, getInstalled, listInstalled, removeSkill, updateSkill, } from './hub/registry.js';
+// ─── Channel Adapters ────────────────────────────────────────────────────────
+export { ChannelManager, BaseChannelAdapter, } from './channels/index.js';
+export { WhatsAppAdapter, createWhatsAppAdapter } from './channels/whatsapp.js';
+export { TelegramAdapter, createTelegramAdapter } from './channels/telegram.js';
+export { DiscordAdapter, createDiscordAdapter } from './channels/discord.js';
+export { SlackAdapter, createSlackAdapter } from './channels/slack.js';
+// ─── Tool System ─────────────────────────────────────────────────────────────
+export { ToolRegistry, } from './tools/index.js';
+// Native web intelligence tools (no API keys required)
+export { WebSearchTool, WebExtractTool, WebCrawlTool, WebResearchTool, WebMapTool, createWebTools, } from './tools/web-tools.js';
+export { nativeSearch, nativeExtract, nativeCrawl, nativeResearch, nativeMap, } from './tools/web-engine.js';
+// ─── Sandbox ─────────────────────────────────────────────────────────────────
+export { SandboxManager, ProcessSandbox, DockerSandbox, } from './sandbox/index.js';
+// ─── Utilities ───────────────────────────────────────────────────────────────
+export { Logger, defaultLogger } from './utils/logger.js';
+export { SkillKitError, ParseError, ModelError, SecurityError, ChannelError, HubError, SandboxError, ConfigError, ToolError, TimeoutError, formatError, formatErrorForCLI, } from './utils/errors.js';
+// ─── i18n ────────────────────────────────────────────────────────────────────
+export { t, setLocale, getLocale, getAvailableLocales } from './i18n/index.js';
+// ─── Version ─────────────────────────────────────────────────────────────────
+export const VERSION = '1.0.0';
+export const CODENAME = 'ForgeOne';
+/**
+ * Main SkillKit facade class
+ * Provides the high-level API for running skills, scanning for security,
+ * and managing the entire lifecycle.
+ *
+ * @example
+ * ```ts
+ * import { SkillKit } from 'skillkit';
+ *
+ * // Run a skill with DeepSeek (free)
+ * const result = await SkillKit.run('./my-skill.md', {
+ *   model: 'deepseek-chat',
+ *   provider: 'deepseek',
+ *   input: 'Analyze my sales data',
+ * });
+ *
+ * // Security scan a skill before running
+ * const report = await SkillKit.scan('./untrusted-skill.md');
+ * if (report.overallStatus === 'APPROVED') {
+ *   await SkillKit.run('./untrusted-skill.md');
+ * }
+ * ```
+ */
+export class SkillKit {
+    constructor() {
+        this.logger = new _Logger();
+        this.toolRegistry = new _ToolRegistry();
+        this.channelManager = new _ChannelManager();
+        this.sandboxManager = new _SandboxManager();
+        this.guard = new _SkillGuard();
+    }
+    /** Get or create singleton instance */
+    static getInstance() {
+        if (!SkillKit.instance) {
+            SkillKit.instance = new SkillKit();
+        }
+        return SkillKit.instance;
+    }
+    /** Access the tool registry */
+    getTools() { return this.toolRegistry; }
+    /** Access the channel manager */
+    getChannels() { return this.channelManager; }
+    /** Access the sandbox manager */
+    getSandbox() { return this.sandboxManager; }
+    /** Access the logger */
+    getLogger() { return this.logger; }
+    /** Access SkillGuard security scanner */
+    getGuard() { return this.guard; }
+    /** Access SkillGuard security scanner */
+    getSecurityGuard() { return this.guard; }
+    /**
+     * Run a SKILL.md file with the specified model and options.
+     * Automatically scans for security threats before execution.
+     *
+     * @param skillPath - Path to SKILL.md file, ClawHub skill ID, or installed skill name
+     * @param options - Execution options (model, provider, input, etc.)
+     * @returns Execution result with output, token usage, and cost estimate
+     */
+    static async run(skillPath, options = {}) {
+        const instance = SkillKit.getInstance();
+        const { logger, guard } = instance;
+        logger.info(`SkillKit v${VERSION} — Running: ${skillPath}`);
+        // Step 1: Parse the skill
+        let skill;
+        try {
+            skill = _parseSkillFile(skillPath);
+        }
+        catch {
+            // Try loading from local registry
+            const installed = await _getInstalled(skillPath);
+            if (installed) {
+                skill = _parseSkillContent(installed.content);
+            }
+            else {
+                throw new _ParseError(`Could not load skill: ${skillPath}`);
+            }
+        }
+        // Step 2: Security scan (ALWAYS runs — cannot be skipped for safety)
+        const report = await guard.scanSkill(skill.body || '');
+        if (report.overallStatus === 'BLOCKED') {
+            throw new _SecurityError(`Skill blocked by SkillGuard: ${report.summary}`, { report });
+        }
+        if (report.overallStatus === 'REVIEW_REQUIRED') {
+            logger.warn(`Security warning: ${report.summary}`);
+        }
+        // Step 3: Configure model
+        const config = _getConfig();
+        const provider = options.provider || String(config.getConfig().defaultProvider) || 'anthropic';
+        const model = options.model || 'deepseek-chat';
+        // Step 4: Execute via SkillRunner
+        const runner = new _SkillRunner({
+            verbose: options.verbose,
+        });
+        const result = await runner.executeSkill(skillPath, { prompt: options.input || '' }, {
+            model,
+            provider: provider,
+            streaming: options.stream,
+            timeout: options.timeout ?? 120000,
+        });
+        logger.info(`Execution complete. Tokens: ${result.usage?.totalTokens || 'N/A'}`);
+        return result;
+    }
+    /**
+     * Security scan a SKILL.md file.
+     *
+     * @param target - Path to SKILL.md file or raw content string
+     * @returns Full security report with threats, score, and recommendations
+     */
+    static async scan(target) {
+        const instance = SkillKit.getInstance();
+        let content;
+        try {
+            // Try reading as file path
+            const { readFileSync } = await import('fs');
+            content = readFileSync(target, 'utf-8');
+        }
+        catch {
+            // Treat as raw content
+            content = target;
+        }
+        return instance.guard.scanSkill(content);
+    }
+    /**
+     * Search ClawHub for skills.
+     *
+     * @param query - Search query
+     * @param options - Search options (limit, safeOnly, etc.)
+     * @returns Array of matching skills from ClawHub
+     */
+    static async search(query, options) {
+        return _searchSkills(query, options);
+    }
+    /**
+     * Install a skill from ClawHub with automatic security scanning.
+     *
+     * @param skillId - ClawHub skill ID or URL
+     * @param options - Install options
+     * @returns Installation result
+     */
+    static async install(skillId, options) {
+        const instance = SkillKit.getInstance();
+        const { guard, logger } = instance;
+        logger.info(`Installing skill: ${skillId}`);
+        // Fetch from hub
+        const skillData = await _fetchSkill(skillId);
+        // Security scan (ALWAYS runs — blocked skills cannot be installed)
+        const report = await guard.scanSkill(skillData.content);
+        if (report.overallStatus === 'BLOCKED') {
+            throw new _SecurityError(`Skill blocked by SkillGuard (score: ${report.safetyScore}/100). This skill contains malicious patterns and CANNOT be installed.`, { report });
+        }
+        // Install to local registry
+        const parsed = _parseSkillContent(skillData.content);
+        const installed = await _registryInstallSkill(parsed.metadata.name, skillData.content, {
+            source: `clawhub://${skillId}`,
+        });
+        logger.info(`Skill installed: ${parsed.metadata.name}`);
+        return { name: parsed.metadata.name, version: parsed.metadata.version };
+    }
+    /** List all installed skills */
+    static async listSkills() {
+        return _listInstalled();
+    }
+    /** Get available AI tools formatted for Vercel AI SDK */
+    static getToolsForAI() {
+        const instance = SkillKit.getInstance();
+        return instance.toolRegistry.getToolsForVercelAI();
+    }
+    /** List registered tools */
+    static listTools() {
+        const instance = SkillKit.getInstance();
+        return instance.toolRegistry.listTools().map((t) => ({
+            name: t.name,
+            description: t.description,
+        }));
+    }
+    /** List active messaging channels */
+    static getActiveChannels() {
+        const instance = SkillKit.getInstance();
+        return instance.channelManager.getActiveChannels();
+    }
+}
+/**
+ * Initialize SkillKit with configuration options.
+ * Call this once at startup for optimal setup.
+ *
+ * @example
+ * ```ts
+ * const kit = await initializeSkillKit({
+ *   verbose: true,
+ *   toolsToLoad: ['tavily_search', 'file_read'],
+ * });
+ * ```
+ */
+export async function initializeSkillKit(config) {
+    const kit = SkillKit.getInstance();
+    const logger = kit.getLogger();
+    if (config?.verbose) {
+        logger.setVerbose(true);
+    }
+    if (config?.locale) {
+        _setLocale(config.locale);
+    }
+    // Native web intelligence tools are auto-registered by ToolRegistry.
+    // No API keys needed — works out of the box.
+    const webActive = kit.getTools().isWebIntelligenceActive();
+    if (webActive) {
+        logger.info('Native web intelligence: ACTIVE (search, extract, crawl, research, map) — zero API keys required');
+    }
+    else {
+        logger.warn('Native web intelligence: FAILED to register — check node-fetch dependency');
+    }
+    logger.info(`SkillKit v${VERSION} (${CODENAME}) initialized`);
+    return kit;
+}
+// ─── Convenience singleton ───────────────────────────────────────────────────
+export const skillkit = SkillKit.getInstance();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+EAA+E;AAC/E,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAmC,SAAS,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,YAAY,IAAI,qBAAqB,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1I,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1D,gFAAgF;AAChF,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,WAAW,EACX,WAAW,GAaZ,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,OAAO,EACL,WAAW,GAKZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,cAAc,EACd,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,OAAO,EACL,UAAU,GAIX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GAIf,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,UAAU,GAIX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,IAAI,oBAAoB,EACpC,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,GAEZ,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,OAAO,EACL,cAAc,EACd,kBAAkB,GAInB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,gFAAgF;AAChF,OAAO,EACL,YAAY,GAKb,MAAM,kBAAkB,CAAC;AAE1B,uDAAuD;AACvD,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,UAAU,EACV,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,SAAS,GAUV,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,GAId,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAiB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACX,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,gFAAgF;AAChF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,QAAQ;IAQnB;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,aAAa,EAAE,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,IAAI,eAAe,EAAE,CAAC;QAC5C,IAAI,CAAC,cAAc,GAAG,IAAI,eAAe,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,uCAAuC;IACvC,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvB,QAAQ,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED,+BAA+B;IAC/B,QAAQ,KAAoB,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAEvD,iCAAiC;IACjC,WAAW,KAAsB,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAE9D,iCAAiC;IACjC,UAAU,KAAsB,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAE7D,wBAAwB;IACxB,SAAS,KAAc,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5C,yCAAyC;IACzC,QAAQ,KAAkB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9C,yCAAyC;IACzC,gBAAgB,KAAkB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtD;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,UAShC,EAAE;QACJ,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;QAEnC,MAAM,CAAC,IAAI,CAAC,aAAa,OAAO,eAAe,SAAS,EAAE,CAAC,CAAC;QAE5D,0BAA0B;QAC1B,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;YAClC,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,GAAG,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,WAAW,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,qEAAqE;QACrE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,cAAc,CACtB,gCAAgC,MAAM,CAAC,OAAO,EAAE,EAChD,EAAE,MAAM,EAAE,CACX,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,KAAK,iBAAiB,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,0BAA0B;QAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,IAAI,WAAW,CAAC;QAC/F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC;QAE/C,kCAAkC;QAClC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE;YACnF,KAAK;YACL,QAAQ,EAAE,QAAe;YACzB,SAAS,EAAE,OAAO,CAAC,MAAM;YACzB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM;SACnC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,KAAK,EAAE,CAAC,CAAC;QAEjF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAc;QAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAExC,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,2BAA2B;YAC3B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;YACvB,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;QAED,OAAO,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAgD;QACjF,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAiD;QACrF,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAEnC,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAE5C,iBAAiB;QACjB,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAE7C,mEAAmE;QACnE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,cAAc,CACtB,uCAAuC,MAAM,CAAC,WAAW,wEAAwE,EACjI,EAAE,MAAM,EAAE,CACX,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE;YACrF,MAAM,EAAE,aAAa,OAAO,EAAE;SAC/B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1E,CAAC;IAED,gCAAgC;IAChC,MAAM,CAAC,KAAK,CAAC,UAAU;QACrB,OAAO,cAAc,EAAE,CAAC;IAC1B,CAAC;IAED,yDAAyD;IACzD,MAAM,CAAC,aAAa;QAClB,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC;IACrD,CAAC;IAED,4BAA4B;IAC5B,MAAM,CAAC,SAAS;QACd,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,iBAAiB;QACtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC;IACrD,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAKxC;IACC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAE/B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,MAAM,CAAC,MAAa,CAAC,CAAC;IACnC,CAAC;IAED,qEAAqE;IACrE,6CAA6C;IAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,uBAAuB,EAAE,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,kGAAkG,CAAC,CAAC;IAClH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,aAAa,OAAO,KAAK,QAAQ,eAAe,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC"}

package/dist/router/index.d.ts

@@ -0,0 +1,89 @@
+import { LanguageModelV1 } from "ai";
+export interface ModelConfig {
+    provider: string;
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+}
+export interface SkillRequirements {
+    minContextWindow?: number;
+    requiresVision?: boolean;
+    requiresTools?: boolean;
+    requiresStreaming?: boolean;
+    preferredProviders?: string[];
+    maxCostPerMTok?: number;
+}
+export interface ModelInstance {
+    id: string;
+    provider: string;
+    model: string;
+    instance: LanguageModelV1;
+    contextWindow: number;
+    maxOutput: number;
+    costPer1kTokens: number;
+}
+export interface CostEstimate {
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    estimatedCost: number;
+    currency: string;
+}
+export declare class ModelRouter {
+    private models;
+    private modelMetadata;
+    private apiKeys;
+    private fallbackChain;
+    constructor(config?: Record<string, ModelConfig>);
+    private initializeApiKeys;
+    private setupFallbackChain;
+    createModelInstance(provider: string, model: string, overrideConfig?: Partial<ModelConfig>): Promise<ModelInstance>;
+    private createProviderInstance;
+    routeToModel(skillRequirements: SkillRequirements, userPreferences?: Partial<ModelConfig>): Promise<ModelInstance>;
+    private findSuitableModels;
+    generateResponse(modelInstance: ModelInstance, prompt: string, systemPrompt?: string, options?: {
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    streamResponse(modelInstance: ModelInstance, prompt: string, systemPrompt?: string, options?: {
+        temperature?: number;
+        maxTokens?: number;
+        onChunk?: (chunk: string) => void;
+    }): Promise<string>;
+    estimateCost(modelInstance: ModelInstance, inputTokens: number, outputTokens: number): CostEstimate;
+    getAvailableModels(): Array<{
+        provider: string;
+        models: Array<{
+            id: string;
+            name: string;
+            contextWindow: number;
+            costPer1kTokens: number;
+        }>;
+    }>;
+    listFreeModels(): Array<{
+        provider: string;
+        model: string;
+        name: string;
+    }>;
+    validateApiKey(provider: string, apiKey: string): Promise<boolean>;
+    setFallbackChain(providers: string[]): void;
+    getFallbackChain(): string[];
+}
+export declare function createModel(config: ModelConfig): Promise<ModelInstance>;
+export declare function getAvailableModels(): Array<{
+    provider: string;
+    models: Array<{
+        id: string;
+        name: string;
+        contextWindow: number;
+        costPer1kTokens: number;
+    }>;
+}>;
+export default ModelRouter;
+//# sourceMappingURL=index.d.ts.map

package/dist/router/index.d.ts.map

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

package/dist/router/index.js

@@ -0,0 +1,292 @@
+import { generateText, streamText, } from "ai";
+import { createOpenAI } from "@ai-sdk/openai";
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createOllama } from "ollama-ai-provider";
+import { PROVIDER_REGISTRY } from "./providers.js";
+export class ModelRouter {
+    constructor(config = {}) {
+        this.models = new Map();
+        this.modelMetadata = new Map();
+        this.apiKeys = {};
+        this.fallbackChain = [];
+        this.initializeApiKeys(config);
+        this.setupFallbackChain(config);
+    }
+    initializeApiKeys(config) {
+        for (const [key, modelConfig] of Object.entries(config)) {
+            if (modelConfig.apiKey) {
+                this.apiKeys[modelConfig.provider] = modelConfig.apiKey;
+            }
+            else if (process.env[`${modelConfig.provider.toUpperCase()}_API_KEY`]) {
+                this.apiKeys[modelConfig.provider] = process.env[`${modelConfig.provider.toUpperCase()}_API_KEY`];
+            }
+        }
+    }
+    setupFallbackChain(config) {
+        const priorityOrder = [
+            "anthropic",
+            "openai",
+            "google",
+            "groq",
+            "deepseek",
+            "together",
+            "fireworks",
+            "qwen",
+            "ollama",
+        ];
+        this.fallbackChain = priorityOrder.filter((provider) => Object.values(config).some((c) => c.provider === provider));
+    }
+    async createModelInstance(provider, model, overrideConfig) {
+        const cacheKey = `${provider}:${model}`;
+        if (this.models.has(cacheKey)) {
+            const instance = this.models.get(cacheKey);
+            const metadata = this.modelMetadata.get(cacheKey);
+            return {
+                id: cacheKey,
+                provider,
+                model,
+                instance,
+                contextWindow: metadata.contextWindow,
+                maxOutput: metadata.maxOutput,
+                costPer1kTokens: metadata.costPer1kTokens,
+            };
+        }
+        const providerData = PROVIDER_REGISTRY[provider];
+        if (!providerData) {
+            throw new Error(`Unknown provider: ${provider}`);
+        }
+        const modelData = providerData.models.find((m) => m.id === model);
+        if (!modelData) {
+            throw new Error(`Unknown model: ${model} for provider: ${provider}`);
+        }
+        const apiKey = overrideConfig?.apiKey ||
+            this.apiKeys[provider] ||
+            process.env[`${provider.toUpperCase()}_API_KEY`];
+        if (providerData.requiresApiKey && !apiKey) {
+            throw new Error(`API key required for ${provider}. Set ${provider.toUpperCase()}_API_KEY environment variable.`);
+        }
+        const instance = this.createProviderInstance(provider, model, apiKey, overrideConfig);
+        this.models.set(cacheKey, instance);
+        this.modelMetadata.set(cacheKey, modelData);
+        return {
+            id: cacheKey,
+            provider,
+            model,
+            instance,
+            contextWindow: modelData.contextWindow,
+            maxOutput: modelData.maxOutput,
+            costPer1kTokens: modelData.costPer1kTokens,
+        };
+    }
+    createProviderInstance(provider, model, apiKey, config) {
+        // Generation params (temperature, maxTokens, etc.) are passed to
+        // generateText/streamText, NOT to the model constructor.
+        switch (provider.toLowerCase()) {
+            case "openai": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.OPENAI_API_KEY,
+                });
+                return client(model);
+            }
+            case "anthropic": {
+                const client = createAnthropic({
+                    apiKey: apiKey || process.env.ANTHROPIC_API_KEY,
+                });
+                return client(model);
+            }
+            case "google": {
+                const client = createGoogleGenerativeAI({
+                    apiKey: apiKey || process.env.GOOGLE_API_KEY,
+                });
+                return client(model);
+            }
+            case "ollama": {
+                const baseURL = config?.baseUrl || "http://localhost:11434";
+                return createOllama({ baseURL })(model);
+            }
+            case "deepseek": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.DEEPSEEK_API_KEY,
+                    baseURL: config?.baseUrl || "https://api.deepseek.com/beta",
+                });
+                return client(model);
+            }
+            case "qwen": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.QWEN_API_KEY,
+                    baseURL: config?.baseUrl || "https://dashscope.aliyuncs.com/compatible-mode/v1",
+                });
+                return client(model);
+            }
+            case "groq": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.GROQ_API_KEY,
+                    baseURL: config?.baseUrl || "https://api.groq.com/openai/v1",
+                });
+                return client(model);
+            }
+            case "together": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.TOGETHER_API_KEY,
+                    baseURL: config?.baseUrl || "https://api.together.xyz/v1",
+                });
+                return client(model);
+            }
+            case "fireworks": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.FIREWORKS_API_KEY,
+                    baseURL: config?.baseUrl || "https://api.fireworks.ai/inference/v1",
+                });
+                return client(model);
+            }
+            case "kimi": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.KIMI_API_KEY || process.env.MOONSHOT_API_KEY,
+                    baseURL: config?.baseUrl || "https://api.moonshot.cn/v1",
+                });
+                return client(model);
+            }
+            case "zhipu": {
+                const client = createOpenAI({
+                    apiKey: apiKey || process.env.ZHIPU_API_KEY,
+                    baseURL: config?.baseUrl || "https://open.bigmodel.cn/api/paas/v4",
+                });
+                return client(model);
+            }
+            default:
+                throw new Error(`Unsupported provider: ${provider}`);
+        }
+    }
+    async routeToModel(skillRequirements, userPreferences) {
+        const candidates = this.findSuitableModels(skillRequirements);
+        if (candidates.length === 0) {
+            throw new Error("No suitable model found matching the skill requirements");
+        }
+        const selectedProvider = skillRequirements.preferredProviders?.[0] ||
+            candidates[0].provider || ["anthropic", "openai"][0];
+        const selectedModel = candidates.find((c) => c.provider === selectedProvider) || candidates[0];
+        return this.createModelInstance(selectedModel.provider, selectedModel.model, userPreferences);
+    }
+    findSuitableModels(requirements) {
+        const results = [];
+        for (const [providerName, providerData] of Object.entries(PROVIDER_REGISTRY)) {
+            for (const model of providerData.models) {
+                const matches = (!requirements.minContextWindow ||
+                    model.contextWindow >= requirements.minContextWindow) &&
+                    (!requirements.requiresVision ||
+                        model.capabilities?.vision) &&
+                    (!requirements.requiresTools ||
+                        model.capabilities?.tools) &&
+                    (!requirements.requiresStreaming ||
+                        model.capabilities?.streaming) &&
+                    (!requirements.maxCostPerMTok ||
+                        model.costPer1kTokens <= requirements.maxCostPerMTok);
+                if (matches) {
+                    results.push({
+                        provider: providerName,
+                        model: model.id,
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    async generateResponse(modelInstance, prompt, systemPrompt, options) {
+        const messages = [{ role: "user", content: prompt }];
+        const result = await generateText({
+            model: modelInstance.instance,
+            system: systemPrompt,
+            messages,
+            temperature: options?.temperature,
+            maxTokens: options?.maxTokens,
+        });
+        return result.text;
+    }
+    async streamResponse(modelInstance, prompt, systemPrompt, options) {
+        const messages = [{ role: "user", content: prompt }];
+        const stream = await streamText({
+            model: modelInstance.instance,
+            system: systemPrompt,
+            messages,
+            temperature: options?.temperature,
+            maxTokens: options?.maxTokens,
+        });
+        let fullText = "";
+        for await (const chunk of stream.textStream) {
+            fullText += chunk;
+            options?.onChunk?.(chunk);
+        }
+        return fullText;
+    }
+    estimateCost(modelInstance, inputTokens, outputTokens) {
+        const inputCost = (inputTokens / 1000) * modelInstance.costPer1kTokens;
+        const outputCost = (outputTokens / 1000) * modelInstance.costPer1kTokens;
+        return {
+            provider: modelInstance.provider,
+            model: modelInstance.model,
+            inputTokens,
+            outputTokens,
+            estimatedCost: inputCost + outputCost,
+            currency: "USD",
+        };
+    }
+    getAvailableModels() {
+        return Object.entries(PROVIDER_REGISTRY).map(([provider, data]) => ({
+            provider,
+            models: data.models.map((m) => ({
+                id: m.id,
+                name: m.name,
+                contextWindow: m.contextWindow,
+                costPer1kTokens: m.costPer1kTokens,
+            })),
+        }));
+    }
+    listFreeModels() {
+        const freeModels = [];
+        for (const [providerName, providerData] of Object.entries(PROVIDER_REGISTRY)) {
+            if (providerData.freeTier) {
+                for (const model of providerData.models) {
+                    if (model.costPer1kTokens === 0 || model.costPer1kTokens < 0.0001) {
+                        freeModels.push({
+                            provider: providerName,
+                            model: model.id,
+                            name: model.name,
+                        });
+                    }
+                }
+            }
+        }
+        return freeModels;
+    }
+    async validateApiKey(provider, apiKey) {
+        try {
+            const instance = await this.createModelInstance(provider, PROVIDER_REGISTRY[provider]?.models[0]?.id || "default", { apiKey });
+            await generateText({
+                model: instance.instance,
+                prompt: "Test",
+                maxTokens: 1,
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    setFallbackChain(providers) {
+        this.fallbackChain = providers.filter((p) => Object.keys(PROVIDER_REGISTRY).includes(p));
+    }
+    getFallbackChain() {
+        return this.fallbackChain;
+    }
+}
+export async function createModel(config) {
+    const router = new ModelRouter();
+    return router.createModelInstance(config.provider, config.model, config);
+}
+export function getAvailableModels() {
+    const router = new ModelRouter();
+    return router.getAvailableModels();
+}
+export default ModelRouter;
+//# sourceMappingURL=index.js.map