@openvtc/trust-tasks 0.22.6 → 0.23.0

package/dist/auth/step-up/approve-response/0.6/payload.d.ts

@@ -0,0 +1,974 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/auth/step-up/approve-response/0.6/payload.schema.json
+ */
+import type { AttestStatement, AuthenticatorAssertionResponseLogin, Ext, Session_AuthV0_1 as Session } from "../../../../_shared/components.js";
+/**
+ * How the approver demonstrated the factor backing this approval. A tagged union on `kind`; absent is equivalent to `didSigned`. Whatever the kind, the document's framework `proof` is REQUIRED — evidence is in addition to it, never instead.
+ */
+export type StepUpEvidence = DidSigned | WebAuthn | ApproverSigned;
+/**
+ * The approver's signed ratification of a step-up: subject + challenge (+ sessionId, when the request carried one) are echoed inside a document signed by the approver, backed by a gate — the proof itself, a WebAuthn assertion, or a bound step-up approver's signed statement — so the relying party can elevate the session, or apply the approval to the one operation it was bound to.
+ */
+export interface AuthStepUpApproveResponse {
+    /**
+     * Echoed from the matching approve-request. The relying party verifies it equals the subject bound to the pending step-up. With `approverSigned` evidence it is also the document's issuer: the subject signs as its own DID.
+     */
+    subject: string;
+    /**
+     * Echoed from the matching approve-request when that request carried one, and absent when it did not — a step-up bound to an operation that arrived without a session.
+     */
+    sessionId?: string;
+    /**
+     * Echoed from the matching approve-request. The relying party verifies it equals the bound challenge.
+     */
+    challenge: string;
+    /**
+     * `approved` elevates the session, or authorizes the bound operation, per the relying party's policy. `denied` is a signed refusal — useful for audit even though it changes nothing.
+     */
+    decision: "approved" | "denied";
+    /**
+     * Required when decision is `denied`. Human-readable rationale the user provided (or which the approver inferred).
+     */
+    deniedReason?: string;
+    /**
+     * The acr the approver believes it has cryptographically demonstrated. The relying party MAY accept this, MAY upgrade to a lower value, but MUST NOT exceed it.
+     */
+    grantedAcr?: string;
+    evidence?: StepUpEvidence;
+    ext?: Ext;
+}
+/**
+ * The approval is gated by the document's framework `proof` alone. The default when `evidence` is omitted. `amr` reflects "vta"/"did".
+ */
+export interface DidSigned {
+    kind: "didSigned";
+}
+export interface WebAuthn {
+    kind: "webauthn";
+    /**
+     * The unmodified AuthenticatorAssertionResponse from the platform WebAuthn API. Its `clientDataJSON` challenge MUST equal the step-up `challenge`. Verified per WebAuthn Level 2 §7.2 in addition to the framework proof; `amr` reflects "passkey".
+     */
+    assertion: AuthenticatorAssertionResponseLogin;
+}
+export interface ApproverSigned {
+    kind: "approverSigned";
+    /**
+     * A complete, signed auth/step-up/approver/attest/0.1 document with `purpose: stepUp`, issued by one of the subject's bound step-up approvers over the step-up `challenge` and `boundTo`, addressed to the relying party. The statement is the factor; the document carrying it MUST still be proved by the subject's own DID — never a delegated key. Verified as received, in addition to the framework proof; `amr` reflects "approver".
+     */
+    statement: AttestStatement;
+}
+/**
+ * Acknowledgement the relying party returns after processing the approval. Carried in a Trust Task document whose type is https://trusttasks.org/spec/auth/step-up/approve-response/0.6#response.
+ */
+export interface AuthStepUpApproveResponseRelyingPartyAck {
+    /**
+     * `elevated` — the approval was applied and the session's assurance level was raised. `recorded` — the approval was applied to the single operation it was bound to, and NO session was elevated; see `boundTo`. `rejected` — the approval was not applied.
+     */
+    status: "elevated" | "recorded" | "rejected";
+    /**
+     * Present when status is `elevated`. Absent for `recorded`, which changes no session.
+     */
+    session?: Session;
+    /**
+     * Present when status is `recorded`. The opaque relying-party identifier for the single operation this approval authorised. Not a capability.
+     */
+    boundTo?: string;
+    /**
+     * Present when status is `rejected`.
+     */
+    reason?: string;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { AttestStatement, AuthenticatorAssertionResponseLogin, Ext, Session };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/auth/step-up/approve-response/0.6";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = AuthStepUpApproveResponse;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/auth/step-up/approve-response/0.6#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = AuthStepUpApproveResponseRelyingPartyAck;
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/auth/step-up/approve-response/0.6";
+    readonly title: "Auth — Step-up Approve Response";
+    readonly description: "The approver's signed ratification of a step-up: subject + challenge (+ sessionId, when the request carried one) are echoed inside a document signed by the approver, backed by a gate — the proof itself, a WebAuthn assertion, or a bound step-up approver's signed statement — so the relying party can elevate the session, or apply the approval to the one operation it was bound to.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["subject", "challenge", "decision"];
+    readonly properties: {
+        readonly subject: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Echoed from the matching approve-request. The relying party verifies it equals the subject bound to the pending step-up. With `approverSigned` evidence it is also the document's issuer: the subject signs as its own DID.";
+        };
+        readonly sessionId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Echoed from the matching approve-request when that request carried one, and absent when it did not — a step-up bound to an operation that arrived without a session.";
+        };
+        readonly challenge: {
+            readonly type: "string";
+            readonly minLength: 16;
+            readonly description: "Echoed from the matching approve-request. The relying party verifies it equals the bound challenge.";
+        };
+        readonly decision: {
+            readonly type: "string";
+            readonly enum: readonly ["approved", "denied"];
+            readonly description: "`approved` elevates the session, or authorizes the bound operation, per the relying party's policy. `denied` is a signed refusal — useful for audit even though it changes nothing.";
+        };
+        readonly deniedReason: {
+            readonly type: "string";
+            readonly maxLength: 500;
+            readonly description: "Required when decision is `denied`. Human-readable rationale the user provided (or which the approver inferred).";
+        };
+        readonly grantedAcr: {
+            readonly type: "string";
+            readonly description: "The acr the approver believes it has cryptographically demonstrated. The relying party MAY accept this, MAY upgrade to a lower value, but MUST NOT exceed it.";
+        };
+        readonly evidence: {
+            readonly $ref: "#/$defs/Evidence";
+            readonly description: "How the approver demonstrated the factor backing this approval. A tagged union on `kind`; absent is equivalent to `didSigned`. Whatever the kind, the document's framework `proof` is REQUIRED — evidence is in addition to it, never instead.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Evidence: {
+            readonly $anchor: "evidence";
+            readonly title: "Step-up Evidence";
+            readonly description: "Tagged union over `kind` describing the cryptographic factor the approver presents to back the approval.";
+            readonly oneOf: readonly [{
+                readonly title: "DidSigned";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind"];
+                readonly properties: {
+                    readonly kind: {
+                        readonly const: "didSigned";
+                    };
+                };
+                readonly description: "The approval is gated by the document's framework `proof` alone. The default when `evidence` is omitted. `amr` reflects \"vta\"/\"did\".";
+            }, {
+                readonly title: "WebAuthn";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind", "assertion"];
+                readonly properties: {
+                    readonly kind: {
+                        readonly const: "webauthn";
+                    };
+                    readonly assertion: {
+                        readonly $ref: "#/$defs/AssertionResponse";
+                        readonly description: "The unmodified AuthenticatorAssertionResponse from the platform WebAuthn API. Its `clientDataJSON` challenge MUST equal the step-up `challenge`. Verified per WebAuthn Level 2 §7.2 in addition to the framework proof; `amr` reflects \"passkey\".";
+                    };
+                };
+            }, {
+                readonly title: "ApproverSigned";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind", "statement"];
+                readonly properties: {
+                    readonly kind: {
+                        readonly const: "approverSigned";
+                    };
+                    readonly statement: {
+                        readonly $ref: "#/$defs/AttestStatement";
+                        readonly description: "A complete, signed auth/step-up/approver/attest/0.1 document with `purpose: stepUp`, issued by one of the subject's bound step-up approvers over the step-up `challenge` and `boundTo`, addressed to the relying party. The statement is the factor; the document carrying it MUST still be proved by the subject's own DID — never a delegated key. Verified as received, in addition to the framework proof; `amr` reflects \"approver\".";
+                    };
+                };
+            }];
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Auth Step-up Approve Response — relying party ack";
+            readonly description: "Acknowledgement the relying party returns after processing the approval. Carried in a Trust Task document whose type is https://trusttasks.org/spec/auth/step-up/approve-response/0.6#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["status"];
+            readonly properties: {
+                readonly status: {
+                    readonly type: "string";
+                    readonly enum: readonly ["elevated", "recorded", "rejected"];
+                    readonly description: "`elevated` — the approval was applied and the session's assurance level was raised. `recorded` — the approval was applied to the single operation it was bound to, and NO session was elevated; see `boundTo`. `rejected` — the approval was not applied.";
+                };
+                readonly session: {
+                    readonly $ref: "#/$defs/Session";
+                    readonly description: "Present when status is `elevated`. Absent for `recorded`, which changes no session.";
+                };
+                readonly boundTo: {
+                    readonly type: "string";
+                    readonly maxLength: 256;
+                    readonly description: "Present when status is `recorded`. The opaque relying-party identifier for the single operation this approval authorised. Not a capability.";
+                };
+                readonly reason: {
+                    readonly type: "string";
+                    readonly maxLength: 1024;
+                    readonly description: "Present when status is `rejected`.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly Session: {
+            readonly $anchor: "session";
+            readonly title: "Session";
+            readonly description: "A logical authentication context bound to a subject. Producers and consumers exchange Session-shaped data in challenge issuance, authentication responses, and introspection (whoami).";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "subject", "issuedAt", "expiresAt"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Opaque, server-chosen session identifier. Stable for the lifetime of the session. Consumers MUST treat the value as opaque; no structure is implied.";
+                };
+                readonly subject: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The authenticated party's VID (typically a DID URL).";
+                };
+                readonly issuedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "ISO-8601 timestamp when the session was created.";
+                };
+                readonly expiresAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "ISO-8601 timestamp when the session ceases to be valid. Producers SHOULD refresh before this time; consumers MUST reject after.";
+                };
+                readonly amr: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: "Authentication Methods References per [RFC 8176]. Typical values: \"did\" (challenge-response), \"passkey\" (WebAuthn), \"vta\" (verifiable-trust agent approval). Multi-factor sessions list every method used.";
+                };
+                readonly acr: {
+                    readonly type: "string";
+                    readonly description: "Authentication Context Class Reference per [OIDC Core §2]. Profiles define their own values; the recommended set is \"aal1\" (single-factor DID auth), \"aal2\" (a second possession-or-biometric factor confirmed), and \"aal3\" (hardware-bound second factor).";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+                };
+            };
+        };
+        readonly AttestStatement: {
+            readonly title: "AttestStatement";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly description: "A complete, signed auth/step-up/approver/attest/0.1 Trust Task document — envelope, payload and proof — issued by the approver. Deliberately an open object here rather than a typed one: the consumer verifies it as a document in its own right (envelope, proof and payload against that specification's schemas), and verifies its proof over the members exactly as received, which a binding that narrowed it to a typed struct and re-serialised it could silently break.";
+        };
+        readonly AssertionResponse: {
+            readonly $anchor: "assertionResponse";
+            readonly title: "AuthenticatorAssertionResponse (login)";
+            readonly description: "The credential the client returns from `navigator.credentials.get`. Binary fields are base64url-encoded.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "rawId", "type", "response"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly rawId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly const: "public-key";
+                };
+                readonly response: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["clientDataJSON", "authenticatorData", "signature"];
+                    readonly properties: {
+                        readonly clientDataJSON: {
+                            readonly type: "string";
+                        };
+                        readonly authenticatorData: {
+                            readonly type: "string";
+                        };
+                        readonly signature: {
+                            readonly type: "string";
+                        };
+                        readonly userHandle: {
+                            readonly type: readonly ["string", "null"];
+                        };
+                    };
+                };
+                readonly authenticatorAttachment: {
+                    readonly enum: readonly ["platform", "cross-platform"];
+                };
+                readonly clientExtensionResults: {
+                    readonly type: "object";
+                };
+            };
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly Evidence: {
+            readonly $anchor: "evidence";
+            readonly title: "Step-up Evidence";
+            readonly description: "Tagged union over `kind` describing the cryptographic factor the approver presents to back the approval.";
+            readonly oneOf: readonly [{
+                readonly title: "DidSigned";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind"];
+                readonly properties: {
+                    readonly kind: {
+                        readonly const: "didSigned";
+                    };
+                };
+                readonly description: "The approval is gated by the document's framework `proof` alone. The default when `evidence` is omitted. `amr` reflects \"vta\"/\"did\".";
+            }, {
+                readonly title: "WebAuthn";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind", "assertion"];
+                readonly properties: {
+                    readonly kind: {
+                        readonly const: "webauthn";
+                    };
+                    readonly assertion: {
+                        readonly $ref: "#/$defs/AssertionResponse";
+                        readonly description: "The unmodified AuthenticatorAssertionResponse from the platform WebAuthn API. Its `clientDataJSON` challenge MUST equal the step-up `challenge`. Verified per WebAuthn Level 2 §7.2 in addition to the framework proof; `amr` reflects \"passkey\".";
+                    };
+                };
+            }, {
+                readonly title: "ApproverSigned";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind", "statement"];
+                readonly properties: {
+                    readonly kind: {
+                        readonly const: "approverSigned";
+                    };
+                    readonly statement: {
+                        readonly $ref: "#/$defs/AttestStatement";
+                        readonly description: "A complete, signed auth/step-up/approver/attest/0.1 document with `purpose: stepUp`, issued by one of the subject's bound step-up approvers over the step-up `challenge` and `boundTo`, addressed to the relying party. The statement is the factor; the document carrying it MUST still be proved by the subject's own DID — never a delegated key. Verified as received, in addition to the framework proof; `amr` reflects \"approver\".";
+                    };
+                };
+            }];
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Auth Step-up Approve Response — relying party ack";
+            readonly description: "Acknowledgement the relying party returns after processing the approval. Carried in a Trust Task document whose type is https://trusttasks.org/spec/auth/step-up/approve-response/0.6#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["status"];
+            readonly properties: {
+                readonly status: {
+                    readonly type: "string";
+                    readonly enum: readonly ["elevated", "recorded", "rejected"];
+                    readonly description: "`elevated` — the approval was applied and the session's assurance level was raised. `recorded` — the approval was applied to the single operation it was bound to, and NO session was elevated; see `boundTo`. `rejected` — the approval was not applied.";
+                };
+                readonly session: {
+                    readonly $ref: "#/$defs/Session";
+                    readonly description: "Present when status is `elevated`. Absent for `recorded`, which changes no session.";
+                };
+                readonly boundTo: {
+                    readonly type: "string";
+                    readonly maxLength: 256;
+                    readonly description: "Present when status is `recorded`. The opaque relying-party identifier for the single operation this approval authorised. Not a capability.";
+                };
+                readonly reason: {
+                    readonly type: "string";
+                    readonly maxLength: 1024;
+                    readonly description: "Present when status is `rejected`.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly Session: {
+            readonly $anchor: "session";
+            readonly title: "Session";
+            readonly description: "A logical authentication context bound to a subject. Producers and consumers exchange Session-shaped data in challenge issuance, authentication responses, and introspection (whoami).";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "subject", "issuedAt", "expiresAt"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Opaque, server-chosen session identifier. Stable for the lifetime of the session. Consumers MUST treat the value as opaque; no structure is implied.";
+                };
+                readonly subject: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "The authenticated party's VID (typically a DID URL).";
+                };
+                readonly issuedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "ISO-8601 timestamp when the session was created.";
+                };
+                readonly expiresAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "ISO-8601 timestamp when the session ceases to be valid. Producers SHOULD refresh before this time; consumers MUST reject after.";
+                };
+                readonly amr: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: "Authentication Methods References per [RFC 8176]. Typical values: \"did\" (challenge-response), \"passkey\" (WebAuthn), \"vta\" (verifiable-trust agent approval). Multi-factor sessions list every method used.";
+                };
+                readonly acr: {
+                    readonly type: "string";
+                    readonly description: "Authentication Context Class Reference per [OIDC Core §2]. Profiles define their own values; the recommended set is \"aal1\" (single-factor DID auth), \"aal2\" (a second possession-or-biometric factor confirmed), and \"aal3\" (hardware-bound second factor).";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+                };
+            };
+        };
+        readonly AttestStatement: {
+            readonly title: "AttestStatement";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly description: "A complete, signed auth/step-up/approver/attest/0.1 Trust Task document — envelope, payload and proof — issued by the approver. Deliberately an open object here rather than a typed one: the consumer verifies it as a document in its own right (envelope, proof and payload against that specification's schemas), and verifies its proof over the members exactly as received, which a binding that narrowed it to a typed struct and re-serialised it could silently break.";
+        };
+        readonly AssertionResponse: {
+            readonly $anchor: "assertionResponse";
+            readonly title: "AuthenticatorAssertionResponse (login)";
+            readonly description: "The credential the client returns from `navigator.credentials.get`. Binary fields are base64url-encoded.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "rawId", "type", "response"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly rawId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly const: "public-key";
+                };
+                readonly response: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["clientDataJSON", "authenticatorData", "signature"];
+                    readonly properties: {
+                        readonly clientDataJSON: {
+                            readonly type: "string";
+                        };
+                        readonly authenticatorData: {
+                            readonly type: "string";
+                        };
+                        readonly signature: {
+                            readonly type: "string";
+                        };
+                        readonly userHandle: {
+                            readonly type: readonly ["string", "null"];
+                        };
+                    };
+                };
+                readonly authenticatorAttachment: {
+                    readonly enum: readonly ["platform", "cross-platform"];
+                };
+                readonly clientExtensionResults: {
+                    readonly type: "object";
+                };
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/auth/step-up/approve-response/0.6";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/auth/step-up/approve-response/0.6";
+        readonly title: "Auth — Step-up Approve Response";
+        readonly description: "The approver's signed ratification of a step-up: subject + challenge (+ sessionId, when the request carried one) are echoed inside a document signed by the approver, backed by a gate — the proof itself, a WebAuthn assertion, or a bound step-up approver's signed statement — so the relying party can elevate the session, or apply the approval to the one operation it was bound to.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["subject", "challenge", "decision"];
+        readonly properties: {
+            readonly subject: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Echoed from the matching approve-request. The relying party verifies it equals the subject bound to the pending step-up. With `approverSigned` evidence it is also the document's issuer: the subject signs as its own DID.";
+            };
+            readonly sessionId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Echoed from the matching approve-request when that request carried one, and absent when it did not — a step-up bound to an operation that arrived without a session.";
+            };
+            readonly challenge: {
+                readonly type: "string";
+                readonly minLength: 16;
+                readonly description: "Echoed from the matching approve-request. The relying party verifies it equals the bound challenge.";
+            };
+            readonly decision: {
+                readonly type: "string";
+                readonly enum: readonly ["approved", "denied"];
+                readonly description: "`approved` elevates the session, or authorizes the bound operation, per the relying party's policy. `denied` is a signed refusal — useful for audit even though it changes nothing.";
+            };
+            readonly deniedReason: {
+                readonly type: "string";
+                readonly maxLength: 500;
+                readonly description: "Required when decision is `denied`. Human-readable rationale the user provided (or which the approver inferred).";
+            };
+            readonly grantedAcr: {
+                readonly type: "string";
+                readonly description: "The acr the approver believes it has cryptographically demonstrated. The relying party MAY accept this, MAY upgrade to a lower value, but MUST NOT exceed it.";
+            };
+            readonly evidence: {
+                readonly $ref: "#/$defs/Evidence";
+                readonly description: "How the approver demonstrated the factor backing this approval. A tagged union on `kind`; absent is equivalent to `didSigned`. Whatever the kind, the document's framework `proof` is REQUIRED — evidence is in addition to it, never instead.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Evidence: {
+                readonly $anchor: "evidence";
+                readonly title: "Step-up Evidence";
+                readonly description: "Tagged union over `kind` describing the cryptographic factor the approver presents to back the approval.";
+                readonly oneOf: readonly [{
+                    readonly title: "DidSigned";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly const: "didSigned";
+                        };
+                    };
+                    readonly description: "The approval is gated by the document's framework `proof` alone. The default when `evidence` is omitted. `amr` reflects \"vta\"/\"did\".";
+                }, {
+                    readonly title: "WebAuthn";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind", "assertion"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly const: "webauthn";
+                        };
+                        readonly assertion: {
+                            readonly $ref: "#/$defs/AssertionResponse";
+                            readonly description: "The unmodified AuthenticatorAssertionResponse from the platform WebAuthn API. Its `clientDataJSON` challenge MUST equal the step-up `challenge`. Verified per WebAuthn Level 2 §7.2 in addition to the framework proof; `amr` reflects \"passkey\".";
+                        };
+                    };
+                }, {
+                    readonly title: "ApproverSigned";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind", "statement"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly const: "approverSigned";
+                        };
+                        readonly statement: {
+                            readonly $ref: "#/$defs/AttestStatement";
+                            readonly description: "A complete, signed auth/step-up/approver/attest/0.1 document with `purpose: stepUp`, issued by one of the subject's bound step-up approvers over the step-up `challenge` and `boundTo`, addressed to the relying party. The statement is the factor; the document carrying it MUST still be proved by the subject's own DID — never a delegated key. Verified as received, in addition to the framework proof; `amr` reflects \"approver\".";
+                        };
+                    };
+                }];
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Auth Step-up Approve Response — relying party ack";
+                readonly description: "Acknowledgement the relying party returns after processing the approval. Carried in a Trust Task document whose type is https://trusttasks.org/spec/auth/step-up/approve-response/0.6#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["status"];
+                readonly properties: {
+                    readonly status: {
+                        readonly type: "string";
+                        readonly enum: readonly ["elevated", "recorded", "rejected"];
+                        readonly description: "`elevated` — the approval was applied and the session's assurance level was raised. `recorded` — the approval was applied to the single operation it was bound to, and NO session was elevated; see `boundTo`. `rejected` — the approval was not applied.";
+                    };
+                    readonly session: {
+                        readonly $ref: "#/$defs/Session";
+                        readonly description: "Present when status is `elevated`. Absent for `recorded`, which changes no session.";
+                    };
+                    readonly boundTo: {
+                        readonly type: "string";
+                        readonly maxLength: 256;
+                        readonly description: "Present when status is `recorded`. The opaque relying-party identifier for the single operation this approval authorised. Not a capability.";
+                    };
+                    readonly reason: {
+                        readonly type: "string";
+                        readonly maxLength: 1024;
+                        readonly description: "Present when status is `rejected`.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly Session: {
+                readonly $anchor: "session";
+                readonly title: "Session";
+                readonly description: "A logical authentication context bound to a subject. Producers and consumers exchange Session-shaped data in challenge issuance, authentication responses, and introspection (whoami).";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "subject", "issuedAt", "expiresAt"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "Opaque, server-chosen session identifier. Stable for the lifetime of the session. Consumers MUST treat the value as opaque; no structure is implied.";
+                    };
+                    readonly subject: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The authenticated party's VID (typically a DID URL).";
+                    };
+                    readonly issuedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "ISO-8601 timestamp when the session was created.";
+                    };
+                    readonly expiresAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "ISO-8601 timestamp when the session ceases to be valid. Producers SHOULD refresh before this time; consumers MUST reject after.";
+                    };
+                    readonly amr: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly description: "Authentication Methods References per [RFC 8176]. Typical values: \"did\" (challenge-response), \"passkey\" (WebAuthn), \"vta\" (verifiable-trust agent approval). Multi-factor sessions list every method used.";
+                    };
+                    readonly acr: {
+                        readonly type: "string";
+                        readonly description: "Authentication Context Class Reference per [OIDC Core §2]. Profiles define their own values; the recommended set is \"aal1\" (single-factor DID auth), \"aal2\" (a second possession-or-biometric factor confirmed), and \"aal3\" (hardware-bound second factor).";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+                    };
+                };
+            };
+            readonly AttestStatement: {
+                readonly title: "AttestStatement";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly description: "A complete, signed auth/step-up/approver/attest/0.1 Trust Task document — envelope, payload and proof — issued by the approver. Deliberately an open object here rather than a typed one: the consumer verifies it as a document in its own right (envelope, proof and payload against that specification's schemas), and verifies its proof over the members exactly as received, which a binding that narrowed it to a typed struct and re-serialised it could silently break.";
+            };
+            readonly AssertionResponse: {
+                readonly $anchor: "assertionResponse";
+                readonly title: "AuthenticatorAssertionResponse (login)";
+                readonly description: "The credential the client returns from `navigator.credentials.get`. Binary fields are base64url-encoded.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "rawId", "type", "response"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly rawId: {
+                        readonly type: "string";
+                    };
+                    readonly type: {
+                        readonly const: "public-key";
+                    };
+                    readonly response: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["clientDataJSON", "authenticatorData", "signature"];
+                        readonly properties: {
+                            readonly clientDataJSON: {
+                                readonly type: "string";
+                            };
+                            readonly authenticatorData: {
+                                readonly type: "string";
+                            };
+                            readonly signature: {
+                                readonly type: "string";
+                            };
+                            readonly userHandle: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                        };
+                    };
+                    readonly authenticatorAttachment: {
+                        readonly enum: readonly ["platform", "cross-platform"];
+                    };
+                    readonly clientExtensionResults: {
+                        readonly type: "object";
+                    };
+                };
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/auth/step-up/approve-response/0.6#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Evidence: {
+                readonly $anchor: "evidence";
+                readonly title: "Step-up Evidence";
+                readonly description: "Tagged union over `kind` describing the cryptographic factor the approver presents to back the approval.";
+                readonly oneOf: readonly [{
+                    readonly title: "DidSigned";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly const: "didSigned";
+                        };
+                    };
+                    readonly description: "The approval is gated by the document's framework `proof` alone. The default when `evidence` is omitted. `amr` reflects \"vta\"/\"did\".";
+                }, {
+                    readonly title: "WebAuthn";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind", "assertion"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly const: "webauthn";
+                        };
+                        readonly assertion: {
+                            readonly $ref: "#/$defs/AssertionResponse";
+                            readonly description: "The unmodified AuthenticatorAssertionResponse from the platform WebAuthn API. Its `clientDataJSON` challenge MUST equal the step-up `challenge`. Verified per WebAuthn Level 2 §7.2 in addition to the framework proof; `amr` reflects \"passkey\".";
+                        };
+                    };
+                }, {
+                    readonly title: "ApproverSigned";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind", "statement"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly const: "approverSigned";
+                        };
+                        readonly statement: {
+                            readonly $ref: "#/$defs/AttestStatement";
+                            readonly description: "A complete, signed auth/step-up/approver/attest/0.1 document with `purpose: stepUp`, issued by one of the subject's bound step-up approvers over the step-up `challenge` and `boundTo`, addressed to the relying party. The statement is the factor; the document carrying it MUST still be proved by the subject's own DID — never a delegated key. Verified as received, in addition to the framework proof; `amr` reflects \"approver\".";
+                        };
+                    };
+                }];
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Auth Step-up Approve Response — relying party ack";
+                readonly description: "Acknowledgement the relying party returns after processing the approval. Carried in a Trust Task document whose type is https://trusttasks.org/spec/auth/step-up/approve-response/0.6#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["status"];
+                readonly properties: {
+                    readonly status: {
+                        readonly type: "string";
+                        readonly enum: readonly ["elevated", "recorded", "rejected"];
+                        readonly description: "`elevated` — the approval was applied and the session's assurance level was raised. `recorded` — the approval was applied to the single operation it was bound to, and NO session was elevated; see `boundTo`. `rejected` — the approval was not applied.";
+                    };
+                    readonly session: {
+                        readonly $ref: "#/$defs/Session";
+                        readonly description: "Present when status is `elevated`. Absent for `recorded`, which changes no session.";
+                    };
+                    readonly boundTo: {
+                        readonly type: "string";
+                        readonly maxLength: 256;
+                        readonly description: "Present when status is `recorded`. The opaque relying-party identifier for the single operation this approval authorised. Not a capability.";
+                    };
+                    readonly reason: {
+                        readonly type: "string";
+                        readonly maxLength: 1024;
+                        readonly description: "Present when status is `rejected`.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly Session: {
+                readonly $anchor: "session";
+                readonly title: "Session";
+                readonly description: "A logical authentication context bound to a subject. Producers and consumers exchange Session-shaped data in challenge issuance, authentication responses, and introspection (whoami).";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "subject", "issuedAt", "expiresAt"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "Opaque, server-chosen session identifier. Stable for the lifetime of the session. Consumers MUST treat the value as opaque; no structure is implied.";
+                    };
+                    readonly subject: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "The authenticated party's VID (typically a DID URL).";
+                    };
+                    readonly issuedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "ISO-8601 timestamp when the session was created.";
+                    };
+                    readonly expiresAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "ISO-8601 timestamp when the session ceases to be valid. Producers SHOULD refresh before this time; consumers MUST reject after.";
+                    };
+                    readonly amr: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly description: "Authentication Methods References per [RFC 8176]. Typical values: \"did\" (challenge-response), \"passkey\" (WebAuthn), \"vta\" (verifiable-trust agent approval). Multi-factor sessions list every method used.";
+                    };
+                    readonly acr: {
+                        readonly type: "string";
+                        readonly description: "Authentication Context Class Reference per [OIDC Core §2]. Profiles define their own values; the recommended set is \"aal1\" (single-factor DID auth), \"aal2\" (a second possession-or-biometric factor confirmed), and \"aal3\" (hardware-bound second factor).";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+                    };
+                };
+            };
+            readonly AttestStatement: {
+                readonly title: "AttestStatement";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly description: "A complete, signed auth/step-up/approver/attest/0.1 Trust Task document — envelope, payload and proof — issued by the approver. Deliberately an open object here rather than a typed one: the consumer verifies it as a document in its own right (envelope, proof and payload against that specification's schemas), and verifies its proof over the members exactly as received, which a binding that narrowed it to a typed struct and re-serialised it could silently break.";
+            };
+            readonly AssertionResponse: {
+                readonly $anchor: "assertionResponse";
+                readonly title: "AuthenticatorAssertionResponse (login)";
+                readonly description: "The credential the client returns from `navigator.credentials.get`. Binary fields are base64url-encoded.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "rawId", "type", "response"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly rawId: {
+                        readonly type: "string";
+                    };
+                    readonly type: {
+                        readonly const: "public-key";
+                    };
+                    readonly response: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["clientDataJSON", "authenticatorData", "signature"];
+                        readonly properties: {
+                            readonly clientDataJSON: {
+                                readonly type: "string";
+                            };
+                            readonly authenticatorData: {
+                                readonly type: "string";
+                            };
+                            readonly signature: {
+                                readonly type: "string";
+                            };
+                            readonly userHandle: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                        };
+                    };
+                    readonly authenticatorAttachment: {
+                        readonly enum: readonly ["platform", "cross-platform"];
+                    };
+                    readonly clientExtensionResults: {
+                        readonly type: "object";
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map