linkque-cli-v2 1.1.5 → 1.2.0

package/linkquejs.js

@@ -19550,6 +19550,30 @@ var SEARCH_DATABASE_ID = "linkque";
 var SEARCH_TABLE_ID = "linkque_conversation_message_search";
 var CLIENT_CAPABILITY_DATABASE_ID = "linkque";
 var CLIENT_CAPABILITY_TABLE_ID = "linkque_client_cap_invocations";
+var A2UI_ACTION_DATABASE_ID = "linkque";
+var A2UI_ACTION_TABLE_ID = "linkque_a2ui_action_invocations";
+var A2UI_ACTION_TABLE_COLUMNS = [
+  ...["ownerId", "agentId", "threadId", "actionId", "cardRef", "cardRevision", "surfaceId", "componentId"].map((key) => ({
+    key,
+    type: "varchar",
+    required: true,
+    array: false,
+    size: 128,
+    default: null
+  })),
+  { key: "cardInstanceId", type: "varchar", required: true, array: false, size: 256, default: null },
+  { key: "status", type: "varchar", required: true, array: false, size: 32, default: null },
+  { key: "actionContext", type: "text", required: true, array: false, size: 0, default: null },
+  { key: "tradeNO", type: "varchar", required: false, array: false, size: 64, default: null },
+  { key: "callback", type: "text", required: false, array: false, size: 0, default: null },
+  { key: "verification", type: "text", required: false, array: false, size: 0, default: null },
+  { key: "createdAt", type: "varchar", required: true, array: false, size: 32, default: null },
+  { key: "expiresAt", type: "varchar", required: true, array: false, size: 32, default: null }
+];
+var A2UI_ACTION_TABLE_INDEXES = [
+  { key: "thread_status", type: "key", columns: ["threadId", "status"], orders: ["asc", "asc"] },
+  { key: "expires_at", type: "key", columns: ["expiresAt"], orders: ["asc"] }
+];
 var CLIENT_CAPABILITY_TABLE_COLUMNS = [
   ...["ownerId", "agentId", "threadId", "runId", "toolCallId"].map((key) => ({
     key,
@@ -20148,6 +20172,8 @@ var FUNCTION_DEFS = [
         value: CLIENT_CAPABILITY_DATABASE_ID
       },
       { key: "CLIENT_CAPABILITY_TABLE_ID", value: CLIENT_CAPABILITY_TABLE_ID },
+      { key: "A2UI_ACTION_DATABASE_ID", value: A2UI_ACTION_DATABASE_ID },
+      { key: "A2UI_ACTION_TABLE_ID", value: A2UI_ACTION_TABLE_ID },
       { key: "RUN_CHUNK_SIZE", value: "10" },
       { key: "RUN_CANCEL_POLL_INTERVAL_MS", value: "500" },
       // linkquegw 出站地址:线上套(无 x-linkque-env 头时生效)。
@@ -20198,6 +20224,8 @@ var FUNCTION_DEFS = [
         value: CLIENT_CAPABILITY_DATABASE_ID
       },
       { key: "CLIENT_CAPABILITY_TABLE_ID", value: CLIENT_CAPABILITY_TABLE_ID },
+      { key: "A2UI_ACTION_DATABASE_ID", value: A2UI_ACTION_DATABASE_ID },
+      { key: "A2UI_ACTION_TABLE_ID", value: A2UI_ACTION_TABLE_ID },
       {
         key: "LINKQUEGW_MCP_SIGN_ENDPOINT",
         value: LINKQUEGW_MCP_SIGN_ENDPOINT
@@ -20273,6 +20301,16 @@ var TABLES = [
     permissions: [],
     columns: CLIENT_CAPABILITY_TABLE_COLUMNS,
     indexes: CLIENT_CAPABILITY_TABLE_INDEXES
+  },
+  {
+    $id: A2UI_ACTION_TABLE_ID,
+    databaseId: A2UI_ACTION_DATABASE_ID,
+    name: A2UI_ACTION_TABLE_ID,
+    enabled: true,
+    rowSecurity: true,
+    permissions: [],
+    columns: A2UI_ACTION_TABLE_COLUMNS,
+    indexes: A2UI_ACTION_TABLE_INDEXES
   }
 ];
 var buildAppwriteConfigTemplate = (envOverrides = {}) => ({
@@ -21040,6 +21078,7 @@ var AGENT_LOG = ".linkque/logs/agent.log";
 var HEALTH_PATH = "/healthz";
 var RUNS_PATH = "/runs";
 var HOME_DATA_PATH = "/home-data";
+var A2UI_ACTION_PATH = "/a2ui-action";
 var AGENT_RUNTIME_PROTOCOL = "conversation-runs-v2";
 var API_KEY_ENV = "LINKQUE_AGENT_API_KEY";
 var stopped = (health) => ({
@@ -21307,6 +21346,7 @@ var spawnAgentOwner = (cwd, config2, port, apiKey, statePath) => {
       cwd,
       healthPath: HEALTH_PATH,
       homeDataPath: HOME_DATA_PATH,
+      a2uiActionPath: A2UI_ACTION_PATH,
       logPath: import_path15.default.join(cwd, AGENT_LOG),
       port,
       runsPath: RUNS_PATH,
@@ -26316,6 +26356,192 @@ function candidateKey(resourceId, toolName) {
   return `${resourceId}\0${toolName}`;
 }
 
+// ../agent-a2ui-card-contract/dist/esm/payment-action.js
+var A2UI_PAYMENT_ACTION_NAME = "payment.trade-pay";
+var A2UI_PAYMENT_CALLBACK_MAX_BYTES = 16 * 1024;
+function getA2UICardActionBindingIssues(value, path22 = "actionBindings") {
+  if (!Array.isArray(value)) {
+    return [issue2(path22, "INVALID_ACTION_BINDINGS", "actionBindings must be an array")];
+  }
+  const issues = [];
+  const actionIds = /* @__PURE__ */ new Set();
+  value.forEach((candidate, index) => {
+    const itemPath = `${path22}[${index}]`;
+    if (!isPlainRecord(candidate)) {
+      issues.push(issue2(itemPath, "INVALID_ACTION_BINDING", "action binding must be an object"));
+      return;
+    }
+    if (!isSafeIdentifier(candidate.actionId)) {
+      issues.push(issue2(`${itemPath}.actionId`, "INVALID_ACTION_ID", "actionId is invalid"));
+    } else if (actionIds.has(candidate.actionId)) {
+      issues.push(issue2(`${itemPath}.actionId`, "DUPLICATE_ACTION_ID", "actionId must be unique"));
+    } else {
+      actionIds.add(candidate.actionId);
+    }
+    if (candidate.kind !== "payment") {
+      issues.push(issue2(`${itemPath}.kind`, "INVALID_ACTION_KIND", "kind must be payment"));
+      return;
+    }
+    rejectExtraKeys(candidate, ["actionId", "kind", "createTrade", "queryTrade"], itemPath, issues);
+    validateToolBinding(candidate.createTrade, `${itemPath}.createTrade`, "create", issues);
+    validateToolBinding(candidate.queryTrade, `${itemPath}.queryTrade`, "query", issues);
+  });
+  return issues;
+}
+function getA2UIPaymentActionReferenceIssues(card, bindings, path22 = "a2uiTemplate.content") {
+  const issues = [];
+  const bindingIds = new Set(bindings.map((binding) => binding.actionId));
+  const referenced = /* @__PURE__ */ new Set();
+  card.forEach((instruction, instructionIndex) => {
+    const instructionRecord = instruction;
+    const update = isPlainRecord(instructionRecord.updateComponents) ? instructionRecord.updateComponents : void 0;
+    const components = update && Array.isArray(update.components) ? update.components : [];
+    components.forEach((component, componentIndex) => {
+      if (!isPlainRecord(component))
+        return;
+      collectPaymentActionReferences(component.action, `${path22}[${instructionIndex}].updateComponents.components[${componentIndex}].action`, referenced, issues);
+    });
+  });
+  for (const actionId of referenced) {
+    if (!bindingIds.has(actionId)) {
+      issues.push(issue2(path22, "PAYMENT_ACTION_BINDING_MISSING", `payment action ${actionId} has no action binding`));
+    }
+  }
+  for (const actionId of bindingIds) {
+    if (!referenced.has(actionId)) {
+      issues.push(issue2(path22, "PAYMENT_ACTION_UNUSED", `payment action binding ${actionId} is not referenced`));
+    }
+  }
+  return issues;
+}
+function validateToolBinding(value, path22, phase, issues) {
+  if (!isPlainRecord(value)) {
+    issues.push(issue2(path22, "INVALID_PAYMENT_TOOL", `${path22} must be an object`));
+    return;
+  }
+  rejectExtraKeys(value, phase === "create" ? ["mcpResourceId", "toolName", "inputBindings", "tradeNoPath"] : ["mcpResourceId", "toolName", "inputBindings", "statusPath", "paidValues"], path22, issues);
+  if (!isSafeIdentifier(value.mcpResourceId)) {
+    issues.push(issue2(`${path22}.mcpResourceId`, "INVALID_MCP_RESOURCE_ID", "mcpResourceId is invalid"));
+  }
+  if (typeof value.toolName !== "string" || !value.toolName.trim()) {
+    issues.push(issue2(`${path22}.toolName`, "INVALID_TOOL_NAME", "toolName is required"));
+  }
+  validateInputBindings2(value.inputBindings, `${path22}.inputBindings`, phase, issues);
+  if (phase === "create") {
+    if (!isSafeJsonPointer(value.tradeNoPath)) {
+      issues.push(issue2(`${path22}.tradeNoPath`, "INVALID_TRADE_NO_PATH", "tradeNoPath must be an absolute JSON Pointer"));
+    }
+    return;
+  }
+  if (!isSafeJsonPointer(value.statusPath)) {
+    issues.push(issue2(`${path22}.statusPath`, "INVALID_PAYMENT_STATUS_PATH", "statusPath must be an absolute JSON Pointer"));
+  }
+  if (!Array.isArray(value.inputBindings) || !value.inputBindings.some((binding) => isPlainRecord(binding) && isPlainRecord(binding.source) && binding.source.kind === "trade-no")) {
+    issues.push(issue2(`${path22}.inputBindings`, "PAYMENT_TRADE_NO_BINDING_MISSING", "queryTrade must map tradeNO"));
+  }
+  if (!Array.isArray(value.paidValues) || value.paidValues.length === 0 || value.paidValues.some((entry) => !isJsonPrimitive(entry))) {
+    issues.push(issue2(`${path22}.paidValues`, "INVALID_PAID_VALUES", "paidValues must contain JSON primitives"));
+  }
+}
+function collectPaymentActionReferences(value, path22, referenced, issues) {
+  if (!isPlainRecord(value))
+    return;
+  if (isPlainRecord(value.client) && value.client.name === A2UI_PAYMENT_ACTION_NAME) {
+    const context = value.client.context;
+    if (!isPlainRecord(context) || !isSafeIdentifier(context.actionId)) {
+      issues.push(issue2(path22, "INVALID_PAYMENT_ACTION", "payment action requires a safe actionId"));
+      return;
+    }
+    rejectExtraKeys(context, ["actionId", "actionContext"], `${path22}.client.context`, issues);
+    if (!isPlainRecord(context.actionContext)) {
+      issues.push(issue2(path22, "INVALID_PAYMENT_ACTION", "payment action requires an object actionContext"));
+    }
+    referenced.add(context.actionId);
+    return;
+  }
+  if (!isPlainRecord(value.select))
+    return;
+  if (Array.isArray(value.select.cases)) {
+    value.select.cases.forEach((entry, index) => {
+      if (isPlainRecord(entry)) {
+        collectPaymentActionReferences(entry.action, `${path22}.select.cases[${index}].action`, referenced, issues);
+      }
+    });
+  }
+  collectPaymentActionReferences(value.select.default, `${path22}.select.default`, referenced, issues);
+}
+function validateInputBindings2(value, path22, phase, issues) {
+  if (!Array.isArray(value) || value.length > 128) {
+    issues.push(issue2(path22, "INVALID_PAYMENT_INPUT_BINDINGS", "inputBindings must be an array of at most 128 entries"));
+    return;
+  }
+  const targets = /* @__PURE__ */ new Set();
+  value.forEach((candidate, index) => {
+    const itemPath = `${path22}[${index}]`;
+    if (!isPlainRecord(candidate) || !isSafeJsonPointer(candidate.inputPath)) {
+      issues.push(issue2(itemPath, "INVALID_PAYMENT_INPUT_BINDING", "inputPath must be an absolute JSON Pointer"));
+      return;
+    }
+    rejectExtraKeys(candidate, ["inputPath", "source"], itemPath, issues);
+    if (targets.has(candidate.inputPath)) {
+      issues.push(issue2(`${itemPath}.inputPath`, "DUPLICATE_PAYMENT_INPUT_PATH", "inputPath must be unique"));
+    }
+    targets.add(candidate.inputPath);
+    validateInputSource(candidate.source, `${itemPath}.source`, phase, issues);
+  });
+}
+function validateInputSource(value, path22, phase, issues) {
+  if (!isPlainRecord(value) || typeof value.kind !== "string") {
+    issues.push(issue2(path22, "INVALID_PAYMENT_INPUT_SOURCE", "source must be an object"));
+    return;
+  }
+  if (value.kind === "action-context") {
+    rejectExtraKeys(value, ["kind", "path"], path22, issues);
+    if (!isSafeJsonPointer(value.path, true)) {
+      issues.push(issue2(`${path22}.path`, "INVALID_PAYMENT_SOURCE_PATH", "action context path must be a JSON Pointer"));
+    }
+    return;
+  }
+  if (value.kind === "runtime-context") {
+    rejectExtraKeys(value, ["kind", "key"], path22, issues);
+    if (!RUNTIME_CONTEXT_KEYS2.has(String(value.key))) {
+      issues.push(issue2(`${path22}.key`, "INVALID_RUNTIME_CONTEXT_KEY", "runtime context key is unsupported"));
+    }
+    return;
+  }
+  if (value.kind === "literal") {
+    rejectExtraKeys(value, ["kind", "value"], path22, issues);
+    if (!isJsonValue(value.value)) {
+      issues.push(issue2(`${path22}.value`, "INVALID_PAYMENT_LITERAL", "literal must be JSON"));
+    }
+    return;
+  }
+  if (phase === "query" && value.kind === "trade-no") {
+    rejectExtraKeys(value, ["kind"], path22, issues);
+    return;
+  }
+  if (phase === "query" && value.kind === "callback") {
+    rejectExtraKeys(value, ["kind", "path"], path22, issues);
+    if (!isSafeJsonPointer(value.path, true)) {
+      issues.push(issue2(`${path22}.path`, "INVALID_PAYMENT_CALLBACK_PATH", "callback path must be a JSON Pointer"));
+    }
+    return;
+  }
+  issues.push(issue2(path22, "INVALID_PAYMENT_INPUT_SOURCE", `${value.kind} is unavailable for ${phase}`));
+}
+function rejectExtraKeys(value, allowed, path22, issues) {
+  const allowedKeys = new Set(allowed);
+  for (const key of Object.keys(value)) {
+    if (!allowedKeys.has(key)) {
+      issues.push(issue2(`${path22}.${key}`, "UNEXPECTED_ACTION_BINDING_FIELD", `${key} is not allowed`));
+    }
+  }
+}
+function isJsonPrimitive(value) {
+  return value === null || ["string", "number", "boolean"].includes(typeof value);
+}
+var RUNTIME_CONTEXT_KEYS2 = /* @__PURE__ */ new Set(["agentId", "tenantId", "threadId", "userId"]);
+
 // ../agent-a2ui-card-contract/dist/esm/validation.js
 var FIELD_TYPES = [
   "array",
@@ -26331,7 +26557,7 @@ var FIELD_SOURCES = [
   "runtime-context",
   "local"
 ];
-var RUNTIME_CONTEXT_KEYS2 = /* @__PURE__ */ new Set([
+var RUNTIME_CONTEXT_KEYS3 = /* @__PURE__ */ new Set([
   "agentId",
   "tenantId",
   "threadId",
@@ -26355,11 +26581,14 @@ function getA2UICardDraftBundleIssues(value) {
   }
   const issues = [];
   exactKeys(value, ["manifest", "card", "fixture"], "draft", issues);
-  validateManifest(value.manifest, "draft.manifest", issues);
+  const manifest = validateManifest(value.manifest, "draft.manifest", issues);
   const card = validateProtocol(value.card, "draft.card", issues);
   if (card) {
     const analysis = analyzeA2UIBindings(card);
     issues.push(...analysis.issues);
+    if (manifest?.schemaVersion === "3") {
+      issues.push(...getA2UIPaymentActionReferenceIssues(card, manifest.actionBindings ?? [], "draft.card"));
+    }
   }
   return issues;
 }
@@ -26427,6 +26656,7 @@ function getA2UICardResourceConfigV3Issues(value) {
     "fields",
     "dataSources",
     "bindings",
+    "actionBindings",
     "a2uiTemplate"
   ], "config", issues);
   if (value.schemaVersion !== A2UI_CARD_SCHEMA_VERSION) {
@@ -26446,6 +26676,11 @@ function getA2UICardResourceConfigV3Issues(value) {
   const dataSources = validateDataSources(value.dataSources, "config.dataSources", issues);
   const bindings = validateV3OutputBindings(value.bindings, "config.bindings", issues);
   const card = validateTemplate(value.a2uiTemplate, fields, issues);
+  const actionBindings = value.actionBindings === void 0 ? [] : value.actionBindings;
+  issues.push(...getA2UICardActionBindingIssues(actionBindings, "config.actionBindings"));
+  if (card && Array.isArray(actionBindings)) {
+    issues.push(...getA2UIPaymentActionReferenceIssues(card, actionBindings, "config.a2uiTemplate.content"));
+  }
   if (fields && dataSources && bindings) {
     validateV3Coverage(fields, dataSources, bindings, issues, { card });
   }
@@ -26651,7 +26886,8 @@ function validateManifest(value, path22, issues) {
       "whenToUse",
       "whenNotToUse",
       "fields",
-      "bindings"
+      "bindings",
+      "actionBindings"
     ], path22, issues);
     if (!isSafeIdentifier(value.draftId)) {
       issues.push(issue2(`${path22}.draftId`, "INVALID_DRAFT_ID", "draftId is invalid"));
@@ -26671,6 +26907,9 @@ function validateManifest(value, path22, issues) {
     if (value.bindings !== void 0) {
       validateV3BindingSelections(value.bindings, `${path22}.bindings`, fields2, issues);
     }
+    if (value.actionBindings !== void 0) {
+      issues.push(...getA2UICardActionBindingIssues(value.actionBindings, `${path22}.actionBindings`));
+    }
     return fields2 ? value : void 0;
   }
   exactKeys(value, [
@@ -26778,7 +27017,7 @@ function validateFieldSource(candidate, itemPath, issues) {
     issues.push(issue2(`${itemPath}.sourcePath`, "UNEXPECTED_FIELD_SOURCE_PATH", "sourcePath is only allowed for invocation fields"));
   }
   if (candidate.source === "runtime-context") {
-    if (!RUNTIME_CONTEXT_KEYS2.has(candidate.runtimeContextKey)) {
+    if (!RUNTIME_CONTEXT_KEYS3.has(candidate.runtimeContextKey)) {
       issues.push(issue2(`${itemPath}.runtimeContextKey`, "INVALID_RUNTIME_CONTEXT", "runtime-context fields require an allowed runtimeContextKey"));
     }
   } else if (candidate.runtimeContextKey !== void 0) {
@@ -26830,11 +27069,11 @@ function validateResolverCalls(value, path22, issues) {
       issues.push(issue2(`${itemPath}.mcpResourceId`, "INVALID_MCP_RESOURCE_ID", "mcpResourceId is invalid"));
     }
     requiredString(candidate.toolName, `${itemPath}.toolName`, issues);
-    validateInputBindings2(candidate.inputBindings, `${itemPath}.inputBindings`, issues);
+    validateInputBindings3(candidate.inputBindings, `${itemPath}.inputBindings`, issues);
   });
   return value;
 }
-function validateInputBindings2(value, path22, issues) {
+function validateInputBindings3(value, path22, issues) {
   if (!Array.isArray(value)) {
     issues.push(issue2(path22, "INVALID_INPUT_BINDINGS", "inputBindings must be an array"));
     return void 0;
@@ -26854,11 +27093,11 @@ function validateInputBindings2(value, path22, issues) {
     } else {
       paths.add(candidate.inputPath);
     }
-    validateInputSource(candidate.source, `${itemPath}.source`, issues);
+    validateInputSource2(candidate.source, `${itemPath}.source`, issues);
   });
   return value;
 }
-function validateInputSource(value, path22, issues) {
+function validateInputSource2(value, path22, issues) {
   if (!isPlainRecord(value)) {
     issues.push(issue2(path22, "INVALID_INPUT_SOURCE", "source must be an object"));
     return;
@@ -26872,7 +27111,7 @@ function validateInputSource(value, path22, issues) {
   }
   if (value.kind === "runtime-context") {
     exactKeys(value, ["kind", "key"], path22, issues);
-    if (!RUNTIME_CONTEXT_KEYS2.has(value.key)) {
+    if (!RUNTIME_CONTEXT_KEYS3.has(value.key)) {
       issues.push(issue2(`${path22}.key`, "INVALID_RUNTIME_CONTEXT", "runtime context key is invalid"));
     }
     return;
@@ -27236,6 +27475,9 @@ function compileV3Resource(draft, revision, bindings, tools) {
     fields: draft.manifest.fields,
     dataSources: [...sourceById.values()].sort((left, right) => left.sourceId.localeCompare(right.sourceId)),
     bindings: outputBindings.sort((left, right) => left.fieldId.localeCompare(right.fieldId)),
+    ...draft.manifest.actionBindings?.length ? {
+      actionBindings: JSON.parse(JSON.stringify(draft.manifest.actionBindings))
+    } : {},
     a2uiTemplate: {
       argsSchema: createA2UICardViewModelSchema(draft.manifest.fields),
       content: stableJsonStringify(draft.card)
@@ -27556,7 +27798,7 @@ function extractA2UICardAuthoringModel(bundle, options = {}) {
       discoverComponentTargets(component, occurrenceId, projection, targets);
       allFieldOccurrenceTargets.push(...fieldTargets(component, occurrenceId, fields, componentOccurrences, false));
       targets.push(...fieldTargets(component, occurrenceId, fields, componentOccurrences, true));
-      targets.push(...actionTargets(component, occurrenceId));
+      targets.push(...actionTargets(component, occurrenceId, bundle.manifest.schemaVersion === "3" ? bundle.manifest.actionBindings : void 0));
     }
     if (targets.length === 0) {
       targets.push({
@@ -27745,7 +27987,7 @@ function discoverTargets(value, occurrenceId, propertyPath, targets) {
     });
   }
 }
-function actionTargets(component, occurrenceId) {
+function actionTargets(component, occurrenceId, actionBindings) {
   if (!isPlainRecord(component.action))
     return [];
   const action = component.action;
@@ -27784,6 +28026,23 @@ function actionTargets(component, occurrenceId) {
       }
     ];
   }
+  if (client?.name === "payment.trade-pay") {
+    const context = isPlainRecord(client.context) ? client.context : void 0;
+    const actionId = typeof context?.actionId === "string" ? context.actionId : "";
+    const actionContext = isPlainRecord(context?.actionContext) ? context.actionContext : {};
+    const binding = actionBindings?.find((candidate) => candidate.kind === "payment" && candidate.actionId === actionId);
+    return [{
+      kind: "payment",
+      targetId: createA2UICardAuthoringTargetId(occurrenceId, "action"),
+      occurrenceId,
+      propertyPath: "action",
+      label: "\u652F\u4ED8",
+      actionId,
+      actionContext,
+      ...binding ? { binding } : {},
+      configured: Boolean(actionId && binding)
+    }];
+  }
   return [agentOnlyAction(occurrenceId, "\u8BE5\u884C\u4E3A\u53EA\u80FD\u901A\u8FC7 Coding Agent \u4FEE\u6539")];
 }
 function fieldTargets(component, occurrenceId, fields, occurrences, projectedOnly) {

package/package.json

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