linkque-cli-v2 1.1.0 → 1.1.2

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
@@ -25322,6 +25329,7 @@ function analyzeA2UIBindings(protocol) {
     }
   }
   return {
+    surfaceIds: [...surfaces],
     surfaceId: surfaces.size === 1 ? [...surfaces][0] : void 0,
     occurrences,
     issues
@@ -27399,9 +27407,6 @@ function createA2UICardDraftStructureChecksum(draft) {
 function createA2UICardMcpConfigChecksum(resources) {
   return sha256Hex(stableJsonStringify(resources));
 }
-function createA2UICardBindingContextChecksum(context) {
-  return sha256Hex(stableJsonStringify(context));
-}
 function createA2UICardRevision(draftChecksum2, bindings) {
   const digest = sha256Hex(`${draftChecksum2}
 ${stableJsonStringify(bindings)}`);
@@ -27530,16 +27535,14 @@ async function readCardDraft(cwd, draftId) {
     ...theme ? { theme } : {}
   };
 }
-async function validateCardBindings(cwd, draftId, contextChecksum, fieldId) {
+async function validateCardBindings(cwd, draftId, _contextChecksum, fieldId) {
   assertDraftId(draftId);
-  assertChecksum(contextChecksum, "\u7ED1\u5B9A\u4E0A\u4E0B\u6587 checksum");
   if (fieldId !== void 0) assertDraftId(fieldId);
-  return validateCardBindingsFromDisk(cwd, draftId, contextChecksum, fieldId);
+  return validateCardBindingsFromDisk(cwd, draftId, fieldId);
 }
-async function finalizeCard(cwd, draftId, expectedDraftChecksum, contextChecksum) {
+async function finalizeCard(cwd, draftId, expectedDraftChecksum, _contextChecksum) {
   assertDraftId(draftId);
   assertChecksum(expectedDraftChecksum, "\u8349\u7A3F checksum");
-  assertChecksum(contextChecksum, "\u7ED1\u5B9A\u4E0A\u4E0B\u6587 checksum");
   return withWorkspaceLock(
     {
       path: import_path22.default.join(cwd, FINALIZE_LOCK_PATH),
@@ -27549,17 +27552,12 @@ async function finalizeCard(cwd, draftId, expectedDraftChecksum, contextChecksum
       retryMs: FINALIZE_LOCK_RETRY_MS,
       timeoutMs: FINALIZE_LOCK_TIMEOUT_MS
     },
-    async () => finalizeCardWhileLocked(
-      cwd,
-      draftId,
-      expectedDraftChecksum,
-      contextChecksum
-    )
+    async () => finalizeCardWhileLocked(cwd, draftId, expectedDraftChecksum)
   );
 }
 async function finalizeCardFromRequest(cwd, requestFile) {
   const value = await readRequiredJson(import_path22.default.resolve(cwd, requestFile));
-  if (!isJsonObject(value) || value.version !== 1 || typeof value.draftId !== "string" || typeof value.expectedDraftChecksum !== "string" || typeof value.contextChecksum !== "string" || Object.keys(value).some(
+  if (!isJsonObject(value) || value.version !== 1 || typeof value.draftId !== "string" || typeof value.expectedDraftChecksum !== "string" || value.contextChecksum !== void 0 && typeof value.contextChecksum !== "string" || Object.keys(value).some(
     (key) => ![
       "version",
       "draftId",
@@ -27612,7 +27610,7 @@ async function rollbackCardFinalize(cwd, rollbackToken) {
     }
   );
 }
-async function validateCardBindingsFromDisk(cwd, draftId, expectedContextChecksum, fieldId) {
+async function validateCardBindingsFromDisk(cwd, draftId, fieldId) {
   const directory = draftDirectory(cwd, draftId);
   const [bundle, contextValue, configValue] = await Promise.all([
     readBundle(directory, draftId),
@@ -27627,16 +27625,6 @@ async function validateCardBindingsFromDisk(cwd, draftId, expectedContextChecksu
     );
   }
   const context = contextResult.data;
-  const actualContextChecksum = createA2UICardBindingContextChecksum(context);
-  const legacyContextChecksum = createA2UICardBindingContextChecksum(
-    contextValue
-  );
-  if (actualContextChecksum !== expectedContextChecksum && legacyContextChecksum !== expectedContextChecksum) {
-    throw new LinkqueCliError(
-      "CARD_BINDING_CONTEXT_STALE",
-      "\u7ED1\u5B9A\u4E0A\u4E0B\u6587\u5DF2\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u53D1\u8D77 AI \u8F85\u52A9\u7ED1\u5B9A"
-    );
-  }
   const draftStructureChecksum = createA2UICardDraftStructureChecksum(bundle);
   const config2 = parseAgentConfig(configValue);
   const mcpResources = normalizedMcpResources(config2);
@@ -27669,7 +27657,6 @@ async function validateCardBindingsFromDisk(cwd, draftId, expectedContextChecksu
   return {
     bindingCount: bundle.manifest.bindings?.length ?? 0,
     complete: businessFieldIds.every((id) => boundFieldIds.has(id)),
-    contextChecksum: actualContextChecksum,
     draftChecksum: draftChecksum(bundle),
     draftId,
     draftStructureChecksum,
@@ -27677,12 +27664,8 @@ async function validateCardBindingsFromDisk(cwd, draftId, expectedContextChecksu
     valid: true
   };
 }
-async function finalizeCardWhileLocked(cwd, draftId, expectedDraftChecksum, contextChecksum) {
-  const validation = await validateCardBindingsFromDisk(
-    cwd,
-    draftId,
-    contextChecksum
-  );
+async function finalizeCardWhileLocked(cwd, draftId, expectedDraftChecksum) {
+  const validation = await validateCardBindingsFromDisk(cwd, draftId);
   if (validation.draftChecksum !== expectedDraftChecksum) {
     throw new LinkqueCliError(
       "CARD_FINALIZE_CONFLICT",
@@ -29107,7 +29090,7 @@ var cardValidateBindings = {
     },
     {
       flags: "--context-checksum <checksum>",
-      description: "binding-context.json checksum prepared by the platform",
+      description: "deprecated compatibility option; accepted and ignored",
       key: "contextChecksum"
     },
     {
@@ -29119,9 +29102,9 @@ var cardValidateBindings = {
   summarize: ({ draftId }) => `Card draft ${draftId} bindings validated.
 `,
   run: (cwd, options) => {
-    if (options.draftId === void 0 || options.contextChecksum === void 0) {
+    if (options.draftId === void 0) {
       throw new InvalidArgumentError(
-        "required options '--draft-id' and '--context-checksum' not specified"
+        "required option '--draft-id' not specified"
       );
     }
     return validateCardBindings(
@@ -29153,7 +29136,7 @@ var cardFinalize = {
     },
     {
       flags: "--context-checksum <checksum>",
-      description: "binding-context.json checksum prepared by the platform",
+      description: "deprecated compatibility option; accepted and ignored",
       key: "contextChecksum"
     }
   ],
@@ -29168,9 +29151,9 @@ var cardFinalize = {
       }
       return finalizeCardFromRequest(cwd, options.requestFile);
     }
-    if (options.draftId === void 0 || options.expectedDraftChecksum === void 0 || options.contextChecksum === void 0) {
+    if (options.draftId === void 0 || options.expectedDraftChecksum === void 0) {
       throw new InvalidArgumentError(
-        "required options '--draft-id', '--expected-draft-checksum' and '--context-checksum' not specified"
+        "required options '--draft-id' and '--expected-draft-checksum' not specified"
       );
     }
     return finalizeCard(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkque-cli-v2",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "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-MN4S5EF5.js → chunk-XGIMLCNP.js}

@@ -17030,6 +17030,7 @@ function analyzeA2UIBindings(protocol) {
     }
   }
   return {
+    surfaceIds: [...surfaces],
     surfaceId: surfaces.size === 1 ? [...surfaces][0] : void 0,
     occurrences,
     issues
@@ -18331,25 +18332,42 @@ function isAgentPresentationToolResult(value) {
 }
 function injectResolvedViewModel(protocol, viewModel) {
   const analysis = analyzeA2UIBindings(protocol);
-  if (analysis.issues.length || !analysis.surfaceId) {
-    throw new Error("CARD template does not contain one valid A2UI surface");
+  const declaredSurfaceIds = analysis.surfaceIds;
+  const surfaceIds = Array.isArray(declaredSurfaceIds) && declaredSurfaceIds.every((surfaceId) => typeof surfaceId === "string") ? declaredSurfaceIds : collectA2UISurfaceIdsForLegacyContract(protocol);
+  if (analysis.issues.length || surfaceIds.length === 0) {
+    throw new Error("CARD template does not contain a valid A2UI surface");
   }
   return [
     ...protocol,
     {
       version: "0.9",
-      datas: [
-        {
-          updateDataModel: {
-            surfaceId: analysis.surfaceId,
-            path: "/",
-            value: viewModel
-          }
-        }
-      ]
+      datas: surfaceIds.map((surfaceId) => ({
+        updateDataModel: { surfaceId, path: "/", value: viewModel }
+      }))
     }
   ];
 }
+function collectA2UISurfaceIdsForLegacyContract(protocol) {
+  const surfaceIds = /* @__PURE__ */ new Set();
+  for (const message of protocol) {
+    if (!isJsonObject(message) || !Array.isArray(message.datas))
+      continue;
+    for (const instruction of message.datas) {
+      if (!isJsonObject(instruction))
+        continue;
+      const operations = [
+        "createSurface" in instruction ? instruction.createSurface : void 0,
+        "updateComponents" in instruction ? instruction.updateComponents : void 0
+      ];
+      for (const operation of operations) {
+        if (isJsonObject(operation) && typeof operation.surfaceId === "string") {
+          surfaceIds.add(operation.surfaceId);
+        }
+      }
+    }
+  }
+  return [...surfaceIds];
+}
 function createPresentationDescription(config) {
   return [
     config.description,
@@ -19771,6 +19789,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;
 }
@@ -19827,10 +19856,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);
@@ -19848,7 +19904,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)
@@ -19859,13 +19919,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 {
@@ -19905,7 +19966,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: {

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-MN4S5EF5.js";
+} from "../../chunk-XGIMLCNP.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-MN4S5EF5.js";
+} from "../chunk-XGIMLCNP.js";
 import "../chunk-XUFLSZM4.js";
 import "../chunk-I64V3ICJ.js";
 import "../chunk-6MHDOBWO.js";

package/worker.js

@@ -13846,6 +13846,7 @@ function analyzeA2UIBindings(protocol) {
     }
   }
   return {
+    surfaceIds: [...surfaces],
     surfaceId: surfaces.size === 1 ? [...surfaces][0] : void 0,
     occurrences,
     issues
@@ -15259,25 +15260,42 @@ function isAgentPresentationToolResult(value) {
 }
 function injectResolvedViewModel(protocol, viewModel) {
   const analysis = analyzeA2UIBindings(protocol);
-  if (analysis.issues.length || !analysis.surfaceId) {
-    throw new Error("CARD template does not contain one valid A2UI surface");
+  const declaredSurfaceIds = analysis.surfaceIds;
+  const surfaceIds = Array.isArray(declaredSurfaceIds) && declaredSurfaceIds.every((surfaceId) => typeof surfaceId === "string") ? declaredSurfaceIds : collectA2UISurfaceIdsForLegacyContract(protocol);
+  if (analysis.issues.length || surfaceIds.length === 0) {
+    throw new Error("CARD template does not contain a valid A2UI surface");
   }
   return [
     ...protocol,
     {
       version: "0.9",
-      datas: [
-        {
-          updateDataModel: {
-            surfaceId: analysis.surfaceId,
-            path: "/",
-            value: viewModel
-          }
-        }
-      ]
+      datas: surfaceIds.map((surfaceId) => ({
+        updateDataModel: { surfaceId, path: "/", value: viewModel }
+      }))
     }
   ];
 }
+function collectA2UISurfaceIdsForLegacyContract(protocol) {
+  const surfaceIds = /* @__PURE__ */ new Set();
+  for (const message of protocol) {
+    if (!isJsonObject(message) || !Array.isArray(message.datas))
+      continue;
+    for (const instruction of message.datas) {
+      if (!isJsonObject(instruction))
+        continue;
+      const operations = [
+        "createSurface" in instruction ? instruction.createSurface : void 0,
+        "updateComponents" in instruction ? instruction.updateComponents : void 0
+      ];
+      for (const operation of operations) {
+        if (isJsonObject(operation) && typeof operation.surfaceId === "string") {
+          surfaceIds.add(operation.surfaceId);
+        }
+      }
+    }
+  }
+  return [...surfaceIds];
+}
 function createPresentationDescription(config2) {
   return [
     config2.description,
@@ -16862,10 +16880,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);
@@ -16879,7 +16924,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";
@@ -16893,6 +16938,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"
+    ];
   }
 });
 
@@ -16907,13 +16963,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;
@@ -16925,7 +16982,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;
@@ -16963,7 +17024,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: {
@@ -196963,7 +197024,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";
@@ -196971,23 +197032,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;
@@ -197016,10 +197093,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));
+          }
+        }
       }
     };
   }
@@ -197031,6 +197110,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({