@cicctencent/agent-core 0.1.18 → 0.1.20

package/dist/cjs/middleware/workspace-notes.js

@@ -0,0 +1,53 @@
+"use strict";
+// ============================================================
+// WorkspaceNotesMiddleware — 工作空间笔记注入中间件
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceNotesMiddleware = void 0;
+/**
+ * 工作空间笔记中间件
+ *
+ * 在每轮迭代开始前读取工作空间笔记（如 agent.md），
+ * 将笔记内容注入到 system prompt 末尾，使 Agent 始终感知工作空间上下文。
+ *
+ * 笔记内容通过 `AgentConfig.basePrompt` 的动态拼接实现注入，
+ * 中间件本身不修改消息历史，仅在 before 阶段触发笔记读取。
+ */
+class WorkspaceNotesMiddleware {
+    name = 'workspace-notes';
+    noteStore;
+    basePrompt;
+    logger;
+    /** 当前注入的笔记内容缓存 */
+    cachedNote = '';
+    constructor(noteStore, basePrompt, logger) {
+        this.noteStore = noteStore;
+        this.basePrompt = basePrompt;
+        this.logger = logger || (() => { });
+    }
+    async before(ctx) {
+        // 每轮迭代重新读取笔记（用户可能在对话过程中编辑笔记）
+        try {
+            const note = await this.noteStore.read();
+            if (note !== this.cachedNote) {
+                this.cachedNote = note;
+                this.logger(`[WorkspaceNotes] Note updated (${note.length} chars) for session ${ctx.sessionId}`);
+            }
+        }
+        catch (e) {
+            this.logger(`[WorkspaceNotes] Failed to read note: ${e?.message || e}`);
+        }
+    }
+    /** 获取当前笔记内容（供外部拼接 system prompt 使用） */
+    getNoteContent() {
+        return this.cachedNote;
+    }
+    /** 获取拼接了笔记的完整 system prompt */
+    getSystemPrompt() {
+        if (!this.cachedNote.trim())
+            return this.basePrompt;
+        return `${this.basePrompt}\n\n--- Workspace Notes ---\n${this.cachedNote}`;
+    }
+}
+exports.WorkspaceNotesMiddleware = WorkspaceNotesMiddleware;
+//# sourceMappingURL=workspace-notes.js.map

package/dist/cjs/middleware/workspace-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-notes.js","sourceRoot":"","sources":["../../../src/middleware/workspace-notes.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,yCAAyC;AACzC,+DAA+D;;;AAgB/D;;;;;;;;GAQG;AACH,MAAa,wBAAwB;IACnC,IAAI,GAAG,iBAAiB,CAAC;IAEjB,SAAS,CAAY;IACrB,UAAU,CAAS;IACnB,MAAM,CAAwB;IAEtC,kBAAkB;IACV,UAAU,GAAW,EAAE,CAAC;IAEhC,YAAY,SAAoB,EAAE,UAAkB,EAAE,MAA8B;QAClF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAsB;QACjC,6BAA6B;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,IAAI,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,kCAAkC,IAAI,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;YACnG,CAAC;QACH,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,yCAAyC,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,+BAA+B;IAC/B,eAAe;QACb,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QACpD,OAAO,GAAG,IAAI,CAAC,UAAU,gCAAgC,IAAI,CAAC,UAAU,EAAE,CAAC;IAC7E,CAAC;CACF;AAvCD,4DAuCC"}

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

@@ -4,6 +4,7 @@ export interface ObservabilityEvent {
     level?: LogLevel;
     event: string;
     traceId?: string;
+    spanId?: string;
     sessionId?: string;
     data?: Record<string, unknown>;
 }

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

@@ -1 +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"}
+{"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,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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/cjs/observability/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/observability/logger.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,4BAA4B;AAC5B,+DAA+D;;AA2B/D,0CAEC;AAGD,4BAUC;AA1BD,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,SAAgB,eAAe,CAAC,SAAuB;IACrD,UAAU,GAAG,SAAS,CAAC;AACzB,CAAC;AAED,eAAe;AACf,SAAgB,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"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/observability/logger.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,4BAA4B;AAC5B,+DAA+D;;AA4B/D,0CAEC;AAGD,4BAUC;AA1BD,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,SAAgB,eAAe,CAAC,SAAuB;IACrD,UAAU,GAAG,SAAS,CAAC;AACzB,CAAC;AAED,eAAe;AACf,SAAgB,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/cjs/observability/trace.d.ts

@@ -0,0 +1,45 @@
+/** 追踪上下文 */
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    startTime: number;
+    attributes: Record<string, unknown>;
+}
+/** 追踪事件 */
+export interface TraceEvent {
+    name: string;
+    timestamp: number;
+    attributes?: Record<string, unknown>;
+}
+/** 追踪 Span */
+export interface TraceSpan {
+    context: TraceContext;
+    endTime?: number;
+    status: 'active' | 'ok' | 'error';
+    events: TraceEvent[];
+}
+/** Tracer 接口 */
+export interface Tracer {
+    startSpan(name: string, parent?: TraceContext): TraceSpan;
+    endSpan(span: TraceSpan): void;
+    addEvent(span: TraceSpan, name: string, attributes?: Record<string, unknown>): void;
+}
+/**
+ * InMemoryTracer — 内存链路追踪实现
+ * 生成唯一 traceId / spanId，支持父子 span 关联
+ */
+export declare class InMemoryTracer implements Tracer {
+    private spans;
+    /** 当前活跃的 traceId（用于跨 span 关联） */
+    private currentTraceId?;
+    startSpan(name: string, parent?: TraceContext): TraceSpan;
+    endSpan(span: TraceSpan): void;
+    addEvent(span: TraceSpan, name: string, attributes?: Record<string, unknown>): void;
+    /** 获取所有已记录的 span */
+    getSpans(): TraceSpan[];
+    /** 清空所有记录 */
+    clear(): void;
+    private generateId;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/cjs/observability/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/observability/trace.ts"],"names":[],"mappings":"AAIA,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,cAAc;AACd,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC;IAClC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,gBAAgB;AAChB,MAAM,WAAW,MAAM;IACrB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACrF;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,KAAK,CAAmB;IAChC,iCAAiC;IACjC,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS;IAqBzD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAK9B,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQnF,oBAAoB;IACpB,QAAQ,IAAI,SAAS,EAAE;IAIvB,aAAa;IACb,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,UAAU;CAGnB"}

package/dist/cjs/observability/trace.js

@@ -0,0 +1,59 @@
+"use strict";
+// ============================================================
+// Trace — 链路追踪接口与内存实现
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryTracer = void 0;
+/**
+ * InMemoryTracer — 内存链路追踪实现
+ * 生成唯一 traceId / spanId，支持父子 span 关联
+ */
+class InMemoryTracer {
+    spans = [];
+    /** 当前活跃的 traceId（用于跨 span 关联） */
+    currentTraceId;
+    startSpan(name, parent) {
+        const traceId = parent?.traceId || this.currentTraceId || this.generateId();
+        const spanId = this.generateId();
+        const span = {
+            context: {
+                traceId,
+                spanId,
+                parentSpanId: parent?.spanId,
+                startTime: Date.now(),
+                attributes: { name },
+            },
+            status: 'active',
+            events: [],
+        };
+        this.spans.push(span);
+        this.currentTraceId = traceId;
+        return span;
+    }
+    endSpan(span) {
+        span.endTime = Date.now();
+        span.status = span.status === 'active' ? 'ok' : span.status;
+    }
+    addEvent(span, name, attributes) {
+        span.events.push({
+            name,
+            timestamp: Date.now(),
+            attributes,
+        });
+    }
+    /** 获取所有已记录的 span */
+    getSpans() {
+        return [...this.spans];
+    }
+    /** 清空所有记录 */
+    clear() {
+        this.spans = [];
+        this.currentTraceId = undefined;
+    }
+    // ---- 内部方法 ----
+    generateId() {
+        return Math.random().toString(36).substring(2, 10) + Date.now().toString(36);
+    }
+}
+exports.InMemoryTracer = InMemoryTracer;
+//# sourceMappingURL=trace.js.map

package/dist/cjs/observability/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/observability/trace.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,sBAAsB;AACtB,+DAA+D;;;AAiC/D;;;GAGG;AACH,MAAa,cAAc;IACjB,KAAK,GAAgB,EAAE,CAAC;IAChC,iCAAiC;IACzB,cAAc,CAAU;IAEhC,SAAS,CAAC,IAAY,EAAE,MAAqB;QAC3C,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAEjC,MAAM,IAAI,GAAc;YACtB,OAAO,EAAE;gBACP,OAAO;gBACP,MAAM;gBACN,YAAY,EAAE,MAAM,EAAE,MAAM;gBAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,UAAU,EAAE,EAAE,IAAI,EAAE;aACrB;YACD,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,EAAE;SACX,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,IAAe;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9D,CAAC;IAED,QAAQ,CAAC,IAAe,EAAE,IAAY,EAAE,UAAoC;QAC1E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,aAAa;IACb,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,iBAAiB;IAET,UAAU;QAChB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AAvDD,wCAuDC"}

package/dist/cjs/runtime/run-registry-interface.d.ts

@@ -0,0 +1,42 @@
+import type { WorkflowCheckpoint } from '../agent/workflow.js';
+import type { ActiveRun, BufferedEvent, EventSubscriber, RunSnapshot } from './run-registry.js';
+/** Agent 运行会话注册表接口 */
+export interface RunRegistryInterface {
+    /** 设置空闲超时回调 */
+    setIdleTimeoutHandler(handler: (threadId: number | string, sessionId: string) => void): void;
+    /** 启用/禁用空闲超时检测 */
+    setIdleTimeoutEnabled(enabled: boolean): void;
+    /** 注册一个新的运行 */
+    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;
+    /** 设置消息 ID */
+    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;
+    /** 获取活跃线程 ID 列表 */
+    getActiveThreadIds(): (number | string)[];
+    /** 销毁，清理资源 */
+    destroy(): void;
+}
+//# sourceMappingURL=run-registry-interface.d.ts.map

package/dist/cjs/runtime/run-registry-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-registry-interface.d.ts","sourceRoot":"","sources":["../../../src/runtime/run-registry-interface.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,MAAM,WAAW,oBAAoB;IACnC,eAAe;IACf,qBAAqB,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAE7F,kBAAkB;IAClB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAE9C,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpF,aAAa;IACb,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAEpD,cAAc;IACd,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAEjD,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IAEpE,WAAW;IACX,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErF,WAAW;IACX,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7D,cAAc;IACd,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE1E,aAAa;IACb,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;IAE5E,aAAa;IACb,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,EAAE,CAAC;IAE9D,aAAa;IACb,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAE9D,eAAe;IACf,gBAAgB,IAAI,WAAW,EAAE,CAAC;IAElC,eAAe;IACf,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAE1E,gBAAgB;IAChB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAErE,WAAW;IACX,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE3C,mBAAmB;IACnB,kBAAkB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAE1C,cAAc;IACd,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/cjs/runtime/run-registry-interface.js

@@ -0,0 +1,7 @@
+"use strict";
+// ============================================================
+// RunRegistryInterface — Agent 运行会话注册表接口
+// 从 RunRegistry 抽取，支持依赖注入和测试 mock
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=run-registry-interface.js.map

package/dist/cjs/runtime/run-registry-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-registry-interface.js","sourceRoot":"","sources":["../../../src/runtime/run-registry-interface.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,yCAAyC;AACzC,kCAAkC;AAClC,+DAA+D"}

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

@@ -1,4 +1,5 @@
 import type { WorkflowCheckpoint } from '../agent/workflow.js';
+import type { RunRegistryInterface } from './run-registry-interface.js';
 /** 单条事件 */
 export interface BufferedEvent {
     event: string;
@@ -72,11 +73,23 @@ export declare class InMemoryRunStateStore implements RunStateStore {
     upsert(snapshot: RunSnapshot): void;
     remove(threadId: number | string): void;
 }
-export declare class RunRegistry {
+export declare class RunRegistry implements RunRegistryInterface {
     private runs;
     private runStateStore;
     private cleanupTimer;
-    constructor(store?: RunStateStore);
+    /** 空闲超时回调（上层注入，用于中止 Engine） */
+    private onIdleTimeout?;
+    /** 是否启用空闲超时检测 */
+    private idleTimeoutEnabled;
+    constructor(store?: RunStateStore, options?: {
+        idleTimeoutMs?: number;
+        onIdleTimeout?: (threadId: number | string, sessionId: string) => void;
+        enableIdleTimeout?: boolean;
+    });
+    /** 设置空闲超时回调 */
+    setIdleTimeoutHandler(handler: (threadId: number | string, sessionId: string) => void): void;
+    /** 启用/禁用空闲超时检测 */
+    setIdleTimeoutEnabled(enabled: boolean): void;
     /** 注册一个新的运行 */
     startRun(threadId: number | string, sessionId: string, traceId?: string): ActiveRun;
     getRun(threadId: number | string): ActiveRun | null;

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

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

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

@@ -27,14 +27,34 @@ exports.InMemoryRunStateStore = InMemoryRunStateStore;
 // ---- 配置 ----
 const CLEANUP_MAX_AGE = 30 * 60 * 1000;
 const CLEANUP_INTERVAL = 5 * 60 * 1000;
+/** 无订阅者时运行自动中止的空闲超时（10 分钟） */
+const IDLE_TIMEOUT_MS = 10 * 60 * 1000;
 class RunRegistry {
     runs = new Map();
     runStateStore;
     cleanupTimer = null;
-    constructor(store) {
+    /** 空闲超时回调（上层注入，用于中止 Engine） */
+    onIdleTimeout;
+    /** 是否启用空闲超时检测 */
+    idleTimeoutEnabled;
+    constructor(store, options) {
         this.runStateStore = store || new InMemoryRunStateStore();
+        this.onIdleTimeout = options?.onIdleTimeout;
+        this.idleTimeoutEnabled = options?.enableIdleTimeout ?? true;
+        if (options?.idleTimeoutMs) {
+            // 覆盖默认空闲超时
+            this._idleTimeoutMs = options.idleTimeoutMs;
+        }
         this.startCleanup();
     }
+    /** 设置空闲超时回调 */
+    setIdleTimeoutHandler(handler) {
+        this.onIdleTimeout = handler;
+    }
+    /** 启用/禁用空闲超时检测 */
+    setIdleTimeoutEnabled(enabled) {
+        this.idleTimeoutEnabled = enabled;
+    }
     /** 注册一个新的运行 */
     startRun(threadId, sessionId, traceId) {
         const existing = this.runs.get(threadId);
@@ -246,9 +266,31 @@ class RunRegistry {
             return;
         this.cleanupTimer = setInterval(() => {
             const now = Date.now();
+            const idleTimeout = this._idleTimeoutMs || IDLE_TIMEOUT_MS;
             for (const [threadId, run] of this.runs) {
+                // 清理过期的已完成运行
                 if (run.status !== 'running' && (now - run.createdAt) > CLEANUP_MAX_AGE) {
                     this.removeRun(threadId);
+                    continue;
+                }
+                // 空闲超时检测：运行中但无订阅者超过 idleTimeout
+                if (this.idleTimeoutEnabled && run.status === 'running' && run.subscribers.size === 0) {
+                    const idleDuration = now - run.lastFlushAt;
+                    if (idleDuration > idleTimeout) {
+                        console.warn(`[RunRegistry] Idle timeout (${idleDuration}ms > ${idleTimeout}ms) for thread ${threadId}, aborting`);
+                        // 标记为 error
+                        run.status = 'error';
+                        run.error = `Idle timeout: no subscribers for ${Math.round(idleDuration / 1000)}s`;
+                        this.persistRun(run);
+                        this.notifySubscribers(run, { event: 'error', data: { error: run.error } });
+                        // 触发上层中止回调
+                        if (this.onIdleTimeout) {
+                            try {
+                                this.onIdleTimeout(threadId, run.sessionId);
+                            }
+                            catch { /* ignore */ }
+                        }
+                    }
                 }
             }
         }, CLEANUP_INTERVAL);

package/dist/cjs/runtime/run-registry.js.map

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

package/dist/cjs/sandbox/code-sandbox.d.ts

@@ -0,0 +1,42 @@
+import type { Sandbox, ScriptLanguage } from './types.js';
+import type { RegisteredTool } from '../tool/types.js';
+/** 代码执行结构化结果 */
+export interface CodeExecutionResult {
+    /** 标准输出 */
+    stdout: string;
+    /** 标准错误输出 */
+    stderr: string;
+    /** 进程退出码（0 = 成功） */
+    exitCode: number;
+    /** 执行过程中产生/修改的文件列表（相对路径） */
+    files: string[];
+    /** 生成的图表标识列表（如 plot 文件名或 chart ID） */
+    charts?: string[];
+    /** 执行耗时（毫秒） */
+    duration: number;
+}
+/**
+ * 代码执行沙箱接口
+ *
+ * 扩展 Sandbox，在 runScript 基础上增加 execute 方法，
+ * 返回结构化的执行结果（stdout / stderr / exitCode / files / charts / duration）。
+ */
+export interface CodeSandbox extends Sandbox {
+    /**
+     * 执行代码并返回结构化结果
+     * @param code    代码内容
+     * @param lang    脚本语言
+     * @param timeout 执行超时 (ms)
+     */
+    execute(code: string, lang: ScriptLanguage, timeout?: number): Promise<CodeExecutionResult>;
+}
+/**
+ * 创建代码执行工具（RegisteredTool 格式）
+ *
+ * 供 Agent 通过 function calling 在沙箱中执行代码，
+ * 返回结构化结果（stdout / stderr / exitCode / files / charts / duration）。
+ *
+ * @param sandbox CodeSandbox 实例
+ */
+export declare function createCodeExecutionTool(sandbox: CodeSandbox): RegisteredTool;
+//# sourceMappingURL=code-sandbox.d.ts.map

package/dist/cjs/sandbox/code-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-sandbox.d.ts","sourceRoot":"","sources":["../../../src/sandbox/code-sandbox.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvE,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7F;AAID;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CA0C5E"}

package/dist/cjs/sandbox/code-sandbox.js

@@ -0,0 +1,59 @@
+"use strict";
+// ============================================================
+// CodeSandbox — 结构化代码执行沙箱接口 + 工具工厂
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCodeExecutionTool = createCodeExecutionTool;
+// ---- createCodeExecutionTool ----
+/**
+ * 创建代码执行工具（RegisteredTool 格式）
+ *
+ * 供 Agent 通过 function calling 在沙箱中执行代码，
+ * 返回结构化结果（stdout / stderr / exitCode / files / charts / duration）。
+ *
+ * @param sandbox CodeSandbox 实例
+ */
+function createCodeExecutionTool(sandbox) {
+    return {
+        definition: {
+            type: 'function',
+            function: {
+                name: 'execute_code',
+                description: 'Execute code in a sandboxed environment and return structured results (stdout, stderr, exitCode, files, charts, duration).',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        code: { type: 'string', description: 'Source code to execute' },
+                        language: {
+                            type: 'string',
+                            description: 'Script language',
+                            enum: ['python', 'nodejs', 'shell'],
+                        },
+                        timeout: { type: 'number', description: 'Execution timeout in milliseconds' },
+                    },
+                    required: ['code', 'language'],
+                },
+            },
+        },
+        executor: async (args) => {
+            const code = String(args.code || '').trim();
+            if (!code)
+                return 'ERROR: execute_code requires non-empty code.';
+            const lang = String(args.language || '').trim();
+            if (!lang || !['python', 'nodejs', 'shell'].includes(lang)) {
+                return `ERROR: execute_code unsupported language: ${lang}`;
+            }
+            const timeout = args.timeout != null ? Number(args.timeout) : undefined;
+            try {
+                const result = await sandbox.execute(code, lang, timeout);
+                return JSON.stringify(result, null, 2);
+            }
+            catch (e) {
+                return `ERROR: code execution failed: ${e?.message || e}`;
+            }
+        },
+        category: 'builtin',
+        concurrent: false,
+    };
+}
+//# sourceMappingURL=code-sandbox.js.map

package/dist/cjs/sandbox/code-sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-sandbox.js","sourceRoot":"","sources":["../../../src/sandbox/code-sandbox.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,mCAAmC;AACnC,+DAA+D;;AAmD/D,0DA0CC;AApDD,oCAAoC;AAEpC;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,OAAoB;IAC1D,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,4HAA4H;gBAC9H,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;wBAC/D,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iBAAiB;4BAC9B,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;yBACpC;wBACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;qBAC9E;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;iBAC/B;aACF;SACF;QACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI;gBAAE,OAAO,8CAA8C,CAAC;YACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAoB,CAAC;YAClE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3D,OAAO,6CAA6C,IAAI,EAAE,CAAC;YAC7D,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAExE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,OAAO,iCAAiC,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC"}

package/dist/cjs/skill/router.d.ts

@@ -1,5 +1,6 @@
-import type { RouteResult, RouteStrategy } from './types.js';
+import type { Skill, RouteResult, RouteStrategy } from './types.js';
 import type { SkillManager } from './manager.js';
+import type { VectorIndex } from './vector-index.js';
 export declare class SkillRouter {
     private strategies;
     private skillManager;
@@ -23,4 +24,22 @@ export declare class SkillRouter {
     private getManifestStorageKey;
     private matchByKeywords;
 }
+/** 嵌入函数：将文本转换为向量 */
+export type EmbedFunction = (text: string) => Promise<number[]>;
+/** VectorRouteStrategy 配置选项 */
+export interface VectorRouteStrategyOptions {
+    /** 检索候选数量（默认 5） */
+    topK?: number;
+    /** 最低相似度阈值，低于此值不命中（默认 0.5） */
+    minScore?: number;
+}
+export declare class VectorRouteStrategy implements RouteStrategy {
+    name: string;
+    private index;
+    private embedFn;
+    private topK;
+    private minScore;
+    constructor(index: VectorIndex, embedFn: EmbedFunction, options?: VectorRouteStrategyOptions);
+    match(message: string, skills: Skill[]): Promise<RouteResult | null>;
+}
 //# sourceMappingURL=router.d.ts.map

package/dist/cjs/skill/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/skill/router.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAwB,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAe;gBAEvB,YAAY,EAAE,YAAY;IAItC;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BlD,6BAA6B;IAC7B,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C,cAAc;IACd,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,aAAa;IA+CrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAK1B,+EAA+E;IAC/E,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,eAAe;CAgCxB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/skill/router.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAiB,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAe;gBAEvB,YAAY,EAAE,YAAY;IAItC;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BlD,6BAA6B;IAC7B,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C,cAAc;IACd,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,aAAa;IA+CrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAK1B,+EAA+E;IAC/E,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,eAAe;CAgCxB;AAOD,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEhE,+BAA+B;AAC/B,MAAM,WAAW,0BAA0B;IACzC,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,IAAI,SAAY;IAChB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;gBAEb,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,0BAA0B;IAOtF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;CAyB3E"}

package/dist/cjs/skill/router.js

@@ -5,7 +5,7 @@
 // 未命中时由 Engine 在 system prompt 中注入 skill catalog，
 // Agent 通过 load_skill 工具按需加载，无需独立 LLM 路由调用
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SkillRouter = void 0;
+exports.VectorRouteStrategy = exports.SkillRouter = void 0;
 class SkillRouter {
     strategies = [];
     skillManager;
@@ -136,4 +136,42 @@ class SkillRouter {
     }
 }
 exports.SkillRouter = SkillRouter;
+class VectorRouteStrategy {
+    name = 'vector';
+    index;
+    embedFn;
+    topK;
+    minScore;
+    constructor(index, embedFn, options) {
+        this.index = index;
+        this.embedFn = embedFn;
+        this.topK = options?.topK ?? 5;
+        this.minScore = options?.minScore ?? 0.5;
+    }
+    async match(message, skills) {
+        if (this.index.size() === 0 || skills.length === 0)
+            return null;
+        // 将消息转换为向量
+        const queryVector = await this.embedFn(message);
+        // 向量搜索 top-K 候选
+        const results = await this.index.search(queryVector, this.topK);
+        if (results.length === 0)
+            return null;
+        // 取最佳匹配
+        const best = results[0];
+        if (best.score < this.minScore)
+            return null;
+        // 在 skills 列表中查找对应的 Skill
+        const skill = skills.find((s) => s.id === best.item.id);
+        if (!skill)
+            return null;
+        return {
+            skill,
+            message,
+            matchType: 'vector',
+            confidence: best.score,
+        };
+    }
+}
+exports.VectorRouteStrategy = VectorRouteStrategy;
 //# sourceMappingURL=router.js.map