linkque-cli-v2 1.1.1 → 1.1.3

package/linkquejs.js

@@ -19639,6 +19639,8 @@ var LINKQUE_BASE_URL = `${LINKQUE_ENDPOINT_PROD}/api/anthropic`;
 var LINKQUE_BASE_URL_PRE = `${LINKQUE_ENDPOINT_PRE}/api/anthropic`;
 var LINKQUEGW_KNOWLEDGE_BASE_URL = LINKQUE_ENDPOINT_PROD;
 var LINKQUEGW_KNOWLEDGE_BASE_URL_PRE = LINKQUE_ENDPOINT_PRE;
+var LINKQUEGW_EVENT_BASE_URL = LINKQUE_ENDPOINT_PROD;
+var LINKQUEGW_EVENT_BASE_URL_PRE = LINKQUE_ENDPOINT_PRE;
 var LINKQUEGW_MCP_SIGN_ENDPOINT = `${LINKQUE_ENDPOINT_PROD}/api/mcp/signature`;
 var LINKQUEGW_MCP_SIGN_ENDPOINT_PRE = `${LINKQUE_ENDPOINT_PRE}/api/mcp/signature`;
 var RUN_TABLE_COLUMNS = [
@@ -20154,6 +20156,7 @@ var FUNCTION_DEFS = [
         key: "LINKQUEGW_KNOWLEDGE_BASE_URL",
         value: LINKQUEGW_KNOWLEDGE_BASE_URL
       },
+      { key: "LINKQUEGW_EVENT_BASE_URL", value: LINKQUEGW_EVENT_BASE_URL },
       {
         key: "LINKQUEGW_MCP_SIGN_ENDPOINT",
         value: LINKQUEGW_MCP_SIGN_ENDPOINT
@@ -20164,6 +20167,10 @@ var FUNCTION_DEFS = [
         key: "LINKQUEGW_KNOWLEDGE_BASE_URL_PRE",
         value: LINKQUEGW_KNOWLEDGE_BASE_URL_PRE
       },
+      {
+        key: "LINKQUEGW_EVENT_BASE_URL_PRE",
+        value: LINKQUEGW_EVENT_BASE_URL_PRE
+      },
       {
         key: "LINKQUEGW_MCP_SIGN_ENDPOINT_PRE",
         value: LINKQUEGW_MCP_SIGN_ENDPOINT_PRE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkque-cli-v2",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Public Linkque CLI bundle for sandbox debugging",
   "bin": {
     "linkquejs": "linkquejs.js"

package/vendor/linkque-agent-appwrite-integrate/dist/esm/{chunk-IAT272TH.js → chunk-B56A2RV5.js}

@@ -11811,6 +11811,8 @@ function describeRuntimeEnv(env, hasRequestKey = false) {
   lines.push(envLine("LINKQUE_BASE_URL_PRE", maskEndpoint(env.LINKQUE_BASE_URL_PRE)));
   lines.push(envLine("LINKQUEGW_KNOWLEDGE_BASE_URL", maskEndpoint(env.LINKQUEGW_KNOWLEDGE_BASE_URL)));
   lines.push(envLine("LINKQUEGW_KNOWLEDGE_BASE_URL_PRE", maskEndpoint(env.LINKQUEGW_KNOWLEDGE_BASE_URL_PRE)));
+  lines.push(envLine("LINKQUEGW_EVENT_BASE_URL", maskEndpoint(env.LINKQUEGW_EVENT_BASE_URL)));
+  lines.push(envLine("LINKQUEGW_EVENT_BASE_URL_PRE", maskEndpoint(env.LINKQUEGW_EVENT_BASE_URL_PRE)));
   lines.push(envLine("LINKQUEGW_MCP_SIGN_ENDPOINT", maskEndpoint(env.LINKQUEGW_MCP_SIGN_ENDPOINT)));
   lines.push(envLine("LINKQUEGW_MCP_SIGN_ENDPOINT_PRE", maskEndpoint(env.LINKQUEGW_MCP_SIGN_ENDPOINT_PRE)));
   lines.push(envLine("RUN_DATABASE_ID", envValue(env, "RUN_DATABASE_ID")));

package/vendor/linkque-agent-appwrite-integrate/dist/esm/{chunk-TM6MTGSL.js → chunk-MR5QT2A5.js}

@@ -16583,6 +16583,7 @@ var require_dist2 = __commonJS({
 // ../linkque-agent-runtime/dist/esm/core/types.js
 var EDebugLogScope;
 (function(EDebugLogScope2) {
+  EDebugLogScope2["CONFIG"] = "CONFIG";
   EDebugLogScope2["LLM"] = "LLM";
   EDebugLogScope2["PI_EVENT"] = "PI_EVENT";
   EDebugLogScope2["MCP"] = "MCP";
@@ -18342,11 +18343,7 @@ function injectResolvedViewModel(protocol, viewModel) {
     {
       version: "0.9",
       datas: surfaceIds.map((surfaceId) => ({
-        updateDataModel: {
-          surfaceId,
-          path: "/",
-          value: viewModel
-        }
+        updateDataModel: { surfaceId, path: "/", value: viewModel }
       }))
     }
   ];
@@ -19793,6 +19790,17 @@ var REDACTED_HEADER_NAMES = /* @__PURE__ */ new Set([
   "anthropic-api-key"
 ]);
 var REDACTED_VALUE = "ak***";
+var RESPONSE_CORRELATION_HEADER_NAMES = [
+  "alipay-trace-id",
+  "x-trace-id",
+  "x-traceid",
+  "trace-id",
+  "traceid",
+  "eagleeye-traceid",
+  "eagleeye-trace-id",
+  "sofa-traceid",
+  "sofa-trace-id"
+];
 function redactHeader(name, value) {
   return REDACTED_HEADER_NAMES.has(name.toLowerCase()) ? REDACTED_VALUE : value;
 }
@@ -19849,10 +19857,37 @@ function createHttpLoggingFetch(debugLog, tag, baseFetch = globalThis.fetch) {
         len = cl;
     } catch {
     }
-    safeLog(debugLog, formatHttpLogLine(tag, "resp", `${method} ${targetUrl} ${resp.status} in ${elapsed}ms len=${len}`));
+    const correlation = readResponseCorrelationId(resp.headers);
+    const correlationField = correlation ? ` traceId=${correlation.value} traceHeader=${correlation.name}` : "";
+    safeLog(debugLog, formatHttpLogLine(tag, "resp", `${method} ${targetUrl} ${resp.status} in ${elapsed}ms len=${len}${correlationField}`));
     return resp;
   };
 }
+function readResponseCorrelationId(headers) {
+  try {
+    for (const name of RESPONSE_CORRELATION_HEADER_NAMES) {
+      const value = headers.get(name)?.trim();
+      if (value) {
+        return { name, value: value.replace(/\s+/gu, " ").slice(0, 200) };
+      }
+    }
+    let matched;
+    headers.forEach((rawValue, rawName) => {
+      if (matched || !/(?:^|[-_])trace[-_]?id$/iu.test(rawName))
+        return;
+      const value = rawValue.trim();
+      if (!value)
+        return;
+      matched = {
+        name: rawName,
+        value: value.replace(/\s+/gu, " ").slice(0, 200)
+      };
+    });
+    return matched;
+  } catch {
+  }
+  return void 0;
+}
 function safeLog(debugLog, line) {
   try {
     debugLog(line, EDebugLogScope.HTTP);
@@ -19870,7 +19905,11 @@ function errorMsg(error) {
 // ../linkque-agent-runtime/dist/esm/core/hook/linkquegwEventHookExecutor.js
 var DEFAULT_LINKQUEGW_EVENT_BASE_URL = "https://linkquegw.alipay.com";
 var LINKQUEGW_AGENT_EVENT_TRIGGER_PATH = "/api/agent/event/trigger";
-var LINKQUEGW_EVENT_TYPE_BY_STAGE = { [EHookStage.RUN_STARTED]: "AGENT_DIALOG_ROUND_STARTED" };
+var LINKQUEGW_EVENT_TYPE_BY_STAGE = {
+  [EHookStage.RUN_STARTED]: "RUN_STARTED",
+  [EHookStage.RUN_COMPLETED]: "RUN_ENDED",
+  [EHookStage.RUN_FAILED]: "RUN_ENDED"
+};
 function buildLinkquegwEventBody(context) {
   const eventType = LINKQUEGW_EVENT_TYPE_BY_STAGE[context.stage];
   if (eventType === void 0)
@@ -19881,13 +19920,14 @@ function buildLinkquegwEventBody(context) {
     eventType,
     eventId: context.eventId,
     eventTime: context.timestamp,
-    conversationId: commonParams.conversationId,
+    ...commonParams.conversationId !== void 0 && {
+      conversationId: commonParams.conversationId
+    },
     ...commonParams.sessionId !== void 0 && {
       sessionId: commonParams.sessionId
     },
     runId: commonParams.runId,
-    runIndex: commonParams.runIndex,
-    traceId: commonParams.traceId ?? commonParams.runId
+    runIndex: commonParams.runIndex
   };
 }
 var LinkquegwEventHookExecutor = class {
@@ -19927,7 +19967,7 @@ var LinkquegwEventHookExecutor = class {
     const startedAt = this.now();
     let result = "ok";
     try {
-      const traceId = body.traceId;
+      const traceId = context.commonParams.traceId ?? context.commonParams.runId;
       const resp = await this.fetchImpl(`${this.baseUrl}${LINKQUEGW_AGENT_EVENT_TRIGGER_PATH}`, {
         method: "POST",
         headers: {
@@ -52766,6 +52806,8 @@ var AgentRuntime = class _AgentRuntime {
   hookMetricsSink;
   /** 装配期固化的统一诊断 sink(逐 run options.debugLog 可覆盖)。 */
   portsDebugLog;
+  /** 插件处理后、runtime 实际使用的完整 Agent Config JSON 快照。 */
+  effectiveAgentConfigJson;
   // —— 从 IAgentProtocol 提取并固化的运行期默认(经 create 注入)——
   /** systemPrompt 默认(来自 protocol.agent.systemPrompt.content)。 */
   defaultSystemPrompt = "";
@@ -52849,6 +52891,11 @@ var AgentRuntime = class _AgentRuntime {
     rt.agentId = agentConfig.agentId;
     rt.followUpQuestionGenerationEnabled = followUpQuestionGenerationEnabled;
     rt.hookResources = normalizeHookResources(agentConfig.agent.resources.filter((r) => r.resourceType === EResourceType.HOOK));
+    try {
+      rt.effectiveAgentConfigJson = JSON.stringify(agentConfig);
+    } catch {
+      rt.effectiveAgentConfigJson = void 0;
+    }
     return rt;
   }
   async prepareFollowUpQuestionContext(sessionId, history = []) {
@@ -52869,6 +52916,12 @@ var AgentRuntime = class _AgentRuntime {
   async *runAgentLoop(request, auth2, options = {}) {
     const sessionId = options.sessionId;
     const debugLog = options.debugLog ?? this.portsDebugLog;
+    if (debugLog) {
+      try {
+        debugLog(this.effectiveAgentConfigJson === void 0 ? "[agent-config] final=<Agent Config \u5E8F\u5217\u5316\u5931\u8D25\uFF0C\u65E0\u6CD5\u6253\u5370\u5B8C\u6574\u5185\u5BB9>" : `[agent-config] final=${this.effectiveAgentConfigJson}`, EDebugLogScope.CONFIG);
+      } catch {
+      }
+    }
     const newTurns = request.messages.map((m) => ({
       role: m.role,
       content: m.content,
@@ -52976,6 +53029,19 @@ var AgentRuntime = class _AgentRuntime {
     let assistantText = "";
     let failed = false;
     let runError;
+    let terminalHookDispatched = false;
+    const dispatchTerminalHook = async () => {
+      if (terminalHookDispatched || hookDispatcher.isEmpty)
+        return;
+      terminalHookDispatched = true;
+      if (failed) {
+        await hookDispatcher.dispatch(EHookStage.RUN_FAILED, hookCommonParams, {
+          error: runError ?? { message: "unknown error" }
+        });
+        return;
+      }
+      await hookDispatcher.dispatch(EHookStage.RUN_COMPLETED, hookCommonParams, { runDurationMs: Date.now() - runStartedAt });
+    };
     try {
       for await (const ev of this.agentLoop.run(agentReq)) {
         if (ev.type === "delta")
@@ -52983,6 +53049,7 @@ var AgentRuntime = class _AgentRuntime {
         if (ev.type === "error") {
           failed = true;
           runError = { message: ev.error.message, code: ev.error.code };
+          await dispatchTerminalHook();
         }
         if (ev.type === "done" && !failed && sessionId !== void 0) {
           const completedTurns = [
@@ -52997,22 +53064,18 @@ var AgentRuntime = class _AgentRuntime {
             }
           }
         }
+        if (ev.type === "done")
+          await dispatchTerminalHook();
         yield ev;
       }
-      if (!hookDispatcher.isEmpty) {
-        if (failed) {
-          await hookDispatcher.dispatch(EHookStage.RUN_FAILED, hookCommonParams, { error: runError ?? { message: "unknown error" } });
-        } else {
-          await hookDispatcher.dispatch(EHookStage.RUN_COMPLETED, hookCommonParams, { runDurationMs: Date.now() - runStartedAt });
-        }
-      }
+      await dispatchTerminalHook();
     } catch (error) {
-      if (!hookDispatcher.isEmpty) {
-        await hookDispatcher.dispatch(EHookStage.RUN_FAILED, hookCommonParams, {
-          error: {
-            message: error instanceof Error ? error.message : String(error)
-          }
-        });
+      if (!terminalHookDispatched) {
+        failed = true;
+        runError = {
+          message: error instanceof Error ? error.message : String(error)
+        };
+        await dispatchTerminalHook();
       }
       throw error;
     } finally {

package/vendor/linkque-agent-appwrite-integrate/dist/esm/runtime/handler/chat.js

@@ -17,7 +17,7 @@ import {
   resolveLinkqueGatewayAuth,
   resolveRunStorage,
   toAgentRunMessages
-} from "../../chunk-IAT272TH.js";
+} from "../../chunk-B56A2RV5.js";
 import "../../chunk-MKS245OU.js";
 import "../../chunk-YDKZZ6EH.js";
 import "../../chunk-2NGJGNYB.js";
@@ -51,7 +51,7 @@ import {
   parseConversationRunRequest,
   parseSkillFile,
   streamToConversationEvents
-} from "../../chunk-TM6MTGSL.js";
+} from "../../chunk-MR5QT2A5.js";
 import "../../chunk-XUFLSZM4.js";
 import "../../chunk-I64V3ICJ.js";
 import "../../chunk-6MHDOBWO.js";
@@ -68,23 +68,39 @@ import { randomUUID as randomUUID3 } from "node:crypto";
 // ../linkque-agent-runtime/dist/esm/impl/plugin/linkquegwEventPlugin.js
 var LINKQUEGW_EVENT_PLUGIN_NAME = "linkquegw-event-plugin";
 var LINKQUEGW_EVENT_HOOK_RESOURCE_ID = "linkquegw-event-run-started";
-var createLinkquegwEventHookResource = () => ({
-  resourceId: LINKQUEGW_EVENT_HOOK_RESOURCE_ID,
+var LINKQUEGW_RUN_COMPLETED_HOOK_RESOURCE_ID = "linkquegw-event-run-completed";
+var LINKQUEGW_RUN_FAILED_HOOK_RESOURCE_ID = "linkquegw-event-run-failed";
+var DEFAULT_LINKQUEGW_EVENT_HOOKS = [
+  {
+    resourceId: LINKQUEGW_EVENT_HOOK_RESOURCE_ID,
+    stage: EHookStage.RUN_STARTED
+  },
+  {
+    resourceId: LINKQUEGW_RUN_COMPLETED_HOOK_RESOURCE_ID,
+    stage: EHookStage.RUN_COMPLETED
+  },
+  {
+    resourceId: LINKQUEGW_RUN_FAILED_HOOK_RESOURCE_ID,
+    stage: EHookStage.RUN_FAILED
+  }
+];
+var createLinkquegwEventHookResource = (resourceId, stage) => ({
+  resourceId,
   resourceType: EResourceType.HOOK,
   providerType: EResourceProviderType.LINK_QUE,
   config: {
     name: "LinkqueGW \u751F\u547D\u5468\u671F\u4E8B\u4EF6\u4E0A\u62A5",
     executorName: EHookExecutorName.LinkquegwEventHookExecutor,
-    stage: EHookStage.RUN_STARTED,
+    stage,
     hasSideEffects: true
   }
 });
 var isUserTokenAuthorization = (value) => /^Bearer[\t ]+[^\s,]+$/u.test(value);
-var isLinkquegwRunStartedHook = (resource) => {
+var isLinkquegwEventHook = (resource, stage) => {
   if (resource.resourceType !== EResourceType.HOOK)
     return false;
   const hookResource = resource;
-  return hookResource.config.executorName === EHookExecutorName.LinkquegwEventHookExecutor && hookResource.config.stage === EHookStage.RUN_STARTED;
+  return hookResource.config.executorName === EHookExecutorName.LinkquegwEventHookExecutor && hookResource.config.stage === stage;
 };
 var LinkquegwEventPlugin = class {
   name = LINKQUEGW_EVENT_PLUGIN_NAME;
@@ -113,10 +129,12 @@ var LinkquegwEventPlugin = class {
   }
   /** 自动补入 event trigger 所需 HookResource;已有同 executorName + stage 时保持原配置。 */
   modifyAgentConfig(agentConfig) {
-    const exists = agentConfig.agent.resources.some(isLinkquegwRunStartedHook);
-    if (exists)
-      return;
-    agentConfig.agent.resources.push(createLinkquegwEventHookResource());
+    for (const hook of DEFAULT_LINKQUEGW_EVENT_HOOKS) {
+      const exists = agentConfig.agent.resources.some((resource) => isLinkquegwEventHook(resource, hook.stage));
+      if (!exists) {
+        agentConfig.agent.resources.push(createLinkquegwEventHookResource(hook.resourceId, hook.stage));
+      }
+    }
   }
 };
 
@@ -298,6 +316,7 @@ function resolveLinkqueEndpoints(env, envSelector) {
   return {
     linkqueBaseUrl: trimEnvVar(isPre ? env.LINKQUE_BASE_URL_PRE : env.LINKQUE_BASE_URL),
     knowledgeBaseUrl: trimEnvVar(isPre ? env.LINKQUEGW_KNOWLEDGE_BASE_URL_PRE : env.LINKQUEGW_KNOWLEDGE_BASE_URL),
+    eventBaseUrl: trimEnvVar(isPre ? env.LINKQUEGW_EVENT_BASE_URL_PRE : env.LINKQUEGW_EVENT_BASE_URL),
     mcpSignEndpoint: trimEnvVar(isPre ? env.LINKQUEGW_MCP_SIGN_ENDPOINT_PRE : env.LINKQUEGW_MCP_SIGN_ENDPOINT)
   };
 }
@@ -353,10 +372,11 @@ function createAppBaseRuntime(protocol, env = process.env, ports = {}, logCtx) {
   }
   const plugins = [...ports.plugins ?? []];
   const hasLinkquegwEventPlugin = plugins.some((plugin) => plugin.name === LINKQUEGW_EVENT_PLUGIN_NAME);
+  const eventBaseUrl = ports.eventBaseUrl ?? ports.knowledgeBaseUrl;
   if (ports.gatewayAuthMode === "user-token" && mcpAuthHeader && !hasLinkquegwEventPlugin) {
     plugins.push(new LinkquegwEventPlugin({
       getUserTokenAuthorizationHeader: mcpAuthHeader,
-      ...ports.knowledgeBaseUrl ? { baseUrl: ports.knowledgeBaseUrl } : {},
+      ...eventBaseUrl ? { baseUrl: eventBaseUrl } : {},
       ...ports.gatewayAgentId ? { agentId: ports.gatewayAgentId } : {},
       ...debugLog ? { debugLog } : {}
     }));
@@ -1745,7 +1765,7 @@ function resolveChatDeps(env, deps, logCtx, historyOwnerId, appwriteApiKey, envS
     chunkSize = storage.chunkSize;
   }
   const mcpAuthorizationHeaderProvider = async () => resolved.authorizationHeader;
-  const { linkqueBaseUrl, knowledgeBaseUrl, mcpSignEndpoint } = resolveLinkqueEndpoints(env, envSelector);
+  const { linkqueBaseUrl, knowledgeBaseUrl, eventBaseUrl, mcpSignEndpoint } = resolveLinkqueEndpoints(env, envSelector);
   const mcpConfigResolver = createAppbaseMcpConfigResolver({
     agentId: protocol.agentId,
     ...mcpSignEndpoint ? { signEndpoint: mcpSignEndpoint } : {}
@@ -1757,7 +1777,8 @@ function resolveChatDeps(env, deps, logCtx, historyOwnerId, appwriteApiKey, envS
     gatewayAuthMode: resolved.mode,
     gatewayAgentId: protocol.agentId,
     ...linkqueBaseUrl ? { linkqueBaseUrl } : {},
-    ...knowledgeBaseUrl ? { knowledgeBaseUrl } : {}
+    ...knowledgeBaseUrl ? { knowledgeBaseUrl } : {},
+    ...eventBaseUrl ? { eventBaseUrl } : {}
   }, logCtx);
   return {
     auth: resolved.auth,

package/vendor/linkque-agent-appwrite-integrate/dist/esm/runtime/handler/clientCapability.js

@@ -3,7 +3,7 @@ import {
   runClientCapability,
   runClientCapabilityCleanup,
   runClientCapabilityResult
-} from "../../chunk-IAT272TH.js";
+} from "../../chunk-B56A2RV5.js";
 import "../../chunk-MKS245OU.js";
 import "../../chunk-YDKZZ6EH.js";
 import "../../chunk-2NGJGNYB.js";

package/vendor/linkque-agent-appwrite-integrate/dist/esm/runtime/protocol.js

@@ -1,7 +1,7 @@
 import {
   getBakedProtocol,
   setBakedProtocol
-} from "../chunk-TM6MTGSL.js";
+} from "../chunk-MR5QT2A5.js";
 import "../chunk-XUFLSZM4.js";
 import "../chunk-I64V3ICJ.js";
 import "../chunk-6MHDOBWO.js";

package/worker.js

@@ -4981,6 +4981,7 @@ var init_types2 = __esm({
   "../linkque-agent-runtime/dist/esm/core/types.js"() {
     "use strict";
     (function(EDebugLogScope2) {
+      EDebugLogScope2["CONFIG"] = "CONFIG";
       EDebugLogScope2["LLM"] = "LLM";
       EDebugLogScope2["PI_EVENT"] = "PI_EVENT";
       EDebugLogScope2["MCP"] = "MCP";
@@ -15270,11 +15271,7 @@ function injectResolvedViewModel(protocol, viewModel) {
     {
       version: "0.9",
       datas: surfaceIds.map((surfaceId) => ({
-        updateDataModel: {
-          surfaceId,
-          path: "/",
-          value: viewModel
-        }
+        updateDataModel: { surfaceId, path: "/", value: viewModel }
       }))
     }
   ];
@@ -16884,10 +16881,37 @@ function createHttpLoggingFetch(debugLog, tag, baseFetch = globalThis.fetch) {
         len = cl;
     } catch {
     }
-    safeLog(debugLog, formatHttpLogLine(tag, "resp", `${method} ${targetUrl} ${resp.status} in ${elapsed}ms len=${len}`));
+    const correlation = readResponseCorrelationId(resp.headers);
+    const correlationField = correlation ? ` traceId=${correlation.value} traceHeader=${correlation.name}` : "";
+    safeLog(debugLog, formatHttpLogLine(tag, "resp", `${method} ${targetUrl} ${resp.status} in ${elapsed}ms len=${len}${correlationField}`));
     return resp;
   };
 }
+function readResponseCorrelationId(headers) {
+  try {
+    for (const name of RESPONSE_CORRELATION_HEADER_NAMES) {
+      const value = headers.get(name)?.trim();
+      if (value) {
+        return { name, value: value.replace(/\s+/gu, " ").slice(0, 200) };
+      }
+    }
+    let matched;
+    headers.forEach((rawValue, rawName) => {
+      if (matched || !/(?:^|[-_])trace[-_]?id$/iu.test(rawName))
+        return;
+      const value = rawValue.trim();
+      if (!value)
+        return;
+      matched = {
+        name: rawName,
+        value: value.replace(/\s+/gu, " ").slice(0, 200)
+      };
+    });
+    return matched;
+  } catch {
+  }
+  return void 0;
+}
 function safeLog(debugLog, line) {
   try {
     debugLog(line, EDebugLogScope.HTTP);
@@ -16901,7 +16925,7 @@ function errorMsg(error40) {
   const msg = error40 instanceof Error ? error40.message : String(error40);
   return msg.replace(/\s+/g, " ").slice(0, 500);
 }
-var MAX_BODY_SUMMARY_LEN, REDACTED_HEADER_NAMES, REDACTED_VALUE;
+var MAX_BODY_SUMMARY_LEN, REDACTED_HEADER_NAMES, REDACTED_VALUE, RESPONSE_CORRELATION_HEADER_NAMES;
 var init_httpLoggingFetch = __esm({
   "../linkque-agent-runtime/dist/esm/impl/httpLoggingFetch.js"() {
     "use strict";
@@ -16915,6 +16939,17 @@ var init_httpLoggingFetch = __esm({
       "anthropic-api-key"
     ]);
     REDACTED_VALUE = "ak***";
+    RESPONSE_CORRELATION_HEADER_NAMES = [
+      "alipay-trace-id",
+      "x-trace-id",
+      "x-traceid",
+      "trace-id",
+      "traceid",
+      "eagleeye-traceid",
+      "eagleeye-trace-id",
+      "sofa-traceid",
+      "sofa-trace-id"
+    ];
   }
 });
 
@@ -16929,13 +16964,14 @@ function buildLinkquegwEventBody(context2) {
     eventType,
     eventId: context2.eventId,
     eventTime: context2.timestamp,
-    conversationId: commonParams.conversationId,
+    ...commonParams.conversationId !== void 0 && {
+      conversationId: commonParams.conversationId
+    },
     ...commonParams.sessionId !== void 0 && {
       sessionId: commonParams.sessionId
     },
     runId: commonParams.runId,
-    runIndex: commonParams.runIndex,
-    traceId: commonParams.traceId ?? commonParams.runId
+    runIndex: commonParams.runIndex
   };
 }
 var DEFAULT_LINKQUEGW_EVENT_BASE_URL, LINKQUEGW_AGENT_EVENT_TRIGGER_PATH, LINKQUEGW_EVENT_TYPE_BY_STAGE, LinkquegwEventHookExecutor;
@@ -16947,7 +16983,11 @@ var init_linkquegwEventHookExecutor = __esm({
     init_hookMetrics();
     DEFAULT_LINKQUEGW_EVENT_BASE_URL = "https://linkquegw.alipay.com";
     LINKQUEGW_AGENT_EVENT_TRIGGER_PATH = "/api/agent/event/trigger";
-    LINKQUEGW_EVENT_TYPE_BY_STAGE = { [EHookStage.RUN_STARTED]: "AGENT_DIALOG_ROUND_STARTED" };
+    LINKQUEGW_EVENT_TYPE_BY_STAGE = {
+      [EHookStage.RUN_STARTED]: "RUN_STARTED",
+      [EHookStage.RUN_COMPLETED]: "RUN_ENDED",
+      [EHookStage.RUN_FAILED]: "RUN_ENDED"
+    };
     LinkquegwEventHookExecutor = class {
       name = EHookExecutorName.LinkquegwEventHookExecutor;
       baseUrl;
@@ -16985,7 +17025,7 @@ var init_linkquegwEventHookExecutor = __esm({
         const startedAt = this.now();
         let result = "ok";
         try {
-          const traceId = body.traceId;
+          const traceId = context2.commonParams.traceId ?? context2.commonParams.runId;
           const resp = await this.fetchImpl(`${this.baseUrl}${LINKQUEGW_AGENT_EVENT_TRIGGER_PATH}`, {
             method: "POST",
             headers: {
@@ -188725,6 +188765,8 @@ var init_agentRuntime = __esm({
       hookMetricsSink;
       /** 装配期固化的统一诊断 sink(逐 run options.debugLog 可覆盖)。 */
       portsDebugLog;
+      /** 插件处理后、runtime 实际使用的完整 Agent Config JSON 快照。 */
+      effectiveAgentConfigJson;
       // —— 从 IAgentProtocol 提取并固化的运行期默认(经 create 注入)——
       /** systemPrompt 默认(来自 protocol.agent.systemPrompt.content)。 */
       defaultSystemPrompt = "";
@@ -188808,6 +188850,11 @@ var init_agentRuntime = __esm({
         rt.agentId = agentConfig.agentId;
         rt.followUpQuestionGenerationEnabled = followUpQuestionGenerationEnabled;
         rt.hookResources = normalizeHookResources(agentConfig.agent.resources.filter((r2) => r2.resourceType === EResourceType.HOOK));
+        try {
+          rt.effectiveAgentConfigJson = JSON.stringify(agentConfig);
+        } catch {
+          rt.effectiveAgentConfigJson = void 0;
+        }
         return rt;
       }
       async prepareFollowUpQuestionContext(sessionId, history = []) {
@@ -188828,6 +188875,12 @@ var init_agentRuntime = __esm({
       async *runAgentLoop(request, auth2, options = {}) {
         const sessionId = options.sessionId;
         const debugLog = options.debugLog ?? this.portsDebugLog;
+        if (debugLog) {
+          try {
+            debugLog(this.effectiveAgentConfigJson === void 0 ? "[agent-config] final=<Agent Config \u5E8F\u5217\u5316\u5931\u8D25\uFF0C\u65E0\u6CD5\u6253\u5370\u5B8C\u6574\u5185\u5BB9>" : `[agent-config] final=${this.effectiveAgentConfigJson}`, EDebugLogScope.CONFIG);
+          } catch {
+          }
+        }
         const newTurns = request.messages.map((m2) => ({
           role: m2.role,
           content: m2.content,
@@ -188935,6 +188988,19 @@ var init_agentRuntime = __esm({
         let assistantText = "";
         let failed = false;
         let runError;
+        let terminalHookDispatched = false;
+        const dispatchTerminalHook = async () => {
+          if (terminalHookDispatched || hookDispatcher.isEmpty)
+            return;
+          terminalHookDispatched = true;
+          if (failed) {
+            await hookDispatcher.dispatch(EHookStage.RUN_FAILED, hookCommonParams, {
+              error: runError ?? { message: "unknown error" }
+            });
+            return;
+          }
+          await hookDispatcher.dispatch(EHookStage.RUN_COMPLETED, hookCommonParams, { runDurationMs: Date.now() - runStartedAt });
+        };
         try {
           for await (const ev of this.agentLoop.run(agentReq)) {
             if (ev.type === "delta")
@@ -188942,6 +189008,7 @@ var init_agentRuntime = __esm({
             if (ev.type === "error") {
               failed = true;
               runError = { message: ev.error.message, code: ev.error.code };
+              await dispatchTerminalHook();
             }
             if (ev.type === "done" && !failed && sessionId !== void 0) {
               const completedTurns = [
@@ -188956,22 +189023,18 @@ var init_agentRuntime = __esm({
                 }
               }
             }
+            if (ev.type === "done")
+              await dispatchTerminalHook();
             yield ev;
           }
-          if (!hookDispatcher.isEmpty) {
-            if (failed) {
-              await hookDispatcher.dispatch(EHookStage.RUN_FAILED, hookCommonParams, { error: runError ?? { message: "unknown error" } });
-            } else {
-              await hookDispatcher.dispatch(EHookStage.RUN_COMPLETED, hookCommonParams, { runDurationMs: Date.now() - runStartedAt });
-            }
-          }
+          await dispatchTerminalHook();
         } catch (error40) {
-          if (!hookDispatcher.isEmpty) {
-            await hookDispatcher.dispatch(EHookStage.RUN_FAILED, hookCommonParams, {
-              error: {
-                message: error40 instanceof Error ? error40.message : String(error40)
-              }
-            });
+          if (!terminalHookDispatched) {
+            failed = true;
+            runError = {
+              message: error40 instanceof Error ? error40.message : String(error40)
+            };
+            await dispatchTerminalHook();
           }
           throw error40;
         } finally {
@@ -196985,7 +197048,7 @@ var init_examplePlugin = __esm({
 });
 
 // ../linkque-agent-runtime/dist/esm/impl/plugin/linkquegwEventPlugin.js
-var LINKQUEGW_EVENT_PLUGIN_NAME, LINKQUEGW_EVENT_HOOK_RESOURCE_ID, createLinkquegwEventHookResource, isUserTokenAuthorization, isLinkquegwRunStartedHook, LinkquegwEventPlugin;
+var LINKQUEGW_EVENT_PLUGIN_NAME, LINKQUEGW_EVENT_HOOK_RESOURCE_ID, LINKQUEGW_RUN_COMPLETED_HOOK_RESOURCE_ID, LINKQUEGW_RUN_FAILED_HOOK_RESOURCE_ID, DEFAULT_LINKQUEGW_EVENT_HOOKS, createLinkquegwEventHookResource, isUserTokenAuthorization, isLinkquegwEventHook, LinkquegwEventPlugin;
 var init_linkquegwEventPlugin = __esm({
   "../linkque-agent-runtime/dist/esm/impl/plugin/linkquegwEventPlugin.js"() {
     "use strict";
@@ -196993,23 +197056,39 @@ var init_linkquegwEventPlugin = __esm({
     init_linkquegwEventHookExecutor();
     LINKQUEGW_EVENT_PLUGIN_NAME = "linkquegw-event-plugin";
     LINKQUEGW_EVENT_HOOK_RESOURCE_ID = "linkquegw-event-run-started";
-    createLinkquegwEventHookResource = () => ({
-      resourceId: LINKQUEGW_EVENT_HOOK_RESOURCE_ID,
+    LINKQUEGW_RUN_COMPLETED_HOOK_RESOURCE_ID = "linkquegw-event-run-completed";
+    LINKQUEGW_RUN_FAILED_HOOK_RESOURCE_ID = "linkquegw-event-run-failed";
+    DEFAULT_LINKQUEGW_EVENT_HOOKS = [
+      {
+        resourceId: LINKQUEGW_EVENT_HOOK_RESOURCE_ID,
+        stage: EHookStage.RUN_STARTED
+      },
+      {
+        resourceId: LINKQUEGW_RUN_COMPLETED_HOOK_RESOURCE_ID,
+        stage: EHookStage.RUN_COMPLETED
+      },
+      {
+        resourceId: LINKQUEGW_RUN_FAILED_HOOK_RESOURCE_ID,
+        stage: EHookStage.RUN_FAILED
+      }
+    ];
+    createLinkquegwEventHookResource = (resourceId, stage) => ({
+      resourceId,
       resourceType: EResourceType.HOOK,
       providerType: EResourceProviderType.LINK_QUE,
       config: {
         name: "LinkqueGW \u751F\u547D\u5468\u671F\u4E8B\u4EF6\u4E0A\u62A5",
         executorName: EHookExecutorName.LinkquegwEventHookExecutor,
-        stage: EHookStage.RUN_STARTED,
+        stage,
         hasSideEffects: true
       }
     });
     isUserTokenAuthorization = (value) => /^Bearer[\t ]+[^\s,]+$/u.test(value);
-    isLinkquegwRunStartedHook = (resource) => {
+    isLinkquegwEventHook = (resource, stage) => {
       if (resource.resourceType !== EResourceType.HOOK)
         return false;
       const hookResource = resource;
-      return hookResource.config.executorName === EHookExecutorName.LinkquegwEventHookExecutor && hookResource.config.stage === EHookStage.RUN_STARTED;
+      return hookResource.config.executorName === EHookExecutorName.LinkquegwEventHookExecutor && hookResource.config.stage === stage;
     };
     LinkquegwEventPlugin = class {
       name = LINKQUEGW_EVENT_PLUGIN_NAME;
@@ -197038,10 +197117,12 @@ var init_linkquegwEventPlugin = __esm({
       }
       /** 自动补入 event trigger 所需 HookResource;已有同 executorName + stage 时保持原配置。 */
       modifyAgentConfig(agentConfig) {
-        const exists = agentConfig.agent.resources.some(isLinkquegwRunStartedHook);
-        if (exists)
-          return;
-        agentConfig.agent.resources.push(createLinkquegwEventHookResource());
+        for (const hook of DEFAULT_LINKQUEGW_EVENT_HOOKS) {
+          const exists = agentConfig.agent.resources.some((resource) => isLinkquegwEventHook(resource, hook.stage));
+          if (!exists) {
+            agentConfig.agent.resources.push(createLinkquegwEventHookResource(hook.resourceId, hook.stage));
+          }
+        }
       }
     };
   }
@@ -197053,6 +197134,8 @@ __export(plugin_exports, {
   ExamplePlugin: () => ExamplePlugin,
   LINKQUEGW_EVENT_HOOK_RESOURCE_ID: () => LINKQUEGW_EVENT_HOOK_RESOURCE_ID,
   LINKQUEGW_EVENT_PLUGIN_NAME: () => LINKQUEGW_EVENT_PLUGIN_NAME,
+  LINKQUEGW_RUN_COMPLETED_HOOK_RESOURCE_ID: () => LINKQUEGW_RUN_COMPLETED_HOOK_RESOURCE_ID,
+  LINKQUEGW_RUN_FAILED_HOOK_RESOURCE_ID: () => LINKQUEGW_RUN_FAILED_HOOK_RESOURCE_ID,
   LinkquegwEventPlugin: () => LinkquegwEventPlugin
 });
 var init_plugin = __esm({