linkque-cli-v2 1.1.4 → 1.1.5

package/linkquejs.js

@@ -25304,6 +25304,7 @@ function analyzeA2UIBindings(protocol) {
     const listRoots = inferListRoots(components, issues);
     for (const component of components) {
       const context = {
+        surfaceId,
         component,
         listRoot: listRoots.get(component.id),
         occurrences,
@@ -25317,6 +25318,7 @@ function analyzeA2UIBindings(protocol) {
           issues.push(issue2(`card.surfaces.${surfaceId}.components.${component.id}.children.path`, "INVALID_BINDING_PATH", `Invalid list path ${children.path}`));
         } else {
           occurrences.push({
+            surfaceId,
             componentId: component.id,
             componentName: component.component,
             propertyPath: "children.path",
@@ -25335,6 +25337,16 @@ function analyzeA2UIBindings(protocol) {
     issues
   };
 }
+function collectReferencedA2UICardBusinessFieldIds(protocol, fields) {
+  const businessFields = fields.filter((field) => field.source === "business").slice().sort((left, right) => right.path.length - left.path.length);
+  const result = /* @__PURE__ */ new Set();
+  for (const occurrence of analyzeA2UIBindings(protocol).occurrences) {
+    const field = businessFields.find((candidate) => occurrence.canonicalPath === candidate.path || occurrence.canonicalPath.startsWith(`${candidate.path}/*/`) || occurrence.canonicalPath.startsWith(`${candidate.path}/`));
+    if (field)
+      result.add(field.fieldId);
+  }
+  return result;
+}
 function visitValue(value, propertyPath, context) {
   if (propertyPath === "action.local.path" && typeof value === "string") {
     addOccurrence(value, propertyPath, "local", context);
@@ -25366,6 +25378,7 @@ function addOccurrence(rawPath, propertyPath, usage, context) {
     return;
   }
   context.occurrences.push({
+    surfaceId: context.surfaceId,
     componentId: context.component.id,
     componentName: context.component.component,
     propertyPath,
@@ -26051,12 +26064,15 @@ function validateA2UICardBindings(input, options = {}) {
     readyCandidates.set(candidateKey(candidate.resourceId, candidate.tool.toolName), candidate.tool);
   }
   const bindingByField = new Map(bindings.map((binding) => [binding.fieldId, binding]));
+  const requiredFields = collectReferencedA2UICardBusinessFieldIds(input.draft.card, input.draft.manifest.fields.filter((field) => field.required));
   for (const field of input.draft.manifest.fields) {
     if (field.source !== "business")
       continue;
     if (selectedFields && !selectedFields.has(field.fieldId))
       continue;
     const binding = bindingByField.get(field.fieldId);
+    if (!selectedFields && !requiredFields.has(field.fieldId) && !binding)
+      continue;
     if (!binding) {
       issues.push(issue2(`fields.${field.fieldId}`, "CARD_BINDING_INCOMPLETE", `business field ${field.fieldId} has not been bound`));
       continue;
@@ -26394,9 +26410,9 @@ function getA2UICardResourceConfigIssues(value) {
   validateLooseJsonSchema(value.presentationInputSchema, "config.presentationInputSchema", issues);
   const fields = validateFields(value.fields, "config.fields", issues);
   const resolver = validateResolver(value.resolver, "config.resolver", issues);
-  validateTemplate(value.a2uiTemplate, fields, issues);
+  const card = validateTemplate(value.a2uiTemplate, fields, issues);
   if (fields && resolver)
-    validateResolverCoverage(fields, resolver, issues);
+    validateResolverCoverage(fields, resolver, issues, card);
   return issues;
 }
 function getA2UICardResourceConfigV3Issues(value) {
@@ -26429,9 +26445,9 @@ function getA2UICardResourceConfigV3Issues(value) {
   }
   const dataSources = validateDataSources(value.dataSources, "config.dataSources", issues);
   const bindings = validateV3OutputBindings(value.bindings, "config.bindings", issues);
-  validateTemplate(value.a2uiTemplate, fields, issues);
+  const card = validateTemplate(value.a2uiTemplate, fields, issues);
   if (fields && dataSources && bindings) {
-    validateV3Coverage(fields, dataSources, bindings, issues);
+    validateV3Coverage(fields, dataSources, bindings, issues, { card });
   }
   return issues;
 }
@@ -26545,7 +26561,8 @@ function validateV3Coverage(fields, dataSources, bindings, issues, options = {})
     bound.add(binding.fieldId);
   });
   if (options.requireComplete !== false) {
-    for (const fieldId of businessFields) {
+    const requiredFields = options.card ? collectReferencedA2UICardBusinessFieldIds(options.card, fields.filter((field) => field.required)) : new Set(fields.filter((field) => field.source === "business" && field.required).map((field) => field.fieldId));
+    for (const fieldId of requiredFields) {
       if (bound.has(fieldId))
         continue;
       issues.push(issue2("config.bindings", "CARD_BINDING_INCOMPLETE", `business field ${fieldId} is not bound`));
@@ -26983,13 +27000,13 @@ function validateInstructionShape(instruction, path22, issues) {
 function validateTemplate(value, fields, issues) {
   if (!isPlainRecord(value)) {
     issues.push(issue2("config.a2uiTemplate", "INVALID_A2UI_TEMPLATE", "a2uiTemplate must be an object"));
-    return;
+    return void 0;
   }
   exactKeys(value, ["argsSchema", "content"], "config.a2uiTemplate", issues);
   validateLooseJsonSchema(value.argsSchema, "config.a2uiTemplate.argsSchema", issues);
   if (typeof value.content !== "string") {
     issues.push(issue2("config.a2uiTemplate.content", "INVALID_A2UI_CONTENT", "a2uiTemplate.content must be serialized A2UI JSON"));
-    return;
+    return void 0;
   }
   try {
     const card = validateProtocol(JSON.parse(value.content), "config.a2uiTemplate.content", issues);
@@ -26997,9 +27014,11 @@ function validateTemplate(value, fields, issues) {
       const analysis = analyzeA2UIBindings(card);
       issues.push(...analysis.issues);
     }
+    return card;
   } catch {
     issues.push(issue2("config.a2uiTemplate.content", "INVALID_A2UI_CONTENT", "a2uiTemplate.content must contain valid JSON"));
   }
+  return void 0;
 }
 function validateLooseJsonSchema(value, path22, issues) {
   const schemaIssues = getJsonSchemaIssues(value, path22, {
@@ -27008,7 +27027,7 @@ function validateLooseJsonSchema(value, path22, issues) {
   issues.push(...schemaIssues);
   return schemaIssues.length === 0;
 }
-function validateResolverCoverage(fields, resolver, issues) {
+function validateResolverCoverage(fields, resolver, issues, card) {
   const businessFields = new Set(fields.filter((field) => field.source === "business").map((field) => field.fieldId));
   const bound = /* @__PURE__ */ new Set();
   resolver.outputBindings.forEach((binding, index) => {
@@ -27017,7 +27036,8 @@ function validateResolverCoverage(fields, resolver, issues) {
     }
     bound.add(binding.fieldId);
   });
-  for (const fieldId of businessFields) {
+  const requiredFields = card ? collectReferencedA2UICardBusinessFieldIds(card, fields.filter((field) => field.required)) : new Set(fields.filter((field) => field.source === "business" && field.required).map((field) => field.fieldId));
+  for (const fieldId of requiredFields) {
     if (!bound.has(fieldId)) {
       issues.push(issue2("config.resolver.outputBindings", "CARD_BINDING_INCOMPLETE", `business field ${fieldId} is not bound`));
     }
@@ -27065,6 +27085,7 @@ function compileA2UICardResource(input) {
   }
   const fieldById = new Map(draft.manifest.fields.map((field) => [field.fieldId, field]));
   const selectionByField = /* @__PURE__ */ new Map();
+  const requiredFields = collectReferencedA2UICardBusinessFieldIds(draft.card, draft.manifest.fields.filter((field) => field.required));
   for (const selection of input.bindings) {
     const field = fieldById.get(selection.fieldId);
     if (!field || field.source !== "business") {
@@ -27078,9 +27099,9 @@ function compileA2UICardResource(input) {
     }
     selectionByField.set(selection.fieldId, cloneSelection(selection));
   }
-  for (const field of draft.manifest.fields) {
-    if (field.source === "business" && !selectionByField.has(field.fieldId)) {
-      throw new A2UICardCompileError("CARD_BINDING_INCOMPLETE", `Business field ${field.fieldId} has not been bound`);
+  for (const fieldId of requiredFields) {
+    if (!selectionByField.has(fieldId)) {
+      throw new A2UICardCompileError("CARD_BINDING_INCOMPLETE", `Required referenced business field ${fieldId} has not been bound`);
     }
   }
   const resolver = compileResolver([...selectionByField.values()]);
@@ -27172,6 +27193,7 @@ function compileV3Resource(draft, revision, bindings, tools) {
   const sourceById = /* @__PURE__ */ new Map();
   const outputBindings = [];
   const boundFields = /* @__PURE__ */ new Set();
+  const requiredFields = collectReferencedA2UICardBusinessFieldIds(draft.card, draft.manifest.fields.filter((field) => field.required));
   for (const binding of bindings) {
     const field = fieldById.get(binding.fieldId);
     if (!field || field.source !== "business" || boundFields.has(binding.fieldId)) {
@@ -27199,9 +27221,9 @@ function compileV3Resource(draft, revision, bindings, tools) {
       transform: binding.transform
     });
   }
-  for (const field of draft.manifest.fields) {
-    if (field.source === "business" && !boundFields.has(field.fieldId)) {
-      throw new A2UICardCompileError("CARD_BINDING_INCOMPLETE", `Business field ${field.fieldId} has not been bound`);
+  for (const fieldId of requiredFields) {
+    if (!boundFields.has(fieldId)) {
+      throw new A2UICardCompileError("CARD_BINDING_INCOMPLETE", `Required referenced business field ${fieldId} has not been bound`);
     }
   }
   const resource = {
@@ -27404,9 +27426,6 @@ function createA2UICardDraftStructureChecksum(draft) {
   delete cloned.manifest.bindings;
   return sha256Hex(stableJsonStringify(cloned));
 }
-function createA2UICardMcpConfigChecksum(resources) {
-  return sha256Hex(stableJsonStringify(resources));
-}
 function createA2UICardRevision(draftChecksum2, bindings) {
   const digest = sha256Hex(`${draftChecksum2}
 ${stableJsonStringify(bindings)}`);
@@ -27485,6 +27504,393 @@ var SHA256_CONSTANTS = [
   3329325298
 ];
 
+// ../agent-a2ui-card-contract/dist/esm/authoring-model.js
+var INTERNAL_KEYS = /* @__PURE__ */ new Set([
+  "__proto__",
+  "constructor",
+  "prototype",
+  "id",
+  "component",
+  "surfaceId",
+  "version",
+  "child",
+  "children"
+]);
+var MERCHANT_CONTENT_KEYS = /* @__PURE__ */ new Set([
+  "caption",
+  "description",
+  "label",
+  "placeholder",
+  "subtitle",
+  "text",
+  "title"
+]);
+var DEFAULT_AUTHORING_PROJECTION = {
+  directTargets: "content"
+};
+var COMPONENT_AUTHORING_PROJECTIONS = {
+  Image: {
+    directTargets: "image-source",
+    fieldProperties: ["src"],
+    groupLabel: "\u56FE\u7247"
+  }
+};
+function extractA2UICardAuthoringModel(bundle, options = {}) {
+  const analysis = analyzeA2UIBindings(bundle.card);
+  const bindingByField = new Map((bundle.manifest.bindings ?? []).map((binding) => [
+    binding.fieldId,
+    binding
+  ]));
+  const fields = bundle.manifest.fields.filter((field) => field.source === "business");
+  const registered = options.registeredComponents ? new Set(options.registeredComponents) : void 0;
+  const occurrencesByComponent = groupBindingOccurrences(analysis.occurrences);
+  const allFieldOccurrenceTargets = [];
+  const groups = [];
+  let order = 0;
+  for (const { surfaceId, component } of orderedComponents(bundle)) {
+    const occurrenceId = createA2UICardAuthoringOccurrenceId(surfaceId, component.id);
+    const targets = [];
+    if (!registered || registered.has(component.component)) {
+      const projection = componentAuthoringProjection(component);
+      const componentOccurrences = occurrencesByComponent.get(componentKey(surfaceId, component.id)) ?? [];
+      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));
+    }
+    if (targets.length === 0) {
+      targets.push({
+        kind: "agent-only",
+        targetId: createA2UICardAuthoringTargetId(occurrenceId, "agent-only"),
+        occurrenceId,
+        label: "\u901A\u8FC7 Coding Agent \u4FEE\u6539",
+        reason: registered && !registered.has(component.component) ? "\u7EC4\u4EF6\u672A\u5728\u5F53\u524D Catalog \u6CE8\u518C" : "\u6CA1\u6709\u53EF\u5B89\u5168\u76F4\u63A5\u7F16\u8F91\u7684\u4E1A\u52A1\u5B57\u6BB5"
+      });
+    }
+    groups.push({
+      occurrenceId,
+      surfaceId,
+      componentId: component.id,
+      componentName: component.component,
+      order: order++,
+      label: componentAuthoringProjection(component).groupLabel ?? componentLabel(component),
+      targets: deduplicateTargets(targets),
+      agentOnly: targets.every((target) => target.kind === "agent-only")
+    });
+  }
+  const fieldStates = fields.map((field) => {
+    const occurrences = allFieldOccurrenceTargets.filter((target) => target.fieldId === field.fieldId);
+    const binding = bindingByField.get(field.fieldId);
+    return {
+      field,
+      ...binding ? { binding: cloneBinding(binding) } : {},
+      occurrences,
+      usageCount: new Set(occurrences.map((target) => `${target.occurrenceId}\0${target.propertyPath}`)).size,
+      status: occurrences.length === 0 ? "unused" : binding ? "bound" : field.required ? "unbound-required" : "unbound-optional"
+    };
+  });
+  const diagnostics = getA2UICardAuthoringDiagnostics(bundle, {
+    groups,
+    fields: fieldStates
+  });
+  return {
+    draftId: bundle.manifest.draftId,
+    resourceId: bundle.manifest.resourceId,
+    groups,
+    fields: fieldStates,
+    diagnostics
+  };
+}
+function componentAuthoringProjection(component) {
+  return COMPONENT_AUTHORING_PROJECTIONS[component.component] ?? DEFAULT_AUTHORING_PROJECTION;
+}
+function discoverComponentTargets(component, occurrenceId, projection, targets) {
+  if (projection.directTargets === "content") {
+    discoverTargets(component, occurrenceId, "", targets);
+    return;
+  }
+  if (typeof component.src !== "string")
+    return;
+  targets.push({
+    kind: "image",
+    targetId: createA2UICardAuthoringTargetId(occurrenceId, "src"),
+    occurrenceId,
+    propertyPath: "src",
+    label: "\u56FE\u7247\u5730\u5740",
+    value: component.src,
+    role: "src"
+  });
+}
+function getA2UICardAuthoringDiagnostics(bundle, partial) {
+  const diagnostics = getA2UICardDraftBundleIssues(bundle).map((entry) => ({
+    ...entry,
+    severity: "hard-error"
+  }));
+  const model = partial ?? extractA2UICardAuthoringModel(bundle);
+  for (const field of model.fields) {
+    if (field.status === "unbound-required") {
+      diagnostics.push({
+        code: "REQUIRED_BINDING_MISSING",
+        path: `manifest.fields.${field.field.fieldId}`,
+        message: `\u5FC5\u586B\u5B57\u6BB5\u201C${field.field.label}\u201D\u5C1A\u672A\u7ED1\u5B9A`,
+        severity: "hard-error",
+        fieldId: field.field.fieldId
+      });
+    }
+  }
+  for (const group of model.groups) {
+    const component = findComponent(bundle, group.surfaceId, group.componentId);
+    const action = isPlainRecord(component?.action) ? component.action : void 0;
+    const client = action && isPlainRecord(action.client) ? action.client : void 0;
+    if (client?.name === "ui.page.open") {
+      const context = isPlainRecord(client.context) ? client.context : void 0;
+      if (typeof context?.url === "string" && !isSafePageUrl(context.url)) {
+        diagnostics.push({
+          code: "UNSAFE_PAGE_URL",
+          path: `${group.occurrenceId}.action.client.context.url`,
+          message: "\u9875\u9762\u5730\u5740\u5FC5\u987B\u662F\u5B89\u5168\u7684 http(s) \u5730\u5740\u6216\u7AD9\u5185\u7EDD\u5BF9\u8DEF\u5F84",
+          severity: "hard-error",
+          occurrenceId: group.occurrenceId
+        });
+      }
+    } else if (client && typeof client.name === "string" && !["ui.overlay.close", "ui.surface.open"].includes(client.name)) {
+      diagnostics.push({
+        code: "UNREGISTERED_CLIENT_ACTION",
+        path: `${group.occurrenceId}.action.client.name`,
+        message: `\u672A\u6CE8\u518C\u7684 Client Action\uFF1A${client.name}`,
+        severity: "hard-error",
+        occurrenceId: group.occurrenceId
+      });
+    }
+  }
+  return deduplicateDiagnostics(diagnostics);
+}
+function validateA2UICardForPublish(bundle) {
+  return getA2UICardAuthoringDiagnostics(bundle).filter((diagnostic) => diagnostic.severity === "hard-error");
+}
+function createA2UICardAuthoringOccurrenceId(surfaceId, componentId) {
+  return `${encodeURIComponent(surfaceId)}:${encodeURIComponent(componentId)}`;
+}
+function createA2UICardAuthoringTargetId(occurrenceId, propertyPath) {
+  return `${occurrenceId}:${encodeURIComponent(propertyPath)}`;
+}
+function isSafePageUrl(url) {
+  const trimmed = url.trim();
+  if (trimmed.length === 0 || trimmed.length > 2e3)
+    return false;
+  const token = /\{\{([^{}]+)\}\}/gu;
+  let tokenCount = 0;
+  for (const match of trimmed.matchAll(token)) {
+    tokenCount++;
+    if (tokenCount > 32)
+      return false;
+    const path22 = match[1]?.trim() ?? "";
+    if (!(path22 === "/" || path22.startsWith("/") || path22.startsWith("./")) || path22.split("/").some((part) => ["..", "__proto__", "constructor", "prototype"].includes(part))) {
+      return false;
+    }
+  }
+  const candidate = trimmed.replace(token, "value");
+  if (candidate.includes("{{") || candidate.includes("}}"))
+    return false;
+  try {
+    return ["https:", "alipays:"].includes(new URL(candidate).protocol);
+  } catch {
+    return false;
+  }
+}
+function orderedComponents(bundle) {
+  const result = [];
+  for (const message of bundle.card) {
+    for (const instruction of message.datas) {
+      if (!("updateComponents" in instruction))
+        continue;
+      for (const component of instruction.updateComponents.components) {
+        result.push({
+          surfaceId: instruction.updateComponents.surfaceId,
+          component
+        });
+      }
+    }
+  }
+  return result;
+}
+function discoverTargets(value, occurrenceId, propertyPath, targets) {
+  if (Array.isArray(value)) {
+    value.forEach((entry, index) => discoverTargets(entry, occurrenceId, appendPath(propertyPath, String(index)), targets));
+    return;
+  }
+  if (!isPlainRecord(value))
+    return;
+  if (typeof value.path === "string")
+    return;
+  for (const [key, entry] of Object.entries(value)) {
+    const nextPath = appendPath(propertyPath, key);
+    if (INTERNAL_KEYS.has(key) || key === "action")
+      continue;
+    if (Array.isArray(entry) || isPlainRecord(entry)) {
+      discoverTargets(entry, occurrenceId, nextPath, targets);
+      continue;
+    }
+    if (!isJsonValue(entry))
+      continue;
+    if (typeof entry !== "string" || !MERCHANT_CONTENT_KEYS.has(key))
+      continue;
+    targets.push({
+      kind: "literal",
+      targetId: createA2UICardAuthoringTargetId(occurrenceId, nextPath),
+      occurrenceId,
+      propertyPath: nextPath,
+      label: propertyLabel(nextPath),
+      value: entry
+    });
+  }
+}
+function actionTargets(component, occurrenceId) {
+  if (!isPlainRecord(component.action))
+    return [];
+  const action = component.action;
+  const event = isPlainRecord(action.event) ? action.event : void 0;
+  if (event) {
+    const message = event["x2-user-message"];
+    if (typeof message === "string" && typeof event.name === "string") {
+      return [
+        {
+          kind: "agent-event",
+          targetId: createA2UICardAuthoringTargetId(occurrenceId, "action"),
+          occurrenceId,
+          propertyPath: "action",
+          label: "\u70B9\u51FB\u540E",
+          message,
+          eventName: event.name,
+          hasContext: isPlainRecord(event.context)
+        }
+      ];
+    }
+    return [agentOnlyAction(occurrenceId, "\u52A8\u6001\u6216\u590D\u6742\u4E8B\u4EF6\u901A\u8FC7\u667A\u80FD\u4F53\u4FEE\u6539")];
+  }
+  const client = isPlainRecord(action.client) ? action.client : void 0;
+  if (client?.name === "ui.page.open") {
+    const context = isPlainRecord(client.context) ? client.context : void 0;
+    const url = context?.url;
+    return [
+      {
+        kind: "page-open",
+        targetId: createA2UICardAuthoringTargetId(occurrenceId, "action"),
+        occurrenceId,
+        propertyPath: "action",
+        label: "\u6253\u5F00\u9875\u9762",
+        ...typeof url === "string" ? { url } : {},
+        dynamic: isPlainRecord(url) && typeof url.path === "string"
+      }
+    ];
+  }
+  return [agentOnlyAction(occurrenceId, "\u8BE5\u884C\u4E3A\u53EA\u80FD\u901A\u8FC7 Coding Agent \u4FEE\u6539")];
+}
+function fieldTargets(component, occurrenceId, fields, occurrences, projectedOnly) {
+  const projection = componentAuthoringProjection(component);
+  const ordered = [...fields].sort((left, right) => right.path.length - left.path.length);
+  return occurrences.flatMap((occurrence) => {
+    if (projectedOnly && !isProjectedFieldOccurrence(occurrence.propertyPath, projection)) {
+      return [];
+    }
+    const field = ordered.find((candidate) => occurrence.canonicalPath === candidate.path || occurrence.canonicalPath.startsWith(`${candidate.path}/*/`) || occurrence.canonicalPath.startsWith(`${candidate.path}/`));
+    if (!field)
+      return [];
+    const suffix = occurrence.canonicalPath.slice(field.path.length).replace(/^\/\*/u, "");
+    const targetPath = suffix ? suffix.startsWith("/") ? suffix : `/${suffix}` : void 0;
+    return [
+      {
+        kind: "field-occurrence",
+        targetId: createA2UICardAuthoringTargetId(occurrenceId, occurrence.propertyPath),
+        occurrenceId,
+        propertyPath: occurrence.propertyPath,
+        label: fieldOccurrenceLabel(targetPath, occurrence.propertyPath),
+        fieldId: field.fieldId,
+        ...targetPath ? { targetPath } : {}
+      }
+    ];
+  });
+}
+function isProjectedFieldOccurrence(propertyPath, projection) {
+  if (propertyPath === "action" || propertyPath.startsWith("action.")) {
+    return false;
+  }
+  return projection.fieldProperties === void 0 || projection.fieldProperties.includes(propertyPath);
+}
+function fieldOccurrenceLabel(targetPath, propertyPath) {
+  if (!targetPath)
+    return propertyLabel(propertyPath);
+  const segment = targetPath.split("/").filter(Boolean).at(-1);
+  return segment ? decodeJsonPointerSegment(segment) : propertyLabel(propertyPath);
+}
+function decodeJsonPointerSegment(segment) {
+  return segment.replace(/~1/gu, "/").replace(/~0/gu, "~");
+}
+function groupBindingOccurrences(occurrences) {
+  const result = /* @__PURE__ */ new Map();
+  for (const occurrence of occurrences) {
+    if (!occurrence.surfaceId)
+      continue;
+    const key = componentKey(occurrence.surfaceId, occurrence.componentId);
+    const entries = result.get(key) ?? [];
+    entries.push(occurrence);
+    result.set(key, entries);
+  }
+  return result;
+}
+function findComponent(bundle, surfaceId, componentId) {
+  return orderedComponents(bundle).find((entry) => entry.surfaceId === surfaceId && entry.component.id === componentId)?.component;
+}
+function agentOnlyAction(occurrenceId, reason) {
+  return {
+    kind: "agent-only",
+    targetId: createA2UICardAuthoringTargetId(occurrenceId, "action"),
+    occurrenceId,
+    propertyPath: "action",
+    label: "\u901A\u8FC7 Coding Agent \u4FEE\u6539\u884C\u4E3A",
+    reason
+  };
+}
+function componentLabel(component) {
+  const candidate = component.label ?? component.title ?? component.text;
+  return typeof candidate === "string" && candidate.trim() ? candidate : component.component;
+}
+function propertyLabel(propertyPath) {
+  const key = propertyPath.split(".").at(-1) ?? propertyPath;
+  const labels = {
+    text: "\u6587\u6848",
+    title: "\u6807\u9898",
+    subtitle: "\u526F\u6807\u9898",
+    label: "\u6807\u7B7E",
+    description: "\u8BF4\u660E",
+    value: "\u5185\u5BB9",
+    alt: "\u56FE\u7247\u8BF4\u660E"
+  };
+  return labels[key] ?? key;
+}
+function appendPath(base, segment) {
+  return base ? `${base}.${segment}` : segment;
+}
+function componentKey(surfaceId, componentId) {
+  return `${surfaceId}\0${componentId}`;
+}
+function deduplicateTargets(targets) {
+  return [
+    ...new Map(targets.map((target) => [target.targetId, target])).values()
+  ];
+}
+function deduplicateDiagnostics(diagnostics) {
+  return [
+    ...new Map(diagnostics.map((entry) => [
+      `${entry.code}\0${entry.path}\0${entry.fieldId ?? ""}`,
+      entry
+    ])).values()
+  ];
+}
+function cloneBinding(binding) {
+  return JSON.parse(JSON.stringify(binding));
+}
+
 // src/commands/card/index.ts
 var DRAFT_ROOT = ".card-drafts";
 var AGENT_CONFIG_PATH = "agent_config.json";
@@ -27614,36 +28020,20 @@ async function validateCardBindingsFromDisk(cwd, draftId, fieldId) {
   const directory = draftDirectory(cwd, draftId);
   const [bundle, contextValue, configValue] = await Promise.all([
     readBundle(directory, draftId),
-    readRequiredJson(import_path22.default.join(directory, "binding-context.json")),
+    readOptionalJson(import_path22.default.join(directory, "binding-context.json")),
     readRequiredJson(import_path22.default.join(cwd, AGENT_CONFIG_PATH))
   ]);
-  const contextResult = parseA2UICardBindingContext(contextValue);
-  if (!contextResult.success) {
-    throw new LinkqueCliError(
-      "CARD_BINDING_CONTEXT_INVALID",
-      contextResult.issues.map((entry) => entry.message).join("; ")
-    );
-  }
-  const context = contextResult.data;
+  const context = parseOptionalBindingContext(contextValue);
   const draftStructureChecksum = createA2UICardDraftStructureChecksum(bundle);
   const config2 = parseAgentConfig(configValue);
   const mcpResources = normalizedMcpResources(config2);
-  if (context.mcpConfigChecksum !== createA2UICardMcpConfigChecksum(mcpResources)) {
-    throw new LinkqueCliError(
-      "CARD_BINDING_CONTEXT_STALE",
-      "MCP \u914D\u7F6E\u5DF2\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u53D1\u8D77 AI \u8F85\u52A9\u7ED1\u5B9A"
-    );
-  }
-  const issues = validateA2UICardBindings(
-    {
-      draft: bundle,
-      context,
-      mountedMcpResourceIds: new Set(
-        mcpResources.map((resource) => String(resource.resourceId))
-      )
-    },
-    fieldId ? { fieldIds: /* @__PURE__ */ new Set([fieldId]) } : void 0
+  const mountedMcpResourceIds = new Set(
+    mcpResources.map((resource) => String(resource.resourceId))
   );
+  const issues = context ? validateA2UICardBindings(
+    { draft: bundle, context, mountedMcpResourceIds },
+    fieldId ? { fieldIds: /* @__PURE__ */ new Set([fieldId]) } : void 0
+  ) : validateBindingsWithoutContext(bundle, mountedMcpResourceIds, fieldId);
   if (issues.length > 0) {
     throw new LinkqueCliError(
       "CARD_BINDING_VALIDATION_FAILED",
@@ -27674,15 +28064,9 @@ async function finalizeCardWhileLocked(cwd, draftId, expectedDraftChecksum) {
   }
   const directory = draftDirectory(cwd, draftId);
   const bundle = await readBundle(directory, draftId);
-  const contextResult = parseA2UICardBindingContext(
-    await readRequiredJson(import_path22.default.join(directory, "binding-context.json"))
+  const context = parseOptionalBindingContext(
+    await readOptionalJson(import_path22.default.join(directory, "binding-context.json"))
   );
-  if (!contextResult.success) {
-    throw new LinkqueCliError(
-      "CARD_BINDING_CONTEXT_INVALID",
-      contextResult.issues.map((entry) => entry.message).join("; ")
-    );
-  }
   const configPath = import_path22.default.join(cwd, AGENT_CONFIG_PATH);
   const oldConfigBytes = await (0, import_promises16.readFile)(configPath);
   const config2 = parseAgentConfig(
@@ -27716,7 +28100,7 @@ async function finalizeCardWhileLocked(cwd, draftId, expectedDraftChecksum) {
     // V3，让 Agent 直接按真实 MCP inputSchema 决定参数；不再把 presentation input
     // 或 inputBindings 固化进 CARD。
     ...bindings.length > 0 ? { targetSchemaVersion: "3" } : {},
-    tools: contextResult.data.candidates.flatMap(
+    tools: (context?.candidates ?? []).flatMap(
       (candidate) => candidate.status === "ready" ? [candidate.tool] : []
     )
   });
@@ -28043,6 +28427,47 @@ function normalizedMcpResources(config2) {
     (left, right) => stableJsonStringify(left).localeCompare(stableJsonStringify(right))
   );
 }
+function parseOptionalBindingContext(value) {
+  if (value === void 0) return void 0;
+  const result = parseA2UICardBindingContext(value);
+  if (!result.success) {
+    throw new LinkqueCliError(
+      "CARD_BINDING_CONTEXT_INVALID",
+      result.issues.map((entry) => entry.message).join("; ")
+    );
+  }
+  return result.data;
+}
+function validateBindingsWithoutContext(bundle, mountedMcpResourceIds, fieldId) {
+  const selectedFields = fieldId ? /* @__PURE__ */ new Set([fieldId]) : void 0;
+  const bindings = (bundle.manifest.bindings ?? []).filter(
+    (binding) => !selectedFields || selectedFields.has(binding.fieldId)
+  );
+  const issues = getA2UICardBindingSelectionIssues(
+    bindings,
+    "draft.manifest.bindings",
+    bundle.manifest.fields
+  );
+  for (const binding of bindings) {
+    if (!mountedMcpResourceIds.has(binding.mcpResourceId)) {
+      issues.push({
+        code: "MCP_TOOL_UNAVAILABLE",
+        message: `MCP resource ${binding.mcpResourceId} is not mounted`,
+        path: `draft.manifest.bindings.${binding.fieldId}`
+      });
+    }
+  }
+  if (!selectedFields) {
+    issues.push(
+      ...validateA2UICardForPublish(bundle).map((diagnostic) => ({
+        code: diagnostic.code,
+        message: diagnostic.message,
+        path: diagnostic.path
+      }))
+    );
+  }
+  return issues;
+}
 function isJsonObject(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/package.json

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

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

@@ -17007,6 +17007,7 @@ function analyzeA2UIBindings(protocol) {
     const listRoots = inferListRoots(components, issues);
     for (const component of components) {
       const context = {
+        surfaceId,
         component,
         listRoot: listRoots.get(component.id),
         occurrences,
@@ -17020,6 +17021,7 @@ function analyzeA2UIBindings(protocol) {
           issues.push(issue2(`card.surfaces.${surfaceId}.components.${component.id}.children.path`, "INVALID_BINDING_PATH", `Invalid list path ${children.path}`));
         } else {
           occurrences.push({
+            surfaceId,
             componentId: component.id,
             componentName: component.component,
             propertyPath: "children.path",
@@ -17038,6 +17040,16 @@ function analyzeA2UIBindings(protocol) {
     issues
   };
 }
+function collectReferencedA2UICardBusinessFieldIds(protocol, fields) {
+  const businessFields = fields.filter((field) => field.source === "business").slice().sort((left, right) => right.path.length - left.path.length);
+  const result = /* @__PURE__ */ new Set();
+  for (const occurrence of analyzeA2UIBindings(protocol).occurrences) {
+    const field = businessFields.find((candidate) => occurrence.canonicalPath === candidate.path || occurrence.canonicalPath.startsWith(`${candidate.path}/*/`) || occurrence.canonicalPath.startsWith(`${candidate.path}/`));
+    if (field)
+      result.add(field.fieldId);
+  }
+  return result;
+}
 function visitValue(value, propertyPath, context) {
   if (propertyPath === "action.local.path" && typeof value === "string") {
     addOccurrence(value, propertyPath, "local", context);
@@ -17069,6 +17081,7 @@ function addOccurrence(rawPath, propertyPath, usage, context) {
     return;
   }
   context.occurrences.push({
+    surfaceId: context.surfaceId,
     componentId: context.component.id,
     componentName: context.component.component,
     propertyPath,
@@ -17480,9 +17493,9 @@ function getA2UICardResourceConfigIssues(value) {
   validateLooseJsonSchema(value.presentationInputSchema, "config.presentationInputSchema", issues);
   const fields = validateFields(value.fields, "config.fields", issues);
   const resolver = validateResolver(value.resolver, "config.resolver", issues);
-  validateTemplate(value.a2uiTemplate, fields, issues);
+  const card = validateTemplate(value.a2uiTemplate, fields, issues);
   if (fields && resolver)
-    validateResolverCoverage(fields, resolver, issues);
+    validateResolverCoverage(fields, resolver, issues, card);
   return issues;
 }
 function getA2UICardResourceConfigV3Issues(value) {
@@ -17515,9 +17528,9 @@ function getA2UICardResourceConfigV3Issues(value) {
   }
   const dataSources = validateDataSources(value.dataSources, "config.dataSources", issues);
   const bindings = validateV3OutputBindings(value.bindings, "config.bindings", issues);
-  validateTemplate(value.a2uiTemplate, fields, issues);
+  const card = validateTemplate(value.a2uiTemplate, fields, issues);
   if (fields && dataSources && bindings) {
-    validateV3Coverage(fields, dataSources, bindings, issues);
+    validateV3Coverage(fields, dataSources, bindings, issues, { card });
   }
   return issues;
 }
@@ -17631,7 +17644,8 @@ function validateV3Coverage(fields, dataSources, bindings, issues, options = {})
     bound.add(binding.fieldId);
   });
   if (options.requireComplete !== false) {
-    for (const fieldId of businessFields) {
+    const requiredFields = options.card ? collectReferencedA2UICardBusinessFieldIds(options.card, fields.filter((field) => field.required)) : new Set(fields.filter((field) => field.source === "business" && field.required).map((field) => field.fieldId));
+    for (const fieldId of requiredFields) {
       if (bound.has(fieldId))
         continue;
       issues.push(issue2("config.bindings", "CARD_BINDING_INCOMPLETE", `business field ${fieldId} is not bound`));
@@ -17931,13 +17945,13 @@ function validateInstructionShape(instruction, path2, issues) {
 function validateTemplate(value, fields, issues) {
   if (!isPlainRecord(value)) {
     issues.push(issue2("config.a2uiTemplate", "INVALID_A2UI_TEMPLATE", "a2uiTemplate must be an object"));
-    return;
+    return void 0;
   }
   exactKeys(value, ["argsSchema", "content"], "config.a2uiTemplate", issues);
   validateLooseJsonSchema(value.argsSchema, "config.a2uiTemplate.argsSchema", issues);
   if (typeof value.content !== "string") {
     issues.push(issue2("config.a2uiTemplate.content", "INVALID_A2UI_CONTENT", "a2uiTemplate.content must be serialized A2UI JSON"));
-    return;
+    return void 0;
   }
   try {
     const card = validateProtocol(JSON.parse(value.content), "config.a2uiTemplate.content", issues);
@@ -17945,9 +17959,11 @@ function validateTemplate(value, fields, issues) {
       const analysis = analyzeA2UIBindings(card);
       issues.push(...analysis.issues);
     }
+    return card;
   } catch {
     issues.push(issue2("config.a2uiTemplate.content", "INVALID_A2UI_CONTENT", "a2uiTemplate.content must contain valid JSON"));
   }
+  return void 0;
 }
 function validateLooseJsonSchema(value, path2, issues) {
   const schemaIssues = getJsonSchemaIssues2(value, path2, {
@@ -17956,7 +17972,7 @@ function validateLooseJsonSchema(value, path2, issues) {
   issues.push(...schemaIssues);
   return schemaIssues.length === 0;
 }
-function validateResolverCoverage(fields, resolver, issues) {
+function validateResolverCoverage(fields, resolver, issues, card) {
   const businessFields = new Set(fields.filter((field) => field.source === "business").map((field) => field.fieldId));
   const bound = /* @__PURE__ */ new Set();
   resolver.outputBindings.forEach((binding, index2) => {
@@ -17965,7 +17981,8 @@ function validateResolverCoverage(fields, resolver, issues) {
     }
     bound.add(binding.fieldId);
   });
-  for (const fieldId of businessFields) {
+  const requiredFields = card ? collectReferencedA2UICardBusinessFieldIds(card, fields.filter((field) => field.required)) : new Set(fields.filter((field) => field.source === "business" && field.required).map((field) => field.fieldId));
+  for (const fieldId of requiredFields) {
     if (!bound.has(fieldId)) {
       issues.push(issue2("config.resolver.outputBindings", "CARD_BINDING_INCOMPLETE", `business field ${fieldId} is not bound`));
     }

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

@@ -51,7 +51,7 @@ import {
   parseConversationRunRequest,
   parseSkillFile,
   streamToConversationEvents
-} from "../../chunk-YAKPGLYU.js";
+} from "../../chunk-IMZDZMKV.js";
 import "../../chunk-XUFLSZM4.js";
 import "../../chunk-I64V3ICJ.js";
 import "../../chunk-6MHDOBWO.js";

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

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

package/worker.js

@@ -13822,6 +13822,7 @@ function analyzeA2UIBindings(protocol) {
     const listRoots = inferListRoots(components, issues);
     for (const component of components) {
       const context2 = {
+        surfaceId,
         component,
         listRoot: listRoots.get(component.id),
         occurrences,
@@ -13835,6 +13836,7 @@ function analyzeA2UIBindings(protocol) {
           issues.push(issue2(`card.surfaces.${surfaceId}.components.${component.id}.children.path`, "INVALID_BINDING_PATH", `Invalid list path ${children.path}`));
         } else {
           occurrences.push({
+            surfaceId,
             componentId: component.id,
             componentName: component.component,
             propertyPath: "children.path",
@@ -13853,6 +13855,16 @@ function analyzeA2UIBindings(protocol) {
     issues
   };
 }
+function collectReferencedA2UICardBusinessFieldIds(protocol, fields) {
+  const businessFields = fields.filter((field) => field.source === "business").slice().sort((left, right) => right.path.length - left.path.length);
+  const result = /* @__PURE__ */ new Set();
+  for (const occurrence of analyzeA2UIBindings(protocol).occurrences) {
+    const field = businessFields.find((candidate) => occurrence.canonicalPath === candidate.path || occurrence.canonicalPath.startsWith(`${candidate.path}/*/`) || occurrence.canonicalPath.startsWith(`${candidate.path}/`));
+    if (field)
+      result.add(field.fieldId);
+  }
+  return result;
+}
 function visitValue(value, propertyPath, context2) {
   if (propertyPath === "action.local.path" && typeof value === "string") {
     addOccurrence(value, propertyPath, "local", context2);
@@ -13884,6 +13896,7 @@ function addOccurrence(rawPath, propertyPath, usage, context2) {
     return;
   }
   context2.occurrences.push({
+    surfaceId: context2.surfaceId,
     componentId: context2.component.id,
     componentName: context2.component.component,
     propertyPath,
@@ -14258,6 +14271,7 @@ var init_binding_context = __esm({
     init_json2();
     init_schema2();
     init_expression();
+    init_binding_analyzer();
   }
 });
 
@@ -14309,9 +14323,9 @@ function getA2UICardResourceConfigIssues(value) {
   validateLooseJsonSchema(value.presentationInputSchema, "config.presentationInputSchema", issues);
   const fields = validateFields(value.fields, "config.fields", issues);
   const resolver = validateResolver(value.resolver, "config.resolver", issues);
-  validateTemplate(value.a2uiTemplate, fields, issues);
+  const card = validateTemplate(value.a2uiTemplate, fields, issues);
   if (fields && resolver)
-    validateResolverCoverage(fields, resolver, issues);
+    validateResolverCoverage(fields, resolver, issues, card);
   return issues;
 }
 function getA2UICardResourceConfigV3Issues(value) {
@@ -14344,9 +14358,9 @@ function getA2UICardResourceConfigV3Issues(value) {
   }
   const dataSources = validateDataSources(value.dataSources, "config.dataSources", issues);
   const bindings = validateV3OutputBindings(value.bindings, "config.bindings", issues);
-  validateTemplate(value.a2uiTemplate, fields, issues);
+  const card = validateTemplate(value.a2uiTemplate, fields, issues);
   if (fields && dataSources && bindings) {
-    validateV3Coverage(fields, dataSources, bindings, issues);
+    validateV3Coverage(fields, dataSources, bindings, issues, { card });
   }
   return issues;
 }
@@ -14460,7 +14474,8 @@ function validateV3Coverage(fields, dataSources, bindings, issues, options = {})
     bound.add(binding.fieldId);
   });
   if (options.requireComplete !== false) {
-    for (const fieldId of businessFields) {
+    const requiredFields = options.card ? collectReferencedA2UICardBusinessFieldIds(options.card, fields.filter((field) => field.required)) : new Set(fields.filter((field) => field.source === "business" && field.required).map((field) => field.fieldId));
+    for (const fieldId of requiredFields) {
       if (bound.has(fieldId))
         continue;
       issues.push(issue2("config.bindings", "CARD_BINDING_INCOMPLETE", `business field ${fieldId} is not bound`));
@@ -14760,13 +14775,13 @@ function validateInstructionShape(instruction, path6, issues) {
 function validateTemplate(value, fields, issues) {
   if (!isPlainRecord(value)) {
     issues.push(issue2("config.a2uiTemplate", "INVALID_A2UI_TEMPLATE", "a2uiTemplate must be an object"));
-    return;
+    return void 0;
   }
   exactKeys(value, ["argsSchema", "content"], "config.a2uiTemplate", issues);
   validateLooseJsonSchema(value.argsSchema, "config.a2uiTemplate.argsSchema", issues);
   if (typeof value.content !== "string") {
     issues.push(issue2("config.a2uiTemplate.content", "INVALID_A2UI_CONTENT", "a2uiTemplate.content must be serialized A2UI JSON"));
-    return;
+    return void 0;
   }
   try {
     const card = validateProtocol(JSON.parse(value.content), "config.a2uiTemplate.content", issues);
@@ -14774,9 +14789,11 @@ function validateTemplate(value, fields, issues) {
       const analysis = analyzeA2UIBindings(card);
       issues.push(...analysis.issues);
     }
+    return card;
   } catch {
     issues.push(issue2("config.a2uiTemplate.content", "INVALID_A2UI_CONTENT", "a2uiTemplate.content must contain valid JSON"));
   }
+  return void 0;
 }
 function validateLooseJsonSchema(value, path6, issues) {
   const schemaIssues = getJsonSchemaIssues2(value, path6, {
@@ -14785,7 +14802,7 @@ function validateLooseJsonSchema(value, path6, issues) {
   issues.push(...schemaIssues);
   return schemaIssues.length === 0;
 }
-function validateResolverCoverage(fields, resolver, issues) {
+function validateResolverCoverage(fields, resolver, issues, card) {
   const businessFields = new Set(fields.filter((field) => field.source === "business").map((field) => field.fieldId));
   const bound = /* @__PURE__ */ new Set();
   resolver.outputBindings.forEach((binding, index2) => {
@@ -14794,7 +14811,8 @@ function validateResolverCoverage(fields, resolver, issues) {
     }
     bound.add(binding.fieldId);
   });
-  for (const fieldId of businessFields) {
+  const requiredFields = card ? collectReferencedA2UICardBusinessFieldIds(card, fields.filter((field) => field.required)) : new Set(fields.filter((field) => field.source === "business" && field.required).map((field) => field.fieldId));
+  for (const fieldId of requiredFields) {
     if (!bound.has(fieldId)) {
       issues.push(issue2("config.resolver.outputBindings", "CARD_BINDING_INCOMPLETE", `business field ${fieldId} is not bound`));
     }
@@ -14847,6 +14865,7 @@ var init_compiler = __esm({
   "../agent-a2ui-card-contract/dist/esm/compiler.js"() {
     "use strict";
     init_json2();
+    init_binding_analyzer();
     init_validation();
     init_schema2();
   }
@@ -15070,6 +15089,25 @@ var init_template = __esm({
   }
 });
 
+// ../agent-a2ui-card-contract/dist/esm/authoring-model.js
+var init_authoring_model = __esm({
+  "../agent-a2ui-card-contract/dist/esm/authoring-model.js"() {
+    "use strict";
+    init_binding_analyzer();
+    init_json2();
+    init_validation();
+  }
+});
+
+// ../agent-a2ui-card-contract/dist/esm/authoring-operation.js
+var init_authoring_operation = __esm({
+  "../agent-a2ui-card-contract/dist/esm/authoring-operation.js"() {
+    "use strict";
+    init_authoring_model();
+    init_json2();
+  }
+});
+
 // ../agent-a2ui-card-contract/dist/esm/index.js
 var init_esm4 = __esm({
   "../agent-a2ui-card-contract/dist/esm/index.js"() {
@@ -15087,6 +15125,8 @@ var init_esm4 = __esm({
     init_binding_context();
     init_preview_binding();
     init_template();
+    init_authoring_model();
+    init_authoring_operation();
   }
 });