Function legacyGetPlanAuditLogsResponse

Parameters

• data: {
      context?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
      governance_context?: string;
      plans: {
          plan_id: string;
          plan_version: number;
          status: "active"
          | "suspended"
          | "completed";
          budget: {
              authorized?: number;
              accounting_mode?: "gross_commitment" | "verified_net_cost";
              committed?: number;
              gross_committed?: number;
              adjustments_reported?: number;
              adjustments_verified?: number;
              net_cost?: number;
              headroom_restored?: number;
              net_committed?: number;
              ledger_committed?: number;
              remaining?: number;
              utilization_pct?: number;
          };
          channel_allocation?: Omit<
              Omit<
                  {
                      [key: string]: | { committed?: (...)
                      | (...); pct?: (...) | (...) }
                      | undefined;
                  },
                  "bank",
              >,
              "authentication",
          > & { authentication?: unknown };
          summary: {
              checks_performed?: number;
              outcomes_reported?: number;
              adjustments_reported?: number;
              adjustments_verified?: number;
              statuses?: {
                  approved?: number;
                  denied?: number;
                  conditions?: number;
                  human_reviewed?: number;
              };
              findings_count?: number;
              escalations?: {
                  check_id: string;
                  reason: string;
                  resolution?: string;
                  resolved_at?: string;
              }[];
              drift_metrics?: {
                  escalation_rate?: number;
                  escalation_rate_trend?: "increasing"
                  | "stable"
                  | "declining";
                  auto_approval_rate?: number;
                  human_override_rate?: number;
                  mean_confidence?: number;
                  thresholds?: {
                      escalation_rate_max?: number;
                      escalation_rate_min?: number;
                      auto_approval_rate_max?: number;
                      human_override_rate_max?: number;
                  };
              };
          };
          entries?: {
              id: string;
              type: "check"
              | "outcome"
              | "adjustment";
              timestamp: string;
              plan_id?: string;
              caller?: string;
              tool?: string;
              verdict?: GovernanceDecision;
              check_type?: "intent" | "execution";
              mode?: GovernanceMode;
              explanation?: string;
              policies_evaluated?: string[];
              categories_evaluated?: string[];
              findings?: {
                  category_id: string;
                  policy_id?: string;
                  source_plan_id?: string;
                  severity: EscalationSeverity;
                  explanation: string;
                  details?: (...) & (...);
                  confidence?: number;
                  uncertainty_reason?: string;
                  attestation_reference_digest?: string;
              }[];
              delivery_statement?: {
                  statement_id: string;
                  statement_digest: string;
                  sequence: number;
                  issued_at: string;
                  seller_reference: string;
                  cumulative_spend: number;
                  currency: string;
                  reporting_period: { start: string; end: string };
                  canonical_payload: {
                      seller_reference: string;
                      delivery_metrics: Omit<(...), (...)> & { authentication?: ... };
                  };
              };
              outcome?: OutcomeType;
              outcome_id?: string;
              seller_adjustment_id?: string;
              adjustment_type?: "refund"
              | "credit"
              | "decommitment"
              | "makegood";
              amount?: { amount: number; currency: string };
              headroom_restored?: number;
              reason?: string;
              effective_at?: string;
              committed_budget?: number;
              reported_committed_budget?: number;
              seller_reference?: string;
              delivery?: {
                  observation_id?: string;
                  source?: "seller_statement_copy" | "buyer_measurement";
                  observed_at?: string;
                  seller_statement_id?: string;
                  seller_statement_digest?: string;
                  reporting_period?: { start: string; end: string };
                  cumulative_spend?: number;
                  currency?: string;
                  period_closed?: boolean;
                  impressions?: number;
              };
              governance_context?: string;
              plan_hash?: string;
              runtime_attestations?: {
                  reference: {
                      issuer: (...)
                      | (...)
                      | (...);
                      claim_type: string;
                      subject: (...) | (...) | (...);
                      locator?: (...) | (...) | (...);
                      embedded_credential?: (...) | (...);
                      content_digest?: (...) | (...);
                      credential_version?: (...) | (...);
                      validity_hint?: (...) | (...);
                      verify_agent?: (...) | (...);
                      ext?: (...) | (...);
                  };
                  evaluation: {
                      reference_digest: string;
                      credential_digest?: (...)
                      | (...);
                      proof_format?: (...) | (...);
                      outcome:
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...)
                          | (...);
                      evaluated_at: string;
                      evaluated_by: string;
                      verifier_agent_url?: (...) | (...);
                      reason_codes?: (...) | (...);
                      confidence?: (...) | (...);
                      revocation_checked_at?: (...) | (...);
                      valid_until?: (...) | (...);
                      action_binding?: (...) | (...);
                      ext?: (...) | (...);
                  };
              }[];
              runtime_attestation_binding_digest?: string;
              purchase_type?: PurchaseType;
              outcome_status?: string;
              delivery_reconciliation_status?: | "disputed"
              | "consistent"
              | "measurement_variance"
              | "unmatched"
              | "closed_unresolved";
              delivery_period_state?: "closed"
              | "open";
              adjustment_state?: "verified" | "disputed" | "reported";
              verified_amount?: number;
              evidence?: {
                  evidence_id: string;
                  evidence_type:
                      | "decommitment_agreement"
                      | "refund_settlement"
                      | "credit_note"
                      | "makegood_agreement";
                  digest: string;
                  issued_at: string;
              };
              reviewed_by?: string;
              reviewed_at?: string;
              review_reason?: string;
          }[];
          governed_actions: {
              governance_context: string;
              purchase_type: PurchaseType;
              status: "active"
              | "suspended"
              | "completed";
              committed: number;
              adjustments_reported?: number;
              adjustments_verified?: number;
              net_cost?: number;
              headroom_restored?: number;
              net_committed?: number;
              seller_reported_spend?: number;
              buyer_observed_spend?: number;
              delivery_reporting_period?: { start: string; end: string };
              conservative_exposure?: number;
              delivery_reconciliation_status?:
                  | "disputed"
                  | "consistent"
                  | "measurement_variance"
                  | "unmatched"
                  | "closed_unresolved";
              delivery_period_state?: "closed"
              | "open";
              check_count: number;
              seller_reference?: string;
          }[];
      }[];
      ext?: Omit<Omit<{ [key: string]: unknown }, "bank">, "authentication"> & {
          authentication?: unknown;
      };
  }

  • Optionalcontext?: Omit<Omit<{}, "bank">, "authentication"> & { authentication?: unknown }

  • Optionalgovernance_context?: string

    Opaque authorization context issued only by an approved check_governance decision. Buyers attach it to governed requests across protocol roles (media buys, rights acquisitions, signal activations, creative services); receiving services persist it and forward it on subsequent execution and lifecycle checks. The context is the authoritative plan binding at service boundaries, so a service MUST NOT require a separate plan_id.

    Governance agents MUST emit a compact JWS per the AdCP JWS profile. Verifiers validate standard authorization claims such as signature, issuer, audience, expiry, and replay protection, but intermediaries MUST NOT interpret embedded governance state for business logic. A conditions or denied verdict never carries an authorization context.

    This is the primary correlation key for audit and reporting across the governance lifecycle.

  • plans: {
        plan_id: string;
        plan_version: number;
        status: "active" | "suspended" | "completed";
        budget: {
            authorized?: number;
            accounting_mode?: "gross_commitment" | "verified_net_cost";
            committed?: number;
            gross_committed?: number;
            adjustments_reported?: number;
            adjustments_verified?: number;
            net_cost?: number;
            headroom_restored?: number;
            net_committed?: number;
            ledger_committed?: number;
            remaining?: number;
            utilization_pct?: number;
        };
        channel_allocation?: Omit<
            Omit<
                {
                    [key: string]: | { committed?: (...)
                    | (...); pct?: (...) | (...) }
                    | undefined;
                },
                "bank",
            >,
            "authentication",
        > & { authentication?: unknown };
        summary: {
            checks_performed?: number;
            outcomes_reported?: number;
            adjustments_reported?: number;
            adjustments_verified?: number;
            statuses?: {
                approved?: number;
                denied?: number;
                conditions?: number;
                human_reviewed?: number;
            };
            findings_count?: number;
            escalations?: {
                check_id: string;
                reason: string;
                resolution?: string;
                resolved_at?: string;
            }[];
            drift_metrics?: {
                escalation_rate?: number;
                escalation_rate_trend?: "increasing"
                | "stable"
                | "declining";
                auto_approval_rate?: number;
                human_override_rate?: number;
                mean_confidence?: number;
                thresholds?: {
                    escalation_rate_max?: number;
                    escalation_rate_min?: number;
                    auto_approval_rate_max?: number;
                    human_override_rate_max?: number;
                };
            };
        };
        entries?: {
            id: string;
            type: "check"
            | "outcome"
            | "adjustment";
            timestamp: string;
            plan_id?: string;
            caller?: string;
            tool?: string;
            verdict?: GovernanceDecision;
            check_type?: "intent" | "execution";
            mode?: GovernanceMode;
            explanation?: string;
            policies_evaluated?: string[];
            categories_evaluated?: string[];
            findings?: {
                category_id: string;
                policy_id?: string;
                source_plan_id?: string;
                severity: EscalationSeverity;
                explanation: string;
                details?: (...) & (...);
                confidence?: number;
                uncertainty_reason?: string;
                attestation_reference_digest?: string;
            }[];
            delivery_statement?: {
                statement_id: string;
                statement_digest: string;
                sequence: number;
                issued_at: string;
                seller_reference: string;
                cumulative_spend: number;
                currency: string;
                reporting_period: { start: string; end: string };
                canonical_payload: {
                    seller_reference: string;
                    delivery_metrics: Omit<(...), (...)> & { authentication?: ... };
                };
            };
            outcome?: OutcomeType;
            outcome_id?: string;
            seller_adjustment_id?: string;
            adjustment_type?: "refund"
            | "credit"
            | "decommitment"
            | "makegood";
            amount?: { amount: number; currency: string };
            headroom_restored?: number;
            reason?: string;
            effective_at?: string;
            committed_budget?: number;
            reported_committed_budget?: number;
            seller_reference?: string;
            delivery?: {
                observation_id?: string;
                source?: "seller_statement_copy" | "buyer_measurement";
                observed_at?: string;
                seller_statement_id?: string;
                seller_statement_digest?: string;
                reporting_period?: { start: string; end: string };
                cumulative_spend?: number;
                currency?: string;
                period_closed?: boolean;
                impressions?: number;
            };
            governance_context?: string;
            plan_hash?: string;
            runtime_attestations?: {
                reference: {
                    issuer: (...)
                    | (...)
                    | (...);
                    claim_type: string;
                    subject: (...) | (...) | (...);
                    locator?: (...) | (...) | (...);
                    embedded_credential?: (...) | (...);
                    content_digest?: (...) | (...);
                    credential_version?: (...) | (...);
                    validity_hint?: (...) | (...);
                    verify_agent?: (...) | (...);
                    ext?: (...) | (...);
                };
                evaluation: {
                    reference_digest: string;
                    credential_digest?: (...)
                    | (...);
                    proof_format?: (...) | (...);
                    outcome:
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...)
                        | (...);
                    evaluated_at: string;
                    evaluated_by: string;
                    verifier_agent_url?: (...) | (...);
                    reason_codes?: (...) | (...);
                    confidence?: (...) | (...);
                    revocation_checked_at?: (...) | (...);
                    valid_until?: (...) | (...);
                    action_binding?: (...) | (...);
                    ext?: (...) | (...);
                };
            }[];
            runtime_attestation_binding_digest?: string;
            purchase_type?: PurchaseType;
            outcome_status?: string;
            delivery_reconciliation_status?: | "disputed"
            | "consistent"
            | "measurement_variance"
            | "unmatched"
            | "closed_unresolved";
            delivery_period_state?: "closed"
            | "open";
            adjustment_state?: "verified" | "disputed" | "reported";
            verified_amount?: number;
            evidence?: {
                evidence_id: string;
                evidence_type:
                    | "decommitment_agreement"
                    | "refund_settlement"
                    | "credit_note"
                    | "makegood_agreement";
                digest: string;
                issued_at: string;
            };
            reviewed_by?: string;
            reviewed_at?: string;
            review_reason?: string;
        }[];
        governed_actions: {
            governance_context: string;
            purchase_type: PurchaseType;
            status: "active"
            | "suspended"
            | "completed";
            committed: number;
            adjustments_reported?: number;
            adjustments_verified?: number;
            net_cost?: number;
            headroom_restored?: number;
            net_committed?: number;
            seller_reported_spend?: number;
            buyer_observed_spend?: number;
            delivery_reporting_period?: { start: string; end: string };
            conservative_exposure?: number;
            delivery_reconciliation_status?:
                | "disputed"
                | "consistent"
                | "measurement_variance"
                | "unmatched"
                | "closed_unresolved";
            delivery_period_state?: "closed"
            | "open";
            check_count: number;
            seller_reference?: string;
        }[];
    }[]

    Audit data for each requested plan.

  • Optionalext?: Omit<Omit<{ [key: string]: unknown }, "bank">, "authentication"> & {
        authentication?: unknown;
    }

• Optionalsummary: string