@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/ReadGraphTool.js

@@ -0,0 +1,259 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+// ─── Schema ─────────────────────────────────────────────────────────────────
+const QUERY_TYPE_VALUES = [
+    'summary',
+    'node_by_id',
+    'nodes_by_kind',
+    'nodes_by_tag',
+    'edges_from',
+    'edges_to',
+    'subgraph',
+];
+const NODE_KIND_VALUES = [
+    'fact', 'intent', 'hint', 'origin', 'goal', 'contract', 'design_doc',
+];
+const ReadGraphSchema = z.object({
+    query_type: z.enum(QUERY_TYPE_VALUES).describe('查询类型: summary=高层概览, node_by_id=单节点详情, nodes_by_kind=按类型列出所有节点, nodes_by_tag=按标签搜索, edges_from=节点出边, edges_to=节点入边, subgraph=邻域子图'),
+    node_id: z.string().optional().describe('目标节点 ID（node_by_id / edges_from / edges_to / subgraph 时必填）'),
+    kind: z.enum(NODE_KIND_VALUES).optional().describe('节点类型（nodes_by_kind 时必填）'),
+    tag: z.string().optional().describe('搜索标签（nodes_by_tag 时必填）'),
+    max_depth: z.number().int().min(1).max(5).optional().describe('子图最大深度（subgraph 时可选，默认 2）'),
+});
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function formatNode(node, index) {
+    const prefix = index !== undefined ? `**${index}.** ` : '';
+    const statusPart = node.kind === 'intent' ? ` [${node.intentStatus ?? 'unknown'}]` : '';
+    const confidencePart = node.confidence ? ` (${node.confidence})` : '';
+    const tagsPart = node.tags.length > 0 ? ` \`${node.tags.join('`, `')}\`` : '';
+    return `${prefix}**${node.title}**${statusPart}${confidencePart} — *${node.kind}* \`${node.id}\`${tagsPart}`;
+}
+function formatNodeDetail(node) {
+    const lines = [
+        `## 节点: ${node.title}`,
+        `- **ID**: \`${node.id}\``,
+        `- **Kind**: ${node.kind}`,
+        `- **创建者**: ${node.createdBy}`,
+        `- **标签**: ${node.tags.length > 0 ? node.tags.join(', ') : '(无)'}`,
+    ];
+    if (node.confidence)
+        lines.push(`- **置信度**: ${node.confidence}`);
+    if (node.kind === 'intent')
+        lines.push(`- **状态**: ${node.intentStatus ?? 'unknown'}`, `- **优先级**: ${node.priority ?? 'N/A'}`);
+    if (node.supersededBy)
+        lines.push(`- **被替代**: \`${node.supersededBy}\``);
+    if (node.evidence && node.evidence.length > 0) {
+        lines.push('', '### Evidence', ...node.evidence.map(e => `- ${e.type}: ${e.ref}`));
+    }
+    lines.push('', '### 内容', node.content);
+    return lines.join('\n');
+}
+function formatEdge(edge, nodeMap, index) {
+    const prefix = index !== undefined ? `**${index}.** ` : '';
+    const fromTitle = nodeMap?.get(edge.fromNodeId)?.title ?? edge.fromNodeId;
+    const toTitle = nodeMap?.get(edge.toNodeId)?.title ?? edge.toNodeId;
+    return `${prefix}\`${fromTitle}\` --[**${edge.edgeType}**]--> \`${toTitle}\` _(edge: \`${edge.id}\`)_`;
+}
+function formatSummary(analysis, snapshot) {
+    const lines = ['## 黑板图概览'];
+    lines.push(`- **总节点数**: ${snapshot.nodes.length}`);
+    lines.push(`- **总边数**: ${snapshot.edges.length}`);
+    const kindCounts = new Map();
+    for (const n of snapshot.nodes) {
+        kindCounts.set(n.kind, (kindCounts.get(n.kind) ?? 0) + 1);
+    }
+    lines.push(`- **节点分布**: ${[...kindCounts.entries()].map(([k, v]) => `${k}=${v}`).join(', ')}`);
+    if (snapshot.originNode)
+        lines.push(`- **Origin**: \`${snapshot.originNode.title}\``);
+    if (snapshot.goalNode)
+        lines.push(`- **Goal**: \`${snapshot.goalNode.title}\``);
+    lines.push('', `### 待探索 Intent (${analysis.openIntents.length})`);
+    if (analysis.openIntents.length === 0) {
+        lines.push('_(无)_');
+    }
+    else {
+        analysis.openIntents.forEach((n, i) => { lines.push(formatNode(n, i + 1)); });
+    }
+    lines.push('', `### 被阻塞 Intent (${analysis.blockedIntents.length})`);
+    if (analysis.blockedIntents.length === 0) {
+        lines.push('_(无)_');
+    }
+    else {
+        analysis.blockedIntents.forEach((n, i) => { lines.push(formatNode(n, i + 1)); });
+    }
+    lines.push('', `### 最新 Fact (${analysis.recentFacts.length})`);
+    if (analysis.recentFacts.length === 0) {
+        lines.push('_(无)_');
+    }
+    else {
+        analysis.recentFacts.forEach((n, i) => { lines.push(formatNode(n, i + 1)); });
+    }
+    if (analysis.knowledgeGaps.length > 0) {
+        lines.push('', `### 知识空白 (${analysis.knowledgeGaps.length})`);
+        analysis.knowledgeGaps.forEach((g, i) => { lines.push(`${i + 1}. ${g}`); });
+    }
+    if (analysis.unresolvedContradictions.length > 0) {
+        lines.push('', `### 未解决矛盾 (${analysis.unresolvedContradictions.length})`);
+        analysis.unresolvedContradictions.forEach((c, i) => {
+            lines.push(`${i + 1}. \`${c.nodeA.title}\` ↔ \`${c.nodeB.title}\``);
+        });
+    }
+    if (analysis.completionSignals.length > 0) {
+        lines.push('', `### 完成信号 (${analysis.completionSignals.length})`);
+        analysis.completionSignals.forEach((s, i) => { lines.push(`${i + 1}. ${s}`); });
+    }
+    return lines.join('\n');
+}
+function formatSubgraph(subgraph) {
+    const lines = [`## 子图 (中心: \`${subgraph.focusNodeId ?? '?'}\`)`];
+    const nodeMap = new Map();
+    for (const n of subgraph.nodes)
+        nodeMap.set(n.id, n);
+    lines.push(`- **节点数**: ${subgraph.nodes.length}`, `- **边数**: ${subgraph.edges.length}`);
+    if (subgraph.originNode)
+        lines.push(`- **Origin**: \`${subgraph.originNode.title}\``);
+    if (subgraph.goalNode)
+        lines.push(`- **Goal**: \`${subgraph.goalNode.title}\``);
+    lines.push('', '### 节点');
+    subgraph.nodes.forEach((n, i) => { lines.push(formatNode(n, i + 1)); });
+    lines.push('', '### 边');
+    if (subgraph.edges.length === 0) {
+        lines.push('_(无)_');
+    }
+    else {
+        subgraph.edges.forEach((e, i) => { lines.push(formatEdge(e, nodeMap, i + 1)); });
+    }
+    return lines.join('\n');
+}
+// ─── Tool ───────────────────────────────────────────────────────────────────
+export class ReadGraphTool extends Tool {
+    name = 'read_graph';
+    description = '查询会话的黑板知识图谱。支持多种查询模式：summary(总览)、node_by_id(单节点)、nodes_by_kind(按类型)、nodes_by_tag(按标签)、edges_from/edges_to(关系边)、subgraph(邻域子图)。' +
+        '查询失败时返回 success=false 和错误原因，黑板未启用时亦然。';
+    parameters = ReadGraphSchema;
+    async execute(args, context) {
+        const params = args;
+        const graph = context?.blackboardGraph;
+        const sessionId = context?.sessionId;
+        if (!graph || !sessionId) {
+            return {
+                success: false,
+                data: null,
+                error: '黑板图未初始化（blackboard 模式未开启或 sessionId 缺失）。使用 blackboard(action="read_graph") 前需先启用黑板模式。',
+            };
+        }
+        try {
+            switch (params.query_type) {
+                case 'summary': {
+                    const analysis = graph.analyze(sessionId);
+                    const snapshot = graph.getSnapshot(sessionId);
+                    return {
+                        success: true,
+                        data: formatSummary(analysis, snapshot),
+                    };
+                }
+                case 'node_by_id': {
+                    if (!params.node_id) {
+                        return { success: false, data: null, error: 'query_type=node_by_id 时 node_id 为必填参数' };
+                    }
+                    const node = graph.getNode(params.node_id, sessionId);
+                    if (!node) {
+                        return { success: false, data: null, error: `节点 \`${params.node_id}\` 不存在` };
+                    }
+                    return { success: true, data: formatNodeDetail(node) };
+                }
+                case 'nodes_by_kind': {
+                    if (!params.kind) {
+                        return { success: false, data: null, error: 'query_type=nodes_by_kind 时 kind 为必填参数' };
+                    }
+                    const nodes = graph.getNodesByKind(sessionId, params.kind);
+                    if (nodes.length === 0) {
+                        return { success: true, data: `## ${params.kind} 节点\n_(无)_` };
+                    }
+                    const lines = [`## ${params.kind} 节点 (${nodes.length})`];
+                    nodes.forEach((n, i) => { lines.push('', formatNodeDetail(n)); });
+                    return { success: true, data: lines.join('\n') };
+                }
+                case 'nodes_by_tag': {
+                    if (!params.tag) {
+                        return { success: false, data: null, error: 'query_type=nodes_by_tag 时 tag 为必填参数' };
+                    }
+                    const nodes = graph.getNodesByTag(sessionId, params.tag);
+                    if (nodes.length === 0) {
+                        return { success: true, data: `## 标签 \`${params.tag}\`\n_(无匹配节点)_` };
+                    }
+                    const lines = [`## 标签 \`${params.tag}\` — ${nodes.length} 个节点`];
+                    nodes.forEach((n, i) => { lines.push(formatNode(n, i + 1)); });
+                    return { success: true, data: lines.join('\n') };
+                }
+                case 'edges_from':
+                case 'edges_to': {
+                    if (!params.node_id) {
+                        return {
+                            success: false,
+                            data: null,
+                            error: `query_type=${params.query_type} 时 node_id 为必填参数`,
+                        };
+                    }
+                    const sourceNode = graph.getNode(params.node_id, sessionId);
+                    if (!sourceNode) {
+                        return { success: false, data: null, error: `节点 \`${params.node_id}\` 不存在` };
+                    }
+                    const edges = params.query_type === 'edges_from'
+                        ? graph.getEdgesFrom(sessionId, params.node_id)
+                        : graph.getEdgesTo(sessionId, params.node_id);
+                    // Build node map for titles
+                    const nodeMap = new Map();
+                    nodeMap.set(sourceNode.id, sourceNode);
+                    const relatedIds = new Set();
+                    for (const e of edges) {
+                        relatedIds.add(e.fromNodeId);
+                        relatedIds.add(e.toNodeId);
+                    }
+                    for (const id of relatedIds) {
+                        if (!nodeMap.has(id)) {
+                            const n = graph.getNode(id, sessionId);
+                            if (n)
+                                nodeMap.set(id, n);
+                        }
+                    }
+                    const direction = params.query_type === 'edges_from' ? '出边' : '入边';
+                    const lines = [
+                        `## ${sourceNode.title} 的${direction} (${edges.length})`,
+                        `源节点: ${formatNode(sourceNode)}`,
+                        '',
+                    ];
+                    if (edges.length === 0) {
+                        lines.push('_(无)_');
+                    }
+                    else {
+                        edges.forEach((e, i) => { lines.push(formatEdge(e, nodeMap, i + 1)); });
+                    }
+                    return { success: true, data: lines.join('\n') };
+                }
+                case 'subgraph': {
+                    if (!params.node_id) {
+                        return { success: false, data: null, error: 'query_type=subgraph 时 node_id 为必填参数' };
+                    }
+                    const maxDepth = params.max_depth ?? 2;
+                    const subgraph = graph.getSubgraph(sessionId, params.node_id, maxDepth);
+                    if (subgraph.nodes.length === 0) {
+                        return {
+                            success: false,
+                            data: null,
+                            error: `节点 \`${params.node_id}\` 不存在或子图为空`,
+                        };
+                    }
+                    return { success: true, data: formatSubgraph(subgraph) };
+                }
+                default:
+                    return { success: false, data: null, error: `未知的 query_type: ${params.query_type}` };
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, data: null, error: `读取图失败: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=ReadGraphTool.js.map

package/dist/tools/implementations/ReadGraphTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadGraphTool.js","sourceRoot":"","sources":["../../../src/tools/implementations/ReadGraphTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAqC,MAAM,YAAY,CAAC;AAGrE,+EAA+E;AAE/E,MAAM,iBAAiB,GAAG;IACxB,SAAS;IACT,YAAY;IACZ,eAAe;IACf,cAAc;IACd,YAAY;IACZ,UAAU;IACV,UAAU;CACF,CAAC;AAEX,MAAM,gBAAgB,GAAG;IACvB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY;CAC5D,CAAC;AAEX,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAC5C,kIAAkI,CACnI;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAC3F,CAAC,CAAC;AAEH,+EAA+E;AAE/E,SAAS,UAAU,CAAC,IAAe,EAAE,KAAc;IACjD,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,YAAY,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,KAAK,KAAK,UAAU,GAAG,cAAc,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;AAC/G,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAe;IACvC,MAAM,KAAK,GAAG;QACZ,UAAU,IAAI,CAAC,KAAK,EAAE;QACtB,eAAe,IAAI,CAAC,EAAE,IAAI;QAC1B,eAAe,IAAI,CAAC,IAAI,EAAE;QAC1B,cAAc,IAAI,CAAC,SAAS,EAAE;QAC9B,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE;KACnE,CAAC;IACF,IAAI,IAAI,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,YAAY,IAAI,SAAS,EAAE,EAAE,cAAc,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;IAC9H,IAAI,IAAI,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IACzE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,IAAe,EAAE,OAAgC,EAAE,KAAc;IACnF,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC;IAC1E,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC;IACpE,OAAO,GAAG,MAAM,KAAK,SAAS,WAAW,IAAI,CAAC,QAAQ,YAAY,OAAO,gBAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;AACzG,CAAC;AAED,SAAS,aAAa,CAAC,QAAuB,EAAE,QAAuB;IACrE,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAElD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC/B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE/F,IAAI,QAAQ,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC;IACtF,IAAI,QAAQ,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;IAEhF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAClE,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IACrE,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9D,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,QAAQ,CAAC,wBAAwB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,QAAQ,CAAC,wBAAwB,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1E,QAAQ,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACjD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,QAAQ,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC;QAClE,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,QAAuB;IAC7C,MAAM,KAAK,GAAG,CAAC,gBAAgB,QAAQ,CAAC,WAAW,IAAI,GAAG,KAAK,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAErD,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,aAAa,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAExF,IAAI,QAAQ,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC;IACtF,IAAI,QAAQ,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;IAEhF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAExE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACxB,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAE/E,MAAM,OAAO,aAAc,SAAQ,IAAI;IAC5B,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAClB,gIAAgI;QAChI,uCAAuC,CAAC;IACjC,UAAU,GAAG,eAAe,CAAC;IAEtC,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,OAAqB;QAChD,MAAM,MAAM,GAAG,IAAuC,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,EAAE,eAAe,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QAErC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,uFAAuF;aAC/F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1B,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;oBAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;oBAC9C,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC;qBACxC,CAAC;gBACJ,CAAC;gBAED,KAAK,YAAY,CAAC,CAAC,CAAC;oBAClB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;oBACxF,CAAC;oBACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBACtD,IAAI,CAAC,IAAI,EAAE,CAAC;wBACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,MAAM,CAAC,OAAO,QAAQ,EAAE,CAAC;oBAC/E,CAAC;oBACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzD,CAAC;gBAED,KAAK,eAAe,CAAC,CAAC,CAAC;oBACrB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;wBACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;oBACxF,CAAC;oBACD,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;oBAChE,CAAC;oBACD,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,QAAQ,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;oBACzD,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,CAAC;gBAED,KAAK,cAAc,CAAC,CAAC,CAAC;oBACpB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;wBAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;oBACtF,CAAC;oBACD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;oBACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;oBACvE,CAAC;oBACD,MAAM,KAAK,GAAG,CAAC,WAAW,MAAM,CAAC,GAAG,QAAQ,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC;oBAChE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,CAAC;gBAED,KAAK,YAAY,CAAC;gBAClB,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACpB,OAAO;4BACL,OAAO,EAAE,KAAK;4BACd,IAAI,EAAE,IAAI;4BACV,KAAK,EAAE,cAAc,MAAM,CAAC,UAAU,kBAAkB;yBACzD,CAAC;oBACJ,CAAC;oBACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;wBAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,MAAM,CAAC,OAAO,QAAQ,EAAE,CAAC;oBAC/E,CAAC;oBAED,MAAM,KAAK,GACT,MAAM,CAAC,UAAU,KAAK,YAAY;wBAChC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC;wBAC/C,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;oBAElD,4BAA4B;oBAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;oBAC7C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;oBACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;oBACrC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;wBACtB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;wBAC7B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;oBAC7B,CAAC;oBACD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;wBAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;4BACrB,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;4BACvC,IAAI,CAAC;gCAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;wBAC5B,CAAC;oBACH,CAAC;oBAED,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACnE,MAAM,KAAK,GAAG;wBACZ,MAAM,UAAU,CAAC,KAAK,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,GAAG;wBACxD,QAAQ,UAAU,CAAC,UAAU,CAAC,EAAE;wBAChC,EAAE;qBACH,CAAC;oBACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACtB,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1E,CAAC;oBACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,CAAC;gBAED,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;oBACtF,CAAC;oBACD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;oBACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;oBACxE,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAChC,OAAO;4BACL,OAAO,EAAE,KAAK;4BACd,IAAI,EAAE,IAAI;4BACV,KAAK,EAAE,QAAQ,MAAM,CAAC,OAAO,aAAa;yBAC3C,CAAC;oBACJ,CAAC;oBACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3D,CAAC;gBAED;oBACE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;YACzF,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;CACF"}

package/dist/tools/implementations/ScreenshotTool.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Screenshot tool using Playwright browser automation.
+ *
+ * Captures screenshots of web pages. 根据当前模型能力决定输出形态：
+ *  - vision 模型：返回结构化 image_url content part（由 provider 适配层转为对应格式）
+ *  - 非 vision 模型：本地 OCR 提取文字，避免把巨大的 base64 灌进对话
+ *  两种模式都把图片保存到磁盘并返回路径
+ */
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class ScreenshotTool extends Tool {
+    readonly name = "screenshot";
+    readonly description = "\u5BF9\u7F51\u9875\u622A\u56FE\u3002vision \u6A21\u578B\u76F4\u63A5\u4EE5\u56FE\u50CF\u5F62\u5F0F\u8FD4\u56DE\uFF1B\u975E vision \u6A21\u578B\u81EA\u52A8 OCR \u4E3A\u6587\u5B57\u3002\u56FE\u7247\u59CB\u7EC8\u4FDD\u5B58\u5230\u78C1\u76D8\u5E76\u8FD4\u56DE\u8DEF\u5F84";
+    readonly parameters: z.ZodObject<{
+        url: z.ZodString;
+        full_page: z.ZodOptional<z.ZodBoolean>;
+        format: z.ZodOptional<z.ZodEnum<{
+            png: "png";
+            jpeg: "jpeg";
+        }>>;
+        quality: z.ZodOptional<z.ZodNumber>;
+        screenshot_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default ScreenshotTool;
+//# sourceMappingURL=ScreenshotTool.d.ts.map

package/dist/tools/implementations/ScreenshotTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenshotTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/ScreenshotTool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA+BrE,qBAAa,cAAe,SAAQ,IAAI;IACtC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,gRAC8C;IAClE,QAAQ,CAAC,UAAU;;;;;;;;;sBAAoB;IAEjC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAyFzE;AAED,eAAe,cAAc,CAAC"}

package/dist/tools/implementations/ScreenshotTool.js

@@ -0,0 +1,124 @@
+/**
+ * Screenshot tool using Playwright browser automation.
+ *
+ * Captures screenshots of web pages. 根据当前模型能力决定输出形态：
+ *  - vision 模型：返回结构化 image_url content part（由 provider 适配层转为对应格式）
+ *  - 非 vision 模型：本地 OCR 提取文字，避免把巨大的 base64 灌进对话
+ *  两种模式都把图片保存到磁盘并返回路径
+ */
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { browserManager } from './BrowserManager.js';
+import { supportsVisionFromProvider } from '../../llm/model_capabilities.js';
+import { ocrImage } from '../../llm/local_vision_fallback.js';
+import { mkdir, writeFile } from 'fs/promises';
+import { dirname, resolve } from 'path';
+import { resolveTaskWritePath } from './utils.js';
+const ScreenshotSchema = z.object({
+    url: z.string().url().describe('要截图的网页 URL'),
+    full_page: z.boolean().optional().describe('是否截取完整页面（包括滚动区域），默认 false（仅视口）'),
+    format: z.enum(['png', 'jpeg']).optional().describe('图片格式，默认 png'),
+    quality: z.number().int().min(1).max(100).optional().describe('jpeg 质量 (1-100)，仅对 jpeg 格式有效'),
+    screenshot_path: z.string().optional().describe('截图保存路径，默认写入 .lingxiao/artifacts'),
+});
+function isUrlSafe(url) {
+    try {
+        const parsed = new URL(url);
+        return ['http:', 'https:'].includes(parsed.protocol);
+    }
+    catch { /* expected: operation may fail */
+        return false;
+    }
+}
+function defaultScreenshotPath(context, format) {
+    const workspace = context?.workspace || process.cwd();
+    const ext = format === 'jpeg' ? 'jpg' : 'png';
+    return resolve(workspace, '.lingxiao', 'artifacts', `screenshot-${Date.now()}.${ext}`);
+}
+export class ScreenshotTool extends Tool {
+    name = 'screenshot';
+    description = '对网页截图。vision 模型直接以图像形式返回；非 vision 模型自动 OCR 为文字。图片始终保存到磁盘并返回路径';
+    parameters = ScreenshotSchema;
+    async execute(args, context) {
+        const params = args;
+        if (!isUrlSafe(params.url)) {
+            return { success: false, data: null, error: '仅支持 http:// 和 https:// 协议的 URL' };
+        }
+        const format = params.format || 'png';
+        // 解析截图保存路径（与 browser_visual_verify 一致的写入隔离逻辑）
+        let screenshotFilePath;
+        try {
+            screenshotFilePath = params.screenshot_path
+                ? resolveTaskWritePath(context?.workspace, params.screenshot_path, context?.sessionId, context?.taskWriteScope)
+                : defaultScreenshotPath(context, format);
+        }
+        catch {
+            screenshotFilePath = defaultScreenshotPath(context, format);
+        }
+        try {
+            const result = await browserManager.takeScreenshot(params.url, {
+                fullPage: params.full_page,
+                format,
+                ...(format === 'jpeg' ? { quality: params.quality || 80 } : {}),
+            });
+            if (!result) {
+                return {
+                    success: false,
+                    data: null,
+                    error: `截图失败: ${params.url}`,
+                };
+            }
+            // 保存图片到磁盘（无论 vision 与否都落盘）
+            const imgBuffer = Buffer.from(result.base64, 'base64');
+            await mkdir(dirname(screenshotFilePath), { recursive: true });
+            await writeFile(screenshotFilePath, imgBuffer);
+            const dataUri = `data:${result.mimeType};base64,${result.base64}`;
+            const header = [
+                `📸 网页截图 - ${params.url}`,
+                `尺寸: ${result.width}x${result.height}`,
+                `格式: ${format}${params.full_page ? ' (全页面)' : ' (视口)'}`,
+                `保存路径: ${screenshotFilePath}`,
+            ];
+            const model = typeof context?.model === 'string' ? context.model : '';
+            const visionCapable = model ? supportsVisionFromProvider(model) : false;
+            if (visionCapable) {
+                return {
+                    success: true,
+                    data: [
+                        { type: 'text', text: header.join('\n') },
+                        {
+                            type: 'image_url',
+                            image_url: {
+                                url: dataUri,
+                                detail: 'auto',
+                            },
+                        },
+                    ],
+                };
+            }
+            const ocrText = await ocrImage(dataUri, 1);
+            const ocrSection = ocrText && ocrText.trim()
+                ? ocrText
+                : `[OCR 未提取到文字。当前模型 ${model || 'unknown'} 不支持 vision，图片已保存至 ${screenshotFilePath}。]`;
+            return {
+                success: true,
+                data: [
+                    ...header,
+                    `[System: 当前模型不支持图片输入，已用本地 OCR 替代图像内容。图片已保存: ${screenshotFilePath}]`,
+                    '',
+                    ocrSection,
+                ].join('\n'),
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                data: null,
+                error: `截图失败: ${msg}`,
+            };
+        }
+    }
+}
+export default ScreenshotTool;
+//# sourceMappingURL=ScreenshotTool.js.map

package/dist/tools/implementations/ScreenshotTool.js.map

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

package/dist/tools/implementations/SendMessageTool.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class SendMessageTool extends Tool {
+    readonly name = "send_message";
+    readonly description = "Worker \u5411 Leader \u6216\u5176\u4ED6 Agent \u53D1\u9001\u6D88\u606F\uFF08\u65B9\u5411\uFF1AWorker \u2192 Leader/Agent\uFF09\u3002\u53C2\u6570\uFF1Arecipient\uFF08\u63A5\u6536\u8005\uFF0C\"leader\" \u6216 agent \u540D\u79F0\uFF09\u3002\u4E0E Leader \u4F7F\u7528\u7684 send_message_to_agent\uFF08\u53C2\u6570\uFF1Aagent_name\uFF09\u548C Team \u6210\u5458\u95F4\u7684 team_message\uFF08\u53C2\u6570\uFF1Atarget_type+target\uFF09\u4E0D\u540C\u3002";
+    readonly parameters: z.ZodObject<{
+        recipient: z.ZodString;
+        message_type: z.ZodEnum<{
+            error: "error";
+            finding: "finding";
+            report: "report";
+            help: "help";
+            flag: "flag";
+        }>;
+        content: z.ZodString;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default SendMessageTool;
+//# sourceMappingURL=SendMessageTool.d.ts.map

package/dist/tools/implementations/SendMessageTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendMessageTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/SendMessageTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAYrE,qBAAa,eAAgB,SAAQ,IAAI;IACvC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,ocAAwM;IAC5N,QAAQ,CAAC,UAAU;;;;;;;;;;;sBAAqB;IAElC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAiEzE;AAED,eAAe,eAAe,CAAC"}

package/dist/tools/implementations/SendMessageTool.js

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+const SendMessageSchema = z.object({
+    recipient: z.string().describe('接收者：\'leader\' 或其他 agent 名称'),
+    message_type: z.enum(['report', 'help', 'finding', 'flag', 'error']).describe('消息类型'),
+    content: z.string().describe('消息内容'),
+    data: z.record(z.string(), z.unknown()).optional().describe('附加数据（可选）'),
+});
+const URGENT_TYPES = new Set(['help', 'error', 'flag']);
+const FINDING_TYPES = new Set(['finding', 'flag']);
+export class SendMessageTool extends Tool {
+    name = 'send_message';
+    description = 'Worker 向 Leader 或其他 Agent 发送消息（方向：Worker → Leader/Agent）。参数：recipient（接收者，"leader" 或 agent 名称）。与 Leader 使用的 send_message_to_agent（参数：agent_name）和 Team 成员间的 team_message（参数：target_type+target）不同。';
+    parameters = SendMessageSchema;
+    async execute(args, context) {
+        const params = args;
+        let { data } = params;
+        const { recipient, message_type, content } = params;
+        if (typeof data === 'string') {
+            try {
+                data = JSON.parse(data);
+            }
+            catch { /* keep as string */ }
+        }
+        const db = context?.db;
+        const sessionId = context?.sessionId;
+        const bus = context?.bus;
+        const agentName = context?.agentName || 'unknown';
+        const emitter = context?.emitter;
+        if (!db || !sessionId) {
+            return { success: false, data: null, error: '上下文缺少 db 或 sessionId' };
+        }
+        try {
+            const message = { type: message_type, content, data: data || {} };
+            await db.setSessionState(sessionId, `messages/${recipient}/${message_type}/${agentName}`, message);
+            if (bus) {
+                let busContent = `[${message_type}] ${content}`;
+                if (data) {
+                    busContent += `\n附加数据：${JSON.stringify(data).slice(0, 500)}`;
+                }
+                const busFrom = agentName.includes(':') ? agentName : `${sessionId}:${agentName}`;
+                const isLeader = recipient === 'leader' || recipient === `${sessionId}:leader`;
+                const busTo = isLeader
+                    ? `${sessionId}:leader`
+                    : (recipient.includes(':') ? recipient : `${sessionId}:${recipient}`);
+                if (URGENT_TYPES.has(message_type) && isLeader) {
+                    await bus.send(busFrom, busTo, 'user_intervention', busContent);
+                    emitter?.emit('agent:intervention', {
+                        sessionId,
+                        agentId: context?.agentId || agentName,
+                        agentName,
+                        message_type,
+                        content,
+                    });
+                }
+                else {
+                    await bus.send(busFrom, busTo, 'message', busContent);
+                }
+            }
+            if ((recipient === 'leader' || recipient === `${sessionId}:leader`) && FINDING_TYPES.has(message_type)) {
+                const existing = await db.getSessionState(sessionId, 'findings');
+                const findingsList = Array.isArray(existing) ? existing : [];
+                findingsList.push({ type: message_type, content, data, from: agentName });
+                await db.setSessionState(sessionId, 'findings', findingsList);
+            }
+            return { success: true, data: `已发送 ${message_type} 消息给 ${recipient}` };
+        }
+        catch (error) {
+            const err = error;
+            return { success: false, data: null, error: `发送消息失败 - ${err.name}: ${err.message}` };
+        }
+    }
+}
+export default SendMessageTool;
+//# sourceMappingURL=SendMessageTool.js.map

package/dist/tools/implementations/SendMessageTool.js.map

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

package/dist/tools/implementations/SessionArtifacts.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class SessionArtifactsTool extends Tool {
+    readonly name = "session_artifacts";
+    readonly description = "\u5217\u51FA\u6216\u8BFB\u53D6\u5F53\u524D session \u7684\u767D\u540D\u5355\u8FD0\u884C\u65F6\u6587\u4EF6\uFF0C\u53EA\u5141\u8BB8\u8BBF\u95EE\u5F53\u524D session \u7684 scratchpad / context / implementations \u76EE\u5F55";
+    readonly parameters: z.ZodObject<{
+        action: z.ZodEnum<{
+            read: "read";
+            list: "list";
+        }>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            context: "context";
+            scratchpad: "scratchpad";
+            implementations: "implementations";
+        }>>;
+        artifact: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default SessionArtifactsTool;
+//# sourceMappingURL=SessionArtifacts.d.ts.map

package/dist/tools/implementations/SessionArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionArtifacts.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/SessionArtifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA0CrE,qBAAa,oBAAqB,SAAQ,IAAI;IAC5C,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,kOAA2F;IAC/G,QAAQ,CAAC,UAAU;;;;;;;;;;;;sBAA0B;IAEvC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAyGzE;AAED,eAAe,oBAAoB,CAAC"}