@fabricorg/platform-host 7.1.0 → 7.1.1

package/dist/index.d.cts

@@ -348,6 +348,14 @@ interface ExternalCompletion {
 }
 interface RecordedExternalCompletion extends ExternalCompletion {
     recordedAt: Date;
+    /**
+     * Canonical digest of provider, reference, outcome, result, error, and
+     * evidence. A repeat with the same digest is the same news; a repeat with
+     * the same outcome and a different digest is changed evidence, and is a
+     * contradiction like a flipped outcome. Observation time is left out,
+     * since a redelivery legitimately carries a new one.
+     */
+    digest: string;
 }
 interface ReconcileOverdueCompletionsInput {
     tenantId?: string;

package/dist/index.d.ts

@@ -348,6 +348,14 @@ interface ExternalCompletion {
 }
 interface RecordedExternalCompletion extends ExternalCompletion {
     recordedAt: Date;
+    /**
+     * Canonical digest of provider, reference, outcome, result, error, and
+     * evidence. A repeat with the same digest is the same news; a repeat with
+     * the same outcome and a different digest is changed evidence, and is a
+     * contradiction like a flipped outcome. Observation time is left out,
+     * since a redelivery legitimately carries a new one.
+     */
+    digest: string;
 }
 interface ReconcileOverdueCompletionsInput {
     tenantId?: string;

package/dist/index.js

@@ -1350,11 +1350,12 @@ function createGovernedActionHost(options) {
       if (completion.provider !== void 0 && recorded.provider !== void 0 && completion.provider !== recorded.provider) {
         throw new ExternalCompletionError("provider_mismatch", `ActionInvocation ${actionInvocationId} was completed by "${recorded.provider}", not "${completion.provider}".`);
       }
-      if (recorded.outcome === completion.outcome) {
+      const incomingDigest = completionDigest(completion, recorded.provider ?? completion.provider);
+      if (recorded.digest === incomingDigest) {
         return withConsistency(actionResult(invocation), invocation.actionId);
       }
-      const message = `External operation "${completion.externalReference}" reported ${completion.outcome} after reporting ${recorded.outcome}.`;
-      await recordCompletionReconciliation(invocation, { ...completion, kind: `contradicted:${completion.outcome}` }, message);
+      const message = recorded.outcome === completion.outcome ? `External operation "${completion.externalReference}" reported ${completion.outcome} again with different evidence.` : `External operation "${completion.externalReference}" reported ${completion.outcome} after reporting ${recorded.outcome}.`;
+      await recordCompletionReconciliation(invocation, { ...completion, kind: `contradicted:${incomingDigest.slice(0, 16)}` }, message);
       await appendEvent(invocation, {
         eventType: "ExternalOperationContradicted",
         subjectType: "AdapterInvocation",
@@ -1384,7 +1385,8 @@ function createGovernedActionHost(options) {
       ...completion,
       provider: completion.provider ?? pending.provider,
       observedAt: completion.observedAt instanceof Date ? completion.observedAt.toISOString() : completion.observedAt,
-      recordedAt
+      recordedAt,
+      digest: completionDigest(completion, completion.provider ?? pending.provider)
     };
     const subject = { subjectType: "AdapterInvocation", subjectId: pending.adapterInvocationId };
     const settles = invocation.status === "running" && pending.parkedAt !== void 0 || invocation.status === "reconciliation_required" && invocation.error?.includes("did not complete by") === true;
@@ -1423,6 +1425,16 @@ function createGovernedActionHost(options) {
     if (settles) emitInvocationStatusTelemetry(invocation, "failed", options.telemetry, now(), invocation.status);
     return withConsistency(actionResult({ ...invocation, ...patch }), invocation.actionId);
   }
+  function completionDigest(completion, provider) {
+    return createHash("sha256").update(canonicalJson({
+      provider: provider ?? null,
+      externalReference: completion.externalReference,
+      outcome: completion.outcome,
+      result: completion.result ?? null,
+      error: completion.error ?? null,
+      evidenceReferences: completion.evidenceReferences ?? null
+    })).digest("hex");
+  }
   async function recordCompletionReconciliation(invocation, completion, reason) {
     const governanceStore = asGovernanceStore(options.store);
     if (!governanceStore) throw new Error("External completion reconciliation requires a governance-capable store.");