@openvtc/trust-tasks 0.12.1 → 0.12.2

package/dist/vta/app-state/put-many/1.0/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../src/vta/app-state/put-many/1.0/payload.ts"],"names":[],"mappings":"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"}

package/dist/vta/app-state/put-many/1.0/payload.js

@@ -0,0 +1,455 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vta/app-state/put-many/1.0/payload.schema.json
+ */
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/vta/app-state/put-many/1.0";
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vta/app-state/put-many/1.0#response";
+/**
+ * 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 const PAYLOAD_SCHEMA = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://trusttasks.org/spec/vta/app-state/put-many/1.0",
+    "title": "VTA Application State Put-Many — payload",
+    "description": "Write up to 64 application-state records in one round trip, each carrying its own optimistic-concurrency precondition. The batch `mode` decides what a single failure costs: `independent` (the default) applies each write on its own merits, `atomic` applies all or none.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "contextId",
+        "namespace",
+        "writes"
+    ],
+    "properties": {
+        "contextId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The VTA context the records are scoped to; the isolation boundary."
+        },
+        "namespace": {
+            "$ref": "#/$defs/Namespace",
+            "description": "One namespace per batch. Atomicity is only meaningful within the counter the writes take their versions from, and that counter is per (contextId, namespace)."
+        },
+        "mode": {
+            "type": "string",
+            "enum": [
+                "independent",
+                "atomic"
+            ],
+            "default": "independent",
+            "description": "`independent` applies each write on its own merits, so one conflicted record does not block the other nine — what a flush of unrelated edits wants, and why it is the default. `atomic` applies all or none, for records carrying a joint invariant. An atomic DEFAULT would let one stale record silently wedge an entire flush, and a caller could not tell a wedged flush from a slow one.",
+            "$comment": "The default is load-bearing rather than a convenience; see the spec's Abstract."
+        },
+        "writes": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 64,
+            "items": {
+                "$ref": "#/$defs/Write"
+            },
+            "description": "The writes to apply. Keys MUST be distinct: two writes to one key in a batch have no defined order and are refused rather than serialised."
+        },
+        "ext": {
+            "$ref": "#/$defs/Ext",
+            "description": "Ecosystem-defined extension members per SPEC.md §4.5.1."
+        }
+    },
+    "$defs": {
+        "Write": {
+            "title": "Write",
+            "description": "One write within the batch. Shaped exactly like a vta/app-state/put payload minus the context and namespace, which the batch supplies.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "key"
+            ],
+            "oneOf": [
+                {
+                    "required": [
+                        "value"
+                    ],
+                    "not": {
+                        "required": [
+                            "mergePatch"
+                        ]
+                    }
+                },
+                {
+                    "required": [
+                        "mergePatch"
+                    ],
+                    "not": {
+                        "required": [
+                            "value"
+                        ]
+                    }
+                }
+            ],
+            "properties": {
+                "key": {
+                    "$ref": "#/$defs/Key"
+                },
+                "value": {
+                    "description": "The complete new value, replacing whatever the record held. Any JSON value, including `null`. Mutually exclusive with `mergePatch`."
+                },
+                "mergePatch": {
+                    "type": "object",
+                    "description": "An RFC 7386 JSON Merge Patch applied to the record's current value. Requires a live record at the address; otherwise this write's outcome is `notFound`. Mutually exclusive with `value`."
+                },
+                "expectedVersion": {
+                    "$ref": "#/$defs/ExpectedVersion",
+                    "description": "This write's own precondition, evaluated independently of every other write in the batch. A positive value requires the record to be at exactly that version; 0 requires that no live record exists."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "VTA Application State Put-Many — response payload",
+            "description": "Success response to vta/app-state/put-many in `independent` mode. Type https://trusttasks.org/spec/vta/app-state/put-many/1.0#response. A response is returned even when some writes conflicted, because the task did what it promised — applied each write on its own merits — and the per-record outcomes are the answer rather than the failure. An `atomic` batch that does not apply is a trust-task-error carrying vta/app-state/put-many:atomicBatchRejected, whose details carry the same per-record outcomes.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "mode",
+                "results"
+            ],
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "enum": [
+                        "independent",
+                        "atomic"
+                    ],
+                    "description": "The mode the maintainer applied, echoed so a caller relying on the default sees what it got."
+                },
+                "results": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "items": {
+                        "$ref": "#/$defs/WriteResult"
+                    },
+                    "description": "One result per requested write, in request order. Every write is accounted for."
+                },
+                "highWatermark": {
+                    "$ref": "#/$defs/Version",
+                    "description": "The namespace's counter value after the batch. A writer that is also a sync consumer can adopt this instead of issuing a list call to discover where its own writes landed."
+                },
+                "ext": {
+                    "$ref": "#/$defs/Ext",
+                    "description": "Ecosystem-defined extension members per SPEC.md §4.5.1."
+                }
+            }
+        },
+        "Ext": {
+            "title": "Ext",
+            "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.",
+            "type": "object",
+            "minProperties": 1,
+            "additionalProperties": true,
+            "propertyNames": {
+                "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+            }
+        },
+        "Version": {
+            "title": "Version",
+            "description": "A value of the namespace's monotonic write counter (see this schema's description). Server-assigned; a producer never chooses one.",
+            "type": "integer",
+            "minimum": 1
+        },
+        "WriteResult": {
+            "title": "WriteResult",
+            "description": "The outcome of one write within a `vta/app-state/put-many` batch. Per-record rather than per-batch, because the default batch mode applies each write on its own merits: a caller flushing ten unrelated edits needs to know which one conflicted, not merely that something did.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "key",
+                "outcome"
+            ],
+            "properties": {
+                "key": {
+                    "$ref": "#/$defs/Key"
+                },
+                "outcome": {
+                    "type": "string",
+                    "enum": [
+                        "written",
+                        "conflict",
+                        "tooLarge",
+                        "notFound",
+                        "skipped"
+                    ],
+                    "description": "`written`: applied, and `version` carries the new value. `conflict`: `expectedVersion` did not match; `currentVersion`, `currentValue` and `currentDeleted` carry the maintainer's view so the caller can resolve without a re-read. `tooLarge`: the value exceeded the per-record cap; `limitBytes` and `actualBytes` say by how much. `notFound`: a `mergePatch` write named an address with no live record. `skipped`: atomic mode only — this write was not attempted because another in the batch failed."
+                },
+                "version": {
+                    "$ref": "#/$defs/Version",
+                    "description": "The new version, on `written`."
+                },
+                "created": {
+                    "type": "boolean",
+                    "description": "On `written`: true when no live record existed at the address beforehand."
+                },
+                "currentVersion": {
+                    "$ref": "#/$defs/Version",
+                    "description": "On `conflict`: the version the maintainer actually holds. Absent when the conflict is that no record exists (`expectedVersion` was positive and the address is empty)."
+                },
+                "currentValue": {
+                    "description": "On `conflict`: the value the maintainer actually holds, returned WITH the rejection rather than left for the caller to re-read. A bare rejection has no fixed point under contention — between the rejection and the re-read the record can change again — so returning the winner's view removes the race rather than narrowing it. Absent when `currentDeleted` is true or no record exists."
+                },
+                "currentDeleted": {
+                    "type": "boolean",
+                    "description": "On `conflict`: true when the address holds a tombstone rather than a live record."
+                },
+                "limitBytes": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "On `tooLarge`: the maintainer's per-record cap in bytes."
+                },
+                "actualBytes": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "On `tooLarge`: the size of the rejected value in bytes."
+                }
+            }
+        },
+        "Key": {
+            "title": "Key",
+            "description": "Application-chosen identifier for a record within a namespace. Opaque to the maintainer: it MUST NOT be parsed, normalized, or case-folded, and prefix matching in `list` is a byte-prefix comparison over the UTF-8 encoding. Applications SHOULD use `/`-delimited hierarchical keys (`community/acme`, `contact/z6Mk…`) so that `prefix` can address a record family, but the delimiter is a convention between an application and itself — the maintainer attaches no meaning to it.",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512,
+            "pattern": "^[^\\u0000]+$"
+        },
+        "ExpectedVersion": {
+            "title": "ExpectedVersion",
+            "description": "Optimistic-concurrency precondition on a write. A positive value requires that the record's current `version` equals it exactly. Zero means \"create only\" — the write applies only if no LIVE record exists at the address, which is what makes lease acquisition safe: without it two instances can each read \"absent\", each write, and each believe it won. A tombstone is not a live record, so `expectedVersion: 0` succeeds over one; the created record takes the namespace's next counter value, which is necessarily greater than the tombstone's.",
+            "type": "integer",
+            "minimum": 0
+        },
+        "Namespace": {
+            "title": "Namespace",
+            "description": "Scopes one application's records within a context, so several tools can share a context without colliding — `openvtc`, `cnm`, an agent runtime. The maintainer MUST NOT interpret the value; it is an opaque partition name. Namespaces are first-come and unreserved, so an application SHOULD pick a stable, specific one: a future per-namespace ACL would grant on this exact string, which makes renaming a namespace a migration rather than an edit.",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+        }
+    }
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export const RESPONSE_PAYLOAD_SCHEMA = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$ref": "#/$defs/Response",
+    "$defs": {
+        "Write": {
+            "title": "Write",
+            "description": "One write within the batch. Shaped exactly like a vta/app-state/put payload minus the context and namespace, which the batch supplies.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "key"
+            ],
+            "oneOf": [
+                {
+                    "required": [
+                        "value"
+                    ],
+                    "not": {
+                        "required": [
+                            "mergePatch"
+                        ]
+                    }
+                },
+                {
+                    "required": [
+                        "mergePatch"
+                    ],
+                    "not": {
+                        "required": [
+                            "value"
+                        ]
+                    }
+                }
+            ],
+            "properties": {
+                "key": {
+                    "$ref": "#/$defs/Key"
+                },
+                "value": {
+                    "description": "The complete new value, replacing whatever the record held. Any JSON value, including `null`. Mutually exclusive with `mergePatch`."
+                },
+                "mergePatch": {
+                    "type": "object",
+                    "description": "An RFC 7386 JSON Merge Patch applied to the record's current value. Requires a live record at the address; otherwise this write's outcome is `notFound`. Mutually exclusive with `value`."
+                },
+                "expectedVersion": {
+                    "$ref": "#/$defs/ExpectedVersion",
+                    "description": "This write's own precondition, evaluated independently of every other write in the batch. A positive value requires the record to be at exactly that version; 0 requires that no live record exists."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "VTA Application State Put-Many — response payload",
+            "description": "Success response to vta/app-state/put-many in `independent` mode. Type https://trusttasks.org/spec/vta/app-state/put-many/1.0#response. A response is returned even when some writes conflicted, because the task did what it promised — applied each write on its own merits — and the per-record outcomes are the answer rather than the failure. An `atomic` batch that does not apply is a trust-task-error carrying vta/app-state/put-many:atomicBatchRejected, whose details carry the same per-record outcomes.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "mode",
+                "results"
+            ],
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "enum": [
+                        "independent",
+                        "atomic"
+                    ],
+                    "description": "The mode the maintainer applied, echoed so a caller relying on the default sees what it got."
+                },
+                "results": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "items": {
+                        "$ref": "#/$defs/WriteResult"
+                    },
+                    "description": "One result per requested write, in request order. Every write is accounted for."
+                },
+                "highWatermark": {
+                    "$ref": "#/$defs/Version",
+                    "description": "The namespace's counter value after the batch. A writer that is also a sync consumer can adopt this instead of issuing a list call to discover where its own writes landed."
+                },
+                "ext": {
+                    "$ref": "#/$defs/Ext",
+                    "description": "Ecosystem-defined extension members per SPEC.md §4.5.1."
+                }
+            }
+        },
+        "Ext": {
+            "title": "Ext",
+            "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.",
+            "type": "object",
+            "minProperties": 1,
+            "additionalProperties": true,
+            "propertyNames": {
+                "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+            }
+        },
+        "Version": {
+            "title": "Version",
+            "description": "A value of the namespace's monotonic write counter (see this schema's description). Server-assigned; a producer never chooses one.",
+            "type": "integer",
+            "minimum": 1
+        },
+        "WriteResult": {
+            "title": "WriteResult",
+            "description": "The outcome of one write within a `vta/app-state/put-many` batch. Per-record rather than per-batch, because the default batch mode applies each write on its own merits: a caller flushing ten unrelated edits needs to know which one conflicted, not merely that something did.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "key",
+                "outcome"
+            ],
+            "properties": {
+                "key": {
+                    "$ref": "#/$defs/Key"
+                },
+                "outcome": {
+                    "type": "string",
+                    "enum": [
+                        "written",
+                        "conflict",
+                        "tooLarge",
+                        "notFound",
+                        "skipped"
+                    ],
+                    "description": "`written`: applied, and `version` carries the new value. `conflict`: `expectedVersion` did not match; `currentVersion`, `currentValue` and `currentDeleted` carry the maintainer's view so the caller can resolve without a re-read. `tooLarge`: the value exceeded the per-record cap; `limitBytes` and `actualBytes` say by how much. `notFound`: a `mergePatch` write named an address with no live record. `skipped`: atomic mode only — this write was not attempted because another in the batch failed."
+                },
+                "version": {
+                    "$ref": "#/$defs/Version",
+                    "description": "The new version, on `written`."
+                },
+                "created": {
+                    "type": "boolean",
+                    "description": "On `written`: true when no live record existed at the address beforehand."
+                },
+                "currentVersion": {
+                    "$ref": "#/$defs/Version",
+                    "description": "On `conflict`: the version the maintainer actually holds. Absent when the conflict is that no record exists (`expectedVersion` was positive and the address is empty)."
+                },
+                "currentValue": {
+                    "description": "On `conflict`: the value the maintainer actually holds, returned WITH the rejection rather than left for the caller to re-read. A bare rejection has no fixed point under contention — between the rejection and the re-read the record can change again — so returning the winner's view removes the race rather than narrowing it. Absent when `currentDeleted` is true or no record exists."
+                },
+                "currentDeleted": {
+                    "type": "boolean",
+                    "description": "On `conflict`: true when the address holds a tombstone rather than a live record."
+                },
+                "limitBytes": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "On `tooLarge`: the maintainer's per-record cap in bytes."
+                },
+                "actualBytes": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "On `tooLarge`: the size of the rejected value in bytes."
+                }
+            }
+        },
+        "Key": {
+            "title": "Key",
+            "description": "Application-chosen identifier for a record within a namespace. Opaque to the maintainer: it MUST NOT be parsed, normalized, or case-folded, and prefix matching in `list` is a byte-prefix comparison over the UTF-8 encoding. Applications SHOULD use `/`-delimited hierarchical keys (`community/acme`, `contact/z6Mk…`) so that `prefix` can address a record family, but the delimiter is a convention between an application and itself — the maintainer attaches no meaning to it.",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512,
+            "pattern": "^[^\\u0000]+$"
+        },
+        "ExpectedVersion": {
+            "title": "ExpectedVersion",
+            "description": "Optimistic-concurrency precondition on a write. A positive value requires that the record's current `version` equals it exactly. Zero means \"create only\" — the write applies only if no LIVE record exists at the address, which is what makes lease acquisition safe: without it two instances can each read \"absent\", each write, and each believe it won. A tombstone is not a live record, so `expectedVersion: 0` succeeds over one; the created record takes the namespace's next counter value, which is necessarily greater than the tombstone's.",
+            "type": "integer",
+            "minimum": 0
+        },
+        "Namespace": {
+            "title": "Namespace",
+            "description": "Scopes one application's records within a context, so several tools can share a context without colliding — `openvtc`, `cnm`, an agent runtime. The maintainer MUST NOT interpret the value; it is an opaque partition name. Namespaces are first-come and unreserved, so an application SHOULD pick a stable, specific one: a future per-namespace ACL would grant on this exact string, which makes renaming a namespace a migration rather than an edit.",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+        }
+    }
+};
+/**
+ * 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 const SPEC = {
+    typeUri: TYPE_URI,
+    isBearer: false,
+    isProofRequired: true,
+    isRecipientRequired: true,
+    payloadSchema: PAYLOAD_SCHEMA,
+};
+/**
+ * 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 const RESPONSE_SPEC = {
+    typeUri: RESPONSE_TYPE_URI,
+    isBearer: false,
+    isProofRequired: true,
+    isRecipientRequired: true,
+    payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
+};
+//# sourceMappingURL=payload.js.map

package/dist/vta/app-state/put-many/1.0/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../../src/vta/app-state/put-many/1.0/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwHH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,wDAAiE,CAAC;AAK1F,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,iEAA0E,CAAC;AAK5G;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,8CAA8C;IACzD,KAAK,EAAE,wDAAwD;IAC/D,OAAO,EAAE,0CAA0C;IACnD,aAAa,EAAE,8QAA8Q;IAC7R,MAAM,EAAE,QAAQ;IAChB,sBAAsB,EAAE,KAAK;IAC7B,UAAU,EAAE;QACV,WAAW;QACX,WAAW;QACX,QAAQ;KACT;IACD,YAAY,EAAE;QACZ,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,oEAAoE;SACpF;QACD,WAAW,EAAE;YACX,MAAM,EAAE,mBAAmB;YAC3B,aAAa,EAAE,+JAA+J;SAC/K;QACD,MAAM,EAAE;YACN,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE;gBACN,aAAa;gBACb,QAAQ;aACT;YACD,SAAS,EAAE,aAAa;YACxB,aAAa,EAAE,+XAA+X;YAC9Y,UAAU,EAAE,iFAAiF;SAC9F;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,EAAE;YACd,OAAO,EAAE;gBACP,MAAM,EAAE,eAAe;aACxB;YACD,aAAa,EAAE,4IAA4I;SAC5J;QACD,KAAK,EAAE;YACL,MAAM,EAAE,aAAa;YACrB,aAAa,EAAE,yDAAyD;SACzE;KACF;IACD,OAAO,EAAE;QACP,OAAO,EAAE;YACP,OAAO,EAAE,OAAO;YAChB,aAAa,EAAE,wIAAwI;YACvJ,MAAM,EAAE,QAAQ;YAChB,sBAAsB,EAAE,KAAK;YAC7B,UAAU,EAAE;gBACV,KAAK;aACN;YACD,OAAO,EAAE;gBACP;oBACE,UAAU,EAAE;wBACV,OAAO;qBACR;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,YAAY;yBACb;qBACF;iBACF;gBACD;oBACE,UAAU,EAAE;wBACV,YAAY;qBACb;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,OAAO;yBACR;qBACF;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,KAAK,EAAE;oBACL,MAAM,EAAE,aAAa;iBACtB;gBACD,OAAO,EAAE;oBACP,aAAa,EAAE,qIAAqI;iBACrJ;gBACD,YAAY,EAAE;oBACZ,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,2LAA2L;iBAC3M;gBACD,iBAAiB,EAAE;oBACjB,MAAM,EAAE,yBAAyB;oBACjC,aAAa,EAAE,sMAAsM;iBACtN;aACF;SACF;QACD,UAAU,EAAE;YACV,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,mDAAmD;YAC5D,aAAa,EAAE,wfAAwf;YACvgB,MAAM,EAAE,QAAQ;YAChB,sBAAsB,EAAE,KAAK;YAC7B,UAAU,EAAE;gBACV,MAAM;gBACN,SAAS;aACV;YACD,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE;wBACN,aAAa;wBACb,QAAQ;qBACT;oBACD,aAAa,EAAE,8FAA8F;iBAC9G;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,UAAU,EAAE,EAAE;oBACd,OAAO,EAAE;wBACP,MAAM,EAAE,qBAAqB;qBAC9B;oBACD,aAAa,EAAE,iFAAiF;iBACjG;gBACD,eAAe,EAAE;oBACf,MAAM,EAAE,iBAAiB;oBACzB,aAAa,EAAE,6KAA6K;iBAC7L;gBACD,KAAK,EAAE;oBACL,MAAM,EAAE,aAAa;oBACrB,aAAa,EAAE,yDAAyD;iBACzE;aACF;SACF;QACD,KAAK,EAAE;YACL,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,uKAAuK;YACtL,MAAM,EAAE,QAAQ;YAChB,eAAe,EAAE,CAAC;YAClB,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE;gBACf,SAAS,EAAE,mCAAmC;aAC/C;SACF;QACD,SAAS,EAAE;YACT,OAAO,EAAE,SAAS;YAClB,aAAa,EAAE,oIAAoI;YACnJ,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,CAAC;SACb;QACD,aAAa,EAAE;YACb,OAAO,EAAE,aAAa;YACtB,aAAa,EAAE,mRAAmR;YAClS,MAAM,EAAE,QAAQ;YAChB,sBAAsB,EAAE,KAAK;YAC7B,UAAU,EAAE;gBACV,KAAK;gBACL,SAAS;aACV;YACD,YAAY,EAAE;gBACZ,KAAK,EAAE;oBACL,MAAM,EAAE,aAAa;iBACtB;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE;wBACN,SAAS;wBACT,UAAU;wBACV,UAAU;wBACV,UAAU;wBACV,SAAS;qBACV;oBACD,aAAa,EAAE,gfAAgf;iBAChgB;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,iBAAiB;oBACzB,aAAa,EAAE,gCAAgC;iBAChD;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,SAAS;oBACjB,aAAa,EAAE,2EAA2E;iBAC3F;gBACD,gBAAgB,EAAE;oBAChB,MAAM,EAAE,iBAAiB;oBACzB,aAAa,EAAE,wKAAwK;iBACxL;gBACD,cAAc,EAAE;oBACd,aAAa,EAAE,gYAAgY;iBAChZ;gBACD,gBAAgB,EAAE;oBAChB,MAAM,EAAE,SAAS;oBACjB,aAAa,EAAE,mFAAmF;iBACnG;gBACD,YAAY,EAAE;oBACZ,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,0DAA0D;iBAC1E;gBACD,aAAa,EAAE;oBACb,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,yDAAyD;iBACzE;aACF;SACF;QACD,KAAK,EAAE;YACL,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,0dAA0d;YACze,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,eAAe;SAC3B;QACD,iBAAiB,EAAE;YACjB,OAAO,EAAE,iBAAiB;YAC1B,aAAa,EAAE,giBAAgiB;YAC/iB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,CAAC;SACb;QACD,WAAW,EAAE;YACX,OAAO,EAAE,WAAW;YACpB,aAAa,EAAE,6bAA6b;YAC5c,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,+BAA+B;SAC3C;KACF;CACO,CAAC;AAEX,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,8CAA8C;IACzD,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE;QACP,OAAO,EAAE;YACP,OAAO,EAAE,OAAO;YAChB,aAAa,EAAE,wIAAwI;YACvJ,MAAM,EAAE,QAAQ;YAChB,sBAAsB,EAAE,KAAK;YAC7B,UAAU,EAAE;gBACV,KAAK;aACN;YACD,OAAO,EAAE;gBACP;oBACE,UAAU,EAAE;wBACV,OAAO;qBACR;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,YAAY;yBACb;qBACF;iBACF;gBACD;oBACE,UAAU,EAAE;wBACV,YAAY;qBACb;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,OAAO;yBACR;qBACF;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,KAAK,EAAE;oBACL,MAAM,EAAE,aAAa;iBACtB;gBACD,OAAO,EAAE;oBACP,aAAa,EAAE,qIAAqI;iBACrJ;gBACD,YAAY,EAAE;oBACZ,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,2LAA2L;iBAC3M;gBACD,iBAAiB,EAAE;oBACjB,MAAM,EAAE,yBAAyB;oBACjC,aAAa,EAAE,sMAAsM;iBACtN;aACF;SACF;QACD,UAAU,EAAE;YACV,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,mDAAmD;YAC5D,aAAa,EAAE,wfAAwf;YACvgB,MAAM,EAAE,QAAQ;YAChB,sBAAsB,EAAE,KAAK;YAC7B,UAAU,EAAE;gBACV,MAAM;gBACN,SAAS;aACV;YACD,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE;wBACN,aAAa;wBACb,QAAQ;qBACT;oBACD,aAAa,EAAE,8FAA8F;iBAC9G;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,UAAU,EAAE,EAAE;oBACd,OAAO,EAAE;wBACP,MAAM,EAAE,qBAAqB;qBAC9B;oBACD,aAAa,EAAE,iFAAiF;iBACjG;gBACD,eAAe,EAAE;oBACf,MAAM,EAAE,iBAAiB;oBACzB,aAAa,EAAE,6KAA6K;iBAC7L;gBACD,KAAK,EAAE;oBACL,MAAM,EAAE,aAAa;oBACrB,aAAa,EAAE,yDAAyD;iBACzE;aACF;SACF;QACD,KAAK,EAAE;YACL,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,uKAAuK;YACtL,MAAM,EAAE,QAAQ;YAChB,eAAe,EAAE,CAAC;YAClB,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE;gBACf,SAAS,EAAE,mCAAmC;aAC/C;SACF;QACD,SAAS,EAAE;YACT,OAAO,EAAE,SAAS;YAClB,aAAa,EAAE,oIAAoI;YACnJ,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,CAAC;SACb;QACD,aAAa,EAAE;YACb,OAAO,EAAE,aAAa;YACtB,aAAa,EAAE,mRAAmR;YAClS,MAAM,EAAE,QAAQ;YAChB,sBAAsB,EAAE,KAAK;YAC7B,UAAU,EAAE;gBACV,KAAK;gBACL,SAAS;aACV;YACD,YAAY,EAAE;gBACZ,KAAK,EAAE;oBACL,MAAM,EAAE,aAAa;iBACtB;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE;wBACN,SAAS;wBACT,UAAU;wBACV,UAAU;wBACV,UAAU;wBACV,SAAS;qBACV;oBACD,aAAa,EAAE,gfAAgf;iBAChgB;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,iBAAiB;oBACzB,aAAa,EAAE,gCAAgC;iBAChD;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,SAAS;oBACjB,aAAa,EAAE,2EAA2E;iBAC3F;gBACD,gBAAgB,EAAE;oBAChB,MAAM,EAAE,iBAAiB;oBACzB,aAAa,EAAE,wKAAwK;iBACxL;gBACD,cAAc,EAAE;oBACd,aAAa,EAAE,gYAAgY;iBAChZ;gBACD,gBAAgB,EAAE;oBAChB,MAAM,EAAE,SAAS;oBACjB,aAAa,EAAE,mFAAmF;iBACnG;gBACD,YAAY,EAAE;oBACZ,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,0DAA0D;iBAC1E;gBACD,aAAa,EAAE;oBACb,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,yDAAyD;iBACzE;aACF;SACF;QACD,KAAK,EAAE;YACL,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,0dAA0d;YACze,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,eAAe;SAC3B;QACD,iBAAiB,EAAE;YACjB,OAAO,EAAE,iBAAiB;YAC1B,aAAa,EAAE,giBAAgiB;YAC/iB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,CAAC;SACb;QACD,WAAW,EAAE;YACX,OAAO,EAAE,WAAW;YACpB,aAAa,EAAE,6bAA6b;YAC5c,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,+BAA+B;SAC3C;KACF;CACO,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,KAAK;IACf,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,IAAI;IACzB,aAAa,EAAE,cAAc;CACrB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,KAAK;IACf,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,IAAI;IACzB,aAAa,EAAE,uBAAuB;CAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvtc/trust-tasks",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "description": "Generated TypeScript bindings for the Trust Tasks framework registry.",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -251,11 +251,18 @@ export * as VaultUsage_v0_1 from "./vault/usage/0.1/payload.js";
 export * as VaultUsage_v0_2 from "./vault/usage/0.2/payload.js";
 export * as VrcRelationshipsIssue_v0_1 from "./vrc/relationships/issue/0.1/payload.js";
 export * as VrcRelationshipsPropose_v0_1 from "./vrc/relationships/propose/0.1/payload.js";
+export * as AppStateRecordShared_v0_1 from "./vta/_shared/0.1/app-state-record.js";
 export * as ContextShared_v0_1 from "./vta/_shared/0.1/context.js";
 export * as DidTemplateShared_v0_1 from "./vta/_shared/0.1/did-template.js";
 export * as PasskeyVmShared_v0_1 from "./vta/_shared/0.1/passkey-vm.js";
 export * as ServiceShared_v0_1 from "./vta/_shared/0.1/service.js";
 export * as WebvhRecordsShared_v0_1 from "./vta/_shared/0.1/webvh-records.js";
+export * as VtaAppStateDelete_v1_0 from "./vta/app-state/delete/1.0/payload.js";
+export * as VtaAppStateGetMany_v1_0 from "./vta/app-state/get-many/1.0/payload.js";
+export * as VtaAppStateGet_v1_0 from "./vta/app-state/get/1.0/payload.js";
+export * as VtaAppStateList_v1_0 from "./vta/app-state/list/1.0/payload.js";
+export * as VtaAppStatePutMany_v1_0 from "./vta/app-state/put-many/1.0/payload.js";
+export * as VtaAppStatePut_v1_0 from "./vta/app-state/put/1.0/payload.js";
 export * as VtaContextsCreate_v1_0 from "./vta/contexts/create/1.0/payload.js";
 export * as VtaContextsDelete_v1_0 from "./vta/contexts/delete/1.0/payload.js";
 export * as VtaContextsDidTemplatesCreate_v1_0 from "./vta/contexts/did-templates/create/1.0/payload.js";

package/src/vta/_shared/0.1/app-state-record.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vta/_shared/0.1/app-state-record.schema.json
+ */
+
+/**
+ * Application state is versioned, namespaced JSON that an application owns and the VTA stores without interpreting. A record is addressed by the triple `(contextId, namespace, key)`; `AppStateRecord` is the shape every task in the family hands back, defined once here because `get`, `list`, `get-many` and the conflict details of `put` and `put-many` all return the same record and an inline copy per task would fork the moment one of them gained a member.
+ *
+ * The store is deliberately schema-agnostic: `value` is any JSON, and the maintainer never validates, migrates, or interprets it. It is also deliberately NOT a secret store — the vault (`vault/*`) is where secret material belongs, and a maintainer SHOULD surface application state in operator tooling on that understanding.
+ *
+ * The version counter is the family's load-bearing invariant and is described once, here. `version` is a monotonically increasing integer maintained per `(contextId, namespace)` pair, NOT per record: every write in a namespace takes the next value of that namespace's counter, and a record's `version` is the counter value its most recent write took. One number therefore serves two purposes that would otherwise need two — it is the optimistic-concurrency token `expectedVersion` is compared against, and it is the watermark `sinceVersion` is compared against. A per-record counter could do the first but not the second, because two records' counters are not comparable to each other and so no single number can mean "everything changed after this point". Consumers MUST treat version numbers as opaque and monotonic: a record's version can jump by any amount between two writes, because writes to its neighbours consumed the intervening values.
+ *
+ * Timestamp invariants (SHOULD-level, prose — not expressible in JSON Schema): when `createdAt` is present, `updatedAt >= createdAt`; when `deletedAt` is present, `deleted` is true and `deletedAt >= createdAt`. Consumers SHOULD reject documents that violate either.
+ */
+export interface AppStateRecordSharedDefinitionForTheVtaAppStateSpecFamily {
+  [k: string]: unknown | undefined;
+}