@openvtc/trust-tasks 0.21.9 → 0.21.11

package/dist/trust-task-discovery/0.3/payload.js

@@ -0,0 +1,242 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/trust-task-discovery/0.3/payload.schema.json
+ */
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/trust-task-discovery/0.3";
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/trust-task-discovery/0.3#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/trust-task-discovery/0.3",
+    "title": "Trust Task Discovery — payload",
+    "description": "Request payload for the framework-defined trust-task-discovery exchange. Carries zero or more slug-glob patterns the discoverer wants the responder to filter against. The response payload schema is reachable via $anchor: 'response'.",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "patterns": {
+            "type": "array",
+            "maxItems": 16,
+            "items": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Slug-glob pattern. Matches: '*' (every slug); '<prefix>/*' (any slug starting with '<prefix>/' — e.g. 'acl/*' matches 'acl/grant', 'acl/revoke', 'acl/grant/sub'); otherwise an exact slug match. Wildcards anywhere other than as a trailing segment are not interpreted — the only sigils are the trailing '/*' and the bare '*'."
+            },
+            "description": "Patterns are ORed: a slug matches the query if at least one pattern matches it. If the array is omitted or empty, the responder MUST treat the query as ['*'] — return every supported task. Bounded at 16 entries as parser hardening (SPEC.md §12.2), not as a capability limit: matching an unbounded pattern list against every published slug is work a responder does on an unauthenticated request, and a discoverer wanting more asks for '*' and filters locally."
+        }
+    },
+    "$defs": {
+        "AcceptanceWindow": {
+            "title": "Acceptance window",
+            "description": "The freshness bounds a responder applies, as a consumer, to the `issuedAt` of a document it receives (SPEC.md §7.2 item 13). A responder refuses a document when now > issuedAt + maxAgeSeconds + clockSkewSeconds, and when issuedAt > now + clockSkewSeconds. It says nothing about `expiresAt`, which is honoured independently (SPEC.md §7.2 item 4). Both members are whole seconds.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "maxAgeSeconds",
+                "clockSkewSeconds"
+            ],
+            "properties": {
+                "maxAgeSeconds": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "The greatest age, in whole seconds, of a document's `issuedAt` at which the responder still accepts the document, before any clock-skew tolerance is applied."
+                },
+                "clockSkewSeconds": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "The clock-skew tolerance, in whole seconds, the responder applies in both directions: added to maxAgeSeconds for a document in its past, and allowed for an `issuedAt` in its future (SPEC.md §4.2, §7.2 item 13). Zero when it applies none."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "Trust Task Discovery — response payload",
+            "description": "List of bare Type URIs the responding party supports. Carried in a Trust Task document whose type is https://trusttasks.org/spec/trust-task-discovery/0.3#response. A response-level `acceptanceWindow` is the window the responder applies to every listed Type URI whose entry carries none of its own. Where neither is present for an entry, the discoverer has learnt nothing about that entry's window and MUST NOT read the absence as the absence of a window.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "supportedTypes"
+            ],
+            "properties": {
+                "supportedTypes": {
+                    "type": "array",
+                    "items": {
+                        "oneOf": [
+                            {
+                                "type": "string",
+                                "format": "uri",
+                                "description": "Shorthand form: a bare Type URI string. Equivalent to an object with only the `type` member set."
+                            },
+                            {
+                                "type": "object",
+                                "additionalProperties": false,
+                                "required": [
+                                    "type"
+                                ],
+                                "properties": {
+                                    "type": {
+                                        "type": "string",
+                                        "format": "uri",
+                                        "description": "A bare Type URI (no #request or #response fragment). The responder supports both request and response variants of every entry it lists."
+                                    },
+                                    "requiredExt": {
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string",
+                                            "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+                                        },
+                                        "minItems": 1,
+                                        "uniqueItems": true,
+                                        "description": "Reverse-DNS `ext` namespaces this responder requires on inbound documents of this Type URI as a matter of local policy (SPEC.md §4.5.1, §7.2). A producer that does not populate every listed namespace will receive a `malformedRequest` rejection. Optional; reserved-but-recognized in 0.1, RECOMMENDED in future revisions for responders that enforce such policies."
+                                    },
+                                    "acceptanceWindow": {
+                                        "$ref": "#/$defs/AcceptanceWindow"
+                                    }
+                                },
+                                "description": "Object form: lists a Type URI together with optional capability annotations. An `acceptanceWindow` here is the window the responder applies to documents of this Type URI, and takes precedence over the response-level `acceptanceWindow` for this entry."
+                            }
+                        ],
+                        "description": "An entry in the supportedTypes list. SHORTHAND: a bare Type URI string. EXPANDED: an object with `type` and optional capability annotations (`requiredExt`, `acceptanceWindow`)."
+                    },
+                    "description": "Each entry's Type URI MUST match at least one of the request's patterns (if any were supplied). Order is not significant. Duplicates by Type URI are not permitted, regardless of whether the entry is in shorthand or expanded form."
+                },
+                "frameworkVersion": {
+                    "type": "string",
+                    "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$",
+                    "description": "MAJOR.MINOR.PATCH version of the Trust Tasks framework specification (SPEC.md) the responder targets — three-part, as the framework has been versioned since 0.4.0 (SPEC.md §5.1.1), and exactly the value a Trust Task specification declares as its target framework version. Lets a discoverer reason about compatibility (SPEC.md §5.2) and select the envelope schema a responder's documents are validated against, which is keyed by the full release: a PATCH is never substituted for another. RECOMMENDED. Two-part in trust-task-discovery/0.1, which could not express a PATCH."
+                },
+                "acceptanceWindow": {
+                    "$ref": "#/$defs/AcceptanceWindow"
+                }
+            }
+        }
+    }
+};
+/** 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": {
+        "AcceptanceWindow": {
+            "title": "Acceptance window",
+            "description": "The freshness bounds a responder applies, as a consumer, to the `issuedAt` of a document it receives (SPEC.md §7.2 item 13). A responder refuses a document when now > issuedAt + maxAgeSeconds + clockSkewSeconds, and when issuedAt > now + clockSkewSeconds. It says nothing about `expiresAt`, which is honoured independently (SPEC.md §7.2 item 4). Both members are whole seconds.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "maxAgeSeconds",
+                "clockSkewSeconds"
+            ],
+            "properties": {
+                "maxAgeSeconds": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "The greatest age, in whole seconds, of a document's `issuedAt` at which the responder still accepts the document, before any clock-skew tolerance is applied."
+                },
+                "clockSkewSeconds": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "The clock-skew tolerance, in whole seconds, the responder applies in both directions: added to maxAgeSeconds for a document in its past, and allowed for an `issuedAt` in its future (SPEC.md §4.2, §7.2 item 13). Zero when it applies none."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "Trust Task Discovery — response payload",
+            "description": "List of bare Type URIs the responding party supports. Carried in a Trust Task document whose type is https://trusttasks.org/spec/trust-task-discovery/0.3#response. A response-level `acceptanceWindow` is the window the responder applies to every listed Type URI whose entry carries none of its own. Where neither is present for an entry, the discoverer has learnt nothing about that entry's window and MUST NOT read the absence as the absence of a window.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "supportedTypes"
+            ],
+            "properties": {
+                "supportedTypes": {
+                    "type": "array",
+                    "items": {
+                        "oneOf": [
+                            {
+                                "type": "string",
+                                "format": "uri",
+                                "description": "Shorthand form: a bare Type URI string. Equivalent to an object with only the `type` member set."
+                            },
+                            {
+                                "type": "object",
+                                "additionalProperties": false,
+                                "required": [
+                                    "type"
+                                ],
+                                "properties": {
+                                    "type": {
+                                        "type": "string",
+                                        "format": "uri",
+                                        "description": "A bare Type URI (no #request or #response fragment). The responder supports both request and response variants of every entry it lists."
+                                    },
+                                    "requiredExt": {
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string",
+                                            "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+                                        },
+                                        "minItems": 1,
+                                        "uniqueItems": true,
+                                        "description": "Reverse-DNS `ext` namespaces this responder requires on inbound documents of this Type URI as a matter of local policy (SPEC.md §4.5.1, §7.2). A producer that does not populate every listed namespace will receive a `malformedRequest` rejection. Optional; reserved-but-recognized in 0.1, RECOMMENDED in future revisions for responders that enforce such policies."
+                                    },
+                                    "acceptanceWindow": {
+                                        "$ref": "#/$defs/AcceptanceWindow"
+                                    }
+                                },
+                                "description": "Object form: lists a Type URI together with optional capability annotations. An `acceptanceWindow` here is the window the responder applies to documents of this Type URI, and takes precedence over the response-level `acceptanceWindow` for this entry."
+                            }
+                        ],
+                        "description": "An entry in the supportedTypes list. SHORTHAND: a bare Type URI string. EXPANDED: an object with `type` and optional capability annotations (`requiredExt`, `acceptanceWindow`)."
+                    },
+                    "description": "Each entry's Type URI MUST match at least one of the request's patterns (if any were supplied). Order is not significant. Duplicates by Type URI are not permitted, regardless of whether the entry is in shorthand or expanded form."
+                },
+                "frameworkVersion": {
+                    "type": "string",
+                    "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$",
+                    "description": "MAJOR.MINOR.PATCH version of the Trust Tasks framework specification (SPEC.md) the responder targets — three-part, as the framework has been versioned since 0.4.0 (SPEC.md §5.1.1), and exactly the value a Trust Task specification declares as its target framework version. Lets a discoverer reason about compatibility (SPEC.md §5.2) and select the envelope schema a responder's documents are validated against, which is keyed by the full release: a PATCH is never substituted for another. RECOMMENDED. Two-part in trust-task-discovery/0.1, which could not express a PATCH."
+                },
+                "acceptanceWindow": {
+                    "$ref": "#/$defs/AcceptanceWindow"
+                }
+            }
+        }
+    }
+};
+/**
+ * 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: false,
+    isRecipientRequired: true,
+    isIssuedAtRequired: false,
+    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: false,
+    isRecipientRequired: true,
+    isIssuedAtRequired: false,
+    payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
+};
+//# sourceMappingURL=payload.js.map

package/dist/trust-task-discovery/0.3/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../src/trust-task-discovery/0.3/payload.ts"],"names":[],"mappings":"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"}

package/package.json

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

package/src/_shared/components.ts

@@ -4703,7 +4703,7 @@ export interface ServiceState {
 /**
  * A logical authentication context bound to a subject. Producers and consumers exchange Session-shaped data in challenge issuance, authentication responses, and introspection (whoami).
  */
-export interface Session {
+export interface Session_AuthV0_1 {
   /**
    * Opaque, server-chosen session identifier. Stable for the lifetime of the session. Consumers MUST treat the value as opaque; no structure is implied.
    */
@@ -4735,6 +4735,45 @@ export interface Session {
    */
   ext?: Ext;
 }
+/**
+ * A logical authentication context bound to a subject. Producers and consumers exchange Session-shaped data in challenge issuance, authentication responses, and introspection (whoami).
+ */
+export interface Session_AuthV0_2 {
+  /**
+   * Opaque, server-chosen session identifier. Stable for the lifetime of the session. Consumers MUST treat the value as opaque; no structure is implied.
+   */
+  id: string;
+  /**
+   * The authenticated party's VID (typically a DID URL).
+   */
+  subject: string;
+  /**
+   * ISO-8601 timestamp when the session was created.
+   */
+  issuedAt: string;
+  /**
+   * ISO-8601 timestamp when the session ceases to be valid. Producers SHOULD refresh before this time; consumers MUST reject after.
+   */
+  expiresAt: string;
+  /**
+   * 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.
+   *
+   * @minItems 1
+   */
+  amr?: [string, ...string[]];
+  /**
+   * 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).
+   */
+  acr?: string;
+  /**
+   * The did:key VID bound to this session by auth/authenticate/0.2, when the producer registered one. Present here so introspection (auth/whoami, auth/sessions/list) can show the binding a client already holds; it is descriptive, not an additional grant — the binding, its scope and its lifetime are governed entirely by the auth/authenticate/0.2 specification that established it. Absent when the session was established without a session key, or by a specification version that does not carry one.
+   */
+  sessionKey?: string;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
+  ext?: Ext;
+}
 export interface WebOrigin_VaultV0_1 {
   kind: "web-origin";
   /**

package/src/auth/_shared/0.1/session.ts

@@ -14,4 +14,4 @@ export interface AuthSharedSessionDefinitions {
  * The definitions this shared schema publishes, hoisted to one declaration each.
  * See "../../../_shared/components.js".
  */
-export type { Session } from "../../../_shared/components.js";
+export type { Session_AuthV0_1 as Session } from "../../../_shared/components.js";

package/src/auth/_shared/0.2/session.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/auth/_shared/0.2/session.schema.json
+ */
+
+/**
+ * Reusable JSON Schema fragments that describe an authenticated session, referenced by the auth/* Trust Task specifications. 0.2 adds the optional sessionKey binding (auth/authenticate/0.2); 0.1 remains in place for specifications still pinned to it (SPEC.md §6.6 item 3 — a component version bump never changes an already-published specification version underfoot).
+ */
+export interface AuthSharedSessionDefinitions {
+  [k: string]: unknown | undefined;
+}
+
+/**
+ * The definitions this shared schema publishes, hoisted to one declaration each.
+ * See "../../../_shared/components.js".
+ */
+export type { Session_AuthV0_2 as Session } from "../../../_shared/components.js";

package/src/auth/authenticate/0.1/payload.ts

@@ -3,7 +3,7 @@
  * Source: specs/auth/authenticate/0.1/payload.schema.json
  */
 
-import type { Ext, Session, TokenBundle } from "../../../_shared/components.js";
+import type { Ext, Session_AuthV0_1 as Session, TokenBundle } from "../../../_shared/components.js";
 
 
 /**