connect

Previous value: -"Optional entity UUID. Resolve via suggest_entity to link to an existing record (~2,500 seed entities cover major galleries, museums, and auction houses)."New value: +"Optional entity UUID. Resolve via the entities tool (action: \"suggest\") to link to an existing record (~2,500 seed entities cover major galleries, museums, and auction houses)."

Previous value: -"Optional entity UUID from suggest_entity."New value: +"Optional entity UUID from the entities tool (action: \"suggest\")."

Previous value: -"Optional entity UUID from suggest_entity."New value: +"Optional entity UUID from the entities tool (action: \"suggest\")."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"UUID of the target work. Use search_natural_language to resolve title → UUID."New value: +"UUID of the target work. Use search_works to resolve title → UUID."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"The work UUID. Look up via search_natural_language. Never ask the user for this."New value: +"The work UUID. Look up via search_works. Never ask the user for this."

Previous value: -"The work to authenticate. Resolve via search_natural_language. Never ask the user for the UUID."New value: +"The work to authenticate. Resolve via search_works. Never ask the user for the UUID."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"Look up via search_natural_language — never ask the user for this."New value: +"Look up via search_works — never ask the user for this."

Previous value: -"Look up via search_natural_language, or from the response of create_work. Never ask the user for this."New value: +"Look up via search_works, or from the response of create_work. Never ask the user for this."

Previous value: -"Look up via search_natural_language — never ask the user for this."New value: +"Look up via search_works — never ask the user for this."

Previous value: -"Omit for roster-level (all works). Set for per-work. Resolve via search_natural_language."New value: +"Omit for roster-level (all works). Set for per-work. Resolve via search_works."

Previous value: -"The work UWI (e.g., RAI-2026-00417) the challenge binds to. Look up via search_natural_language."New value: +"The work UWI (e.g., RAI-2026-00417) the challenge binds to. Look up via search_works."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"From search_natural_language. Never ask the user for this."New value: +"From search_works. Never ask the user for this."

Previous value: -"The work UUID. Look up via search_natural_language. Never ask the user for this."New value: +"The work UUID. Look up via search_works. Never ask the user for this."

Previous value: -"Optional. Look up via search_natural_language if the user mentions a specific work."New value: +"Optional. Look up via search_works if the user mentions a specific work."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Previous value: -"The work to save provenance for. Look up via search_natural_language. Never ask the user for this."New value: +"The work to save provenance for. Look up via search_works. Never ask the user for this."

Previous value: -"Look up via search_natural_language. Never ask the user for this."New value: +"Look up via search_works. Never ask the user for this."

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "depth": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "diameter": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "height": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "unit": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "width": {
-      "type": [
-        "number",
-        "null"
-      ]
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "e.g. \"36 × 24 in\"",
-  "type": "string"
-}

Removed value: -{
-  "description": "LEGACY (pre-ADR-0027). Prefer authentication_marker_value.wording. Retained during transition.",
-  "type": "string"
-}

Removed value: -{
-  "description": "LEGACY (pre-ADR-0027). Prefer authentication_marker_type. Retained during transition.",
-  "enum": [
-    "signed",
-    "unsigned",
-    "signed_and_dated",
-    "inscribed",
-    "signed_verso",
-    "stamped"
-  ],
-  "type": "string"
-}

Added value: +{
+  "description": "ADR-0027 Identity Eight slot 8 discriminator. Ask using the per-category label (e.g. \"Inscription\" for a painting), never a generic \"signature\" field. \"unsigned\" / \"none\" are legitimate positive values. NFT: link_wallet_challenge + link_wallet_verify first. See create_work.",
+  "enum": [
+    "physical_inscription",
+    "digital_signature",
+    "credits",
+    "score",
+    "instructions",
+    "certificate",
+    "generation_params",
+    "on_chain_signer",
+    "unsigned",
+    "none"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 slot 8 variant payload. See create_work.",
+  "type": "object"
+}

Removed value: -{
-  "type": "string"
-}

Previous value: -"Identity Eight field 6 — unique / numbered / artist_proof."New value: +"Identity Eight slot 6 — six values per ADR-0027: unique / numbered / artist_proof / open / variable / not_applicable. Omission blocks authentication."

Previous value: -[
-  "unique",
-  "numbered",
-  "artist_proof"
-]New value: +[
+  "unique",
+  "numbered",
+  "artist_proof",
+  "open",
+  "variable",
+  "not_applicable"
+]

Added value: +{
+  "description": "ADR-0027 Identity Eight slot 5 discriminator. See create_work.",
+  "enum": [
+    "dimensions",
+    "duration",
+    "runtime",
+    "file_size",
+    "variable",
+    "not_applicable"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 slot 5 variant payload. See create_work.",
+  "type": "object"
+}

Removed value: -{
-  "description": "Free-text signature/inscription wording (orthogonal to signature_status).",
-  "type": "string"
-}

Added value: +{
+  "description": "ADR-0027 sibling — drives per-category labels + defaults for slots 5/7/8. See create_work.",
+  "enum": [
+    "painting",
+    "sculpture",
+    "photography",
+    "print",
+    "drawing",
+    "time_based",
+    "software",
+    "nft",
+    "performance",
+    "installation",
+    "conceptual",
+    "generative",
+    "other"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "ADR-0027 sibling (NOT one of the Eight). For time_based / software / nft / generative. See create_work.",
+  "enum": [
+    "sha256",
+    "ipfs_cid",
+    "arweave_tx",
+    "on_chain"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 primary_work_file variant payload.",
+  "type": "object"
+}

Removed value: -{
-  "description": "Identity Eight field 8 — \"unsigned\" is a legitimate positive value.",
-  "enum": [
-    "signed",
-    "unsigned",
-    "signed_and_dated",
-    "inscribed",
-    "signed_verso",
-    "stamped"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "depth": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "diameter": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "height": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "unit": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "width": {
-      "type": [
-        "number",
-        "null"
-      ]
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "description": "LEGACY (pre-ADR-0027). Prefer authentication_marker_value.wording.",
-  "type": "string"
-}

Removed value: -{
-  "description": "LEGACY (pre-ADR-0027). Prefer authentication_marker_type.",
-  "enum": [
-    "signed",
-    "unsigned",
-    "signed_and_dated",
-    "inscribed",
-    "signed_verso",
-    "stamped"
-  ],
-  "type": "string"
-}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "V1.1 AIPREF (ADR-0021) per-work override. Shape: { train_ai?: boolean, train_genai?: boolean, ai_use?: boolean, search?: boolean, all?: boolean }. true = allowed, false = restricted. NULL inherits the account default (protective for train_ai / train_genai / ai_use; permissive for search). Touching this on a signed work triggers pending_identity_resign."
+}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "V1.1 attribution per-work override (ADR-0020, Berne Art. 6bis framing). Shape: { credit_line?: string, anonymity?: \"named\" | \"anonymous\" | \"pseudonymous\", pseudonym?: string }. NULL falls back to the computed credit line from the artist's display name. Touching this on a signed work triggers pending_identity_resign."
+}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "V1.1 IPTC PLUS reproduction rights per-work override (ADR-0019). Shape per the IPTC PLUS vocabulary pinned in the credential at issuance. NULL inherits the account default. Touching this on a signed work triggers pending_identity_resign."
+}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "V1.1 AIPREF per-work override (ADR-0021). { train_ai?, train_genai?, ai_use?, search?, all? }. true = allowed, false = restricted. NULL inherits the account default. Triggers pending_identity_resign on signed works."
+}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "V1.1 attribution per-work override (ADR-0020). { credit_line?, anonymity?, pseudonym? }. NULL falls back to computed credit line. Triggers pending_identity_resign on signed works."
+}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "V1.1 IPTC PLUS reproduction rights per-work override (ADR-0019). NULL inherits. Triggers pending_identity_resign on signed works."
+}

Removed value: -{
-  "type": [
-    "string",
-    "null"
-  ]
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "type": "string"
-}

Removed value: -{
-  "type": "string"
-}

Added value: +{
+  "description": "ADR-0027 Identity Eight slot 8 discriminator. Variants: physical_inscription (signature/monogram/stamp on physical works), digital_signature (master file or binary), credits (named in credits — time_based), score / instructions (performance/installation/conceptual), certificate (paper or PDF CoA), generation_params (seed + model + prompt — generative), on_chain_signer (NFT — embeds wallet-link proof; requires link_wallet_verify first), unsigned (artist asserts no inscription — positive value), none (no marker by nature — positive value, distinct from unsigned). Must be a value allowed by the work's medium_category per the config.",
+  "enum": [
+    "physical_inscription",
+    "digital_signature",
+    "credits",
+    "score",
+    "instructions",
+    "certificate",
+    "generation_params",
+    "on_chain_signer",
+    "unsigned",
+    "none"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 Identity Eight slot 8 variant payload. Shape depends on authentication_marker_type. For on_chain_signer: { chain, wallet_address, wallet_link_id, challenge_text_hash, wallet_signature, verified_at } — call link_wallet_challenge + link_wallet_verify first; the verify response gives you wallet_link_id and the canonical payload. For physical_inscription: { wording? }. For generation_params: { seed, model, prompt, dimensions? }. For unsigned / none: {}.",
+  "type": "object"
+}

Previous value: -"Identity Eight field 6 — the edition shape. \"unique\" for one-off works. \"numbered\" requires edition_number + edition_total (X of Y). \"artist_proof\" uses edition_total as the AP count. Omission blocks authentication."New value: +"Identity Eight slot 6 — the edition shape. Six values per ADR-0027: \"unique\" (one-off), \"numbered\" (X of Y — requires edition_number + edition_total), \"artist_proof\" (edition_total = AP count), \"open\" (no fixed limit — software/photography/time-based), \"variable\" (every instance differs by design — generative/performance), \"not_applicable\" (no edition framing — conceptual/performance/software). Omission blocks authentication. Per-category allowed lists live in @raisonnai/shared/medium-categories."

Previous value: -[
-  "unique",
-  "numbered",
-  "artist_proof"
-]New value: +[
+  "unique",
+  "numbered",
+  "artist_proof",
+  "open",
+  "variable",
+  "not_applicable"
+]

Added value: +{
+  "description": "ADR-0027 Identity Eight slot 5 discriminator. Variants: dimensions (H × W × D — physical), duration (ISO 8601 / seconds — time_based), runtime (CPU/render time — software/generative), file_size (bytes — software), variable (installation/performance), not_applicable (conceptual). Must be a value allowed by the work's medium_category per the config.",
+  "enum": [
+    "dimensions",
+    "duration",
+    "runtime",
+    "file_size",
+    "variable",
+    "not_applicable"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 Identity Eight slot 5 variant payload. Shape depends on extent_type: dimensions = { height, width, depth?, diameter?, unit }; duration = { iso_8601 | seconds }; runtime = { seconds }; file_size = { bytes }; variable = { note? }; not_applicable = {}.",
+  "type": "object"
+}

Previous value: -"Free-text signature/inscription wording, e.g. \"Signed l.r. in graphite: Julia McDaid 2026.\" Orthogonal to signature_status — may be empty even when signature_status is set (e.g., when signature_status is \"unsigned\")."New value: +"LEGACY (pre-ADR-0027). Prefer authentication_marker_value.wording. Retained during transition."

Added value: +{
+  "description": "ADR-0027 sibling field. Picks one of thirteen categories. Drives per-category defaults for slots 5, 7, 8 + primary_work_file requirement. Required to reach Ready to authenticate. Use the user's own framing: \"video\" / \"film\" / \"sound\" → time_based; \"binary\" / \"app\" / \"software\" → software; \"NFT\" / \"on-chain\" → nft.",
+  "enum": [
+    "painting",
+    "sculpture",
+    "photography",
+    "print",
+    "drawing",
+    "time_based",
+    "software",
+    "nft",
+    "performance",
+    "installation",
+    "conceptual",
+    "generative",
+    "other"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "ADR-0027 sibling reference. Required for time_based / software / nft / generative categories. NOT one of the Identity Eight. sha256 = Raisonnai stores or co-stores the file; ipfs_cid = IPFS content identifier (already a hash); arweave_tx = Arweave transaction ID; on_chain = chain reference for NFT works. Column NULL when absent — there is no `none` value.",
+  "enum": [
+    "sha256",
+    "ipfs_cid",
+    "arweave_tx",
+    "on_chain"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 primary_work_file variant payload. Shape depends on primary_work_file_type. sha256: { hash, byte_length, mime_type?, storage_uris: string[] } — storage_uris are non-canonical (multi-location redundancy doesn't invalidate the credential). ipfs_cid: { cid, codec?, gateway_uris?: string[] }. arweave_tx: { tx_id, gateway_uris?: string[] }. on_chain: { chain, contract_address, token_id, token_uri, token_uri_resolved_at, token_uri_mutable, token_uri_content_hash, token_uri_metadata_excerpt } — call /on-chain/resolve-token-uri to populate the resolved fields.",
+  "type": "object"
+}

Previous value: -"Identity Eight field 8 — the artist's positive assertion about signature/inscription. \"unsigned\" is a legitimate value meaning the artist confirms the work is unsigned (NOT equivalent to leaving this field blank). Omission blocks authentication."New value: +"LEGACY (pre-ADR-0027). Prefer authentication_marker_type. Retained during transition."

Previous value: -"Why the record is needed: purchase, verification, insurance, estate_planning, loan, other. Always required."New value: +"Why the Report is needed: purchase, verification, insurance, estate_planning, loan, other. Always required."

Added value: +{
+  "description": "ADR-0027 slot 8 discriminator. For on_chain_signer (NFT), call link_wallet_challenge + link_wallet_verify first.",
+  "enum": [
+    "physical_inscription",
+    "digital_signature",
+    "credits",
+    "score",
+    "instructions",
+    "certificate",
+    "generation_params",
+    "on_chain_signer",
+    "unsigned",
+    "none"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 slot 8 variant payload.",
+  "type": "object"
+}

Previous value: -"Identity Eight field 6 — edition shape (unique / numbered / artist_proof). Changing this on a signed work triggers pending_resignature."New value: +"Identity Eight slot 6 (ADR-0027 expanded). Six values: unique / numbered / artist_proof / open / variable / not_applicable. Changing this on a signed work triggers pending_identity_resign."

Previous value: -[
-  "unique",
-  "numbered",
-  "artist_proof"
-]New value: +[
+  "unique",
+  "numbered",
+  "artist_proof",
+  "open",
+  "variable",
+  "not_applicable"
+]

Added value: +{
+  "description": "ADR-0027 slot 5 discriminator.",
+  "enum": [
+    "dimensions",
+    "duration",
+    "runtime",
+    "file_size",
+    "variable",
+    "not_applicable"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 slot 5 variant payload.",
+  "type": "object"
+}

Previous value: -"Free-text signature/inscription wording. Changing this on a signed work triggers pending_resignature (the wording is part of the signed canonical record)."New value: +"LEGACY (pre-ADR-0027). Prefer authentication_marker_value.wording."

Added value: +{
+  "description": "ADR-0027 sibling field — changing on signed work triggers pending_identity_resign.",
+  "enum": [
+    "painting",
+    "sculpture",
+    "photography",
+    "print",
+    "drawing",
+    "time_based",
+    "software",
+    "nft",
+    "performance",
+    "installation",
+    "conceptual",
+    "generative",
+    "other"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "ADR-0027 sibling reference (NOT one of the Eight). Required for time_based / software / nft / generative.",
+  "enum": [
+    "sha256",
+    "ipfs_cid",
+    "arweave_tx",
+    "on_chain"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "ADR-0027 primary_work_file variant payload.",
+  "type": "object"
+}

Previous value: -"Identity Eight field 8 — artist's positive assertion about signature/inscription. \"unsigned\" is a legitimate value. Changing this on a signed work triggers pending_resignature."New value: +"LEGACY (pre-ADR-0027). Prefer authentication_marker_type."

Removed value: -{
-  "description": "LEGACY free-text edition descriptor. Prefer edition_status for new records.",
-  "type": "string"
-}

Removed value: -{
-  "description": "LEGACY — prefer edition_status.",
-  "type": "string"
-}

Removed value: -{
-  "description": "LEGACY — prefer edition_status.",
-  "type": "string"
-}

Added value: +"Required when edition_status is \"numbered\" (the X in X of Y)."

Added value: +{
+  "description": "Identity Eight field 6 — the edition shape. \"unique\" for one-off works. \"numbered\" requires edition_number + edition_total (X of Y). \"artist_proof\" uses edition_total as the AP count. Omission blocks authentication.",
+  "enum": [
+    "unique",
+    "numbered",
+    "artist_proof"
+  ],
+  "type": "string"
+}

Added value: +"Required when edition_status is \"numbered\" (the Y in X of Y) or \"artist_proof\" (the AP count)."

Added value: +"LEGACY free-text edition descriptor. Prefer edition_status for new records."

Added value: +"Free-text signature/inscription wording, e.g. \"Signed l.r. in graphite: Julia McDaid 2026.\" Orthogonal to signature_status — may be empty even when signature_status is set (e.g., when signature_status is \"unsigned\")."

Added value: +{
+  "description": "Identity Eight field 8 — the artist's positive assertion about signature/inscription. \"unsigned\" is a legitimate value meaning the artist confirms the work is unsigned (NOT equivalent to leaving this field blank). Omission blocks authentication.",
+  "enum": [
+    "signed",
+    "unsigned",
+    "signed_and_dated",
+    "inscribed",
+    "signed_verso",
+    "stamped"
+  ],
+  "type": "string"
+}

Added value: +{
+  "type": "integer"
+}

Added value: +{
+  "description": "Identity Eight field 6 — unique / numbered / artist_proof.",
+  "enum": [
+    "unique",
+    "numbered",
+    "artist_proof"
+  ],
+  "type": "string"
+}

Added value: +{
+  "type": "integer"
+}

Added value: +{
+  "description": "LEGACY — prefer edition_status.",
+  "type": "string"
+}

Added value: +{
+  "description": "Free-text signature/inscription wording (orthogonal to signature_status).",
+  "type": "string"
+}

Added value: +{
+  "description": "Identity Eight field 8 — \"unsigned\" is a legitimate positive value.",
+  "enum": [
+    "signed",
+    "unsigned",
+    "signed_and_dated",
+    "inscribed",
+    "signed_verso",
+    "stamped"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Identity Eight field 6 — edition shape (unique / numbered / artist_proof). Changing this on a signed work triggers pending_resignature.",
+  "enum": [
+    "unique",
+    "numbered",
+    "artist_proof"
+  ],
+  "type": "string"
+}

Added value: +"LEGACY — prefer edition_status."

Added value: +"Free-text signature/inscription wording. Changing this on a signed work triggers pending_resignature (the wording is part of the signed canonical record)."

Added value: +{
+  "description": "Identity Eight field 8 — artist's positive assertion about signature/inscription. \"unsigned\" is a legitimate value. Changing this on a signed work triggers pending_resignature.",
+  "enum": [
+    "signed",
+    "unsigned",
+    "signed_and_dated",
+    "inscribed",
+    "signed_verso",
+    "stamped"
+  ],
+  "type": "string"
+}

Previous value: -"The work UUID. Look up via search_natural_language — never ask the user for this."New value: +"The work UUID. Look up via search_natural_language. Never ask the user for this."

Previous value: -"The work to authenticate. Resolve via search_natural_language — never ask the user for the UUID."New value: +"The work to authenticate. Resolve via search_natural_language. Never ask the user for the UUID."

Previous value: -"Look up via search_natural_language — never ask the user for this."New value: +"Look up via search_natural_language. Never ask the user for this."

Previous value: -"Account ID of the artist being endorsed. Resolve via get_profile or the authorization record."New value: +"Account ID of the account being endorsed (artist, estate, foundation, or scholar). Resolve via get_profile or the authorization record. Parameter name is historic; the receiver does not have to be an artist account."

Previous value: -"The work UUID. Look up via search_natural_language — never ask the user for this."New value: +"The work UUID. Look up via search_natural_language. Never ask the user for this."

Previous value: -"Work-centric event type. Transfer type (ownership/custody) is derived at the API level."New value: +"Work-centric ownership transfer. Consignments, loans, and deposits are CUSTODY events (the work moves but ownership does not) and live on a separate timeline. Do not write them here. See parse_provenance description for routing."

Previous value: -[
-  "sold",
-  "gifted",
-  "bequeathed",
-  "consigned",
-  "loaned",
-  "deposited",
-  "returned",
-  "exchanged",
-  "inherited",
-  "seized",
-  "found",
-  "transferred",
-  "created",
-  "unknown"
-]New value: +[
+  "sold",
+  "gifted",
+  "bequeathed",
+  "returned",
+  "exchanged",
+  "inherited",
+  "seized",
+  "found",
+  "transferred",
+  "created",
+  "unknown"
+]

Previous value: -"Work-centric event type. Transfer type (ownership/custody) is derived at the API level."New value: +"Work-centric ownership transfer. Consignments, loans, and deposits are CUSTODY events (the work moves but ownership does not) and live on a separate timeline. Do not write them here. See parse_provenance description for routing."

Previous value: -[
-  "sold",
-  "gifted",
-  "bequeathed",
-  "consigned",
-  "loaned",
-  "deposited",
-  "returned",
-  "exchanged",
-  "inherited",
-  "seized",
-  "found",
-  "transferred",
-  "created",
-  "unknown"
-]New value: +[
+  "sold",
+  "gifted",
+  "bequeathed",
+  "returned",
+  "exchanged",
+  "inherited",
+  "seized",
+  "found",
+  "transferred",
+  "created",
+  "unknown"
+]

Previous value: -"The work to save provenance for. Look up via search_natural_language — never ask the user for this."New value: +"The work to save provenance for. Look up via search_natural_language. Never ask the user for this."

Previous value: -"Look up via search_natural_language — never ask the user for this."New value: +"Look up via search_natural_language. Never ask the user for this."

Added value: +{
+  "description": "Optional. Shared with the requester in the decline email.",
+  "maxLength": 500,
+  "type": "string"
+}

Added value: +{
+  "description": "Optional note attached to the fulfillment email.",
+  "maxLength": 2000,
+  "type": "string"
+}

Previous value: -"PIN the requester will enter to open the view. Ask the user to choose one; never invent."New value: +"PIN the requester will enter. Required for unauthenticated requesters; optional when the requester has a Raisonnai account. Ask the user to choose one if needed; never invent."

Previous value: -[
-  "request_id",
-  "work_id",
-  "pin"
-]New value: +[
+  "request_id",
+  "work_id"
+]

Added value: +{
+  "default": "inbox",
+  "description": "Which side: \"inbox\" for requests addressed to the user (artist), \"outgoing\" for requests the user has sent.",
+  "enum": [
+    "inbox",
+    "outgoing"
+  ],
+  "type": "string"
+}

Previous value: -[
-  "private",
-  "authorized_dealers",
-  "all_authorized"
-]New value: +[
+  "private",
+  "public",
+  "authorized"
+]

Previous value: -"The raw HTML or plain text content containing artwork information. Can be a full HTML page, a fragment, or plain text with artwork details."New value: +"Raw HTML containing schema.org / JSON-LD markup for artworks. Plain text without structured markup will return zero works."