@openvtc/trust-tasks 0.2.3 → 0.2.5

package/package.json

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

package/src/consent/_shared/0.1/consent.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/consent/_shared/0.1/consent.schema.json
+ */
+
+/**
+ * Platform-agnostic definitions shared across the consent/* tasks.
+ */
+export interface ConsentSharedDefinitions {
+  [k: string]: unknown | undefined;
+}

package/src/consent/approver-list/1.0/payload.ts

@@ -0,0 +1,31 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/consent/approver-list/1.0/payload.schema.json
+ */
+
+/**
+ * Fetch approver bindings, optionally filtered by platform or context.
+ */
+export interface ConsentListApproversPayload {
+  /**
+   * Optional. Restrict to this platform tag.
+   */
+  platform?: string;
+  /**
+   * Optional. Restrict to this context path.
+   */
+  context?: string;
+  ext?: Ext;
+}
+/**
+ * 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.
+ */
+export interface Ext {
+  [k: string]: unknown | undefined;
+}
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/consent/approver-list/1.0" as const;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/consent/approver-list/1.0#response" as const;

package/src/consent/approver-set/1.0/payload.ts

@@ -0,0 +1,43 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/consent/approver-set/1.0/payload.schema.json
+ */
+
+/**
+ * An admin binds the operator who approves inbound-messaging consent for a platform within a context.
+ */
+export interface ConsentSetApproverPayload {
+  /**
+   * Messaging-platform tag, e.g. "signal".
+   */
+  platform: string;
+  /**
+   * The VTA context path this binding applies to.
+   */
+  context: string;
+  /**
+   * VID of the operator authorized to decide consent.
+   */
+  approver: string;
+  /**
+   * How the prompt reaches the approver; defaults to bridge-relay.
+   */
+  route?: "wake" | "bridge-relay";
+  /**
+   * Optional routing detail (e.g. the operator's opaque conversationRef).
+   */
+  routeHint?: string;
+  ext?: Ext;
+}
+/**
+ * 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.
+ */
+export interface Ext {
+  [k: string]: unknown | undefined;
+}
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/consent/approver-set/1.0" as const;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/consent/approver-set/1.0#response" as const;

package/src/consent/decision/1.0/payload.ts

@@ -0,0 +1,61 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/consent/decision/1.0/payload.schema.json
+ */
+
+/**
+ * An approver allows or denies an AI agent's access to a messaging conversation.
+ */
+export interface ConsentDecisionPayload {
+  subject: ConsentSubject;
+  /**
+   * Whether the subject is permitted. The ABSENCE of any grant is treated as `deny` (default-deny).
+   */
+  effect: "allow" | "deny";
+  /**
+   * Granted scope. REQUIRED when `effect` is `allow`.
+   */
+  scope?: "receive" | "converse";
+  /**
+   * Echoes the consent/request challenge this decision answers. Omit only for an operator-initiated pre-authorization.
+   */
+  challenge?: string;
+  /**
+   * Optional grant TTL; after it the subject must be re-consented.
+   */
+  expiresAt?: string;
+  ext?: Ext;
+}
+/**
+ * The platform-agnostic identifier of WHAT is being consented to: one conversation, for one agent.
+ */
+export interface ConsentSubject {
+  /**
+   * Messaging-platform tag, e.g. "signal", "whatsapp", "slack".
+   */
+  platform: string;
+  /**
+   * The bridge's OPAQUE conversation handle (e.g. "sig-1a2b3c4d"). NEVER the raw platform address — the VTA never learns the phone number / chat id.
+   */
+  conversationRef: string;
+  /**
+   * The interaction kind: a 1:1 direct message, a multi-party group, or a broadcast channel.
+   */
+  kind: "dm" | "group" | "channel";
+  /**
+   * VID (DID) of the AI agent the conversation would reach.
+   */
+  agent: string;
+}
+/**
+ * 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.
+ */
+export interface Ext {
+  [k: string]: unknown | undefined;
+}
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/consent/decision/1.0" as const;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/consent/decision/1.0#response" as const;

package/src/consent/list/1.0/payload.ts

@@ -0,0 +1,57 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/consent/list/1.0/payload.schema.json
+ */
+
+/**
+ * A bridge fetches the consent grants it should enforce.
+ */
+export interface ConsentListPayload {
+  /**
+   * Optional. Restrict to grants for this agent VID.
+   */
+  agent?: string;
+  /**
+   * Optional. Restrict to this platform tag.
+   */
+  platform?: string;
+  subject?: ConsentSubject;
+  /**
+   * Optional opaque cursor; return only grants changed after it.
+   */
+  since?: string;
+  ext?: Ext;
+}
+/**
+ * Optional. A full subject, to point-check a single conversation.
+ */
+export interface ConsentSubject {
+  /**
+   * Messaging-platform tag, e.g. "signal", "whatsapp", "slack".
+   */
+  platform: string;
+  /**
+   * The bridge's OPAQUE conversation handle (e.g. "sig-1a2b3c4d"). NEVER the raw platform address — the VTA never learns the phone number / chat id.
+   */
+  conversationRef: string;
+  /**
+   * The interaction kind: a 1:1 direct message, a multi-party group, or a broadcast channel.
+   */
+  kind: "dm" | "group" | "channel";
+  /**
+   * VID (DID) of the AI agent the conversation would reach.
+   */
+  agent: string;
+}
+/**
+ * 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.
+ */
+export interface Ext {
+  [k: string]: unknown | undefined;
+}
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/consent/list/1.0" as const;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/consent/list/1.0#response" as const;

package/src/consent/request/1.0/payload.ts

@@ -0,0 +1,65 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/consent/request/1.0/payload.schema.json
+ */
+
+/**
+ * A bridge asks the VTA whether an inbound conversation may reach an AI agent, prompting operator consent on first contact.
+ */
+export interface ConsentRequestPayload {
+  subject: ConsentSubject;
+  /**
+   * The access the bridge seeks for the agent on this conversation.
+   */
+  scope: "receive" | "converse";
+  /**
+   * base64url-encoded nonce (≥128 bits entropy) echoed by the matching consent/decision, so the bridge can correlate the decision to this request.
+   */
+  challenge: string;
+  /**
+   * Optional operator-facing label (e.g. "Signal group 'Family'"). MUST NOT contain a raw platform address.
+   */
+  displayHint?: string;
+  /**
+   * Optional multihash digest of the held first message, binding the request to concrete content.
+   */
+  firstMessageDigest?: string;
+  /**
+   * Optional VTA context path the bridge runs under, to scope approver resolution.
+   */
+  contextHint?: string;
+  ext?: Ext;
+}
+/**
+ * The platform-agnostic identifier of WHAT is being consented to: one conversation, for one agent.
+ */
+export interface ConsentSubject {
+  /**
+   * Messaging-platform tag, e.g. "signal", "whatsapp", "slack".
+   */
+  platform: string;
+  /**
+   * The bridge's OPAQUE conversation handle (e.g. "sig-1a2b3c4d"). NEVER the raw platform address — the VTA never learns the phone number / chat id.
+   */
+  conversationRef: string;
+  /**
+   * The interaction kind: a 1:1 direct message, a multi-party group, or a broadcast channel.
+   */
+  kind: "dm" | "group" | "channel";
+  /**
+   * VID (DID) of the AI agent the conversation would reach.
+   */
+  agent: string;
+}
+/**
+ * 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.
+ */
+export interface Ext {
+  [k: string]: unknown | undefined;
+}
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/consent/request/1.0" as const;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/consent/request/1.0#response" as const;

package/src/consent/revoke/1.0/payload.ts

@@ -0,0 +1,49 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/consent/revoke/1.0/payload.schema.json
+ */
+
+/**
+ * An operator revokes a standing consent grant.
+ */
+export interface ConsentRevokePayload {
+  subject: ConsentSubject;
+  /**
+   * Optional operator note recorded in the audit trail.
+   */
+  reason?: string;
+  ext?: Ext;
+}
+/**
+ * The platform-agnostic identifier of WHAT is being consented to: one conversation, for one agent.
+ */
+export interface ConsentSubject {
+  /**
+   * Messaging-platform tag, e.g. "signal", "whatsapp", "slack".
+   */
+  platform: string;
+  /**
+   * The bridge's OPAQUE conversation handle (e.g. "sig-1a2b3c4d"). NEVER the raw platform address — the VTA never learns the phone number / chat id.
+   */
+  conversationRef: string;
+  /**
+   * The interaction kind: a 1:1 direct message, a multi-party group, or a broadcast channel.
+   */
+  kind: "dm" | "group" | "channel";
+  /**
+   * VID (DID) of the AI agent the conversation would reach.
+   */
+  agent: string;
+}
+/**
+ * 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.
+ */
+export interface Ext {
+  [k: string]: unknown | undefined;
+}
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/consent/revoke/1.0" as const;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/consent/revoke/1.0#response" as const;

package/src/index.ts

@@ -34,6 +34,13 @@ export * as AuthWhoami_v0_1 from "./auth/whoami/0.1/payload";
 export * as ChatMessage_v1_0 from "./chat/message/1.0/payload";
 export * as ConfirmRequest_v0_1 from "./confirm/request/0.1/payload";
 export * as ConfirmResponse_v0_1 from "./confirm/response/0.1/payload";
+export * as ConsentShared_v0_1 from "./consent/_shared/0.1/consent";
+export * as ConsentApproverList_v1_0 from "./consent/approver-list/1.0/payload";
+export * as ConsentApproverSet_v1_0 from "./consent/approver-set/1.0/payload";
+export * as ConsentDecision_v1_0 from "./consent/decision/1.0/payload";
+export * as ConsentList_v1_0 from "./consent/list/1.0/payload";
+export * as ConsentRequest_v1_0 from "./consent/request/1.0/payload";
+export * as ConsentRevoke_v1_0 from "./consent/revoke/1.0/payload";
 export * as DeviceBindingShared_v0_1 from "./device/_shared/0.1/device-binding";
 export * as DeviceBindingShared_v0_2 from "./device/_shared/0.2/device-binding";
 export * as DeviceDisable_v0_1 from "./device/disable/0.1/payload";