linkque-cli-v2 1.0.7 → 1.1.1

package/linkquejs.js

@@ -25322,6 +25322,7 @@ function analyzeA2UIBindings(protocol) {
     }
   }
   return {
+    surfaceIds: [...surfaces],
     surfaceId: surfaces.size === 1 ? [...surfaces][0] : void 0,
     occurrences,
     issues
@@ -25449,6 +25450,20 @@ function getJsonSchemaIssues(value, path22 = "schema", options = {}) {
   validateSchemaNode(value, path22, issues, options);
   return issues;
 }
+var OPAQUE_OBJECT_SCHEMA = {
+  type: "object",
+  additionalProperties: true
+};
+function normalizeMcpOutputSchema(value) {
+  if (!isPlainRecord(value) || getJsonSchemaIssues(value).length > 0) {
+    return { schema: { ...OPAQUE_OBJECT_SCHEMA }, mode: "opaque" };
+  }
+  const schema = cloneJsonValue(value);
+  if (schema.type === "object" && (!isPlainRecord(schema.properties) || Object.keys(schema.properties).length === 0) && !isPlainRecord(schema.additionalProperties)) {
+    return { schema: { ...OPAQUE_OBJECT_SCHEMA }, mode: "opaque" };
+  }
+  return { schema, mode: "declared" };
+}
 function normalizeTargetJsonSchema(schema) {
   const cloned = JSON.parse(JSON.stringify(schema));
   normalizeObjectDefaults(cloned);
@@ -25901,7 +25916,7 @@ function parseA2UICardBindingContext(value) {
   const issues = getA2UICardBindingContextIssues(value);
   return issues.length > 0 ? { success: false, issues } : {
     success: true,
-    data: JSON.parse(JSON.stringify(value)),
+    data: normalizeBindingContext(value),
     issues: []
   };
 }
@@ -26048,11 +26063,7 @@ function validateA2UICardBindings(input, options = {}) {
       issues.push(issue2(`fields.${field.fieldId}`, "MCP_TOOL_UNAVAILABLE", `MCP tool ${binding.toolName} is absent from binding context`));
       continue;
     }
-    const transform = validateA2UICardTransform(binding.transform, {
-      fieldId: field.fieldId,
-      sourceSchema: tool.outputSchema,
-      targetSchema: field.valueSchema
-    });
+    const transform = validateA2UICardTransform(binding.transform);
     issues.push(...transform.issues.map((entry) => ({
       ...entry,
       path: `fields.${field.fieldId}.${entry.path}`
@@ -26123,6 +26134,7 @@ function validateTool(value, path22, resourceId, issues) {
     "description",
     "inputSchema",
     "outputSchema",
+    "outputSchemaMode",
     "annotations"
   ], path22, issues);
   if (value.resourceId !== resourceId) {
@@ -26132,11 +26144,28 @@ function validateTool(value, path22, resourceId, issues) {
     issues.push(issue2(`${path22}.toolName`, "CARD_BINDING_CONTEXT_INVALID", "toolName is required"));
   }
   issues.push(...getJsonSchemaIssues(value.inputSchema, `${path22}.inputSchema`));
-  issues.push(...getJsonSchemaIssues(value.outputSchema, `${path22}.outputSchema`));
-  if (isPlainRecord(value.annotations) && value.annotations.readOnlyHint === false) {
-    issues.push(issue2(`${path22}.annotations`, "CARD_BINDING_CONTEXT_INVALID", "tool explicitly declares readOnlyHint=false"));
+  if (value.outputSchemaMode !== void 0 && value.outputSchemaMode !== "declared" && value.outputSchemaMode !== "opaque") {
+    issues.push(issue2(`${path22}.outputSchemaMode`, "CARD_BINDING_CONTEXT_INVALID", "outputSchemaMode must be declared or opaque"));
   }
 }
+function normalizeBindingContext(context) {
+  const cloned = JSON.parse(JSON.stringify(context));
+  cloned.candidates = cloned.candidates.map((candidate) => {
+    if (candidate.status !== "ready")
+      return candidate;
+    const normalized = normalizeMcpOutputSchema(candidate.tool.outputSchema);
+    const mode2 = normalized.mode === "opaque" || candidate.tool.outputSchemaMode === "opaque" ? "opaque" : "declared";
+    return {
+      ...candidate,
+      tool: {
+        ...candidate.tool,
+        outputSchema: normalized.schema,
+        outputSchemaMode: mode2
+      }
+    };
+  });
+  return cloned;
+}
 function validatePreferences(value, path22, issues) {
   if (value === void 0)
     return;
@@ -27150,7 +27179,7 @@ function compileV3Resource(draft, revision, bindings, tools) {
       purpose: binding.purpose,
       required: binding.required,
       ...binding.dependsOn?.length ? { dependsOn: [...binding.dependsOn] } : {},
-      outputSchema: tool?.outputSchema ?? {}
+      outputSchema: normalizeMcpOutputSchema(tool?.outputSchema).schema
     };
     const previous = sourceById.get(source.sourceId);
     if (previous && stableJsonStringify(previous) !== stableJsonStringify(source)) {
@@ -27371,9 +27400,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)}`);
@@ -27502,16 +27528,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),
@@ -27521,17 +27545,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",
@@ -27584,7 +27603,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),
@@ -27599,13 +27618,6 @@ async function validateCardBindingsFromDisk(cwd, draftId, expectedContextChecksu
     );
   }
   const context = contextResult.data;
-  const actualContextChecksum = createA2UICardBindingContextChecksum(context);
-  if (actualContextChecksum !== 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);
@@ -27638,7 +27650,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,
@@ -27646,12 +27657,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",
@@ -29076,7 +29083,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"
     },
     {
@@ -29088,9 +29095,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(
@@ -29122,7 +29129,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"
     }
   ],
@@ -29137,9 +29144,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.0.7",
+  "version": "1.1.1",
   "description": "Public Linkque CLI bundle for sandbox debugging",
   "bin": {
     "linkquejs": "linkquejs.js"