@vibe-lark/larkpal 0.1.52 → 0.1.54

package/dist/main.mjs

@@ -2326,6 +2326,8 @@ function buildAgentRuntimeConfig(input) {
 		userName: input.identity?.userName,
 		cwd,
 		authHeaders,
+		attachments: input.attachments,
+		sourceArtifacts: input.sourceArtifacts,
 		llmConfig: input.llmConfig,
 		policy,
 		metadata
@@ -2341,6 +2343,8 @@ function buildAgentRuntimeConfig(input) {
 		userContext,
 		tenantContext: { tenantKey },
 		authHeaders,
+		attachments: input.attachments,
+		sourceArtifacts: input.sourceArtifacts,
 		llmConfig: input.llmConfig,
 		policy,
 		requestContext,
@@ -2359,6 +2363,9 @@ function buildAgentRuntimeConfig(input) {
 		metadata
 	};
 }
+function getRunInputValue(...values) {
+	return values.find((value) => value !== void 0);
+}
 function summarizeForAudit(value) {
 	if (value == null) return value;
 	if (typeof value === "string") return summarizeString(value);
@@ -2419,6 +2426,39 @@ function buildVerifierAuditMetadata(result) {
 	if (result.missingArtifacts) metadata.missingArtifacts = summarizeForAudit(result.missingArtifacts);
 	return metadata;
 }
+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);
+	return metadata;
+}
+function buildRuntimeEventAuditMetadata(event) {
+	const metadata = {
+		runtimeEventType: event.type,
+		runtimeEvent: summarizeForAudit(event)
+	};
+	for (const key of [
+		"scenarioId",
+		"traceId",
+		"phaseId",
+		"artifactName",
+		"artifactNames",
+		"capabilityId",
+		"repairActionId",
+		"repairAttempt",
+		"targetPhase",
+		"requiredNextPhases",
+		"plannerInstruction",
+		"reasonCode",
+		"verifierReasonCode",
+		"missingPhases",
+		"failedGates",
+		"missingArtifacts",
+		"status",
+		"finalStatus"
+	]) if (event[key] !== void 0) metadata[key] = summarizeForAudit(event[key]);
+	return metadata;
+}
 function buildAuthHeaders(params) {
 	const headers = {
 		"x-tenant-key": params.tenantKey,
@@ -2571,6 +2611,8 @@ async function handleExecute(req, res, processManager) {
 	const traceId = body.traceId || body.trace_id || getGatewayTraceId(req.headers, requestId);
 	const conversationId = body.conversationId || body.conversation_id || body.session_id;
 	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 identity = resolveExecuteIdentity(req, body);
 	const missingIdentityFields = getMissingIdentityFields(identity);
 	if (missingIdentityFields.length > 0) {
@@ -2615,6 +2657,8 @@ async function handleExecute(req, res, processManager) {
 				model: body.llm_config.model
 			} : void 0,
 			authHeaders: body.auth_headers,
+			attachments,
+			sourceArtifacts,
 			policy: body.policy,
 			metadata: body.metadata,
 			identity
@@ -2669,6 +2713,7 @@ async function handleExecute(req, res, processManager) {
 	try {
 		logRunStarted(config);
 		const result = await executeAndWaitResult$1(taskId, config, processManager);
+		const completedTask = taskStore.get(taskId);
 		logger$8.info("同步任务执行完成", {
 			taskId,
 			resultSubtype: result?.subtype
@@ -2676,10 +2721,12 @@ async function handleExecute(req, res, processManager) {
 		res.status(200).json({
 			task_id: taskId,
 			status: result?.isError ? "failed" : "completed",
-			result
+			result,
+			...completedTask?.runtimeEvents?.length ? { runtime_events: completedTask.runtimeEvents } : {}
 		});
 	} catch (err) {
 		const errorMsg = err instanceof Error ? err.message : String(err);
+		const failedTask = taskStore.get(taskId);
 		logger$8.error("同步任务执行失败", {
 			taskId,
 			error: errorMsg
@@ -2687,7 +2734,8 @@ async function handleExecute(req, res, processManager) {
 		res.status(500).json({
 			task_id: taskId,
 			status: "failed",
-			error: errorMsg
+			error: errorMsg,
+			...failedTask?.runtimeEvents?.length ? { runtime_events: failedTask.runtimeEvents } : {}
 		});
 	} finally {
 		releaseTaskIfRunning(taskId);
@@ -2737,6 +2785,8 @@ async function handleBatchExecute(req, res, processManager) {
 	const batchRequestId = getGatewayRequestId(req.headers);
 	const traceId = getGatewayTraceId(req.headers, batchRequestId);
 	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 concurrency = body.concurrency ?? 3;
 	const taskIds = [];
 	const taskConfigs = [];
@@ -2744,6 +2794,14 @@ async function handleBatchExecute(req, res, processManager) {
 		const taskId = v4();
 		taskIds.push(taskId);
 		try {
+			const taskMetadata = {
+				...body.metadata,
+				...task.metadata,
+				batchId,
+				batchTaskIndex: index
+			};
+			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 config = buildAgentRuntimeConfig({
 				requestId: `${batchRequestId}:${index}`,
 				traceId,
@@ -2754,12 +2812,10 @@ async function handleBatchExecute(req, res, processManager) {
 				cwd: task.cwd,
 				prompt: task.prompt,
 				authHeaders: body.auth_headers,
+				attachments: taskAttachments,
+				sourceArtifacts: taskSourceArtifacts,
 				policy: body.policy,
-				metadata: {
-					...body.metadata,
-					batchId,
-					batchTaskIndex: index
-				},
+				metadata: taskMetadata,
 				identity
 			});
 			const taskInfo = {
@@ -2826,6 +2882,7 @@ function handleGetTask(req, res) {
 	};
 	if (taskInfo.result) response.result = taskInfo.result;
 	if (taskInfo.error) response.error = taskInfo.error;
+	if (taskInfo.runtimeEvents?.length) response.runtime_events = taskInfo.runtimeEvents;
 	res.status(200).json(response);
 }
 /**
@@ -2916,12 +2973,36 @@ function logRunStarted(config) {
 		traceId: config.runContext?.traceId,
 		requestId: config.runContext?.requestId,
 		entrypoint: config.runContext?.entrypoint,
-		scenarioId: config.runContext?.scenarioId
+		scenarioId: config.runContext?.scenarioId,
+		...buildRunInputAuditMetadata(config)
 	} }));
 }
 function logAuditEvent(event) {
 	logger$8.info("Agent audit event", { ...event });
 }
+function recordRuntimeEvent(taskId, config, event) {
+	const eventSummary = summarizeForAudit(event);
+	const taskInfo = taskStore.get(taskId);
+	if (taskInfo) {
+		taskInfo.runtimeEvents = taskInfo.runtimeEvents || [];
+		taskInfo.runtimeEvents.push({
+			type: event.type,
+			event: eventSummary
+		});
+	}
+	logger$8.info("Agent runtime event", {
+		taskId,
+		type: event.type,
+		traceId: config.runContext?.traceId,
+		scenarioId: event.scenarioId || config.runContext?.scenarioId,
+		phaseId: event.phaseId,
+		reasonCode: event.reasonCode || event.verifierReasonCode
+	});
+	if (config.requestContext) logAuditEvent(buildAuditEvent(config.requestContext, "runtime_event", {
+		resultSummary: eventSummary,
+		metadata: buildRuntimeEventAuditMetadata(event)
+	}));
+}
 /**
 * 创建任务级别的流回调
 *
@@ -3021,6 +3102,12 @@ function createTaskCallbacks(taskId, config) {
 				metadata: buildVerifierAuditMetadata(result)
 			}));
 		},
+		onRuntimeEvent: (event) => {
+			recordRuntimeEvent(taskId, config, event);
+		},
+		onScenarioEvent: (event) => {
+			recordRuntimeEvent(taskId, config, event);
+		},
 		onBlocked: handleBlockedEvent,
 		onBlockedEvent: handleBlockedEvent
 	};
@@ -4825,6 +4912,27 @@ function isChatSessionRunning(sessionId, processManager) {
 function logChatAudit(event) {
 	log$25.info("[stream] Agent audit event", { ...event });
 }
+function buildRuntimeEventMessageMetadata(event, runtimeConfig) {
+	return {
+		runtimeEventType: event.type,
+		requestId: runtimeConfig.runContext?.requestId,
+		traceId: runtimeConfig.runContext?.traceId,
+		scenarioId: event.scenarioId || runtimeConfig.runContext?.scenarioId,
+		phaseId: event.phaseId,
+		artifactName: event.artifactName,
+		artifactNames: event.artifactNames,
+		targetPhase: event.targetPhase,
+		requiredNextPhases: event.requiredNextPhases,
+		plannerInstruction: event.plannerInstruction,
+		verifierReasonCode: event.verifierReasonCode,
+		reasonCode: event.reasonCode,
+		missingPhases: event.missingPhases,
+		failedGates: event.failedGates,
+		missingArtifacts: event.missingArtifacts,
+		repairAttempt: event.repairAttempt,
+		finalStatus: event.finalStatus
+	};
+}
 /**
 * 创建 Chat 流式对话 + 历史查询路由
 *
@@ -4852,12 +4960,16 @@ function createChatRouter(config) {
 		const requestId = getGatewayRequestId(req.headers);
 		const traceId = getGatewayTraceId(req.headers, requestId);
 		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);
 		log$25.info("[stream] 收到流式对话请求", {
 			userId,
 			sessionId: body.session_id,
 			requestId,
 			traceId,
 			scenarioId,
+			hasAttachments: attachments !== void 0,
+			hasSourceArtifacts: sourceArtifacts !== void 0,
 			promptLength: body.prompt.length
 		});
 		let sessionId = body.session_id;
@@ -4895,7 +5007,16 @@ function createChatRouter(config) {
 				sessionId,
 				role: "user",
 				content: body.prompt,
-				channel: "web"
+				channel: "web",
+				metadata: {
+					requestId,
+					traceId,
+					scenarioId,
+					...buildRunInputAuditMetadata({
+						attachments,
+						sourceArtifacts
+					})
+				}
 			});
 		} catch (err) {
 			activeStreamSessions.delete(sessionId);
@@ -4924,6 +5045,8 @@ function createChatRouter(config) {
 			maxTurns: body.options?.maxTurns,
 			maxBudgetUsd: body.options?.maxBudgetUsd,
 			model: process.env.CLAUDE_MODEL || void 0,
+			attachments,
+			sourceArtifacts,
 			policy: body.options?.policy,
 			metadata: body.options?.metadata,
 			identity: {
@@ -4953,6 +5076,32 @@ function createChatRouter(config) {
 			clientDisconnected = true;
 			log$25.info("[stream] 客户端断开连接", { sessionId });
 		});
+		const handleRuntimeEvent = (event) => {
+			const eventSummary = summarizeForAudit(event);
+			if (runtimeConfig.requestContext) logChatAudit(buildAuditEvent(runtimeConfig.requestContext, "runtime_event", {
+				resultSummary: eventSummary,
+				metadata: buildRuntimeEventAuditMetadata(event)
+			}));
+			messageStore.appendMessage({
+				sessionId,
+				role: "tool",
+				content: JSON.stringify({
+					runtimeEventType: event.type,
+					event: eventSummary
+				}),
+				channel: "web",
+				metadata: buildRuntimeEventMessageMetadata(event, runtimeConfig)
+			}).catch((err) => {
+				log$25.error("[stream] 保存 runtime event 消息失败", {
+					sessionId,
+					error: err
+				});
+			});
+			if (!clientDisconnected) sendSSE(res, "runtime-event", {
+				type: event.type,
+				event: eventSummary
+			});
+		};
 		const callbacks = {
 			onTextDelta: (text) => {
 				accumText += text;
@@ -5091,6 +5240,8 @@ function createChatRouter(config) {
 				}));
 				if (!clientDisconnected) sendSSE(res, "verifier-result", { result: resultSummary });
 			},
+			onRuntimeEvent: handleRuntimeEvent,
+			onScenarioEvent: handleRuntimeEvent,
 			onBlocked: handleBlockedEvent,
 			onBlockedEvent: handleBlockedEvent
 		};
@@ -5103,7 +5254,8 @@ function createChatRouter(config) {
 				traceId: runtimeConfig.runContext?.traceId,
 				requestId: runtimeConfig.runContext?.requestId,
 				entrypoint: runtimeConfig.runContext?.entrypoint,
-				scenarioId: runtimeConfig.runContext?.scenarioId
+				scenarioId: runtimeConfig.runContext?.scenarioId,
+				...buildRunInputAuditMetadata(runtimeConfig)
 			} }));
 			log$25.info("[stream] 开始执行 prompt", {
 				sessionId,
@@ -11117,6 +11269,8 @@ function buildAuthCard(ctx) {
 	const openPlatformHost = ctx.brand === "lark" ? "https://open.larksuite.com" : "https://open.feishu.cn";
 	const scopeQuery = ctx.scopes.join(",");
 	const authUrl = `${openPlatformHost}/app/${ctx.appId}/auth?q=${encodeURIComponent(scopeQuery)}`;
+	const scopeList = ctx.scopes.map((s) => `• \`${s}\``).join("\n");
+	const reason = ctx.reason?.trim();
 	const card = {
 		schema: "2.0",
 		config: {
@@ -11131,8 +11285,12 @@ function buildAuthCard(ctx) {
 			},
 			{
 				tag: "markdown",
-				content: `当前操作需要以下飞书权限，请应用管理员前往开放平台申请：\n\n${ctx.scopes.map((s) => `• \`${s}\``).join("\n")}`
+				content: `当前操作需要以下飞书权限，请应用管理员前往开放平台申请：\n\n${scopeList}`
 			},
+			...reason ? [{
+				tag: "markdown",
+				content: `**申请原因：** ${reason}`
+			}] : [],
 			{ tag: "hr" },
 			{
 				tag: "markdown",
@@ -11140,11 +11298,13 @@ function buildAuthCard(ctx) {
 			},
 			{
 				tag: "button",
+				name: getAuthButtonName("open"),
 				text: {
 					tag: "plain_text",
 					content: "去申请权限 ↗"
 				},
 				type: "primary",
+				width: "default",
 				multi_url: {
 					url: authUrl,
 					pc_url: authUrl,
@@ -11158,12 +11318,14 @@ function buildAuthCard(ctx) {
 			},
 			{
 				tag: "button",
+				name: getAuthButtonName("complete"),
 				text: {
 					tag: "plain_text",
 					content: "✓ 已完成权限配置"
 				},
 				type: "text",
 				size: "small",
+				width: "default",
 				behaviors: [{
 					type: "callback",
 					value: {
@@ -11195,6 +11357,9 @@ function buildAuthCard(ctx) {
 		operationId
 	};
 }
+function getAuthButtonName(action) {
+	return `auth_${action}`;
+}
 /**
 * 构建多 phase 提问卡片（CardKit v2 格式）
 *
@@ -12091,6 +12256,49 @@ async function dispatchToCC(params) {
 			log$12.warn("记录飞书 assistant 消息到 store 失败", { error: String(err) });
 		});
 	};
+	const appendRuntimeEventMessage = (event) => {
+		const eventSummary = summarizeForAudit(event);
+		log$12.info("CC onRuntimeEvent", {
+			sessionId: route.sessionId,
+			type: event.type,
+			traceId: runtimeConfig.runContext?.traceId,
+			scenarioId: event.scenarioId || runtimeConfig.runContext?.scenarioId,
+			phaseId: event.phaseId,
+			reasonCode: event.reasonCode || event.verifierReasonCode,
+			event: eventSummary
+		});
+		if (!params.messageStore) return;
+		params.messageStore.appendMessage({
+			sessionId: route.sessionId,
+			role: "tool",
+			content: JSON.stringify({
+				runtimeEventType: event.type,
+				event: eventSummary
+			}),
+			channel: "feishu-bot",
+			metadata: {
+				runtimeEventType: event.type,
+				requestId: runtimeConfig.runContext?.requestId,
+				traceId: runtimeConfig.runContext?.traceId,
+				scenarioId: event.scenarioId || runtimeConfig.runContext?.scenarioId,
+				phaseId: event.phaseId,
+				artifactName: event.artifactName,
+				artifactNames: event.artifactNames,
+				targetPhase: event.targetPhase,
+				requiredNextPhases: event.requiredNextPhases,
+				plannerInstruction: event.plannerInstruction,
+				verifierReasonCode: event.verifierReasonCode,
+				reasonCode: event.reasonCode,
+				missingPhases: event.missingPhases,
+				failedGates: event.failedGates,
+				missingArtifacts: event.missingArtifacts,
+				repairAttempt: event.repairAttempt,
+				finalStatus: event.finalStatus
+			}
+		}).catch((err) => {
+			log$12.warn("记录飞书 runtime event 到 store 失败", { error: String(err) });
+		});
+	};
 	const handleResult = async (result) => {
 		log$12.info("CC onResult", {
 			sessionId: route.sessionId,
@@ -12228,6 +12436,8 @@ async function dispatchToCC(params) {
 				resultSummary: summarizeForAudit(event.resultSummary)
 			});
 		},
+		onRuntimeEvent: appendRuntimeEventMessage,
+		onScenarioEvent: appendRuntimeEventMessage,
 		onBlocked: handleBlockedEvent,
 		onBlockedEvent: handleBlockedEvent
 	};
@@ -12505,6 +12715,28 @@ async function dispatchTeammateEval(params) {
 						resultSummary: summarizeForAudit(event.resultSummary)
 					});
 				},
+				onRuntimeEvent: (event) => {
+					log$12.info("teammate onRuntimeEvent", {
+						type: event.type,
+						chatId,
+						traceId: runtimeConfig.runContext?.traceId,
+						scenarioId: event.scenarioId || runtimeConfig.runContext?.scenarioId,
+						phaseId: event.phaseId,
+						reasonCode: event.reasonCode || event.verifierReasonCode,
+						event: summarizeForAudit(event)
+					});
+				},
+				onScenarioEvent: (event) => {
+					log$12.info("teammate onScenarioEvent", {
+						type: event.type,
+						chatId,
+						traceId: runtimeConfig.runContext?.traceId,
+						scenarioId: event.scenarioId || runtimeConfig.runContext?.scenarioId,
+						phaseId: event.phaseId,
+						reasonCode: event.reasonCode || event.verifierReasonCode,
+						event: summarizeForAudit(event)
+					});
+				},
 				onBlocked: (event) => {
 					const sanitized = sanitizeBlockedEvent(event);
 					log$12.warn("teammate onBlocked", {
@@ -12587,6 +12819,7 @@ async function handleMcpToolCallback(req, ctx) {
 				sessionId: req.sessionId,
 				appId: ctx.appId,
 				scopes: params.scopes,
+				reason: params.reason,
 				brand: ctx.brand
 			});
 			mcpOperationMap.set(operationId, req.requestId);
@@ -15442,7 +15675,7 @@ function enqueueFeishuChatTask(params) {
 */
 const log$1 = larkLogger("channel/interactive-card-handler");
 async function handleAuthCompleteAction(_ctx, data) {
-	const operationId = data?.action?.value?.operationId;
+	const operationId = extractActionValue$1(data)?.operationId;
 	if (!operationId) return { toast: {
 		type: "error",
 		content: "操作参数缺失"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-lark/larkpal",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "LarkPal - Lark/Feishu bot service",
   "type": "module",
   "main": "./dist/main.mjs",
@@ -50,7 +50,7 @@
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
-    "@vibe-lark/larkpal-agent": "^0.1.9"
+    "@vibe-lark/larkpal-agent": "^0.1.16"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",