@openvtc/trust-tasks 0.8.2 → 0.9.0

package/dist/vta/did-templates/update/2.0/payload.d.ts

@@ -121,16 +121,632 @@ export type Payload = VTADIDTemplateUpdatePayload;
 export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vta/did-templates/update/2.0#response";
 /** Stable alias for this specification's success-response payload shape. */
 export type Response = DidTemplateRecord;
+/**
+ * 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/vta/did-templates/update/2.0";
+    readonly title: "VTA DID-Template Update — payload";
+    readonly description: "Replace an existing DID template on a VTA. Omit `contextId` to replace in the global scope (super-admin gated); set it to replace a template scoped to that context (gated on the context's admin, or a super-admin). The `name` is the resource id within the selected scope and MUST equal `template.name`; the VTA replaces the stored body, preserving createdAt/createdBy and advancing updatedAt. The success response is the persisted DidTemplateRecord.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["name", "template"];
+    readonly properties: {
+        readonly contextId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Scope selector. Absent: the global scope, gated on a super-administrator. Present: the context the template is scoped to, gated on that context's administrator (or a super-administrator).";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Resource id — the template's name within the selected scope. MUST equal `template.name` or the VTA rejects with the framework's `malformedRequest`.";
+        };
+        readonly template: {
+            readonly $ref: "#/$defs/DidTemplate";
+            readonly description: "Full replacement template document. Validated against the v1 template schema before persistence; an invalid shape is rejected with the framework's `malformedRequest`.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+            readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTA DID-Template Update — response payload";
+            readonly description: "The persisted DidTemplateRecord after replacement. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata (createdAt/createdBy preserved, updatedAt advanced). Same shape returned by create/get.";
+            readonly $ref: "#/$defs/DidTemplateRecord";
+        };
+        readonly DidTemplateRecord: {
+            readonly title: "DidTemplateRecord";
+            readonly description: "A persisted template. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by get/create/update and carried per-item by list.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["schemaVersion", "name", "kind", "document", "scope", "createdAt", "updatedAt", "createdBy"];
+            readonly properties: {
+                readonly schemaVersion: {
+                    readonly type: "integer";
+                    readonly const: 1;
+                };
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly pattern: "^[a-z0-9-]+$";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly description: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly methods: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly requiredVars: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly optionalVars: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+                readonly defaults: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+                readonly document: {
+                    readonly type: "object";
+                };
+                readonly scope: {
+                    readonly $ref: "#/$defs/Scope";
+                    readonly description: "Resolved scope of the stored template.";
+                };
+                readonly createdAt: {
+                    readonly type: "integer";
+                    readonly description: "UTC unix-epoch seconds the template was first stored.";
+                };
+                readonly updatedAt: {
+                    readonly type: "integer";
+                    readonly description: "UTC unix-epoch seconds of the last write.";
+                };
+                readonly createdBy: {
+                    readonly type: "string";
+                    readonly description: "DID of the admin who last wrote the template.";
+                };
+            };
+        };
+        readonly Scope: {
+            readonly title: "Scope";
+            readonly description: "Where a stored template lives. Tagged by `type`.";
+            readonly type: "object";
+            readonly oneOf: readonly [{
+                readonly title: "Builtin";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "builtin";
+                    };
+                };
+            }, {
+                readonly title: "Global";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "global";
+                    };
+                };
+            }, {
+                readonly title: "Context";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "contextId"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "context";
+                    };
+                    readonly contextId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+            }];
+        };
+        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 DidTemplate: {
+            readonly title: "DidTemplate";
+            readonly description: "Authored template shape: a DID document with `{TOKEN}` placeholders plus the variable contract the VTA's renderer enforces.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["schemaVersion", "name", "kind", "document"];
+            readonly properties: {
+                readonly schemaVersion: {
+                    readonly type: "integer";
+                    readonly const: 1;
+                    readonly description: "Template schema version. Currently always 1.";
+                };
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly pattern: "^[a-z0-9-]+$";
+                    readonly description: "Template id within its scope. Lowercase alphanumeric and hyphen only.";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Classification hint, e.g. `mediator`, `did-host-http`, `app`. Drives downstream provisioning behaviour.";
+                };
+                readonly description: {
+                    readonly type: readonly ["string", "null"];
+                    readonly description: "Human-readable description of what the template provisions.";
+                };
+                readonly methods: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "DID methods this template targets, e.g. [\"webvh\", \"web\"] for a hosted DID or [\"key\"] for a did:key.";
+                };
+                readonly requiredVars: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Variables the caller MUST supply at render time. MUST NOT include reserved ambient names (DID, SIGNING_KEY_MB, KA_KEY_MB, VTA_DID, VTA_URL, CONTEXT_ID, CONTEXT_DID, NOW).";
+                };
+                readonly optionalVars: {
+                    readonly type: "object";
+                    readonly description: "Variables with default values, keyed by variable name.";
+                    readonly additionalProperties: true;
+                };
+                readonly defaults: {
+                    readonly type: "object";
+                    readonly description: "Hints for CLI / setup wizards (e.g. preRotationCount, portable, addMediatorService).";
+                    readonly additionalProperties: true;
+                };
+                readonly document: {
+                    readonly type: "object";
+                    readonly description: "The DID document body with `{TOKEN}` placeholders. `document.id` MUST contain the `{DID}` placeholder. Every `{TOKEN}` MUST be declared in requiredVars/optionalVars or be a reserved ambient name.";
+                };
+            };
+        };
+    };
+};
+/** 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 Response: {
+            readonly $anchor: "response";
+            readonly title: "VTA DID-Template Update — response payload";
+            readonly description: "The persisted DidTemplateRecord after replacement. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata (createdAt/createdBy preserved, updatedAt advanced). Same shape returned by create/get.";
+            readonly $ref: "#/$defs/DidTemplateRecord";
+        };
+        readonly DidTemplateRecord: {
+            readonly title: "DidTemplateRecord";
+            readonly description: "A persisted template. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by get/create/update and carried per-item by list.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["schemaVersion", "name", "kind", "document", "scope", "createdAt", "updatedAt", "createdBy"];
+            readonly properties: {
+                readonly schemaVersion: {
+                    readonly type: "integer";
+                    readonly const: 1;
+                };
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly pattern: "^[a-z0-9-]+$";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly description: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly methods: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly requiredVars: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly optionalVars: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+                readonly defaults: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+                readonly document: {
+                    readonly type: "object";
+                };
+                readonly scope: {
+                    readonly $ref: "#/$defs/Scope";
+                    readonly description: "Resolved scope of the stored template.";
+                };
+                readonly createdAt: {
+                    readonly type: "integer";
+                    readonly description: "UTC unix-epoch seconds the template was first stored.";
+                };
+                readonly updatedAt: {
+                    readonly type: "integer";
+                    readonly description: "UTC unix-epoch seconds of the last write.";
+                };
+                readonly createdBy: {
+                    readonly type: "string";
+                    readonly description: "DID of the admin who last wrote the template.";
+                };
+            };
+        };
+        readonly Scope: {
+            readonly title: "Scope";
+            readonly description: "Where a stored template lives. Tagged by `type`.";
+            readonly type: "object";
+            readonly oneOf: readonly [{
+                readonly title: "Builtin";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "builtin";
+                    };
+                };
+            }, {
+                readonly title: "Global";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "global";
+                    };
+                };
+            }, {
+                readonly title: "Context";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "contextId"];
+                readonly properties: {
+                    readonly type: {
+                        readonly const: "context";
+                    };
+                    readonly contextId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+            }];
+        };
+        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 DidTemplate: {
+            readonly title: "DidTemplate";
+            readonly description: "Authored template shape: a DID document with `{TOKEN}` placeholders plus the variable contract the VTA's renderer enforces.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["schemaVersion", "name", "kind", "document"];
+            readonly properties: {
+                readonly schemaVersion: {
+                    readonly type: "integer";
+                    readonly const: 1;
+                    readonly description: "Template schema version. Currently always 1.";
+                };
+                readonly name: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly pattern: "^[a-z0-9-]+$";
+                    readonly description: "Template id within its scope. Lowercase alphanumeric and hyphen only.";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Classification hint, e.g. `mediator`, `did-host-http`, `app`. Drives downstream provisioning behaviour.";
+                };
+                readonly description: {
+                    readonly type: readonly ["string", "null"];
+                    readonly description: "Human-readable description of what the template provisions.";
+                };
+                readonly methods: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "DID methods this template targets, e.g. [\"webvh\", \"web\"] for a hosted DID or [\"key\"] for a did:key.";
+                };
+                readonly requiredVars: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Variables the caller MUST supply at render time. MUST NOT include reserved ambient names (DID, SIGNING_KEY_MB, KA_KEY_MB, VTA_DID, VTA_URL, CONTEXT_ID, CONTEXT_DID, NOW).";
+                };
+                readonly optionalVars: {
+                    readonly type: "object";
+                    readonly description: "Variables with default values, keyed by variable name.";
+                    readonly additionalProperties: true;
+                };
+                readonly defaults: {
+                    readonly type: "object";
+                    readonly description: "Hints for CLI / setup wizards (e.g. preRotationCount, portable, addMediatorService).";
+                    readonly additionalProperties: true;
+                };
+                readonly document: {
+                    readonly type: "object";
+                    readonly description: "The DID document body with `{TOKEN}` placeholders. `document.id` MUST contain the `{DID}` placeholder. Every `{TOKEN}` MUST be declared in requiredVars/optionalVars or be a reserved ambient name.";
+                };
+            };
+        };
+    };
+};
 /**
  * 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.
+ * 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/vta/did-templates/update/2.0";
     readonly isBearer: false;
     readonly isProofRequired: true;
     readonly isRecipientRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vta/did-templates/update/2.0";
+        readonly title: "VTA DID-Template Update — payload";
+        readonly description: "Replace an existing DID template on a VTA. Omit `contextId` to replace in the global scope (super-admin gated); set it to replace a template scoped to that context (gated on the context's admin, or a super-admin). The `name` is the resource id within the selected scope and MUST equal `template.name`; the VTA replaces the stored body, preserving createdAt/createdBy and advancing updatedAt. The success response is the persisted DidTemplateRecord.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["name", "template"];
+        readonly properties: {
+            readonly contextId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Scope selector. Absent: the global scope, gated on a super-administrator. Present: the context the template is scoped to, gated on that context's administrator (or a super-administrator).";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Resource id — the template's name within the selected scope. MUST equal `template.name` or the VTA rejects with the framework's `malformedRequest`.";
+            };
+            readonly template: {
+                readonly $ref: "#/$defs/DidTemplate";
+                readonly description: "Full replacement template document. Validated against the v1 template schema before persistence; an invalid shape is rejected with the framework's `malformedRequest`.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+                readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTA DID-Template Update — response payload";
+                readonly description: "The persisted DidTemplateRecord after replacement. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata (createdAt/createdBy preserved, updatedAt advanced). Same shape returned by create/get.";
+                readonly $ref: "#/$defs/DidTemplateRecord";
+            };
+            readonly DidTemplateRecord: {
+                readonly title: "DidTemplateRecord";
+                readonly description: "A persisted template. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by get/create/update and carried per-item by list.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["schemaVersion", "name", "kind", "document", "scope", "createdAt", "updatedAt", "createdBy"];
+                readonly properties: {
+                    readonly schemaVersion: {
+                        readonly type: "integer";
+                        readonly const: 1;
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly pattern: "^[a-z0-9-]+$";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly methods: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly requiredVars: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly optionalVars: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                    readonly defaults: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                    readonly document: {
+                        readonly type: "object";
+                    };
+                    readonly scope: {
+                        readonly $ref: "#/$defs/Scope";
+                        readonly description: "Resolved scope of the stored template.";
+                    };
+                    readonly createdAt: {
+                        readonly type: "integer";
+                        readonly description: "UTC unix-epoch seconds the template was first stored.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "integer";
+                        readonly description: "UTC unix-epoch seconds of the last write.";
+                    };
+                    readonly createdBy: {
+                        readonly type: "string";
+                        readonly description: "DID of the admin who last wrote the template.";
+                    };
+                };
+            };
+            readonly Scope: {
+                readonly title: "Scope";
+                readonly description: "Where a stored template lives. Tagged by `type`.";
+                readonly type: "object";
+                readonly oneOf: readonly [{
+                    readonly title: "Builtin";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "builtin";
+                        };
+                    };
+                }, {
+                    readonly title: "Global";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "global";
+                        };
+                    };
+                }, {
+                    readonly title: "Context";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type", "contextId"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "context";
+                        };
+                        readonly contextId: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                }];
+            };
+            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 DidTemplate: {
+                readonly title: "DidTemplate";
+                readonly description: "Authored template shape: a DID document with `{TOKEN}` placeholders plus the variable contract the VTA's renderer enforces.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["schemaVersion", "name", "kind", "document"];
+                readonly properties: {
+                    readonly schemaVersion: {
+                        readonly type: "integer";
+                        readonly const: 1;
+                        readonly description: "Template schema version. Currently always 1.";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly pattern: "^[a-z0-9-]+$";
+                        readonly description: "Template id within its scope. Lowercase alphanumeric and hyphen only.";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "Classification hint, e.g. `mediator`, `did-host-http`, `app`. Drives downstream provisioning behaviour.";
+                    };
+                    readonly description: {
+                        readonly type: readonly ["string", "null"];
+                        readonly description: "Human-readable description of what the template provisions.";
+                    };
+                    readonly methods: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "DID methods this template targets, e.g. [\"webvh\", \"web\"] for a hosted DID or [\"key\"] for a did:key.";
+                    };
+                    readonly requiredVars: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Variables the caller MUST supply at render time. MUST NOT include reserved ambient names (DID, SIGNING_KEY_MB, KA_KEY_MB, VTA_DID, VTA_URL, CONTEXT_ID, CONTEXT_DID, NOW).";
+                    };
+                    readonly optionalVars: {
+                        readonly type: "object";
+                        readonly description: "Variables with default values, keyed by variable name.";
+                        readonly additionalProperties: true;
+                    };
+                    readonly defaults: {
+                        readonly type: "object";
+                        readonly description: "Hints for CLI / setup wizards (e.g. preRotationCount, portable, addMediatorService).";
+                        readonly additionalProperties: true;
+                    };
+                    readonly document: {
+                        readonly type: "object";
+                        readonly description: "The DID document body with `{TOKEN}` placeholders. `document.id` MUST contain the `{DID}` placeholder. Every `{TOKEN}` MUST be declared in requiredVars/optionalVars or be a reserved ambient name.";
+                    };
+                };
+            };
+        };
+    };
 };
 /**
  * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
@@ -142,5 +758,190 @@ export declare const RESPONSE_SPEC: {
     readonly isBearer: false;
     readonly isProofRequired: true;
     readonly isRecipientRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTA DID-Template Update — response payload";
+                readonly description: "The persisted DidTemplateRecord after replacement. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata (createdAt/createdBy preserved, updatedAt advanced). Same shape returned by create/get.";
+                readonly $ref: "#/$defs/DidTemplateRecord";
+            };
+            readonly DidTemplateRecord: {
+                readonly title: "DidTemplateRecord";
+                readonly description: "A persisted template. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by get/create/update and carried per-item by list.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["schemaVersion", "name", "kind", "document", "scope", "createdAt", "updatedAt", "createdBy"];
+                readonly properties: {
+                    readonly schemaVersion: {
+                        readonly type: "integer";
+                        readonly const: 1;
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly pattern: "^[a-z0-9-]+$";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly methods: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly requiredVars: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly optionalVars: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                    readonly defaults: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                    readonly document: {
+                        readonly type: "object";
+                    };
+                    readonly scope: {
+                        readonly $ref: "#/$defs/Scope";
+                        readonly description: "Resolved scope of the stored template.";
+                    };
+                    readonly createdAt: {
+                        readonly type: "integer";
+                        readonly description: "UTC unix-epoch seconds the template was first stored.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "integer";
+                        readonly description: "UTC unix-epoch seconds of the last write.";
+                    };
+                    readonly createdBy: {
+                        readonly type: "string";
+                        readonly description: "DID of the admin who last wrote the template.";
+                    };
+                };
+            };
+            readonly Scope: {
+                readonly title: "Scope";
+                readonly description: "Where a stored template lives. Tagged by `type`.";
+                readonly type: "object";
+                readonly oneOf: readonly [{
+                    readonly title: "Builtin";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "builtin";
+                        };
+                    };
+                }, {
+                    readonly title: "Global";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "global";
+                        };
+                    };
+                }, {
+                    readonly title: "Context";
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["type", "contextId"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly const: "context";
+                        };
+                        readonly contextId: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                }];
+            };
+            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 DidTemplate: {
+                readonly title: "DidTemplate";
+                readonly description: "Authored template shape: a DID document with `{TOKEN}` placeholders plus the variable contract the VTA's renderer enforces.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["schemaVersion", "name", "kind", "document"];
+                readonly properties: {
+                    readonly schemaVersion: {
+                        readonly type: "integer";
+                        readonly const: 1;
+                        readonly description: "Template schema version. Currently always 1.";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly pattern: "^[a-z0-9-]+$";
+                        readonly description: "Template id within its scope. Lowercase alphanumeric and hyphen only.";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly description: "Classification hint, e.g. `mediator`, `did-host-http`, `app`. Drives downstream provisioning behaviour.";
+                    };
+                    readonly description: {
+                        readonly type: readonly ["string", "null"];
+                        readonly description: "Human-readable description of what the template provisions.";
+                    };
+                    readonly methods: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "DID methods this template targets, e.g. [\"webvh\", \"web\"] for a hosted DID or [\"key\"] for a did:key.";
+                    };
+                    readonly requiredVars: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Variables the caller MUST supply at render time. MUST NOT include reserved ambient names (DID, SIGNING_KEY_MB, KA_KEY_MB, VTA_DID, VTA_URL, CONTEXT_ID, CONTEXT_DID, NOW).";
+                    };
+                    readonly optionalVars: {
+                        readonly type: "object";
+                        readonly description: "Variables with default values, keyed by variable name.";
+                        readonly additionalProperties: true;
+                    };
+                    readonly defaults: {
+                        readonly type: "object";
+                        readonly description: "Hints for CLI / setup wizards (e.g. preRotationCount, portable, addMediatorService).";
+                        readonly additionalProperties: true;
+                    };
+                    readonly document: {
+                        readonly type: "object";
+                        readonly description: "The DID document body with `{TOKEN}` placeholders. `document.id` MUST contain the `{DID}` placeholder. Every `{TOKEN}` MUST be declared in requiredVars/optionalVars or be a reserved ambient name.";
+                    };
+                };
+            };
+        };
+    };
 };
 //# sourceMappingURL=payload.d.ts.map