Function getPlanAuditLogsResponse

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;
              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;
              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";
              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;
                  severity: EscalationSeverity;
                  explanation: string;
                  confidence?: number;
              }[];
              outcome?: OutcomeType;
              committed_budget?: number;
              governance_context?: string;
              plan_hash?: string;
              purchase_type?: PurchaseType;
              outcome_status?: string;
          }[];
          governed_actions: {
              governance_context: string;
              purchase_type: PurchaseType;
              status: "active"
              | "suspended"
              | "completed";
              committed: number;
              check_count: number;
              seller_reference?: string;
          }[];
      }[];
      ext?: Omit<Omit<{}, "bank">, "authentication"> & {
          authentication?: unknown;
      };
  }

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

  • Optionalgovernance_context?: string

    Governance context token issued by the account's governance agent during check_governance. Buyers attach it to governed purchase requests (media buys, rights acquisitions, signal activations, creative services); sellers persist it and include it on all subsequent governance calls for that action's lifecycle. An account binds to one governance agent (see sync_governance); governance is phased across purchase / modification / delivery, not partitioned across specialist agents, so the envelope carries a single token for the full lifecycle.

    Value format: governance agents MUST emit a compact JWS per the AdCP JWS profile (see Security — Signed Governance Context). Sellers MAY verify; sellers that do not verify MUST persist and forward the token unchanged. In 3.1 all sellers MUST verify. Non-JWS values from pre-3.0 governance agents are deprecated.

    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;
            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;
            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";
            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;
                severity: EscalationSeverity;
                explanation: string;
                confidence?: number;
            }[];
            outcome?: OutcomeType;
            committed_budget?: number;
            governance_context?: string;
            plan_hash?: string;
            purchase_type?: PurchaseType;
            outcome_status?: string;
        }[];
        governed_actions: {
            governance_context: string;
            purchase_type: PurchaseType;
            status: "active"
            | "suspended"
            | "completed";
            committed: number;
            check_count: number;
            seller_reference?: string;
        }[];
    }[]

    Audit data for each requested plan.

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

• Optionalsummary: string