opc-agent 4.2.0 → 4.2.1

package/dist/core/gateway-registry.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * Tool Gateway — Remote managed tool provider pattern.
+ *
+ * Inspired by Hermes Agent v0.10's Tool Gateway feature.
+ * Allows agents to access remote tool services (web search, image gen, TTS,
+ * browser automation) through a unified gateway, removing the need for
+ * individual API keys per tool.
+ *
+ * Key features:
+ * - Subscription-based tool access (single API key → multiple tools)
+ * - Per-tool opt-in/opt-out via configuration
+ * - Auto-detection of gateway availability
+ * - Fallback to direct API keys when gateway unavailable
+ * - Usage tracking and quota enforcement
+ *
+ * Usage:
+ *   const gw = new ToolGateway({ endpoint: 'https://tools.example.com', apiKey: '...' });
+ *   await gw.connect();
+ *   const result = await gw.invoke('web-search', { query: 'hello' });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolGatewayRegistry = exports.ToolGateway = void 0;
+const events_1 = require("events");
+const logger_1 = require("./logger");
+// ─── Tool Gateway ────────────────────────────────────────────
+class ToolGateway extends events_1.EventEmitter {
+    config;
+    tools = new Map();
+    connected = false;
+    logger = new logger_1.Logger('tool-gateway');
+    invocationCount = 0;
+    constructor(config) {
+        super();
+        this.config = {
+            endpoint: config.endpoint.replace(/\/$/, ''),
+            apiKey: config.apiKey,
+            enabledTools: config.enabledTools ?? [],
+            timeout: config.timeout ?? 60_000,
+            preferGateway: config.preferGateway ?? true,
+            retry: {
+                maxRetries: config.retry?.maxRetries ?? 2,
+                backoffMs: config.retry?.backoffMs ?? 1000,
+            },
+        };
+    }
+    /** Connect to gateway and discover available tools */
+    async connect() {
+        try {
+            const res = await this.request('GET', '/tools');
+            const data = res;
+            this.tools.clear();
+            for (const tool of data.tools) {
+                // If enabledTools is specified, only include those
+                if (this.config.enabledTools.length === 0 ||
+                    this.config.enabledTools.includes(tool.id)) {
+                    this.tools.set(tool.id, tool);
+                }
+            }
+            this.connected = true;
+            this.logger.info('Connected to tool gateway', {
+                endpoint: this.config.endpoint,
+                tools: this.tools.size,
+            });
+            this.emit('connected', this.getStatus());
+            return {
+                connected: true,
+                endpoint: this.config.endpoint,
+                tools: Array.from(this.tools.values()),
+                subscription: data.subscription,
+            };
+        }
+        catch (err) {
+            this.connected = false;
+            this.logger.error('Failed to connect to tool gateway', {
+                error: err.message,
+            });
+            throw err;
+        }
+    }
+    /** Invoke a tool through the gateway */
+    async invoke(toolId, input) {
+        if (!this.connected) {
+            throw new Error('Tool gateway not connected. Call connect() first.');
+        }
+        const tool = this.tools.get(toolId);
+        if (!tool) {
+            return {
+                toolId,
+                requestId: this.generateRequestId(),
+                status: 'unavailable',
+                error: `Tool "${toolId}" not available on this gateway`,
+                durationMs: 0,
+            };
+        }
+        if (!tool.available) {
+            return {
+                toolId,
+                requestId: this.generateRequestId(),
+                status: 'unavailable',
+                error: `Tool "${toolId}" is currently unavailable`,
+                durationMs: 0,
+            };
+        }
+        const requestId = this.generateRequestId();
+        const start = Date.now();
+        try {
+            const result = await this.request('POST', '/invoke', {
+                toolId,
+                input,
+                requestId,
+            });
+            const durationMs = Date.now() - start;
+            this.invocationCount++;
+            const gatewayResult = {
+                toolId,
+                requestId,
+                status: 'success',
+                output: result.output,
+                durationMs,
+                quotaRemaining: result.quotaRemaining,
+            };
+            // Update quota info
+            if (gatewayResult.quotaRemaining !== undefined) {
+                tool.quotaRemaining = gatewayResult.quotaRemaining;
+            }
+            this.emit('invocation', gatewayResult);
+            return gatewayResult;
+        }
+        catch (err) {
+            const durationMs = Date.now() - start;
+            const message = err.message;
+            const status = message.includes('quota') ? 'quota_exceeded' : 'error';
+            const gatewayResult = {
+                toolId,
+                requestId,
+                status,
+                error: message,
+                durationMs,
+            };
+            this.emit('invocation:error', gatewayResult);
+            return gatewayResult;
+        }
+    }
+    /** Get a tool definition (for MCP/tool schema exposure) */
+    getTool(toolId) {
+        return this.tools.get(toolId);
+    }
+    /** List all available tools */
+    listTools() {
+        return Array.from(this.tools.values());
+    }
+    /** Get current status */
+    getStatus() {
+        return {
+            connected: this.connected,
+            endpoint: this.config.endpoint,
+            tools: Array.from(this.tools.values()),
+        };
+    }
+    /** Check if gateway should be preferred over direct API call */
+    shouldUseGateway(toolId) {
+        if (!this.connected)
+            return false;
+        if (!this.config.preferGateway)
+            return false;
+        const tool = this.tools.get(toolId);
+        if (!tool || !tool.available)
+            return false;
+        if (tool.quotaRemaining !== undefined && tool.quotaRemaining <= 0)
+            return false;
+        return true;
+    }
+    /** Disconnect from gateway */
+    disconnect() {
+        this.connected = false;
+        this.tools.clear();
+        this.emit('disconnected');
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    get totalInvocations() {
+        return this.invocationCount;
+    }
+    // ─── Private helpers ─────────────────────────────────────────
+    async request(method, path, body) {
+        const url = `${this.config.endpoint}${path}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.config.timeout);
+        let lastError;
+        const maxAttempts = 1 + (this.config.retry?.maxRetries ?? 0);
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                const res = await fetch(url, {
+                    method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${this.config.apiKey}`,
+                        'X-Client': 'opc-agent',
+                    },
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (!res.ok) {
+                    const errBody = await res.text().catch(() => '');
+                    throw new Error(`Gateway ${res.status}: ${errBody || res.statusText}`);
+                }
+                return await res.json();
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < maxAttempts - 1) {
+                    await new Promise(r => setTimeout(r, (this.config.retry?.backoffMs ?? 1000) * (attempt + 1)));
+                }
+            }
+        }
+        clearTimeout(timer);
+        throw lastError;
+    }
+    generateRequestId() {
+        return `gw_${++this.invocationCount}_${Date.now().toString(36)}`;
+    }
+}
+exports.ToolGateway = ToolGateway;
+// ─── Tool Gateway Registry (multi-gateway support) ───────────
+class ToolGatewayRegistry {
+    gateways = new Map();
+    toolToGateway = new Map();
+    logger = new logger_1.Logger('tool-gateway-registry');
+    /** Register a gateway */
+    register(name, gateway) {
+        this.gateways.set(name, gateway);
+        // Index tools → gateway
+        for (const tool of gateway.listTools()) {
+            this.toolToGateway.set(tool.id, name);
+        }
+        this.logger.info('Gateway registered', { name, tools: gateway.listTools().length });
+    }
+    /** Find which gateway provides a tool */
+    findGateway(toolId) {
+        const name = this.toolToGateway.get(toolId);
+        return name ? this.gateways.get(name) : undefined;
+    }
+    /** Invoke a tool, auto-routing to the right gateway */
+    async invoke(toolId, input) {
+        const gateway = this.findGateway(toolId);
+        if (!gateway) {
+            return {
+                toolId,
+                requestId: 'none',
+                status: 'unavailable',
+                error: `No gateway provides tool "${toolId}"`,
+                durationMs: 0,
+            };
+        }
+        return gateway.invoke(toolId, input);
+    }
+    /** List all tools across all gateways */
+    listAllTools() {
+        const result = [];
+        for (const [name, gw] of this.gateways) {
+            for (const tool of gw.listTools()) {
+                result.push({ ...tool, gateway: name });
+            }
+        }
+        return result;
+    }
+    /** Disconnect all gateways */
+    disconnectAll() {
+        for (const gw of this.gateways.values()) {
+            gw.disconnect();
+        }
+        this.gateways.clear();
+        this.toolToGateway.clear();
+    }
+}
+exports.ToolGatewayRegistry = ToolGatewayRegistry;
+//# sourceMappingURL=gateway-registry.js.map

package/dist/core/gateway-registry.js.map

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

package/dist/core/model-recommender.d.ts

@@ -0,0 +1,40 @@
+export interface ModelRec {
+    name: string;
+    size: string;
+    minRAM: number;
+    desc: string;
+    descEn?: string;
+    tier: number;
+    lang?: string[];
+    useCase?: string[];
+    speed?: string;
+    recommended?: boolean;
+}
+interface SystemInfo {
+    totalRAM: number;
+    freeRAM: number;
+    cpuCount: number;
+    platform: string;
+    arch: string;
+}
+export declare function fetchModelList(): Promise<ModelRec[]>;
+export declare function detectSystem(): SystemInfo;
+export declare function recommendModels(models: ModelRec[], sys: SystemInfo, installedModels?: string[], opts?: {
+    useCase?: string;
+    lang?: string;
+}): {
+    suitable: ModelRec[];
+    best: ModelRec;
+    installed: ModelRec[];
+    toDownload: ModelRec[];
+};
+/** Invalidate cache so next fetchModelList() re-downloads */
+export declare function clearModelCache(): boolean;
+/** Get cache info */
+export declare function cacheInfo(): {
+    exists: boolean;
+    age?: string;
+    version?: string;
+};
+export {};
+//# sourceMappingURL=model-recommender.d.ts.map

package/dist/core/model-recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-recommender.d.ts","sourceRoot":"","sources":["../../src/core/model-recommender.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AASD,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AA8CD,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsB1D;AAED,wBAAgB,YAAY,IAAI,UAAU,CAQzC;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,QAAQ,EAAE,EAClB,GAAG,EAAE,UAAU,EACf,eAAe,GAAE,MAAM,EAAO,EAC9B,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C;IACD,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,QAAQ,EAAE,CAAC;CACxB,CA+BA;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAED,qBAAqB;AACrB,wBAAgB,SAAS,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAU/E"}

package/dist/core/model-recommender.js

@@ -0,0 +1,186 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchModelList = fetchModelList;
+exports.detectSystem = detectSystem;
+exports.recommendModels = recommendModels;
+exports.clearModelCache = clearModelCache;
+exports.cacheInfo = cacheInfo;
+/**
+ * 智能模型推荐引擎
+ * - 远程模型列表 (GitHub) + 本地缓存 (24h) + 硬编码 fallback
+ * - 根据系统硬件自动推荐最适合的模型
+ */
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const REMOTE_URL = 'https://raw.githubusercontent.com/Deepleaper/opc-agent/main/models.json';
+const CACHE_FILE = '.opc-models-cache.json';
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
+// Hardcoded fallback (same as models.json, kept in sync)
+const FALLBACK_MODELS = [
+    { name: 'qwen2.5:0.5b', size: '0.4GB', minRAM: 2, desc: '超轻量，适合低配机器', tier: 1 },
+    { name: 'qwen2.5:1.5b', size: '1.0GB', minRAM: 4, desc: '轻量但更智能', tier: 1 },
+    { name: 'qwen2.5:3b', size: '2.0GB', minRAM: 6, desc: '性价比最优', tier: 2 },
+    { name: 'llama3.2:3b', size: '2.0GB', minRAM: 6, desc: 'Meta 最新轻量模型', tier: 2 },
+    { name: 'phi3:mini', size: '2.3GB', minRAM: 6, desc: '微软高效小模型', tier: 2 },
+    { name: 'qwen2.5:7b', size: '4.7GB', minRAM: 8, desc: '推荐：中文最强 7B', tier: 3, recommended: true },
+    { name: 'llama3.1:8b', size: '4.7GB', minRAM: 8, desc: 'Meta 通用 8B', tier: 3 },
+    { name: 'mistral:7b', size: '4.1GB', minRAM: 8, desc: 'Mistral 经典 7B', tier: 3 },
+    { name: 'gemma2:9b', size: '5.4GB', minRAM: 10, desc: 'Google 高效 9B', tier: 3 },
+    { name: 'qwen2.5-coder:7b', size: '4.7GB', minRAM: 8, desc: '编程专用 7B', tier: 3 },
+    { name: 'qwen2.5:14b', size: '9.0GB', minRAM: 16, desc: '中文强力 14B', tier: 4 },
+    { name: 'deepseek-coder-v2:16b', size: '9.0GB', minRAM: 16, desc: '编程专用 16B', tier: 4 },
+    { name: 'qwen2.5:32b', size: '20GB', minRAM: 32, desc: '接近 GPT-4 水平', tier: 5, recommended: true },
+    { name: 'llama3.1:70b', size: '40GB', minRAM: 64, desc: '开源最强', tier: 6 },
+];
+function getCachePath() {
+    return path.join(os.homedir(), CACHE_FILE);
+}
+function readCache() {
+    try {
+        const cachePath = getCachePath();
+        if (!fs.existsSync(cachePath))
+            return null;
+        const stat = fs.statSync(cachePath);
+        if (Date.now() - stat.mtimeMs > CACHE_TTL)
+            return null; // expired
+        const data = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+        if (!data.models || !Array.isArray(data.models))
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(data) {
+    try {
+        fs.writeFileSync(getCachePath(), JSON.stringify(data, null, 2));
+    }
+    catch { /* best effort */ }
+}
+async function fetchModelList() {
+    // 1. Try cache
+    const cached = readCache();
+    if (cached)
+        return cached.models;
+    // 2. Try remote
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        const res = await fetch(REMOTE_URL, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (res.ok) {
+            const data = await res.json();
+            if (data.models && Array.isArray(data.models) && data.models.length > 0) {
+                writeCache(data);
+                return data.models;
+            }
+        }
+    }
+    catch { /* fallback */ }
+    // 3. Fallback
+    return FALLBACK_MODELS;
+}
+function detectSystem() {
+    return {
+        totalRAM: Math.round(os.totalmem() / (1024 ** 3)),
+        freeRAM: Math.round(os.freemem() / (1024 ** 3)),
+        cpuCount: os.cpus().length,
+        platform: os.platform(),
+        arch: os.arch(),
+    };
+}
+function recommendModels(models, sys, installedModels = [], opts = {}) {
+    const availableRAM = sys.freeRAM + 2; // +2GB tolerance
+    // Filter by hardware
+    let suitable = models.filter(m => m.minRAM <= availableRAM);
+    if (suitable.length === 0)
+        suitable = [models[0]]; // always have at least one
+    // Optional: filter by use case
+    if (opts.useCase) {
+        const filtered = suitable.filter(m => m.useCase?.includes(opts.useCase));
+        if (filtered.length > 0)
+            suitable = filtered;
+    }
+    // Optional: filter by language
+    if (opts.lang) {
+        const filtered = suitable.filter(m => m.lang?.includes(opts.lang));
+        if (filtered.length > 0)
+            suitable = filtered;
+    }
+    // Best = highest tier that fits, prefer 'recommended' flag
+    const recommended = suitable.filter(m => m.recommended);
+    const best = recommended.length > 0
+        ? recommended[recommended.length - 1]
+        : suitable[suitable.length - 1];
+    // Split installed vs to-download
+    const installedSet = new Set(installedModels);
+    const installed = suitable.filter(m => installedSet.has(m.name));
+    const toDownload = suitable.filter(m => !installedSet.has(m.name)).slice(-3); // top 3 recommendations
+    return { suitable, best, installed, toDownload };
+}
+/** Invalidate cache so next fetchModelList() re-downloads */
+function clearModelCache() {
+    try {
+        const p = getCachePath();
+        if (fs.existsSync(p)) {
+            fs.unlinkSync(p);
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/** Get cache info */
+function cacheInfo() {
+    try {
+        const p = getCachePath();
+        if (!fs.existsSync(p))
+            return { exists: false };
+        const stat = fs.statSync(p);
+        const ageMs = Date.now() - stat.mtimeMs;
+        const hours = Math.round(ageMs / (60 * 60 * 1000));
+        const data = JSON.parse(fs.readFileSync(p, 'utf-8'));
+        return { exists: true, age: `${hours}h ago`, version: data.version };
+    }
+    catch {
+        return { exists: false };
+    }
+}
+//# sourceMappingURL=model-recommender.js.map

package/dist/core/model-recommender.js.map

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

package/dist/core/priority-queue.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Priority Queue / Fast Mode — Route requests through priority tiers
+ * for lower latency on supported providers.
+ *
+ * Inspired by Hermes Agent's /fast mode. Provides a priority-aware request
+ * queue that separates normal and fast-mode requests, ensuring fast-mode
+ * requests are processed first and routed to provider priority endpoints.
+ *
+ * Usage:
+ *   const pq = new PriorityQueue();
+ *   pq.enqueue({ id: 'req1', priority: 'fast', provider: 'openai', ... });
+ *   const next = pq.dequeue(); // Always returns highest priority first
+ */
+import { EventEmitter } from 'events';
+export type PriorityLevel = 'fast' | 'normal' | 'batch';
+export interface PriorityRequest {
+    id: string;
+    priority: PriorityLevel;
+    provider: string;
+    model: string;
+    payload: unknown;
+    enqueuedAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface PriorityConfig {
+    /** Maximum concurrent fast-mode requests per provider */
+    maxConcurrentFast?: number;
+    /** Maximum concurrent normal requests per provider */
+    maxConcurrentNormal?: number;
+    /** Timeout for fast-mode requests before fallback (ms, default 30s) */
+    fastTimeout?: number;
+    /** Providers that support priority routing */
+    supportedProviders?: string[];
+}
+export interface ProviderPriorityEndpoint {
+    provider: string;
+    priorityUrl?: string;
+    priorityHeader?: {
+        key: string;
+        value: string;
+    };
+    priorityParam?: {
+        key: string;
+        value: string;
+    };
+}
+export declare class PriorityQueue extends EventEmitter {
+    private queues;
+    private activeCounts;
+    private config;
+    private endpoints;
+    constructor(config?: PriorityConfig);
+    /** Register a custom priority endpoint for a provider */
+    registerEndpoint(endpoint: ProviderPriorityEndpoint): void;
+    /** Check if a provider supports priority routing */
+    supportsPriority(provider: string): boolean;
+    /** Get priority endpoint configuration for a provider */
+    getEndpoint(provider: string): ProviderPriorityEndpoint | undefined;
+    /** Enqueue a request */
+    enqueue(request: PriorityRequest): void;
+    /** Dequeue the next highest-priority request that can run */
+    dequeue(): PriorityRequest | undefined;
+    /** Mark a request as completed, freeing a concurrency slot */
+    complete(provider: string, priority: PriorityLevel): void;
+    /** Get queue lengths */
+    getStats(): {
+        fast: number;
+        normal: number;
+        batch: number;
+        total: number;
+        active: Record<string, {
+            fast: number;
+            normal: number;
+            batch: number;
+        }>;
+    };
+    /** Drain all requests (for shutdown) */
+    drain(): PriorityRequest[];
+    /** Determine effective priority for a request (auto-upgrade/downgrade) */
+    static resolvePriority(requested: PriorityLevel, provider: string, supportedProviders: string[]): PriorityLevel;
+    private canRun;
+    private incrementActive;
+}
+/**
+ * Tracks per-session fast mode toggle (like /fast command).
+ */
+export declare class FastModeManager {
+    private sessions;
+    /** Toggle fast mode for a session, returns new state */
+    toggle(sessionId: string): boolean;
+    /** Set fast mode explicitly */
+    set(sessionId: string, enabled: boolean): void;
+    /** Check if session has fast mode enabled */
+    isEnabled(sessionId: string): boolean;
+    /** Get priority level for a session */
+    getPriority(sessionId: string): PriorityLevel;
+    /** Clear all state */
+    reset(): void;
+}
+//# sourceMappingURL=priority-queue.d.ts.map

package/dist/core/priority-queue.d.ts.map

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