@toyako/hive 1.0.0

package/dist/runtime/v2/provider/ProviderRegistry.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Provider Plugin System — Phase 3
+ *
+ * 供应商无关的模型接入系统
+ *
+ * 铁律：
+ * 1. 所有模型接入必须作为独立插件或扩展实现
+ * 2. 绝对不能在 Runtime Core 核心代码里硬编码任何厂商的特定 API 逻辑
+ * 3. 严格遵守架构冻结规则（第4条：供应商无关原则）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalProviderRegistry = exports.ProviderRegistry = exports.ProviderCapability = exports.ProviderType = void 0;
+// Provider 类型
+var ProviderType;
+(function (ProviderType) {
+    ProviderType["OPENAI"] = "openai";
+    ProviderType["ANTHROPIC"] = "anthropic";
+    ProviderType["GOOGLE"] = "google";
+    ProviderType["OPENROUTER"] = "openrouter";
+    ProviderType["MIMO"] = "mimo";
+    ProviderType["CUSTOM"] = "custom";
+})(ProviderType || (exports.ProviderType = ProviderType = {}));
+// Provider 能力
+var ProviderCapability;
+(function (ProviderCapability) {
+    ProviderCapability["CHAT"] = "chat";
+    ProviderCapability["COMPLETION"] = "completion";
+    ProviderCapability["EMBEDDING"] = "embedding";
+    ProviderCapability["VISION"] = "vision";
+    ProviderCapability["FUNCTION_CALLING"] = "function_calling";
+    ProviderCapability["STREAMING"] = "streaming";
+})(ProviderCapability || (exports.ProviderCapability = ProviderCapability = {}));
+/**
+ * Provider Registry — 供应商无关的插件注册表
+ */
+class ProviderRegistry {
+    providers = new Map();
+    registrations = new Map();
+    /**
+     * 注册 Provider 插件
+     */
+    register(registration) {
+        this.registrations.set(registration.name, registration);
+        console.log(`[Provider] Registered: ${registration.name} (${registration.type})`);
+    }
+    /**
+     * 创建 Provider 实例
+     */
+    createProvider(name, config) {
+        const registration = this.registrations.get(name);
+        if (!registration) {
+            console.error(`[Provider] Not found: ${name}`);
+            return null;
+        }
+        const fullConfig = {
+            ...registration.defaultConfig,
+            ...config,
+            type: registration.type,
+            name: name
+        };
+        const provider = registration.factory(fullConfig);
+        this.providers.set(name, provider);
+        return provider;
+    }
+    /**
+     * 获取 Provider 实例
+     */
+    getProvider(name) {
+        return this.providers.get(name);
+    }
+    /**
+     * 按能力查找 Provider（搜索活跃实例）
+     */
+    findProvidersByCapability(capability) {
+        const result = [];
+        for (const [name, provider] of this.providers) {
+            if (provider.capabilities.includes(capability)) {
+                result.push(provider);
+            }
+        }
+        return result;
+    }
+    /**
+     * 按能力查找注册信息
+     */
+    findRegistrationsByCapability(capability) {
+        return Array.from(this.registrations.values())
+            .filter(reg => reg.capabilities.includes(capability));
+    }
+    /**
+     * 获取所有注册的 Provider
+     */
+    getRegistrations() {
+        return Array.from(this.registrations.values());
+    }
+    /**
+     * 获取所有活跃的 Provider
+     */
+    getActiveProviders() {
+        return Array.from(this.providers.values());
+    }
+    /**
+     * 初始化所有 Provider
+     */
+    async initializeAll() {
+        for (const [name, provider] of this.providers) {
+            try {
+                await provider.initialize();
+                console.log(`[Provider] Initialized: ${name}`);
+            }
+            catch (error) {
+                console.error(`[Provider] Failed to initialize ${name}:`, error);
+            }
+        }
+    }
+    /**
+     * 健康检查所有 Provider
+     */
+    async healthCheckAll() {
+        const results = new Map();
+        for (const [name, provider] of this.providers) {
+            try {
+                const healthy = await provider.healthCheck();
+                results.set(name, healthy);
+            }
+            catch (error) {
+                results.set(name, false);
+            }
+        }
+        return results;
+    }
+    /**
+     * 关闭所有 Provider
+     */
+    async closeAll() {
+        for (const [name, provider] of this.providers) {
+            try {
+                if (provider.close) {
+                    await provider.close();
+                }
+                console.log(`[Provider] Closed: ${name}`);
+            }
+            catch (error) {
+                console.error(`[Provider] Failed to close ${name}:`, error);
+            }
+        }
+        this.providers.clear();
+    }
+}
+exports.ProviderRegistry = ProviderRegistry;
+// 全局 Provider 注册表
+exports.globalProviderRegistry = new ProviderRegistry();
+//# sourceMappingURL=ProviderRegistry.js.map

package/dist/runtime/v2/provider/ProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRegistry.js","sourceRoot":"","sources":["../../../../src/runtime/v2/provider/ProviderRegistry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,cAAc;AACd,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;IACjB,yCAAyB,CAAA;IACzB,6BAAa,CAAA;IACb,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB;AAeD,cAAc;AACd,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,+CAAyB,CAAA;IACzB,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;IACjB,2DAAqC,CAAA;IACrC,6CAAuB,CAAA;AACzB,CAAC,EAPW,kBAAkB,kCAAlB,kBAAkB,QAO7B;AAsFD;;GAEG;AACH,MAAa,gBAAgB;IACnB,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;IAC7C,aAAa,GAAsC,IAAI,GAAG,EAAE,CAAC;IAErE;;OAEG;IACH,QAAQ,CAAC,YAAkC;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,0BAA0B,YAAY,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,IAAY,EAAE,MAA+B;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAmB;YACjC,GAAG,YAAY,CAAC,aAAa;YAC7B,GAAG,MAAM;YACT,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,IAAI,EAAE,IAAI;SACO,CAAC;QAEpB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,yBAAyB,CAAC,UAA8B;QACtD,MAAM,MAAM,GAAe,EAAE,CAAC;QAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,6BAA6B,CAAC,UAA8B;QAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aAC3C,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;QAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACnB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACzB,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AA/HD,4CA+HC;AAED,kBAAkB;AACL,QAAA,sBAAsB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/runtime/v2/queue/RuntimeQueue.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Queue — Phase 1
+ *
+ * 运行时队列
+ *
+ * 所有任务通过 Queue 进入 Runtime
+ *
+ * 支持:
+ * - Priority
+ * - Delay
+ * - Retry
+ * - Cancellation
+ * - Dependency
+ * - Checkpoint Waiting
+ */
+import { TaskContract, TaskPriority } from "../intent/TaskContract";
+import { RuntimeState } from "../state-machine/RuntimeStateMachine";
+export interface QueueItem {
+    task: TaskContract;
+    state: RuntimeState;
+    priority: TaskPriority;
+    enqueuedAt: number;
+    scheduledAt?: number;
+    delay?: number;
+    dependencies?: string[];
+    checkpointWaiting?: boolean;
+}
+export declare class RuntimeQueue {
+    private queue;
+    private processing;
+    private completedTaskIds;
+    private completedOrder;
+    private maxSize;
+    private maxCompletedIds;
+    constructor(maxSize?: number, maxCompletedIds?: number);
+    /**
+     * 将任务加入队列
+     */
+    enqueue(task: TaskContract, options?: {
+        delay?: number;
+        dependencies?: string[];
+    }): boolean;
+    /**
+     * 从队列取出下一个任务
+     */
+    dequeue(): QueueItem | null;
+    /**
+     * 完成任务处理
+     */
+    complete(taskId: string): boolean;
+    /**
+     * 取消任务
+     */
+    cancel(taskId: string): boolean;
+    /**
+     * 延迟任务
+     */
+    delay(taskId: string, delayMs: number): boolean;
+    /**
+     * 设置检查点等待
+     */
+    setCheckpointWaiting(taskId: string, waiting: boolean): boolean;
+    /**
+     * 获取队列状态
+     */
+    getStatus(): {
+        queue: number;
+        processing: number;
+        total: number;
+    };
+    /**
+     * 获取队列中的任务
+     */
+    getQueuedTasks(): QueueItem[];
+    /**
+     * 获取处理中的任务
+     */
+    getProcessingTasks(): QueueItem[];
+    /**
+     * 检查任务是否在队列中
+     */
+    isQueued(taskId: string): boolean;
+    /**
+     * 检查任务是否在处理中
+     */
+    isProcessing(taskId: string): boolean;
+    /**
+     * 清空队列
+     */
+    clear(): void;
+    /**
+     * 获取队列大小
+     */
+    get size(): number;
+    /**
+     * 获取处理中任务数量
+     */
+    get processingSize(): number;
+    /**
+     * 检查队列是否为空
+     */
+    get isEmpty(): boolean;
+    /**
+     * 检查队列是否已满
+     */
+    get isFull(): boolean;
+    /**
+     * 标记任务为已完成（用于外部依赖追踪）
+     * 不要求任务在 processing 中
+     */
+    markCompleted(taskId: string): void;
+    /**
+     * 检查一组依赖是否全部满足
+     */
+    areDependenciesMet(dependencies: string[]): boolean;
+    /**
+     * 获取因依赖未满足而阻塞的任务数
+     */
+    getBlockedByDependencyCount(): number;
+    /**
+     * 获取已知完成的任务数
+     */
+    get completedCount(): number;
+    /**
+     * 添加到已完成集合，超出上限时 FIFO 驱逐最旧的条目
+     */
+    private addToCompleted;
+}
+//# sourceMappingURL=RuntimeQueue.d.ts.map

package/dist/runtime/v2/queue/RuntimeQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeQueue.d.ts","sourceRoot":"","sources":["../../../../src/runtime/v2/queue/RuntimeQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,GAAE,MAAa,EAAE,eAAe,GAAE,MAAa;IAKlE;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,OAAO;IA2B/F;;OAEG;IACH,OAAO,IAAI,SAAS,GAAG,IAAI;IA4B3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKjC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAY/B;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAY/C;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAS/D;;OAEG;IACH,SAAS,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAQjE;;OAEG;IACH,cAAc,IAAI,SAAS,EAAE;IAI7B;;OAEG;IACH,kBAAkB,IAAI,SAAS,EAAE;IAIjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO;IAInD;;OAEG;IACH,2BAA2B,IAAI,MAAM;IAOrC;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;CAavB"}

package/dist/runtime/v2/queue/RuntimeQueue.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * Queue — Phase 1
+ *
+ * 运行时队列
+ *
+ * 所有任务通过 Queue 进入 Runtime
+ *
+ * 支持:
+ * - Priority
+ * - Delay
+ * - Retry
+ * - Cancellation
+ * - Dependency
+ * - Checkpoint Waiting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuntimeQueue = void 0;
+const RuntimeStateMachine_1 = require("../state-machine/RuntimeStateMachine");
+class RuntimeQueue {
+    queue = [];
+    processing = new Map();
+    completedTaskIds = new Set();
+    completedOrder = []; // FIFO eviction order
+    maxSize;
+    maxCompletedIds;
+    constructor(maxSize = 1000, maxCompletedIds = 5000) {
+        this.maxSize = maxSize;
+        this.maxCompletedIds = maxCompletedIds;
+    }
+    /**
+     * 将任务加入队列
+     */
+    enqueue(task, options = {}) {
+        if (this.queue.length >= this.maxSize) {
+            return false;
+        }
+        const item = {
+            task,
+            state: RuntimeStateMachine_1.RuntimeState.QUEUED,
+            priority: task.priority,
+            enqueuedAt: Date.now(),
+            scheduledAt: options.delay ? Date.now() + options.delay : undefined,
+            delay: options.delay,
+            dependencies: options.dependencies,
+            checkpointWaiting: false
+        };
+        // 按优先级插入
+        const insertIndex = this.queue.findIndex(i => i.priority < item.priority);
+        if (insertIndex === -1) {
+            this.queue.push(item);
+        }
+        else {
+            this.queue.splice(insertIndex, 0, item);
+        }
+        return true;
+    }
+    /**
+     * 从队列取出下一个任务
+     */
+    dequeue() {
+        const now = Date.now();
+        // 找到第一个可以执行的任务
+        const index = this.queue.findIndex(item => {
+            // 检查延迟
+            if (item.scheduledAt && item.scheduledAt > now)
+                return false;
+            // 检查依赖 — 所有依赖必须已完成
+            if (item.dependencies && item.dependencies.length > 0) {
+                const allMet = item.dependencies.every(depId => this.completedTaskIds.has(depId));
+                if (!allMet)
+                    return false;
+            }
+            // 检查检查点等待
+            if (item.checkpointWaiting)
+                return false;
+            return true;
+        });
+        if (index === -1)
+            return null;
+        const item = this.queue.splice(index, 1)[0];
+        this.processing.set(item.task.id, item);
+        return item;
+    }
+    /**
+     * 完成任务处理
+     */
+    complete(taskId) {
+        this.addToCompleted(taskId);
+        return this.processing.delete(taskId);
+    }
+    /**
+     * 取消任务
+     */
+    cancel(taskId) {
+        // 从队列中移除
+        const queueIndex = this.queue.findIndex(item => item.task.id === taskId);
+        if (queueIndex !== -1) {
+            this.queue.splice(queueIndex, 1);
+            return true;
+        }
+        // 从处理中移除
+        return this.processing.delete(taskId);
+    }
+    /**
+     * 延迟任务
+     */
+    delay(taskId, delayMs) {
+        const item = this.processing.get(taskId);
+        if (!item)
+            return false;
+        item.scheduledAt = Date.now() + delayMs;
+        item.delay = delayMs;
+        this.processing.delete(taskId);
+        this.queue.push(item);
+        return true;
+    }
+    /**
+     * 设置检查点等待
+     */
+    setCheckpointWaiting(taskId, waiting) {
+        const item = this.processing.get(taskId) ||
+            this.queue.find(i => i.task.id === taskId);
+        if (!item)
+            return false;
+        item.checkpointWaiting = waiting;
+        return true;
+    }
+    /**
+     * 获取队列状态
+     */
+    getStatus() {
+        return {
+            queue: this.queue.length,
+            processing: this.processing.size,
+            total: this.queue.length + this.processing.size
+        };
+    }
+    /**
+     * 获取队列中的任务
+     */
+    getQueuedTasks() {
+        return [...this.queue];
+    }
+    /**
+     * 获取处理中的任务
+     */
+    getProcessingTasks() {
+        return Array.from(this.processing.values());
+    }
+    /**
+     * 检查任务是否在队列中
+     */
+    isQueued(taskId) {
+        return this.queue.some(item => item.task.id === taskId);
+    }
+    /**
+     * 检查任务是否在处理中
+     */
+    isProcessing(taskId) {
+        return this.processing.has(taskId);
+    }
+    /**
+     * 清空队列
+     */
+    clear() {
+        this.queue = [];
+        this.processing.clear();
+        this.completedTaskIds.clear();
+        this.completedOrder = [];
+    }
+    /**
+     * 获取队列大小
+     */
+    get size() {
+        return this.queue.length;
+    }
+    /**
+     * 获取处理中任务数量
+     */
+    get processingSize() {
+        return this.processing.size;
+    }
+    /**
+     * 检查队列是否为空
+     */
+    get isEmpty() {
+        return this.queue.length === 0;
+    }
+    /**
+     * 检查队列是否已满
+     */
+    get isFull() {
+        return this.queue.length >= this.maxSize;
+    }
+    /**
+     * 标记任务为已完成（用于外部依赖追踪）
+     * 不要求任务在 processing 中
+     */
+    markCompleted(taskId) {
+        this.addToCompleted(taskId);
+    }
+    /**
+     * 检查一组依赖是否全部满足
+     */
+    areDependenciesMet(dependencies) {
+        return dependencies.every(depId => this.completedTaskIds.has(depId));
+    }
+    /**
+     * 获取因依赖未满足而阻塞的任务数
+     */
+    getBlockedByDependencyCount() {
+        return this.queue.filter(item => item.dependencies && item.dependencies.length > 0 &&
+            !item.dependencies.every(depId => this.completedTaskIds.has(depId))).length;
+    }
+    /**
+     * 获取已知完成的任务数
+     */
+    get completedCount() {
+        return this.completedTaskIds.size;
+    }
+    /**
+     * 添加到已完成集合，超出上限时 FIFO 驱逐最旧的条目
+     */
+    addToCompleted(taskId) {
+        if (this.completedTaskIds.has(taskId))
+            return;
+        this.completedTaskIds.add(taskId);
+        this.completedOrder.push(taskId);
+        // FIFO 驱逐：超出上限时移除最旧的条目
+        while (this.completedTaskIds.size > this.maxCompletedIds) {
+            const evicted = this.completedOrder.shift();
+            if (evicted !== undefined) {
+                this.completedTaskIds.delete(evicted);
+            }
+        }
+    }
+}
+exports.RuntimeQueue = RuntimeQueue;
+//# sourceMappingURL=RuntimeQueue.js.map

package/dist/runtime/v2/queue/RuntimeQueue.js.map

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

package/dist/runtime/v2/recovery/RecoveryEngine.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Recovery Engine — Phase 1
+ *
+ * 铁律：见好就收，严禁无限套娃
+ *
+ * Recovery Engine 在执行 Rollback 或 Retry 时，
+ * 必须有严格的全局最大循环阈值（Global Loop Limit）。
+ *
+ * 一旦超过阈值或遇到未知崩溃：
+ * - 立即阻断自主循环
+ * - 状态强转为 WAITING_CHECKPOINT
+ * - 抛给人工处理
+ *
+ * 不能让系统在后台自己反复重试。
+ */
+import { RuntimeState, RuntimeStateMachine } from "../state-machine/RuntimeStateMachine";
+import { EventBus } from "../observation/EventBus";
+import { PersistenceEngine } from "../persistence/PersistenceEngine";
+export declare enum RecoveryAction {
+    RESUME = "resume",
+    REPLAY = "replay",
+    ROLLBACK = "rollback",
+    RETRY = "retry",
+    RESTART = "restart",
+    SKIP = "skip",
+    ABORT = "abort",
+    ESCALATE = "escalate"
+}
+export interface RecoveryConfig {
+    globalMaxLoops: number;
+    maxRetriesPerTask: number;
+    maxRollbackDepth: number;
+    unknownCrashPolicy: RecoveryAction;
+    escalateAfterMaxLoops: boolean;
+}
+export interface RecoveryRecord {
+    taskId: string;
+    action: RecoveryAction;
+    fromState: RuntimeState;
+    toState: RuntimeState;
+    reason: string;
+    timestamp: number;
+    loopCount: number;
+}
+export declare class RecoveryEngine {
+    private config;
+    private stateMachine;
+    private eventBus;
+    private persistence;
+    private globalLoopCount;
+    private taskLoopCounts;
+    private recoveryHistory;
+    private escalateCallbacks;
+    constructor(stateMachine: RuntimeStateMachine, config?: Partial<RecoveryConfig>, eventBus?: EventBus);
+    /**
+     * 设置持久化引擎
+     */
+    setPersistence(persistence: PersistenceEngine): void;
+    /**
+     * 注册升级回调
+     */
+    onEscalate(callback: (taskId: string, reason: string) => void): void;
+    /**
+     * 尝试恢复任务
+     *
+     * 返回恢复动作，如果返回 ESCALATE 则表示需要人工介入
+     */
+    attemptRecovery(taskId: string, error?: string): Promise<RecoveryAction>;
+    /**
+     * 决定恢复策略
+     */
+    private decideRecoveryAction;
+    /**
+     * 执行恢复动作
+     */
+    private executeRecoveryAction;
+    /**
+     * 升级到人工处理
+     *
+     * 立即阻断自主循环，状态强转为 WAITING_CHECKPOINT
+     */
+    private escalateToHuman;
+    /**
+     * 人工批准后恢复
+     */
+    approveTask(taskId: string): boolean;
+    /**
+     * 人工拒绝后中止
+     */
+    rejectTask(taskId: string, reason: string): boolean;
+    /**
+     * 获取恢复历史
+     */
+    getRecoveryHistory(taskId?: string): RecoveryRecord[];
+    /**
+     * 获取全局循环计数
+     */
+    getGlobalLoopCount(): number;
+    /**
+     * 获取任务循环计数
+     */
+    getTaskLoopCount(taskId: string): number;
+    /**
+     * 获取配置
+     */
+    getConfig(): RecoveryConfig;
+    /**
+     * 重置全局循环计数
+     */
+    resetGlobalLoopCount(): void;
+}
+//# sourceMappingURL=RecoveryEngine.d.ts.map

package/dist/runtime/v2/recovery/RecoveryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryEngine.d.ts","sourceRoot":"","sources":["../../../../src/runtime/v2/recovery/RecoveryEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAkB,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACzG,OAAO,EAAE,QAAQ,EAAoC,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAGD,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,cAAc,CAAC;IACnC,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAGD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAkC;IAGrD,OAAO,CAAC,eAAe,CAAa;IAEpC,OAAO,CAAC,cAAc,CAAkC;IAExD,OAAO,CAAC,eAAe,CAAwB;IAE/C,OAAO,CAAC,iBAAiB,CAAuD;gBAG9E,YAAY,EAAE,mBAAmB,EACjC,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,EACpC,QAAQ,GAAE,QAAyB;IAcrC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;IAIpD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIpE;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqC9E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;YACW,qBAAqB;IA2EnC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAUpC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAUnD;;OAEG;IACH,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAOrD;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,SAAS,IAAI,cAAc;IAI3B;;OAEG;IACH,oBAAoB,IAAI,IAAI;CAG7B"}