@cicctencent/agent-core 0.1.6 → 0.1.8

package/dist/esm/middleware/timing.js

@@ -0,0 +1,58 @@
+// ============================================================
+// TimingMiddleware — 执行耗时统计中间件
+// ============================================================
+/**
+ * 统计每轮迭代和每次工具调用的耗时
+ * 可通过 onReport 回调获取汇总数据（如写入监控）
+ */
+export class TimingMiddleware {
+    name = 'timing';
+    iterStarts = new Map();
+    toolTimings = new Map();
+    onReport;
+    constructor(onReport) {
+        this.onReport = onReport;
+    }
+    async before(ctx) {
+        this.iterStarts.set(ctx.sessionId, Date.now());
+    }
+    async after(ctx) {
+        const start = this.iterStarts.get(ctx.sessionId);
+        const elapsed = start ? Date.now() - start : -1;
+        this.iterStarts.delete(ctx.sessionId);
+        if (this.onReport) {
+            this.onReport({
+                type: 'iteration',
+                sessionId: ctx.sessionId,
+                iteration: ctx.iteration,
+                elapsedMs: elapsed,
+            });
+        }
+        else {
+            console.log(`[Timing] Session=${ctx.sessionId} Iter=${ctx.iteration} elapsed=${elapsed}ms`);
+        }
+    }
+    async onToolBefore(ctx) {
+        const key = `${ctx.tool}_${Date.now()}`;
+        this.toolTimings.set(key, { name: ctx.tool || 'unknown', start: Date.now() });
+        ctx._timingKey = key;
+    }
+    async onToolAfter(ctx) {
+        const key = ctx._timingKey;
+        const timing = key ? this.toolTimings.get(key) : undefined;
+        const elapsed = timing ? Date.now() - timing.start : -1;
+        if (key)
+            this.toolTimings.delete(key);
+        if (this.onReport) {
+            this.onReport({
+                type: 'tool',
+                toolName: ctx.tool,
+                elapsedMs: elapsed,
+            });
+        }
+        else {
+            console.log(`[Timing] Tool=${ctx.tool} elapsed=${elapsed}ms`);
+        }
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/esm/middleware/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../src/middleware/timing.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+BAA+B;AAC/B,+DAA+D;AAkB/D;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC3B,IAAI,GAAG,QAAQ,CAAC;IAER,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,QAAQ,CAAkC;IAElD,YAAY,QAAyC;QACnD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAsB;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAsB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEtC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC;gBACZ,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,SAAS,SAAS,GAAG,CAAC,SAAS,YAAY,OAAO,IAAI,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAgB;QACjC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7E,GAAW,CAAC,UAAU,GAAG,GAAG,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAgB;QAChC,MAAM,GAAG,GAAI,GAAW,CAAC,UAAoB,CAAC;QAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,GAAG;YAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC;gBACZ,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,GAAG,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,IAAI,YAAY,OAAO,IAAI,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF"}

package/dist/esm/middleware/tool-guard.d.ts

@@ -0,0 +1,15 @@
+import type { Middleware } from '../middleware/types.ts';
+import type { HookContext, HookResult } from '../hooks/types.ts';
+/**
+ * 工具调用守卫：对指定工具进行拦截
+ * - 可配置需要拦截的工具名列表
+ * - 匹配时 onToolBefore 返回 block，阻止工具执行
+ */
+export declare class ToolGuardMiddleware implements Middleware {
+    name: string;
+    private blockedTools;
+    private logger;
+    constructor(blockedTools: string[], logger?: (msg: string) => void);
+    onToolBefore(ctx: HookContext): Promise<HookResult | void>;
+}
+//# sourceMappingURL=tool-guard.d.ts.map

package/dist/esm/middleware/tool-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-guard.d.ts","sourceRoot":"","sources":["../../../src/middleware/tool-guard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IACpD,IAAI,SAAgB;IAEpB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,MAAM,CAAwB;gBAE1B,YAAY,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAK5D,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CASjE"}

package/dist/esm/middleware/tool-guard.js

@@ -0,0 +1,27 @@
+// ============================================================
+// ToolGuardMiddleware — 工具安全守卫中间件
+// ============================================================
+/**
+ * 工具调用守卫：对指定工具进行拦截
+ * - 可配置需要拦截的工具名列表
+ * - 匹配时 onToolBefore 返回 block，阻止工具执行
+ */
+export class ToolGuardMiddleware {
+    name = 'tool-guard';
+    blockedTools;
+    logger;
+    constructor(blockedTools, logger) {
+        this.blockedTools = new Set(blockedTools);
+        this.logger = logger || ((msg) => console.warn(`[ToolGuard] ${msg}`));
+    }
+    async onToolBefore(ctx) {
+        if (ctx.tool && this.blockedTools.has(ctx.tool)) {
+            this.logger(`BLOCKED tool call: ${ctx.tool}`);
+            return {
+                block: true,
+                reason: `Tool "${ctx.tool}" is blocked by ToolGuard middleware`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=tool-guard.js.map

package/dist/esm/middleware/tool-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-guard.js","sourceRoot":"","sources":["../../../src/middleware/tool-guard.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kCAAkC;AAClC,+DAA+D;AAK/D;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAC9B,IAAI,GAAG,YAAY,CAAC;IAEZ,YAAY,CAAc;IAC1B,MAAM,CAAwB;IAEtC,YAAY,YAAsB,EAAE,MAA8B;QAChE,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAgB;QACjC,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,sBAAsB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,SAAS,GAAG,CAAC,IAAI,sCAAsC;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/observability/logger.d.ts

@@ -0,0 +1,16 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface ObservabilityEvent {
+    ts?: number;
+    level?: LogLevel;
+    event: string;
+    traceId?: string;
+    sessionId?: string;
+    data?: Record<string, unknown>;
+}
+/** 日志传输层接口 */
+export type LogTransport = (payload: Required<Pick<ObservabilityEvent, 'ts' | 'level'>> & ObservabilityEvent) => void;
+/** 设置自定义日志传输层 */
+export declare function setLogTransport(transport: LogTransport): void;
+/** 记录可观测性事件 */
+export declare function logEvent(input: ObservabilityEvent): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/esm/observability/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/observability/logger.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,cAAc;AACd,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,kBAAkB,KAAK,IAAI,CAAC;AAYtH,iBAAiB;AACjB,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAE7D;AAED,eAAe;AACf,wBAAgB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAUxD"}

package/dist/esm/observability/logger.js

@@ -0,0 +1,31 @@
+// ============================================================
+// Observability — 结构化可观测性日志
+// ============================================================
+/** 默认传输：console 输出 */
+const defaultTransport = (payload) => {
+    const line = `[obs] ${JSON.stringify(payload)}`;
+    if (payload.level === 'error')
+        console.error(line);
+    else if (payload.level === 'warn')
+        console.warn(line);
+    else
+        console.log(line);
+};
+let _transport = defaultTransport;
+/** 设置自定义日志传输层 */
+export function setLogTransport(transport) {
+    _transport = transport;
+}
+/** 记录可观测性事件 */
+export function logEvent(input) {
+    const payload = {
+        ts: input.ts || Date.now(),
+        level: input.level || 'info',
+        event: input.event,
+        traceId: input.traceId,
+        sessionId: input.sessionId,
+        data: input.data || {},
+    };
+    _transport(payload);
+}
+//# sourceMappingURL=logger.js.map

package/dist/esm/observability/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,4BAA4B;AAC5B,+DAA+D;AAgB/D,sBAAsB;AACtB,MAAM,gBAAgB,GAAiB,CAAC,OAAO,EAAE,EAAE;IACjD,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC9C,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;QACjD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,IAAI,UAAU,GAAiB,gBAAgB,CAAC;AAEhD,iBAAiB;AACjB,MAAM,UAAU,eAAe,CAAC,SAAuB;IACrD,UAAU,GAAG,SAAS,CAAC;AACzB,CAAC;AAED,eAAe;AACf,MAAM,UAAU,QAAQ,CAAC,KAAyB;IAChD,MAAM,OAAO,GAAG;QACd,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;KACvB,CAAC;IACF,UAAU,CAAC,OAAO,CAAC,CAAC;AACtB,CAAC"}

package/dist/esm/pool/engine-pool.d.ts

@@ -0,0 +1,22 @@
+import type { AgentEngine } from '../agent/engine.ts';
+/** AgentEngine 实例复用池 */
+export declare class EnginePool {
+    private pool;
+    private readonly ttl;
+    private readonly maxSize;
+    constructor(ttlMs?: number, maxSize?: number);
+    /** 生成缓存 key */
+    static key(profileId?: number | string, scopeKey?: string): string;
+    /** 从池中获取 Engine（未命中或过期返回 null） */
+    get(profileId?: number | string, scopeKey?: string): AgentEngine | null;
+    /** 将 Engine 放入池中 */
+    set(profileId: number | string | undefined, engine: AgentEngine, scopeKey?: string): void;
+    /** 清除所有缓存（配置变更时调用） */
+    clear(): void;
+    /** 仅清除过期的实例 */
+    purgeExpired(): void;
+    /** 池大小 */
+    get size(): number;
+    private evictOldest;
+}
+//# sourceMappingURL=engine-pool.d.ts.map

package/dist/esm/pool/engine-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-pool.d.ts","sourceRoot":"","sources":["../../../src/pool/engine-pool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtD,wBAAwB;AACxB,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,KAAK,GAAE,MAAmB,EAAE,OAAO,GAAE,MAAW;IAK5D,eAAe;IACf,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlE,kCAAkC;IAClC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAcvE,oBAAoB;IACpB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAazF,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAOb,eAAe;IACf,YAAY,IAAI,IAAI;IAUpB,UAAU;IACV,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,WAAW;CAQpB"}

package/dist/esm/pool/engine-pool.js

@@ -0,0 +1,71 @@
+// ============================================================
+// EnginePool — AgentEngine 实例复用池
+// ============================================================
+/** AgentEngine 实例复用池 */
+export class EnginePool {
+    pool = new Map();
+    ttl;
+    maxSize;
+    constructor(ttlMs = 5 * 60_000, maxSize = 10) {
+        this.ttl = ttlMs;
+        this.maxSize = maxSize;
+    }
+    /** 生成缓存 key */
+    static key(profileId, scopeKey) {
+        return `${profileId ?? '_'}:${scopeKey || '_'}`;
+    }
+    /** 从池中获取 Engine（未命中或过期返回 null） */
+    get(profileId, scopeKey) {
+        const key = EnginePool.key(profileId, scopeKey);
+        const entry = this.pool.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() - entry.createdAt > this.ttl) {
+            entry.engine.destroy();
+            this.pool.delete(key);
+            return null;
+        }
+        return entry.engine;
+    }
+    /** 将 Engine 放入池中 */
+    set(profileId, engine, scopeKey) {
+        const key = EnginePool.key(profileId, scopeKey);
+        const old = this.pool.get(key);
+        if (old)
+            old.engine.destroy();
+        if (this.pool.size >= this.maxSize && !this.pool.has(key)) {
+            this.evictOldest();
+        }
+        this.pool.set(key, { engine, createdAt: Date.now() });
+    }
+    /** 清除所有缓存（配置变更时调用） */
+    clear() {
+        for (const entry of this.pool.values()) {
+            entry.engine.destroy();
+        }
+        this.pool.clear();
+    }
+    /** 仅清除过期的实例 */
+    purgeExpired() {
+        const now = Date.now();
+        for (const [key, entry] of this.pool) {
+            if (now - entry.createdAt > this.ttl) {
+                entry.engine.destroy();
+                this.pool.delete(key);
+            }
+        }
+    }
+    /** 池大小 */
+    get size() {
+        return this.pool.size;
+    }
+    evictOldest() {
+        const oldestKey = this.pool.keys().next().value;
+        if (oldestKey !== undefined) {
+            const entry = this.pool.get(oldestKey);
+            entry?.engine.destroy();
+            this.pool.delete(oldestKey);
+        }
+    }
+}
+//# sourceMappingURL=engine-pool.js.map

package/dist/esm/pool/engine-pool.js.map

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

package/dist/esm/runtime/run-registry.d.ts

@@ -0,0 +1,104 @@
+import type { WorkflowCheckpoint } from '../agent/workflow.ts';
+/** 单条事件 */
+export interface BufferedEvent {
+    event: string;
+    data: any;
+}
+/** 工具调用记录（用于重连时恢复 UI 状态） */
+export interface RunToolCallRecord {
+    toolCallId: string;
+    toolName: string;
+    displayName?: string;
+    input?: Record<string, any>;
+    output?: any;
+    error?: string;
+    duration?: number;
+    status: 'running' | 'success' | 'error';
+}
+/** 事件订阅回调 */
+export type EventSubscriber = (evt: BufferedEvent) => void;
+/** Agent 运行状态 */
+export type RunStatus = 'running' | 'done' | 'error';
+/** 活跃运行记录 */
+export interface ActiveRun {
+    threadId: number | string;
+    sessionId: string;
+    traceId?: string;
+    status: RunStatus;
+    eventBuffer: BufferedEvent[];
+    fullContent: string;
+    reasoningText: string;
+    toolCalls: RunToolCallRecord[];
+    widgets: Array<{
+        widgetId: string;
+        html: string;
+        title: string;
+        height?: number;
+    }>;
+    artifacts: Array<{
+        artifactId: string;
+        filename: string;
+        mimeType: string;
+        size: number;
+        url: string;
+        description?: string;
+    }>;
+    checkpoints: WorkflowCheckpoint[];
+    stepCount: number;
+    toolCallCount: number;
+    error?: string;
+    messageId?: number | string;
+    subscribers: Set<EventSubscriber>;
+    createdAt: number;
+    lastFlushAt: number;
+    lastFailedStage?: string;
+    /** 扩展字段（上层可附加任意数据） */
+    meta?: Record<string, unknown>;
+}
+/** 可跨进程读取的运行态快照（不包含实时订阅者） */
+export type RunSnapshot = Omit<ActiveRun, 'subscribers'> & {
+    updatedAt: number;
+};
+/** 运行态持久化存储接口（上层实现） */
+export interface RunStateStore {
+    list(): RunSnapshot[];
+    upsert(snapshot: RunSnapshot): void;
+    remove(threadId: number | string): void;
+}
+/** 内存实现（默认） */
+export declare class InMemoryRunStateStore implements RunStateStore {
+    private snapshots;
+    list(): RunSnapshot[];
+    upsert(snapshot: RunSnapshot): void;
+    remove(threadId: number | string): void;
+}
+export declare class RunRegistry {
+    private runs;
+    private runStateStore;
+    private cleanupTimer;
+    constructor(store?: RunStateStore);
+    /** 注册一个新的运行 */
+    startRun(threadId: number | string, sessionId: string, traceId?: string): ActiveRun;
+    getRun(threadId: number | string): ActiveRun | null;
+    hasActiveRun(threadId: number | string): boolean;
+    /** 添加事件到缓冲区并通知所有订阅者 */
+    addEvent(threadId: number | string, event: string, data: any): void;
+    finishRun(threadId: number | string, status: 'done' | 'error', error?: string): void;
+    setStepCount(threadId: number | string, count: number): void;
+    setMessageId(threadId: number | string, messageId: number | string): void;
+    subscribe(threadId: number | string, callback: EventSubscriber): () => void;
+    getBufferedEvents(threadId: number | string): BufferedEvent[];
+    getRunSnapshot(threadId: number | string): RunSnapshot | null;
+    listRunSnapshots(): RunSnapshot[];
+    getFailedCheckpoint(threadId: number | string): WorkflowCheckpoint | null;
+    setLastFailedStage(threadId: number | string, stageId: string): void;
+    removeRun(threadId: number | string): void;
+    getActiveThreadIds(): (number | string)[];
+    destroy(): void;
+    private upsertCheckpoint;
+    private notifySubscribers;
+    private toSnapshot;
+    private persistRun;
+    private startCleanup;
+}
+//# sourceMappingURL=run-registry.d.ts.map

package/dist/esm/runtime/run-registry.d.ts.map

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

package/dist/esm/runtime/run-registry.js

@@ -0,0 +1,256 @@
+// ============================================================
+// RunRegistry — Agent 运行会话注册表
+// 解耦 Engine 执行与传输层，支持事件缓冲、订阅和断线重连
+// ============================================================
+import { logEvent } from "../observability/logger.js";
+/** 内存实现（默认） */
+export class InMemoryRunStateStore {
+    snapshots = [];
+    list() {
+        return [...this.snapshots];
+    }
+    upsert(snapshot) {
+        this.snapshots = this.snapshots
+            .filter(item => item.threadId !== snapshot.threadId)
+            .concat(snapshot)
+            .sort((a, b) => b.updatedAt - a.updatedAt)
+            .slice(0, 200);
+    }
+    remove(threadId) {
+        this.snapshots = this.snapshots.filter(item => item.threadId !== threadId);
+    }
+}
+// ---- 配置 ----
+const CLEANUP_MAX_AGE = 30 * 60 * 1000;
+const CLEANUP_INTERVAL = 5 * 60 * 1000;
+export class RunRegistry {
+    runs = new Map();
+    runStateStore;
+    cleanupTimer = null;
+    constructor(store) {
+        this.runStateStore = store || new InMemoryRunStateStore();
+        this.startCleanup();
+    }
+    /** 注册一个新的运行 */
+    startRun(threadId, sessionId, traceId) {
+        const existing = this.runs.get(threadId);
+        if (existing && existing.status === 'running') {
+            existing.status = 'error';
+            existing.error = 'Superseded by new run';
+            this.notifySubscribers(existing, { event: 'error', data: { error: '被新的对话覆盖' } });
+            this.persistRun(existing);
+        }
+        const run = {
+            threadId,
+            sessionId,
+            traceId,
+            status: 'running',
+            eventBuffer: [],
+            fullContent: '',
+            reasoningText: '',
+            toolCalls: [],
+            widgets: [],
+            artifacts: [],
+            checkpoints: [],
+            stepCount: 0,
+            toolCallCount: 0,
+            subscribers: new Set(),
+            createdAt: Date.now(),
+            lastFlushAt: Date.now(),
+        };
+        this.runs.set(threadId, run);
+        this.persistRun(run);
+        logEvent({ event: 'run.start', sessionId, data: { threadId } });
+        return run;
+    }
+    getRun(threadId) {
+        return this.runs.get(threadId) || null;
+    }
+    hasActiveRun(threadId) {
+        const run = this.runs.get(threadId);
+        return !!run && run.status === 'running';
+    }
+    /** 添加事件到缓冲区并通知所有订阅者 */
+    addEvent(threadId, event, data) {
+        const run = this.runs.get(threadId);
+        if (!run)
+            return;
+        const buffered = { event, data };
+        run.eventBuffer.push(buffered);
+        switch (event) {
+            case 'content':
+                run.fullContent += (typeof data === 'string' ? data : '');
+                break;
+            case 'reasoning':
+                run.reasoningText += (typeof data === 'string' ? data : '');
+                break;
+            case 'tool-call':
+                run.toolCallCount++;
+                run.toolCalls.push({
+                    toolCallId: data.toolCallId,
+                    toolName: data.toolName,
+                    displayName: data.displayName,
+                    input: data.input,
+                    status: 'running',
+                });
+                break;
+            case 'tool-result': {
+                const tc = run.toolCalls.find(t => t.toolCallId === data.toolCallId);
+                if (tc) {
+                    tc.status = data.error ? 'error' : 'success';
+                    tc.output = data.output;
+                    tc.error = data.error;
+                    tc.duration = data.duration;
+                }
+                break;
+            }
+            case 'sub-agent':
+                if (data?.eventType === 'checkpoint' && data?.data) {
+                    this.upsertCheckpoint(run, data.data);
+                    if (data.data.status === 'failed') {
+                        run.lastFailedStage = data.data.id;
+                    }
+                }
+                break;
+        }
+        this.persistRun(run);
+        this.notifySubscribers(run, buffered);
+    }
+    finishRun(threadId, status, error) {
+        const run = this.runs.get(threadId);
+        if (!run)
+            return;
+        run.status = status;
+        if (error)
+            run.error = error;
+        this.persistRun(run);
+        logEvent({
+            event: 'run.finish',
+            level: status === 'error' ? 'error' : 'info',
+            traceId: run.traceId,
+            sessionId: run.sessionId,
+            data: { threadId, status, error },
+        });
+        if (status === 'error' && error) {
+            this.notifySubscribers(run, { event: 'error', data: { error } });
+        }
+    }
+    setStepCount(threadId, count) {
+        const run = this.runs.get(threadId);
+        if (run) {
+            run.stepCount = count;
+            this.persistRun(run);
+        }
+    }
+    setMessageId(threadId, messageId) {
+        const run = this.runs.get(threadId);
+        if (run) {
+            run.messageId = messageId;
+            this.persistRun(run);
+        }
+    }
+    subscribe(threadId, callback) {
+        const run = this.runs.get(threadId);
+        if (!run)
+            return () => { };
+        run.subscribers.add(callback);
+        return () => { run.subscribers.delete(callback); };
+    }
+    getBufferedEvents(threadId) {
+        const run = this.runs.get(threadId);
+        return run ? [...run.eventBuffer] : [];
+    }
+    getRunSnapshot(threadId) {
+        const run = this.runs.get(threadId);
+        if (run)
+            return this.toSnapshot(run);
+        return this.runStateStore.list().find(item => item.threadId === threadId) || null;
+    }
+    listRunSnapshots() {
+        const merged = new Map();
+        for (const snapshot of this.runStateStore.list())
+            merged.set(snapshot.threadId, snapshot);
+        for (const [threadId, run] of this.runs)
+            merged.set(threadId, this.toSnapshot(run));
+        return [...merged.values()].sort((a, b) => b.updatedAt - a.updatedAt);
+    }
+    getFailedCheckpoint(threadId) {
+        const run = this.runs.get(threadId);
+        const checkpoints = run?.checkpoints || this.getRunSnapshot(threadId)?.checkpoints || [];
+        const failed = checkpoints.filter(c => c.status === 'failed');
+        return failed.length > 0 ? failed[failed.length - 1] : null;
+    }
+    setLastFailedStage(threadId, stageId) {
+        const run = this.runs.get(threadId);
+        if (run) {
+            run.lastFailedStage = stageId;
+            this.persistRun(run);
+        }
+    }
+    removeRun(threadId) {
+        const run = this.runs.get(threadId);
+        if (run) {
+            run.subscribers.clear();
+            this.runs.delete(threadId);
+        }
+        this.runStateStore.remove(threadId);
+    }
+    getActiveThreadIds() {
+        const ids = [];
+        for (const [threadId, run] of this.runs) {
+            if (run.status === 'running')
+                ids.push(threadId);
+        }
+        return ids;
+    }
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        for (const [threadId] of this.runs) {
+            this.removeRun(threadId);
+        }
+    }
+    // ---- 内部方法 ----
+    upsertCheckpoint(run, checkpoint) {
+        const idx = run.checkpoints.findIndex(item => item.id === checkpoint.id);
+        if (idx >= 0) {
+            run.checkpoints[idx] = checkpoint;
+        }
+        else {
+            run.checkpoints.push(checkpoint);
+        }
+    }
+    notifySubscribers(run, evt) {
+        for (const sub of run.subscribers) {
+            try {
+                sub(evt);
+            }
+            catch { /* 订阅者异常不影响其他订阅者 */ }
+        }
+    }
+    toSnapshot(run) {
+        const { subscribers: _subscribers, ...serializable } = run;
+        return { ...serializable, updatedAt: Date.now() };
+    }
+    persistRun(run) {
+        this.runStateStore.upsert(this.toSnapshot(run));
+    }
+    startCleanup() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            const now = Date.now();
+            for (const [threadId, run] of this.runs) {
+                if (run.status !== 'running' && (now - run.createdAt) > CLEANUP_MAX_AGE) {
+                    this.removeRun(threadId);
+                }
+            }
+        }, CLEANUP_INTERVAL);
+        if (this.cleanupTimer && typeof this.cleanupTimer === 'object' && 'unref' in this.cleanupTimer) {
+            this.cleanupTimer.unref();
+        }
+    }
+}
+//# sourceMappingURL=run-registry.js.map