@vibe-lark/larkpal 0.1.73 → 0.1.75

package/dist/main.mjs

@@ -782,7 +782,10 @@ function getToolDisplayName(toolName) {
 * - parseError(error, rawLine)       — 解析错误（不中断流）
 */
 const log$36 = larkLogger("cc-runtime/stream-parser");
+const MAX_TOOL_RESULT_CONTENT_CHARS = 8e3;
 var CCStreamParser = class extends EventEmitter {
+	toolNamesById = /* @__PURE__ */ new Map();
+	declaredTools = null;
 	/**
 	* 解析一行 NDJSON 文本
 	*
@@ -830,6 +833,7 @@ var CCStreamParser = class extends EventEmitter {
 					subtype: msg.subtype,
 					detail: JSON.stringify(msg).slice(0, 500)
 				});
+				this.handleSystem(msg);
 				this.emit("system", msg);
 				break;
 			default:
@@ -858,6 +862,7 @@ var CCStreamParser = class extends EventEmitter {
 					toolUseId: block?.id
 				});
 				if (block?.type === "tool_use" && block.name) {
+					this.recordToolUse(block.name, block.id);
 					log$36.info("工具调用开始", {
 						toolName: block.name,
 						displayName: getToolDisplayName(block.name),
@@ -905,6 +910,7 @@ var CCStreamParser = class extends EventEmitter {
 		});
 		if (Array.isArray(content)) {
 			for (const block of content) if (block.type === "tool_use" && block.name) {
+				this.recordToolUse(block.name, block.id);
 				log$36.info("从 assistant 消息提取工具调用", {
 					toolName: block.name,
 					displayName: getToolDisplayName(block.name),
@@ -924,10 +930,46 @@ var CCStreamParser = class extends EventEmitter {
 		const content = msg.message?.content;
 		if (!Array.isArray(content)) return;
 		for (const item of content) if (item.type === "tool_result" && item.tool_use_id) {
-			log$36.debug("工具结果返回", { toolUseId: item.tool_use_id });
-			this.emit("toolResult", item.tool_use_id);
+			const result = this.buildToolResultSummary(item, msg.toolUseResult);
+			log$36.debug("工具结果返回", {
+				toolUseId: item.tool_use_id,
+				toolName: result.toolName,
+				isError: result.isError,
+				truncated: result.truncated
+			});
+			this.emit("toolResult", item.tool_use_id, result);
+		}
+	}
+	handleSystem(msg) {
+		if (msg.subtype !== "init" || !Array.isArray(msg.tools)) return;
+		this.declaredTools = new Set(msg.tools);
+	}
+	recordToolUse(toolName, toolUseId) {
+		if (toolUseId) this.toolNamesById.set(toolUseId, toolName);
+		if (this.declaredTools && !this.declaredTools.has(toolName)) {
+			log$36.warn("模型请求了未声明工具", {
+				toolName,
+				toolUseId
+			});
+			this.emit("unknownToolUse", toolName, toolUseId);
 		}
 	}
+	buildToolResultSummary(item, toolUseResult) {
+		const serializedContent = serializeToolResultContent(item.content);
+		const truncatedContent = truncateToolResultContent(serializedContent);
+		const toolUseResultSummary = summarizeToolUseResult(toolUseResult);
+		return {
+			toolCallId: item.tool_use_id,
+			toolName: this.toolNamesById.get(item.tool_use_id),
+			rawType: "tool_result",
+			isError: item.is_error,
+			content: truncatedContent.content,
+			resultSummary: extractToolResultSummary(serializedContent, toolUseResultSummary),
+			truncated: truncatedContent.truncated || toolUseResultSummary.truncated,
+			originalSize: Math.max(serializedContent.length, toolUseResultSummary.originalSize),
+			toolUseResult: toolUseResultSummary.summary
+		};
+	}
 	/**
 	* 处理 tool_progress 消息 — 工具执行进度
 	*/
@@ -959,6 +1001,52 @@ var CCStreamParser = class extends EventEmitter {
 		});
 	}
 };
+function serializeToolResultContent(content) {
+	if (typeof content === "string") return content;
+	return safeJsonStringify(content);
+}
+function summarizeToolUseResult(value) {
+	if (value === void 0) return {
+		originalSize: 0,
+		truncated: false
+	};
+	const serialized = typeof value === "string" ? value : safeJsonStringify(value);
+	const truncated = truncateToolResultContent(serialized);
+	return {
+		summary: typeof value === "string" ? truncated.content : tryParseJson$1(truncated.content) ?? truncated.content,
+		originalSize: serialized.length,
+		truncated: truncated.truncated
+	};
+}
+function truncateToolResultContent(content) {
+	if (content.length <= MAX_TOOL_RESULT_CONTENT_CHARS) return {
+		content,
+		truncated: false
+	};
+	return {
+		content: content.slice(0, MAX_TOOL_RESULT_CONTENT_CHARS),
+		truncated: true
+	};
+}
+function extractToolResultSummary(content, toolUseResult) {
+	const text = (typeof toolUseResult.summary === "string" ? toolUseResult.summary : toolUseResult.summary === void 0 ? void 0 : safeJsonStringify(toolUseResult.summary)) || content;
+	const summary = (text.match(/<tool_use_error>([\s\S]*?)<\/tool_use_error>/)?.[1] || text).trim();
+	return summary ? truncateToolResultContent(summary).content : void 0;
+}
+function safeJsonStringify(value) {
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+function tryParseJson$1(value) {
+	try {
+		return JSON.parse(value);
+	} catch {
+		return;
+	}
+}
 //#endregion
 //#region src/cc-runtime/process-manager.ts
 /**
@@ -1416,8 +1504,11 @@ var SessionProcessManager = class {
 		parser.on("toolUseStart", (toolName, toolInput) => {
 			getCallbacks()?.onToolUseStart?.(toolName, toolInput);
 		});
-		parser.on("toolResult", (toolUseId) => {
-			getCallbacks()?.onToolResult?.(toolUseId);
+		parser.on("toolResult", (toolUseId, result) => {
+			getCallbacks()?.onToolResult?.(toolUseId, result);
+		});
+		parser.on("unknownToolUse", (toolName, toolUseId) => {
+			getCallbacks()?.onUnknownToolUse?.(toolName, toolUseId);
 		});
 		parser.on("toolProgress", (toolName, elapsedSeconds) => {
 			getCallbacks()?.onToolProgress?.(toolName, elapsedSeconds);
@@ -3373,6 +3464,139 @@ function createChatAuthRouter() {
 	return router;
 }
 //#endregion
+//#region src/gateway/runtime-context.ts
+const CLAUDE_MD_START = "<!-- LARKPAL_RUNTIME_INSTRUCTIONS_START -->";
+const CLAUDE_MD_END = "<!-- LARKPAL_RUNTIME_INSTRUCTIONS_END -->";
+function materializeRuntimeContext(params) {
+	const instructions = normalizeRuntimeInstructions(params.instructions);
+	const skills = normalizeRuntimeSkills(params.skills);
+	if (instructions.length === 0 && skills.length === 0) return void 0;
+	return {
+		instructions: instructions.length > 0 ? writeRuntimeInstructions(params.cwd, instructions) : [],
+		skills: skills.map((skill) => writeRuntimeSkill(params.cwd, skill))
+	};
+}
+function normalizeRuntimeInstructions(value) {
+	if (!Array.isArray(value)) return [];
+	return value.map((item) => {
+		if (!item || typeof item !== "object" || Array.isArray(item)) return null;
+		const record = item;
+		const id = readNonEmptyString(record.id);
+		const content = readNonEmptyString(record.content);
+		if (!id || !content) return null;
+		return {
+			id,
+			content,
+			scope: readScope(record.scope),
+			version: readNonEmptyString(record.version)
+		};
+	}).filter((item) => item != null);
+}
+function normalizeRuntimeSkills(value) {
+	if (!Array.isArray(value)) return [];
+	return value.map((item) => {
+		if (!item || typeof item !== "object" || Array.isArray(item)) return null;
+		const record = item;
+		const id = readNonEmptyString(record.id);
+		const content = readNonEmptyString(record.content) || readNonEmptyString(record.skillMarkdown);
+		if (!id || !content) return null;
+		return {
+			id,
+			content,
+			scope: readScope(record.scope),
+			version: readNonEmptyString(record.version),
+			name: readNonEmptyString(record.name),
+			description: readNonEmptyString(record.description)
+		};
+	}).filter((item) => item != null);
+}
+function writeRuntimeInstructions(cwd, instructions) {
+	const filePath = join(cwd, "CLAUDE.md");
+	const body = [
+		CLAUDE_MD_START,
+		"# LarkPal Runtime Instructions",
+		"",
+		"The following instructions were injected by LarkPal for this agent session. Treat them as runtime context, not as user message content.",
+		"",
+		...instructions.flatMap((instruction) => [
+			`## ${instruction.id}`,
+			"",
+			instruction.content.trim(),
+			""
+		]),
+		CLAUDE_MD_END,
+		""
+	].join("\n");
+	const next = replaceManagedBlock(existsSync(filePath) ? readFileSync(filePath, "utf-8") : "", body);
+	mkdirSync(dirname(filePath), { recursive: true });
+	writeFileSync(filePath, next, "utf-8");
+	return instructions.map((instruction) => ({
+		id: instruction.id,
+		scope: instruction.scope ?? "request",
+		hash: hashContent(instruction.content),
+		version: instruction.version,
+		path: "CLAUDE.md"
+	}));
+}
+function writeRuntimeSkill(cwd, skill) {
+	const relativePath = `.claude/skills/${sanitizePathSegment(skill.id)}/SKILL.md`;
+	const filePath = join(cwd, relativePath);
+	const content = buildSkillContent(skill);
+	mkdirSync(dirname(filePath), { recursive: true });
+	writeFileSync(filePath, content, "utf-8");
+	return {
+		id: skill.id,
+		scope: skill.scope ?? "request",
+		hash: hashContent(content),
+		version: skill.version,
+		path: relativePath
+	};
+}
+function buildSkillContent(skill) {
+	const content = skill.content.trim();
+	if (content.startsWith("---")) return `${content}\n`;
+	const name = skill.name || skill.id;
+	const description = skill.description || `Runtime skill injected by LarkPal: ${skill.id}`;
+	return [
+		"---",
+		`name: ${yamlScalar(name)}`,
+		`description: ${yamlScalar(description)}`,
+		"---",
+		"",
+		content,
+		""
+	].join("\n");
+}
+function replaceManagedBlock(current, managedBlock) {
+	const start = current.indexOf(CLAUDE_MD_START);
+	const end = current.indexOf(CLAUDE_MD_END);
+	if (start !== -1 && end !== -1 && end > start) {
+		const before = current.slice(0, start).trimEnd();
+		const after = current.slice(end + 41).trimStart();
+		return [
+			before,
+			managedBlock.trimEnd(),
+			after
+		].filter(Boolean).join("\n\n") + "\n";
+	}
+	return [current.trimEnd(), managedBlock.trimEnd()].filter(Boolean).join("\n\n") + "\n";
+}
+function hashContent(content) {
+	return `sha256:${createHash("sha256").update(content).digest("hex")}`;
+}
+function sanitizePathSegment(value) {
+	return value.replace(/[^A-Za-z0-9._-]/g, "_").replace(/^\.+$/, "skill") || "skill";
+}
+function readNonEmptyString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readScope(value) {
+	return value === "app" || value === "session" || value === "request" ? value : "request";
+}
+function yamlScalar(value) {
+	return JSON.stringify(value);
+}
+//#endregion
 //#region src/gateway/agent-context.ts
 const SENSITIVE_KEY_PATTERN = /(authorization|cookie|token|api[-_]?key|secret|password|credential)/i;
 const SAFE_KEY_PATTERN = /^(file[-_]?token|drive[-_]?file[-_]?token|doc[-_]?token|sheet[-_]?token|wiki[-_]?token|node[-_]?token)$/i;
@@ -3414,11 +3638,17 @@ function buildAgentRuntimeConfig(input) {
 	const userId = requireContextField(input.identity?.userId || input.identity?.openId, "userId");
 	const scenarioId = getScenarioId(input.scenarioId, input.metadata);
 	const cwd = resolveAgentCwd(sessionId, input.cwd);
+	const runtimeContext = materializeRuntimeContext({
+		cwd,
+		instructions: input.runtimeInstructions,
+		skills: input.runtimeSkills
+	});
 	const metadata = buildRunMetadata(input.metadata, {
 		conversationId,
 		traceId,
 		entrypoint: input.entrypoint,
-		scenarioId
+		scenarioId,
+		runtimeContext
 	});
 	const authHeaders = buildAuthHeaders({
 		tenantKey,
@@ -3450,6 +3680,7 @@ function buildAgentRuntimeConfig(input) {
 		authHeaders,
 		attachments: input.attachments,
 		sourceArtifacts: input.sourceArtifacts,
+		runtimeContext,
 		llmConfig: input.llmConfig,
 		policy,
 		metadata
@@ -3468,6 +3699,7 @@ function buildAgentRuntimeConfig(input) {
 		authHeaders,
 		attachments: input.attachments,
 		sourceArtifacts: input.sourceArtifacts,
+		runtimeContext,
 		llmConfig: input.llmConfig,
 		policy,
 		requestContext,
@@ -3553,6 +3785,7 @@ function buildRunInputAuditMetadata(config) {
 	const metadata = {};
 	if (config.attachments !== void 0) metadata.attachments = summarizeForAudit(config.attachments);
 	if (config.sourceArtifacts !== void 0) metadata.sourceArtifacts = summarizeForAudit(config.sourceArtifacts);
+	if (config.runtimeContext !== void 0) metadata.runtimeContext = config.runtimeContext;
 	return metadata;
 }
 function buildRuntimeEventAuditMetadata(event) {
@@ -3641,7 +3874,8 @@ function buildRunMetadata(metadata, context) {
 		conversationId: context.conversationId,
 		traceId: context.traceId,
 		entrypoint: context.entrypoint,
-		...context.scenarioId ? { scenarioId: context.scenarioId } : {}
+		...context.scenarioId ? { scenarioId: context.scenarioId } : {},
+		...context.runtimeContext ? { runtimeContext: context.runtimeContext } : {}
 	};
 }
 function buildAuditMetadata(context, metadata) {
@@ -3732,6 +3966,9 @@ function serializeChatRun(run) {
 		lastEventAt: run.lastEventAt,
 		lastEventType: run.lastEventType,
 		lastToolName: run.lastToolName,
+		lastToolError: run.lastToolError,
+		unknownToolCallCount: run.unknownToolCallCount,
+		lastUnknownToolName: run.lastUnknownToolName,
 		idleSeconds,
 		adapterBusy: run.status === "running" ? run.adapterBusy : false,
 		processStatus,
@@ -4244,6 +4481,29 @@ function isPathInside(parent, child) {
 	const path = relative(parent, child);
 	return path !== "" && !path.startsWith("..") && !isAbsolute(path);
 }
+function buildToolResultPayload(result, resultSummary) {
+	if (!result || typeof result !== "object" || Array.isArray(result)) return { result: resultSummary };
+	const record = result;
+	return {
+		rawType: record.rawType,
+		isError: record.isError,
+		content: record.content,
+		resultSummary: record.resultSummary ?? resultSummary,
+		truncated: record.truncated,
+		originalSize: record.originalSize,
+		result: resultSummary
+	};
+}
+function readStringField(value, key) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const field = value[key];
+	return typeof field === "string" ? field : void 0;
+}
+function readBooleanField(value, key) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const field = value[key];
+	return typeof field === "boolean" ? field : void 0;
+}
 /**
 * 创建 Chat 流式对话 + 历史查询路由
 *
@@ -4353,6 +4613,8 @@ function createChatRouter(config) {
 		const scenarioId = getScenarioId(body.options?.scenarioId, body.options?.metadata);
 		const attachments = getRunInputValue(body.attachments, body.options?.attachments, body.options?.metadata?.attachments);
 		const sourceArtifacts = getRunInputValue(body.sourceArtifacts, body.source_artifacts, body.options?.sourceArtifacts, body.options?.source_artifacts, body.options?.metadata?.sourceArtifacts, body.options?.metadata?.source_artifacts);
+		const runtimeInstructions = getRunInputValue(body.runtimeInstructions, body.runtime_instructions, body.options?.runtimeInstructions, body.options?.runtime_instructions, body.options?.metadata?.runtimeInstructions, body.options?.metadata?.runtime_instructions);
+		const runtimeSkills = getRunInputValue(body.runtimeSkills, body.runtime_skills, body.options?.runtimeSkills, body.options?.runtime_skills, body.options?.metadata?.runtimeSkills, body.options?.metadata?.runtime_skills);
 		log$30.info("[stream] 收到流式对话请求", {
 			userId,
 			sessionId,
@@ -4361,6 +4623,8 @@ function createChatRouter(config) {
 			scenarioId,
 			hasAttachments: attachments !== void 0,
 			hasSourceArtifacts: sourceArtifacts !== void 0,
+			hasRuntimeInstructions: runtimeInstructions !== void 0,
+			hasRuntimeSkills: runtimeSkills !== void 0,
 			promptLength: body.prompt.length
 		});
 		if (!sessionId) {
@@ -4408,6 +4672,8 @@ function createChatRouter(config) {
 			model: process.env.CLAUDE_MODEL || void 0,
 			attachments,
 			sourceArtifacts,
+			runtimeInstructions,
+			runtimeSkills,
 			policy: body.options?.policy,
 			metadata: body.options?.metadata,
 			identity: {
@@ -4447,10 +4713,7 @@ function createChatRouter(config) {
 					requestId,
 					traceId,
 					scenarioId,
-					...buildRunInputAuditMetadata({
-						attachments,
-						sourceArtifacts
-					})
+					...buildRunInputAuditMetadata(runtimeConfig)
 				}
 			});
 		} catch (err) {
@@ -4594,8 +4857,12 @@ function createChatRouter(config) {
 				if (run.status !== "running") return;
 				recordRunEvent(run, "tool-result");
 				const resultSummary = summarizeForAudit(result);
+				const toolName = readStringField(result, "toolName") || run.lastToolName;
+				const isError = readBooleanField(result, "isError");
+				if (isError) run.lastToolError = resultSummary;
 				if (runtimeConfig.requestContext) logChatAudit(buildAuditEvent(runtimeConfig.requestContext, "tool_call_finished", {
 					toolCallId: toolUseId,
+					toolName,
 					resultSummary,
 					metadata: buildToolResultAuditMetadata(result)
 				}));
@@ -4604,7 +4871,8 @@ function createChatRouter(config) {
 					role: "tool",
 					content: JSON.stringify({
 						toolUseId,
-						result: resultSummary
+						toolName,
+						...buildToolResultPayload(result, resultSummary)
 					}),
 					channel: "web",
 					metadata: {
@@ -4614,12 +4882,33 @@ function createChatRouter(config) {
 						scenarioId,
 						runtimeEventType: "tool-result",
 						toolCallId: toolUseId,
-						toolResult: resultSummary
+						toolName,
+						toolResult: resultSummary,
+						isError
 					}
 				}, "[stream] 保存 tool result 消息失败");
 				broadcastRunEvent(run, "tool-result", {
 					toolUseId,
-					result: resultSummary
+					toolName,
+					...buildToolResultPayload(result, resultSummary)
+				});
+			},
+			onUnknownToolUse: (toolName, toolUseId) => {
+				if (run.status !== "running") return;
+				run.unknownToolCallCount = (run.unknownToolCallCount ?? 0) + 1;
+				run.lastUnknownToolName = toolName;
+				run.lastToolError = {
+					isError: true,
+					reasonCode: "UNKNOWN_TOOL_CALL",
+					toolName,
+					toolCallId: toolUseId
+				};
+				recordRunEvent(run, "unknown-tool-use", { toolName });
+				broadcastRunEvent(run, "runtime-event", {
+					type: "unknown-tool-use",
+					toolName,
+					toolUseId,
+					unknownToolCallCount: run.unknownToolCallCount
 				});
 			},
 			onToolProgress: (toolName, elapsedSeconds) => {
@@ -5967,6 +6256,8 @@ async function handleExecute(req, res, processManager) {
 	const scenarioId = getScenarioId(body.scenarioId || body.scenario_id, body.metadata);
 	const attachments = getRunInputValue(body.attachments, body.metadata?.attachments);
 	const sourceArtifacts = getRunInputValue(body.sourceArtifacts, body.source_artifacts, body.metadata?.sourceArtifacts, body.metadata?.source_artifacts);
+	const runtimeInstructions = getRunInputValue(body.runtimeInstructions, body.runtime_instructions, body.metadata?.runtimeInstructions, body.metadata?.runtime_instructions);
+	const runtimeSkills = getRunInputValue(body.runtimeSkills, body.runtime_skills, body.metadata?.runtimeSkills, body.metadata?.runtime_skills);
 	const identity = resolveExecuteIdentity(req, body);
 	const missingIdentityFields = getMissingIdentityFields(identity);
 	if (missingIdentityFields.length > 0) {
@@ -6013,6 +6304,8 @@ async function handleExecute(req, res, processManager) {
 			authHeaders: body.auth_headers,
 			attachments,
 			sourceArtifacts,
+			runtimeInstructions,
+			runtimeSkills,
 			policy: body.policy,
 			metadata: body.metadata,
 			identity
@@ -6141,6 +6434,8 @@ async function handleBatchExecute(req, res, processManager) {
 	const scenarioId = getScenarioId(body.scenarioId || body.scenario_id, body.metadata);
 	const batchAttachments = getRunInputValue(body.attachments, body.metadata?.attachments);
 	const batchSourceArtifacts = getRunInputValue(body.sourceArtifacts, body.source_artifacts, body.metadata?.sourceArtifacts, body.metadata?.source_artifacts);
+	const batchRuntimeInstructions = getRunInputValue(body.runtimeInstructions, body.runtime_instructions, body.metadata?.runtimeInstructions, body.metadata?.runtime_instructions);
+	const batchRuntimeSkills = getRunInputValue(body.runtimeSkills, body.runtime_skills, body.metadata?.runtimeSkills, body.metadata?.runtime_skills);
 	const concurrency = body.concurrency ?? 3;
 	const taskIds = [];
 	const taskConfigs = [];
@@ -6156,6 +6451,8 @@ async function handleBatchExecute(req, res, processManager) {
 			};
 			const taskAttachments = getRunInputValue(task.attachments, task.metadata?.attachments, batchAttachments);
 			const taskSourceArtifacts = getRunInputValue(task.sourceArtifacts, task.source_artifacts, task.metadata?.sourceArtifacts, task.metadata?.source_artifacts, batchSourceArtifacts);
+			const taskRuntimeInstructions = getRunInputValue(task.runtimeInstructions, task.runtime_instructions, task.metadata?.runtimeInstructions, task.metadata?.runtime_instructions, batchRuntimeInstructions);
+			const taskRuntimeSkills = getRunInputValue(task.runtimeSkills, task.runtime_skills, task.metadata?.runtimeSkills, task.metadata?.runtime_skills, batchRuntimeSkills);
 			const config = buildAgentRuntimeConfig({
 				requestId: `${batchRequestId}:${index}`,
 				traceId,
@@ -6168,6 +6465,8 @@ async function handleBatchExecute(req, res, processManager) {
 				authHeaders: body.auth_headers,
 				attachments: taskAttachments,
 				sourceArtifacts: taskSourceArtifacts,
+				runtimeInstructions: taskRuntimeInstructions,
+				runtimeSkills: taskRuntimeSkills,
 				policy: body.policy,
 				metadata: taskMetadata,
 				identity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-lark/larkpal",
-  "version": "0.1.73",
+  "version": "0.1.75",
   "description": "LarkPal - Lark/Feishu bot service",
   "type": "module",
   "main": "./dist/main.mjs",