@agentcontextdistributionprotocol/acdp 0.8.1 → 0.8.2

package/index.d.ts

@@ -1,159 +1,31 @@
-/* tslint:disable */
-/* eslint-disable */
-
 /* auto-generated by NAPI-RS */
-
-/**
- * A verification method resolved to raw public-key bytes, in the
- * base64 shape the host's pinned-key directory speaks.
- */
-export interface ResolvedDidKey {
-  /** Verification-method id (full DID URL with `#fragment`). */
-  keyId: string
-  /** `ed25519` or `ecdsa-p256`. */
-  algorithm: string
-  /**
-   * Standard base64 of the raw key bytes:
-   * * ed25519 — 32 bytes
-   * * ecdsa-p256 — 65-byte SEC1 uncompressed (`0x04 || x || y`)
-   */
-  publicKeyB64: string
-}
-/**
- * [`ResolvedDidKey`] plus the RFC-ACDP-0010 §9 lifecycle signal for
- * registry receipt keys.
- */
-export interface ResolvedReceiptKey {
-  /** Verification-method id (full DID URL with `#fragment`). */
-  keyId: string
-  /** `ed25519` or `ecdsa-p256`. */
-  algorithm: string
-  /** Standard base64 of the raw key bytes (see [`ResolvedDidKey`]). */
-  publicKeyB64: string
-  /**
-   * `true` when the key is retained in `verificationMethod` but no
-   * longer referenced by `assertionMethod` — a retired receipt key.
-   * Verify the receipt, but report it with the distinguishable
-   * *historically authorized* status (RFC-ACDP-0010 §9).
-   */
-  historical: boolean
-}
-/**
- * Options for `buildPublishRequest`. Field names map directly to the
- * PublishRequest wire schema (camelCase on the JS side).
- */
-export interface PublishOpts {
-  /** Human-readable title (1..=500 chars). */
-  title: string
-  /** Closed enum or namespaced custom (`^[a-z][a-z0-9_]*:[a-z][a-z0-9_-]*$`). */
-  contextType: string
-  /** `public` | `restricted` | `private`. Defaults to `public`. */
-  visibility?: string
-  /** Long human-readable description (≤ 5000 chars). */
-  description?: string
-  /**
-   * Producer-supplied summary for search results (≤ 1000 chars).
-   * Part of ProducerContent — included in the content_hash preimage.
-   */
-  summary?: string
-  /** Free-form tags (each: `^[A-Za-z0-9][A-Za-z0-9_.-]*$`, ≤ 100 chars). */
-  tags?: Array<string>
-  /** Subject-domain identifier (≤ 200 chars). */
-  domain?: string
-  /**
-   * Producer-specific structured metadata. MUST be a JSON-encoded
-   * object string (it is re-parsed so it lands as a JSON object,
-   * not a quoted string).
-   */
-  metadata?: string
-  /**
-   * Lineage of contexts this body was derived from (`acdp://…` ids,
-   * ≤ 1000 unique).
-   */
-  derivedFrom?: Array<string>
-  /** Audience DIDs — required (≥ 1) when `visibility = "restricted"`. */
-  audience?: Array<string>
-  /** Optional JSON Schema URI describing the metadata shape. */
-  schemaUri?: string
-  /** Contributors (DIDs, ≤ 100 unique). */
-  contributors?: Array<string>
-  /**
-   * Data references — a JSON-encoded array of `acdp-data-ref` objects.
-   * Part of ProducerContent, so it is included in the content_hash
-   * preimage.
-   */
-  dataRefs?: string
-  /**
-   * RFC 3339 timestamp after which the conclusions should no longer be
-   * relied upon. Truncated to millisecond precision.
-   */
-  expiresAt?: string
-  /**
-   * Time window the data covers — a JSON object
-   * `{"start": <rfc3339>, "end": <rfc3339>}`. Both ends truncated to
-   * millisecond precision.
-   */
-  dataPeriod?: string
-  /**
-   * Self-verifying `lin:sha256:<hex>` lineage id. v2+ supersession
-   * only — rejected on first-version publishes.
-   */
-  expectedLineageId?: string
+/* eslint-disable */
+/** RFC 8785 canonicalization utilities. All methods are static. */
+export declare class AcdpCanonicalizer {
   /**
-   * Explicit `acdp_version` string for the emitted request.
+   * Canonicalize a JSON document to its RFC 8785 (JCS) form.
    *
-   * **SDK default (since 0.2): `acdp_version` is emitted explicitly,
-   * set to the library's current ACDP protocol version
-   * (`acdp::ACDP_VERSION` — `"0.2.0"` as of this release).** Per
-   * RFC-ACDP-0001 §6 consumers treat an absent field as `"0.1.0"`,
-   * but the omitted and explicit forms are *different JCS preimages*
-   * and therefore hash differently — pick one form per lineage and
-   * never switch mid-lineage.
-   */
-  acdpVersion?: string
-  /**
-   * When `true`, omit `acdp_version` entirely (the 0.1.x SDK default
-   * form). Use this only to reproduce hashes signed under the
-   * omitted form (e.g. the sig-001 golden vector); takes precedence
-   * over `acdpVersion`.
-   */
-  omitAcdpVersion?: boolean
-}
-/**
- * Options for `buildSupersedeRequest`. Any field omitted is carried
- * over from `previousBodyJson` unchanged (mirrors `new_version_from`).
- */
-export interface SupersedeOpts {
-  title?: string
-  summary?: string
-  description?: string
-  tags?: Array<string>
-  domain?: string
-  metadata?: string
-  /**
-   * JSON-encoded array of `acdp-data-ref` objects (replaces the
-   * carried-over data refs when present).
-   */
-  dataRefs?: string
-  /** RFC 3339 expiry timestamp. */
-  expiresAt?: string
-  /** JSON object `{"start": <rfc3339>, "end": <rfc3339>}`. */
-  dataPeriod?: string
-  /** Self-verifying `lin:sha256:<hex>` lineage id (v2+). */
-  expectedLineageId?: string
-  /**
-   * Explicit `acdp_version` string. **By default (since 0.2) the
-   * library's current ACDP protocol version (`acdp::ACDP_VERSION` —
-   * `"0.2.0"` as of this release) is emitted explicitly** — see
-   * `PublishOpts.acdpVersion`. Do not switch the form mid-lineage.
+   * * `jsonStr` — any JSON document as a string.
+   *
+   * Returns the canonical UTF-8 JSON string (sorted object keys, no
+   * whitespace, `-0.0` normalized to `0`, ECMAScript number
+   * formatting). Throws on malformed JSON, or if the document nests
+   * past the canonicalizer's recursion ceiling.
    */
-  acdpVersion?: string
+  static canonicalize(jsonStr: string): string
   /**
-   * When `true`, omit `acdp_version` entirely (the 0.1.x form);
-   * takes precedence over `acdpVersion`.
+   * SHA-256 over the canonical (JCS) form of a JSON document, returned
+   * as the ACDP envelope `"sha256:<64-lowercase-hex>"`.
+   *
+   * This is the hashing primitive behind `content_hash` /
+   * `data_ref.content_hash`. It hashes the document *as given* — it
+   * does NOT strip the RFC-ACDP-0001 §5.7 exclusion set, so to
+   * recompute a body's `content_hash` the caller passes the already
+   * producer-controlled object (or uses `AcdpVerifier.verifyContentHash`).
    */
-  omitAcdpVersion?: boolean
+  static contentHash(jsonStr: string): string
 }
+
 /** Stateless did:web string helpers. All methods are static. */
 export declare class AcdpDid {
   /**
@@ -173,6 +45,7 @@ export declare class AcdpDid {
    */
   static stripFragment(didUrl: string): string
 }
+
 /**
  * A parsed did:web DID document. Construct with
  * [`AcdpDidDocument::parse`], then resolve a signing key with
@@ -233,31 +106,7 @@ export declare class AcdpDidDocument {
    */
   receiptKeyForAlgorithm(requestedKeyId: string, requestedAlg: string): ResolvedReceiptKey
 }
-/** RFC 8785 canonicalization utilities. All methods are static. */
-export declare class AcdpCanonicalizer {
-  /**
-   * Canonicalize a JSON document to its RFC 8785 (JCS) form.
-   *
-   * * `jsonStr` — any JSON document as a string.
-   *
-   * Returns the canonical UTF-8 JSON string (sorted object keys, no
-   * whitespace, `-0.0` normalized to `0`, ECMAScript number
-   * formatting). Throws on malformed JSON, or if the document nests
-   * past the canonicalizer's recursion ceiling.
-   */
-  static canonicalize(jsonStr: string): string
-  /**
-   * SHA-256 over the canonical (JCS) form of a JSON document, returned
-   * as the ACDP envelope `"sha256:<64-lowercase-hex>"`.
-   *
-   * This is the hashing primitive behind `content_hash` /
-   * `data_ref.content_hash`. It hashes the document *as given* — it
-   * does NOT strip the RFC-ACDP-0001 §5.7 exclusion set, so to
-   * recompute a body's `content_hash` the caller passes the already
-   * producer-controlled object (or uses `AcdpVerifier.verifyContentHash`).
-   */
-  static contentHash(jsonStr: string): string
-}
+
 /** RFC-ACDP-0012 §5 Merkle helpers. All methods are static. */
 export declare class AcdpMerkle {
   /**
@@ -273,102 +122,19 @@ export declare class AcdpMerkle {
   static leafHash(leafJson: string): string
   /**
    * The §5.1 interior-node hash `SHA-256(0x01 ‖ left ‖ right)` over
-   * the raw digests the two wire-form (`"sha256:<hex>"`) arguments
-   * encode. The 0x00/0x01 domain-separation prefixes are what stop
-   * leaf/node second-preimage forgeries — never hash without them.
-   */
-  static nodeHash(leftHash: string, rightHash: string): string
-  /**
-   * The §5.2 RFC 6962 Merkle tree hash `MTH(D[n])` over an ordered
-   * JSON array of wire-form leaf hashes (`'["sha256:...", ...]'`).
-   * An empty array yields the empty-tree root, `SHA-256("")`.
-   */
-  static rootHash(leafHashesJson: string): string
-}
-/**
- * An ACDP producer: an Ed25519 signing key and its DID identity
- * (`did:web`, or `did:key` via the `*DidKey` factories — ACDP 0.2).
- *
- * All methods return wire-ready JSON strings the caller sends via its
- * own HTTP client. No HTTP calls are made inside this class.
- */
-export declare class AcdpProducer {
-  /** Generate a producer with a fresh random Ed25519 key (OsRng). */
-  static generate(agentDid: string, keyId: string): AcdpProducer
-  /**
-   * Generate a producer whose identity **is** its fresh Ed25519 key
-   * (`did:key`, ACDP 0.2). The `agentDid` and `keyId` are derived
-   * from the public key — no domain, no DID-document hosting.
-   * Consumers verify did:key contexts offline
-   * (`AcdpVerifier.verifyBodyOffline`), with no dependency on the
-   * producer's infrastructure remaining online.
-   *
-   * Tradeoff: did:key cannot rotate — a new key is a new identity,
-   * and `supersedes` requires the same `agent_id`, so lineage
-   * continuity ends with the key. Use `did:web` for long-lived
-   * organizational anchors; use did:key for ephemeral or
-   * archival-critical producers.
-   */
-  static generateDidKey(): AcdpProducer
-  /**
-   * Construct a `did:key` producer from a 32-byte Ed25519 seed.
-   *
-   * Deterministic — the same seed always derives the same
-   * `agentDid` / `keyId`. The seed is the private key — protect it
-   * as such. See [`AcdpProducer::generate_did_key`] for the did:key
-   * rotation tradeoff.
-   */
-  static fromSeedDidKey(seed: Buffer): AcdpProducer
-  /** Construct from a 32-byte Ed25519 seed (deterministic). */
-  static fromSeed(seed: Buffer, agentDid: string, keyId: string): AcdpProducer
-  /** The producer's DID (`did:web:…` or `did:key:…`). */
-  get agentDid(): string
-  /**
-   * The producer's signing-key DID URL (`did:web:…#key-1`, or the
-   * `did:key:z…#z…` self-fragment form).
-   */
-  get keyId(): string
-  /**
-   * Raw Ed25519 public key as standard base64 (44 chars with padding).
-   * Use this to populate a did:web verification method.
-   */
-  get publicKeyB64(): string
-  /**
-   * The raw 32-byte seed, for storage in a key vault. Returns a
-   * fresh `Buffer` each call — JS owns the bytes.
-   */
-  seedBytes(): Buffer
-  /**
-   * Build and sign a first-version PublishRequest. Returns the
-   * wire JSON string.
-   *
-   * **By default (since 0.2) `acdp_version` is emitted explicitly,
-   * set to the library's current ACDP protocol version
-   * (`acdp::ACDP_VERSION` — `"0.2.0"` as of this release).** Pass
-   * `omitAcdpVersion: true` to reproduce the 0.1.x omitted form (a
-   * distinct JCS preimage, so a distinct `content_hash`), or
-   * `acdpVersion` to pin another string.
-   */
-  buildPublishRequest(opts: PublishOpts): string
-  /**
-   * Build and sign a supersession PublishRequest from a previous
-   * version's `Body` JSON. Version is propagated automatically
-   * (`previous.version + 1`) and `lineage_id` is carried forward.
-   *
-   * **By default (since 0.2) `acdp_version` is emitted explicitly,
-   * set to the library's current ACDP protocol version
-   * (`acdp::ACDP_VERSION` — `"0.2.0"` as of this release)** — see
-   * `buildPublishRequest`. Do not switch between the omitted and
-   * explicit forms mid-lineage.
+   * the raw digests the two wire-form (`"sha256:<hex>"`) arguments
+   * encode. The 0x00/0x01 domain-separation prefixes are what stop
+   * leaf/node second-preimage forgeries — never hash without them.
    */
-  buildSupersedeRequest(previousBodyJson: string, opts: SupersedeOpts): string
+  static nodeHash(leftHash: string, rightHash: string): string
   /**
-   * Sign a registry auth-challenge `signingInput` string. Returns
-   * the base64-encoded Ed25519 signature (88 chars with padding).
-   * Used by the ACDP registry's bearer-token flow.
+   * The §5.2 RFC 6962 Merkle tree hash `MTH(D[n])` over an ordered
+   * JSON array of wire-form leaf hashes (`'["sha256:...", ...]'`).
+   * An empty array yields the empty-tree root, `SHA-256("")`.
    */
-  signChallenge(signingInput: string): string
+  static rootHash(leafHashesJson: string): string
 }
+
 /**
  * An ACDP producer signing with ECDSA-P256 (`ecdsa-p256`) instead of
  * the Ed25519 baseline.
@@ -464,6 +230,92 @@ export declare class AcdpP256Producer {
    */
   signChallenge(signingInput: string): string
 }
+
+/**
+ * An ACDP producer: an Ed25519 signing key and its DID identity
+ * (`did:web`, or `did:key` via the `*DidKey` factories — ACDP 0.2).
+ *
+ * All methods return wire-ready JSON strings the caller sends via its
+ * own HTTP client. No HTTP calls are made inside this class.
+ */
+export declare class AcdpProducer {
+  /** Generate a producer with a fresh random Ed25519 key (OsRng). */
+  static generate(agentDid: string, keyId: string): AcdpProducer
+  /**
+   * Generate a producer whose identity **is** its fresh Ed25519 key
+   * (`did:key`, ACDP 0.2). The `agentDid` and `keyId` are derived
+   * from the public key — no domain, no DID-document hosting.
+   * Consumers verify did:key contexts offline
+   * (`AcdpVerifier.verifyBodyOffline`), with no dependency on the
+   * producer's infrastructure remaining online.
+   *
+   * Tradeoff: did:key cannot rotate — a new key is a new identity,
+   * and `supersedes` requires the same `agent_id`, so lineage
+   * continuity ends with the key. Use `did:web` for long-lived
+   * organizational anchors; use did:key for ephemeral or
+   * archival-critical producers.
+   */
+  static generateDidKey(): AcdpProducer
+  /**
+   * Construct a `did:key` producer from a 32-byte Ed25519 seed.
+   *
+   * Deterministic — the same seed always derives the same
+   * `agentDid` / `keyId`. The seed is the private key — protect it
+   * as such. See [`AcdpProducer::generate_did_key`] for the did:key
+   * rotation tradeoff.
+   */
+  static fromSeedDidKey(seed: Buffer): AcdpProducer
+  /** Construct from a 32-byte Ed25519 seed (deterministic). */
+  static fromSeed(seed: Buffer, agentDid: string, keyId: string): AcdpProducer
+  /** The producer's DID (`did:web:…` or `did:key:…`). */
+  get agentDid(): string
+  /**
+   * The producer's signing-key DID URL (`did:web:…#key-1`, or the
+   * `did:key:z…#z…` self-fragment form).
+   */
+  get keyId(): string
+  /**
+   * Raw Ed25519 public key as standard base64 (44 chars with padding).
+   * Use this to populate a did:web verification method.
+   */
+  get publicKeyB64(): string
+  /**
+   * The raw 32-byte seed, for storage in a key vault. Returns a
+   * fresh `Buffer` each call — JS owns the bytes.
+   */
+  seedBytes(): Buffer
+  /**
+   * Build and sign a first-version PublishRequest. Returns the
+   * wire JSON string.
+   *
+   * **By default (since 0.2) `acdp_version` is emitted explicitly,
+   * set to the library's current ACDP protocol version
+   * (`acdp::ACDP_VERSION` — `"0.2.0"` as of this release).** Pass
+   * `omitAcdpVersion: true` to reproduce the 0.1.x omitted form (a
+   * distinct JCS preimage, so a distinct `content_hash`), or
+   * `acdpVersion` to pin another string.
+   */
+  buildPublishRequest(opts: PublishOpts): string
+  /**
+   * Build and sign a supersession PublishRequest from a previous
+   * version's `Body` JSON. Version is propagated automatically
+   * (`previous.version + 1`) and `lineage_id` is carried forward.
+   *
+   * **By default (since 0.2) `acdp_version` is emitted explicitly,
+   * set to the library's current ACDP protocol version
+   * (`acdp::ACDP_VERSION` — `"0.2.0"` as of this release)** — see
+   * `buildPublishRequest`. Do not switch between the omitted and
+   * explicit forms mid-lineage.
+   */
+  buildSupersedeRequest(previousBodyJson: string, opts: SupersedeOpts): string
+  /**
+   * Sign a registry auth-challenge `signingInput` string. Returns
+   * the base64-encoded Ed25519 signature (88 chars with padding).
+   * Used by the ACDP registry's bearer-token flow.
+   */
+  signChallenge(signingInput: string): string
+}
+
 /**
  * An SSRF policy: the synchronous classification half of the Rust
  * `SsrfPolicy`, exposed verdict-only (no DNS, no sockets).
@@ -510,6 +362,7 @@ export declare class AcdpSsrfPolicy {
    */
   checkRedirectAuthority(fromUrl: string, toUrl: string): void
 }
+
 /** Consumer-side verification utilities. All methods are static. */
 export declare class AcdpVerifier {
   /**
@@ -942,3 +795,158 @@ export declare class AcdpVerifier {
    */
   static evaluateWitnessQuorum(cosignaturesJson: string, expectedCheckpointJson: string, trustedWitnessDidsJson: string, witnessDidDocsJson: string, policyJson: string, nowRfc3339?: string | undefined | null): string
 }
+
+/**
+ * Options for `buildPublishRequest`. Field names map directly to the
+ * PublishRequest wire schema (camelCase on the JS side).
+ */
+export interface PublishOpts {
+  /** Human-readable title (1..=500 chars). */
+  title: string
+  /** Closed enum or namespaced custom (`^[a-z][a-z0-9_]*:[a-z][a-z0-9_-]*$`). */
+  contextType: string
+  /** `public` | `restricted` | `private`. Defaults to `public`. */
+  visibility?: string
+  /** Long human-readable description (≤ 5000 chars). */
+  description?: string
+  /**
+   * Producer-supplied summary for search results (≤ 1000 chars).
+   * Part of ProducerContent — included in the content_hash preimage.
+   */
+  summary?: string
+  /** Free-form tags (each: `^[A-Za-z0-9][A-Za-z0-9_.-]*$`, ≤ 100 chars). */
+  tags?: Array<string>
+  /** Subject-domain identifier (≤ 200 chars). */
+  domain?: string
+  /**
+   * Producer-specific structured metadata. MUST be a JSON-encoded
+   * object string (it is re-parsed so it lands as a JSON object,
+   * not a quoted string).
+   */
+  metadata?: string
+  /**
+   * Lineage of contexts this body was derived from (`acdp://…` ids,
+   * ≤ 1000 unique).
+   */
+  derivedFrom?: Array<string>
+  /** Audience DIDs — required (≥ 1) when `visibility = "restricted"`. */
+  audience?: Array<string>
+  /** Optional JSON Schema URI describing the metadata shape. */
+  schemaUri?: string
+  /** Contributors (DIDs, ≤ 100 unique). */
+  contributors?: Array<string>
+  /**
+   * Data references — a JSON-encoded array of `acdp-data-ref` objects.
+   * Part of ProducerContent, so it is included in the content_hash
+   * preimage.
+   */
+  dataRefs?: string
+  /**
+   * RFC 3339 timestamp after which the conclusions should no longer be
+   * relied upon. Truncated to millisecond precision.
+   */
+  expiresAt?: string
+  /**
+   * Time window the data covers — a JSON object
+   * `{"start": <rfc3339>, "end": <rfc3339>}`. Both ends truncated to
+   * millisecond precision.
+   */
+  dataPeriod?: string
+  /**
+   * Self-verifying `lin:sha256:<hex>` lineage id. v2+ supersession
+   * only — rejected on first-version publishes.
+   */
+  expectedLineageId?: string
+  /**
+   * Explicit `acdp_version` string for the emitted request.
+   *
+   * **SDK default (since 0.2): `acdp_version` is emitted explicitly,
+   * set to the library's current ACDP protocol version
+   * (`acdp::ACDP_VERSION` — `"0.2.0"` as of this release).** Per
+   * RFC-ACDP-0001 §6 consumers treat an absent field as `"0.1.0"`,
+   * but the omitted and explicit forms are *different JCS preimages*
+   * and therefore hash differently — pick one form per lineage and
+   * never switch mid-lineage.
+   */
+  acdpVersion?: string
+  /**
+   * When `true`, omit `acdp_version` entirely (the 0.1.x SDK default
+   * form). Use this only to reproduce hashes signed under the
+   * omitted form (e.g. the sig-001 golden vector); takes precedence
+   * over `acdpVersion`.
+   */
+  omitAcdpVersion?: boolean
+}
+
+/**
+ * A verification method resolved to raw public-key bytes, in the
+ * base64 shape the host's pinned-key directory speaks.
+ */
+export interface ResolvedDidKey {
+  /** Verification-method id (full DID URL with `#fragment`). */
+  keyId: string
+  /** `ed25519` or `ecdsa-p256`. */
+  algorithm: string
+  /**
+   * Standard base64 of the raw key bytes:
+   * * ed25519 — 32 bytes
+   * * ecdsa-p256 — 65-byte SEC1 uncompressed (`0x04 || x || y`)
+   */
+  publicKeyB64: string
+}
+
+/**
+ * [`ResolvedDidKey`] plus the RFC-ACDP-0010 §9 lifecycle signal for
+ * registry receipt keys.
+ */
+export interface ResolvedReceiptKey {
+  /** Verification-method id (full DID URL with `#fragment`). */
+  keyId: string
+  /** `ed25519` or `ecdsa-p256`. */
+  algorithm: string
+  /** Standard base64 of the raw key bytes (see [`ResolvedDidKey`]). */
+  publicKeyB64: string
+  /**
+   * `true` when the key is retained in `verificationMethod` but no
+   * longer referenced by `assertionMethod` — a retired receipt key.
+   * Verify the receipt, but report it with the distinguishable
+   * *historically authorized* status (RFC-ACDP-0010 §9).
+   */
+  historical: boolean
+}
+
+/**
+ * Options for `buildSupersedeRequest`. Any field omitted is carried
+ * over from `previousBodyJson` unchanged (mirrors `new_version_from`).
+ */
+export interface SupersedeOpts {
+  title?: string
+  summary?: string
+  description?: string
+  tags?: Array<string>
+  domain?: string
+  metadata?: string
+  /**
+   * JSON-encoded array of `acdp-data-ref` objects (replaces the
+   * carried-over data refs when present).
+   */
+  dataRefs?: string
+  /** RFC 3339 expiry timestamp. */
+  expiresAt?: string
+  /** JSON object `{"start": <rfc3339>, "end": <rfc3339>}`. */
+  dataPeriod?: string
+  /** Self-verifying `lin:sha256:<hex>` lineage id (v2+). */
+  expectedLineageId?: string
+  /**
+   * Explicit `acdp_version` string. **By default (since 0.2) the
+   * library's current ACDP protocol version (`acdp::ACDP_VERSION` —
+   * `"0.2.0"` as of this release) is emitted explicitly** — see
+   * `PublishOpts.acdpVersion`. Do not switch the form mid-lineage.
+   */
+  acdpVersion?: string
+  /**
+   * When `true`, omit `acdp_version` entirely (the 0.1.x form);
+   * takes precedence over `acdpVersion`.
+   */
+  omitAcdpVersion?: boolean
+}