@yigemo/choosefire 0.1.0

package/contracts/choosefire-family-wealth/v2/openapi.generated.json

@@ -0,0 +1,2605 @@
+{
+  "components": {
+    "schemas": {
+      "ActivityItemV2": {
+        "additionalProperties": false,
+        "properties": {
+          "actorRole": {
+            "enum": [
+              "owner",
+              "viewer_suggester"
+            ]
+          },
+          "affectedObjects": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "objectId": {
+                  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+                  "type": "string"
+                },
+                "objectType": {
+                  "enum": [
+                    "household",
+                    "workspace",
+                    "asset_account",
+                    "valuation_snapshot",
+                    "classification"
+                  ]
+                }
+              },
+              "required": [
+                "objectType",
+                "objectId"
+              ],
+              "type": "object"
+            },
+            "maxItems": 20,
+            "minItems": 1,
+            "type": "array"
+          },
+          "baseWorkspaceVersion": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "committedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "operation": {
+            "enum": [
+              "workspace.initialize.v2",
+              "asset_account.create.v2",
+              "asset_account.update.v2",
+              "asset_account.archive.v2",
+              "valuation_snapshot.append.v2",
+              "classification.replace.v2"
+            ]
+          },
+          "operationId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "resultWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "operationId",
+          "commandId",
+          "operation",
+          "source",
+          "actorRole",
+          "baseWorkspaceVersion",
+          "resultWorkspaceVersion",
+          "committedAt",
+          "affectedObjects"
+        ],
+        "type": "object"
+      },
+      "ActivityPageQueryV2": {
+        "additionalProperties": false,
+        "properties": {
+          "cursor": {
+            "maxLength": 2048,
+            "minLength": 32,
+            "type": "string"
+          },
+          "limit": {
+            "maximum": 100,
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "limit"
+        ],
+        "type": "object"
+      },
+      "ActivityPageSuccessV2": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/ActivityPageV2"
+          },
+          "kind": {
+            "const": "family_wealth_success.v2"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "data"
+        ],
+        "type": "object"
+      },
+      "ActivityPageV2": {
+        "additionalProperties": false,
+        "properties": {
+          "authority": {
+            "$ref": "#/components/schemas/WorkspaceAuthorityV2"
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "hasMore": {
+            "type": "boolean"
+          },
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/ActivityItemV2"
+            },
+            "maxItems": 100,
+            "type": "array"
+          },
+          "kind": {
+            "const": "activity.page.v2"
+          },
+          "nextCursor": {
+            "maxLength": 2048,
+            "minLength": 32,
+            "type": "string"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "workspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "workspaceVersion",
+          "authority",
+          "items",
+          "nextCursor",
+          "hasMore"
+        ],
+        "type": "object"
+      },
+      "AllocationLineV2": {
+        "additionalProperties": false,
+        "properties": {
+          "basisPoints": {
+            "maximum": 10000,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "code": {
+            "pattern": "^[a-z][a-z0-9._-]{0,63}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "basisPoints"
+        ],
+        "type": "object"
+      },
+      "AssetAccountArchiveCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "asset_account.archive.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/AssetAccountArchivePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "AssetAccountArchivePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "reason": {
+            "maxLength": 240,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "accountId",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "AssetAccountCreateCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "type": "null"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "asset_account.create.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/AssetAccountCreatePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "AssetAccountCreatePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "account": {
+            "$ref": "#/components/schemas/AssetAccountDraftV2"
+          },
+          "accountId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "accountId",
+          "account"
+        ],
+        "type": "object"
+      },
+      "AssetAccountDraftV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accountType": {
+            "enum": [
+              "bank",
+              "brokerage",
+              "fund",
+              "insurance",
+              "pension",
+              "housing_fund",
+              "property",
+              "liability",
+              "other"
+            ]
+          },
+          "aggregationConsent": {
+            "type": "boolean"
+          },
+          "currency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "maintenanceMode": {
+            "enum": [
+              "simplified",
+              "detailed"
+            ]
+          },
+          "name": {
+            "maxLength": 120,
+            "minLength": 1,
+            "type": "string"
+          },
+          "ownerSubjectId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "visibility": {
+            "$ref": "#/components/schemas/VisibilityV2"
+          }
+        },
+        "required": [
+          "name",
+          "accountType",
+          "ownerSubjectId",
+          "visibility",
+          "aggregationConsent",
+          "currency",
+          "maintenanceMode"
+        ],
+        "type": "object"
+      },
+      "AssetAccountUpdateCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "asset_account.update.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/AssetAccountUpdatePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "AssetAccountUpdatePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "account": {
+            "$ref": "#/components/schemas/AssetAccountDraftV2"
+          },
+          "accountId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "accountId",
+          "account"
+        ],
+        "type": "object"
+      },
+      "ClassificationDraftV2": {
+        "additionalProperties": false,
+        "properties": {
+          "assetClasses": {
+            "items": {
+              "$ref": "#/components/schemas/AllocationLineV2"
+            },
+            "maxItems": 20,
+            "minItems": 1,
+            "type": "array"
+          },
+          "effectiveFrom": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "purposeBuckets": {
+            "items": {
+              "$ref": "#/components/schemas/AllocationLineV2"
+            },
+            "maxItems": 20,
+            "minItems": 1,
+            "type": "array"
+          },
+          "scopeId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "scopeType": {
+            "enum": [
+              "account",
+              "holding"
+            ]
+          }
+        },
+        "required": [
+          "scopeType",
+          "scopeId",
+          "assetClasses",
+          "purposeBuckets",
+          "effectiveFrom"
+        ],
+        "type": "object"
+      },
+      "ClassificationReplaceCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "classification.replace.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/ClassificationReplacePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "ClassificationReplacePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "classification": {
+            "$ref": "#/components/schemas/ClassificationDraftV2"
+          },
+          "classificationRevisionId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "classificationRevisionId",
+          "classification"
+        ],
+        "type": "object"
+      },
+      "CommandReceiptV2": {
+        "additionalProperties": false,
+        "properties": {
+          "affectedObjects": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "objectId": {
+                  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+                  "type": "string"
+                },
+                "objectType": {
+                  "pattern": "^[a-z][a-z0-9._-]{0,63}$",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "objectType",
+                "objectId"
+              ],
+              "type": "object"
+            },
+            "maxItems": 100,
+            "type": "array"
+          },
+          "baseWorkspaceVersion": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "committedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "cursor": {
+            "maxLength": 2048,
+            "minLength": 32,
+            "type": "string"
+          },
+          "kind": {
+            "const": "command_receipt.v2"
+          },
+          "projectionHints": {
+            "items": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxItems": 20,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "receiptId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "replayed": {
+            "type": "boolean"
+          },
+          "resultWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "status": {
+            "const": "committed"
+          }
+        },
+        "required": [
+          "kind",
+          "receiptId",
+          "commandId",
+          "status",
+          "baseWorkspaceVersion",
+          "resultWorkspaceVersion",
+          "replayed",
+          "committedAt",
+          "cursor",
+          "affectedObjects",
+          "projectionHints"
+        ],
+        "type": "object"
+      },
+      "CommandSuccessV2": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/CommandReceiptV2"
+          },
+          "kind": {
+            "const": "family_wealth_success.v2"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "data"
+        ],
+        "type": "object"
+      },
+      "CurrencyCodeV2": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "DecimalAmountV2": {
+        "maxLength": 48,
+        "pattern": "^(?:0|[1-9]\\d*|-[1-9]\\d*)(?:\\.\\d{1,8})?$",
+        "type": "string"
+      },
+      "FamilyWealthErrorV2": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "VALIDATION_ERROR",
+              "AUTH_REQUIRED",
+              "ACCOUNT_SCOPE_REQUIRED",
+              "WORKSPACE_NOT_INITIALIZED",
+              "WORKSPACE_ALREADY_INITIALIZED",
+              "PERMISSION_DENIED",
+              "OBJECT_NOT_FOUND",
+              "WORKSPACE_VERSION_CONFLICT",
+              "OBJECT_REVISION_CONFLICT",
+              "IDEMPOTENCY_CONFLICT",
+              "CURSOR_INVALID",
+              "CURSOR_EXPIRED",
+              "TRANSACTION_RETRYABLE",
+              "REMOTE_UNAVAILABLE"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "additionalProperties": false,
+                "properties": {
+                  "conflictingFields": {
+                    "items": {
+                      "maxLength": 120,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "maxItems": 20,
+                    "type": "array",
+                    "uniqueItems": true
+                  },
+                  "contractId": {
+                    "const": "choosefire-family-wealth.v2"
+                  },
+                  "currentObjectRevision": {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "currentWorkspaceVersion": {
+                    "minimum": 1,
+                    "type": "integer"
+                  },
+                  "retryable": {
+                    "type": "boolean"
+                  },
+                  "safeRetry": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "contractId",
+                  "retryable"
+                ],
+                "type": "object"
+              },
+              "message": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "requestId",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "family_wealth_error.v2"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "error"
+        ],
+        "type": "object"
+      },
+      "McpDelegatedTokenCredentialV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accessToken": {
+            "pattern": "^[A-Za-z0-9_-]{43}$",
+            "type": "string"
+          },
+          "audience": {
+            "const": "choosefire-mcp"
+          },
+          "clientId": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{2,190}$",
+            "type": "string"
+          },
+          "expiresAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "expiresIn": {
+            "maximum": 900,
+            "minimum": 60,
+            "type": "integer"
+          },
+          "kind": {
+            "const": "choosefire_workspace_mcp_delegated_token.v1"
+          },
+          "scopes": {
+            "maxItems": 1,
+            "minItems": 1,
+            "prefixItems": [
+              {
+                "const": "workspace:read"
+              }
+            ],
+            "type": "array"
+          },
+          "tokenType": {
+            "const": "Bearer"
+          },
+          "workspaceId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "accessToken",
+          "tokenType",
+          "expiresIn",
+          "expiresAt",
+          "audience",
+          "scopes",
+          "workspaceId",
+          "clientId"
+        ],
+        "type": "object"
+      },
+      "McpDelegationIssueRequestV2": {
+        "additionalProperties": false,
+        "properties": {
+          "clientId": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{2,190}$",
+            "type": "string"
+          },
+          "ttlSeconds": {
+            "maximum": 900,
+            "minimum": 60,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "clientId"
+        ],
+        "type": "object"
+      },
+      "McpDelegationRevokeRequestV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accessToken": {
+            "pattern": "^[A-Za-z0-9_-]{43}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "accessToken"
+        ],
+        "type": "object"
+      },
+      "McpDelegationRevokeResponseV2": {
+        "additionalProperties": false,
+        "properties": {
+          "success": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "success"
+        ],
+        "type": "object"
+      },
+      "MoneyV2": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "$ref": "#/components/schemas/DecimalAmountV2"
+          },
+          "currency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          }
+        },
+        "required": [
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "OverviewAccountV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "accountType": {
+            "enum": [
+              "bank",
+              "brokerage",
+              "fund",
+              "insurance",
+              "pension",
+              "housing_fund",
+              "property",
+              "liability",
+              "other"
+            ]
+          },
+          "aggregationConsent": {
+            "type": "boolean"
+          },
+          "assetClasses": {
+            "items": {
+              "$ref": "#/components/schemas/AllocationLineV2"
+            },
+            "maxItems": 20,
+            "type": "array"
+          },
+          "classificationRevision": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "currency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "maintenanceMode": {
+            "enum": [
+              "simplified",
+              "detailed"
+            ]
+          },
+          "name": {
+            "maxLength": 120,
+            "minLength": 1,
+            "type": "string"
+          },
+          "ownerSubjectId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "purposeBuckets": {
+            "items": {
+              "$ref": "#/components/schemas/AllocationLineV2"
+            },
+            "maxItems": 20,
+            "type": "array"
+          },
+          "revision": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "valuation": {
+            "$ref": "#/components/schemas/OverviewValuationV2"
+          },
+          "visibility": {
+            "$ref": "#/components/schemas/VisibilityV2"
+          }
+        },
+        "required": [
+          "accountId",
+          "name",
+          "accountType",
+          "ownerSubjectId",
+          "visibility",
+          "aggregationConsent",
+          "currency",
+          "maintenanceMode",
+          "revision",
+          "classificationRevision",
+          "valuation",
+          "assetClasses",
+          "purposeBuckets"
+        ],
+        "type": "object"
+      },
+      "OverviewAllocationLineV2": {
+        "additionalProperties": false,
+        "properties": {
+          "basisPoints": {
+            "maximum": 10000,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "code": {
+            "pattern": "^[a-z][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "value": {
+            "$ref": "#/components/schemas/MoneyV2"
+          }
+        },
+        "required": [
+          "code",
+          "basisPoints",
+          "value"
+        ],
+        "type": "object"
+      },
+      "OverviewCoverageV2": {
+        "additionalProperties": false,
+        "properties": {
+          "estimatedAccountCount": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "missingValuationAccountCount": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "staleAccountCount": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "unclassifiedAccountCount": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "unconverted": {
+            "items": {
+              "$ref": "#/components/schemas/OverviewUnconvertedAmountV2"
+            },
+            "maxItems": 20,
+            "type": "array"
+          },
+          "visibleAccountCount": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "visibleAccountCount",
+          "estimatedAccountCount",
+          "staleAccountCount",
+          "unclassifiedAccountCount",
+          "missingValuationAccountCount",
+          "unconverted"
+        ],
+        "type": "object"
+      },
+      "OverviewPrivacyV2": {
+        "additionalProperties": false,
+        "properties": {
+          "containsRestrictedData": {
+            "type": "boolean"
+          },
+          "suppressedFields": {
+            "items": {
+              "enum": [
+                "account_count",
+                "account_details",
+                "allocation_breakdowns",
+                "freshness_breakdown"
+              ]
+            },
+            "type": "array",
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "containsRestrictedData",
+          "suppressedFields"
+        ],
+        "type": "object"
+      },
+      "OverviewTotalsV2": {
+        "additionalProperties": false,
+        "properties": {
+          "grossAssets": {
+            "$ref": "#/components/schemas/MoneyV2"
+          },
+          "liabilities": {
+            "$ref": "#/components/schemas/MoneyV2"
+          },
+          "netWorth": {
+            "$ref": "#/components/schemas/MoneyV2"
+          }
+        },
+        "required": [
+          "grossAssets",
+          "liabilities",
+          "netWorth"
+        ],
+        "type": "object"
+      },
+      "OverviewUnconvertedAmountV2": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "$ref": "#/components/schemas/MoneyV2"
+          },
+          "reason": {
+            "const": "fx_rate_missing"
+          }
+        },
+        "required": [
+          "amount",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "OverviewValuationV2": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "anyOf": [
+              {
+                "format": "date-time",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "freshness": {
+            "enum": [
+              "current",
+              "stale",
+              "missing"
+            ]
+          },
+          "quality": {
+            "$ref": "#/components/schemas/QualityV2"
+          },
+          "value": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/MoneyV2"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "value",
+          "asOf",
+          "quality",
+          "freshness"
+        ],
+        "type": "object"
+      },
+      "PerformanceCoverageV2": {
+        "additionalProperties": false,
+        "properties": {
+          "assumptions": {
+            "items": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "calculationVersion": {
+            "pattern": "^performance\\.v[1-9]\\d*$",
+            "type": "string"
+          },
+          "eligibleMetrics": {
+            "items": {
+              "maxLength": 64,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "level": {
+            "enum": [
+              "balance_change",
+              "estimated_return",
+              "detailed_performance"
+            ]
+          },
+          "unavailableMetrics": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "metric": {
+                  "maxLength": 64,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "reason": {
+                  "maxLength": 100,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "metric",
+                "reason"
+              ],
+              "type": "object"
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "warnings": {
+            "items": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "array",
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "level",
+          "eligibleMetrics",
+          "unavailableMetrics",
+          "assumptions",
+          "warnings",
+          "calculationVersion"
+        ],
+        "type": "object"
+      },
+      "PerformancePeriodRequestV2": {
+        "additionalProperties": false,
+        "properties": {
+          "baseCurrency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "from": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "scopeId": {
+            "anyOf": [
+              {
+                "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "scopeType": {
+            "enum": [
+              "household",
+              "account",
+              "holding"
+            ]
+          },
+          "timezone": {
+            "maxLength": 64,
+            "pattern": "^(?:UTC|[A-Za-z_]+(?:/[A-Za-z0-9_+.-]+)+)$",
+            "type": "string"
+          },
+          "to": {
+            "format": "date-time",
+            "type": "string"
+          }
+        },
+        "required": [
+          "from",
+          "to",
+          "timezone",
+          "baseCurrency",
+          "scopeType",
+          "scopeId"
+        ],
+        "type": "object"
+      },
+      "PortfolioTreeV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accounts": {
+            "items": {
+              "$ref": "#/components/schemas/OverviewAccountV2"
+            },
+            "maxItems": 500,
+            "type": "array"
+          },
+          "asOf": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "authority": {
+            "$ref": "#/components/schemas/WorkspaceAuthorityV2"
+          },
+          "baseCurrency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "kind": {
+            "const": "portfolio.tree.v2"
+          },
+          "privacy": {
+            "$ref": "#/components/schemas/OverviewPrivacyV2"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "workspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "workspaceVersion",
+          "asOf",
+          "authority",
+          "baseCurrency",
+          "accounts",
+          "privacy"
+        ],
+        "type": "object"
+      },
+      "QualityV2": {
+        "enum": [
+          "confirmed",
+          "estimated",
+          "unknown"
+        ]
+      },
+      "RemoteUnavailableErrorV2": {
+        "$ref": "#/components/schemas/FamilyWealthErrorV2"
+      },
+      "SourceV2": {
+        "additionalProperties": false,
+        "properties": {
+          "channel": {
+            "enum": [
+              "web",
+              "cli",
+              "mcp",
+              "builtin_ai",
+              "migration"
+            ]
+          },
+          "clientId": {
+            "pattern": "^[a-z][a-z0-9-]{2,63}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "clientId",
+          "channel"
+        ],
+        "type": "object"
+      },
+      "ValuationSnapshotAppendCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "type": "null"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "valuation_snapshot.append.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/ValuationSnapshotAppendPayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "ValuationSnapshotAppendPayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "snapshot": {
+            "$ref": "#/components/schemas/ValuationSnapshotDraftV2"
+          },
+          "snapshotId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "snapshotId",
+          "snapshot"
+        ],
+        "type": "object"
+      },
+      "ValuationSnapshotDraftV2": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "quality": {
+            "$ref": "#/components/schemas/QualityV2"
+          },
+          "scopeId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "scopeType": {
+            "enum": [
+              "account",
+              "holding"
+            ]
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          },
+          "value": {
+            "$ref": "#/components/schemas/MoneyV2"
+          }
+        },
+        "required": [
+          "scopeType",
+          "scopeId",
+          "value",
+          "asOf",
+          "quality",
+          "source"
+        ],
+        "type": "object"
+      },
+      "VisibilityV2": {
+        "enum": [
+          "household",
+          "private"
+        ]
+      },
+      "WorkspaceAuthorityV2": {
+        "additionalProperties": false,
+        "properties": {
+          "householdId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "role": {
+            "enum": [
+              "owner",
+              "viewer_suggester"
+            ]
+          },
+          "workspaceId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "householdId",
+          "workspaceId",
+          "role"
+        ],
+        "type": "object"
+      },
+      "WorkspaceCapabilitiesV2": {
+        "additionalProperties": false,
+        "properties": {
+          "readable": {
+            "items": {
+              "enum": [
+                "workspace.summary.v2",
+                "activity.page.v2",
+                "workspace.overview.v2"
+              ]
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "writable": {
+            "items": {
+              "enum": [
+                "asset_account.create.v2",
+                "asset_account.update.v2",
+                "asset_account.archive.v2",
+                "valuation_snapshot.append.v2",
+                "classification.replace.v2"
+              ]
+            },
+            "type": "array",
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "readable",
+          "writable"
+        ],
+        "type": "object"
+      },
+      "WorkspaceDataQualityV2": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "authority": {
+            "$ref": "#/components/schemas/WorkspaceAuthorityV2"
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "coverage": {
+            "$ref": "#/components/schemas/OverviewCoverageV2"
+          },
+          "kind": {
+            "const": "workspace.data_quality.v2"
+          },
+          "privacy": {
+            "$ref": "#/components/schemas/OverviewPrivacyV2"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "warnings": {
+            "items": {
+              "enum": [
+                "estimated_values_present",
+                "stale_values_present",
+                "unclassified_values_present",
+                "missing_valuations_present",
+                "unconverted_values_excluded",
+                "restricted_values_aggregated"
+              ]
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "workspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "workspaceVersion",
+          "asOf",
+          "authority",
+          "coverage",
+          "privacy",
+          "warnings"
+        ],
+        "type": "object"
+      },
+      "WorkspaceInitializeCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedWorkspaceVersion": {
+            "const": 0
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "workspace.initialize.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/WorkspaceInitializePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "WorkspaceInitializePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "baseCurrency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "timezone": {
+            "maxLength": 64,
+            "pattern": "^(?:UTC|[A-Za-z_]+(?:/[A-Za-z0-9_+.-]+)+)$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "baseCurrency",
+          "timezone"
+        ],
+        "type": "object"
+      },
+      "WorkspaceInitializeSuccessV2": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/CommandReceiptV2"
+          },
+          "kind": {
+            "const": "family_wealth_success.v2"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "data"
+        ],
+        "type": "object"
+      },
+      "WorkspaceMetadataCoverageAvailableV2": {
+        "additionalProperties": false,
+        "properties": {
+          "omitted": {
+            "items": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "projection": {
+            "const": "workspace.summary.v2"
+          },
+          "status": {
+            "const": "complete"
+          }
+        },
+        "required": [
+          "status",
+          "projection",
+          "omitted"
+        ],
+        "type": "object"
+      },
+      "WorkspaceMetadataCoverageUnavailableV2": {
+        "additionalProperties": false,
+        "properties": {
+          "omitted": {
+            "items": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "projection": {
+            "const": "workspace.summary.v2"
+          },
+          "reason": {
+            "const": "REMOTE_UNAVAILABLE"
+          },
+          "status": {
+            "const": "unavailable"
+          }
+        },
+        "required": [
+          "status",
+          "projection",
+          "omitted",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "WorkspaceMetadataPermissionsV2": {
+        "additionalProperties": false,
+        "properties": {
+          "readable": {
+            "maxItems": 3,
+            "minItems": 3,
+            "prefixItems": [
+              {
+                "const": "workspace.summary.v2"
+              },
+              {
+                "const": "activity.page.v2"
+              },
+              {
+                "const": "workspace.overview.v2"
+              }
+            ],
+            "type": "array"
+          },
+          "role": {
+            "anyOf": [
+              {
+                "enum": [
+                  "owner",
+                  "viewer_suggester"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "scopes": {
+            "maxItems": 1,
+            "minItems": 1,
+            "prefixItems": [
+              {
+                "const": "workspace:read"
+              }
+            ],
+            "type": "array"
+          },
+          "writable": {
+            "maxItems": 0,
+            "type": "array"
+          }
+        },
+        "required": [
+          "role",
+          "scopes",
+          "readable",
+          "writable"
+        ],
+        "type": "object"
+      },
+      "WorkspaceMetadataResourceAvailableV2": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "authority": {
+            "$ref": "#/components/schemas/WorkspaceAuthorityV2"
+          },
+          "baseCurrency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "counts": {
+            "additionalProperties": false,
+            "properties": {
+              "accounts": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "holdings": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "pendingItems": {
+                "minimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "accounts",
+              "holdings",
+              "pendingItems"
+            ],
+            "type": "object"
+          },
+          "coverage": {
+            "$ref": "#/components/schemas/WorkspaceMetadataCoverageAvailableV2"
+          },
+          "emptyState": {
+            "enum": [
+              "ready_for_first_asset",
+              "assets_present"
+            ]
+          },
+          "kind": {
+            "const": "workspace.metadata.v2"
+          },
+          "permissions": {
+            "$ref": "#/components/schemas/WorkspaceMetadataPermissionsV2"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "status": {
+            "const": "available"
+          },
+          "timezone": {
+            "maxLength": 64,
+            "pattern": "^(?:UTC|[A-Za-z_]+(?:/[A-Za-z0-9_+.-]+)+)$",
+            "type": "string"
+          },
+          "workspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "status",
+          "workspaceVersion",
+          "asOf",
+          "authority",
+          "baseCurrency",
+          "timezone",
+          "emptyState",
+          "counts",
+          "coverage",
+          "permissions"
+        ],
+        "type": "object"
+      },
+      "WorkspaceMetadataResourceUnavailableV2": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "type": "null"
+          },
+          "authority": {
+            "type": "null"
+          },
+          "baseCurrency": {
+            "type": "null"
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "counts": {
+            "type": "null"
+          },
+          "coverage": {
+            "$ref": "#/components/schemas/WorkspaceMetadataCoverageUnavailableV2"
+          },
+          "emptyState": {
+            "type": "null"
+          },
+          "kind": {
+            "const": "workspace.metadata.v2"
+          },
+          "permissions": {
+            "$ref": "#/components/schemas/WorkspaceMetadataPermissionsV2"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "status": {
+            "const": "unavailable"
+          },
+          "timezone": {
+            "type": "null"
+          },
+          "workspaceVersion": {
+            "type": "null"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "status",
+          "workspaceVersion",
+          "asOf",
+          "authority",
+          "baseCurrency",
+          "timezone",
+          "emptyState",
+          "counts",
+          "coverage",
+          "permissions"
+        ],
+        "type": "object"
+      },
+      "WorkspaceMetadataResourceV2": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/WorkspaceMetadataResourceAvailableV2"
+          },
+          {
+            "$ref": "#/components/schemas/WorkspaceMetadataResourceUnavailableV2"
+          }
+        ]
+      },
+      "WorkspaceOverviewSuccessV2": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/WorkspaceOverviewV2"
+          },
+          "kind": {
+            "const": "family_wealth_success.v2"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "data"
+        ],
+        "type": "object"
+      },
+      "WorkspaceOverviewV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accounts": {
+            "items": {
+              "$ref": "#/components/schemas/OverviewAccountV2"
+            },
+            "maxItems": 500,
+            "type": "array"
+          },
+          "asOf": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "assetClasses": {
+            "items": {
+              "$ref": "#/components/schemas/OverviewAllocationLineV2"
+            },
+            "maxItems": 20,
+            "type": "array"
+          },
+          "authority": {
+            "$ref": "#/components/schemas/WorkspaceAuthorityV2"
+          },
+          "baseCurrency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "breakdownStatus": {
+            "enum": [
+              "complete",
+              "suppressed_due_to_private_aggregation"
+            ]
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "coverage": {
+            "$ref": "#/components/schemas/OverviewCoverageV2"
+          },
+          "kind": {
+            "const": "workspace.overview.v2"
+          },
+          "privacy": {
+            "$ref": "#/components/schemas/OverviewPrivacyV2"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "purposeBuckets": {
+            "items": {
+              "$ref": "#/components/schemas/OverviewAllocationLineV2"
+            },
+            "maxItems": 20,
+            "type": "array"
+          },
+          "totals": {
+            "$ref": "#/components/schemas/OverviewTotalsV2"
+          },
+          "warnings": {
+            "items": {
+              "enum": [
+                "estimated_values_present",
+                "stale_values_present",
+                "unclassified_values_present",
+                "missing_valuations_present",
+                "unconverted_values_excluded",
+                "restricted_values_aggregated"
+              ]
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "workspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "workspaceVersion",
+          "asOf",
+          "authority",
+          "baseCurrency",
+          "totals",
+          "breakdownStatus",
+          "accounts",
+          "assetClasses",
+          "purposeBuckets",
+          "coverage",
+          "privacy",
+          "warnings"
+        ],
+        "type": "object"
+      },
+      "WorkspaceSummarySuccessV2": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/WorkspaceSummaryV2"
+          },
+          "kind": {
+            "const": "family_wealth_success.v2"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "data"
+        ],
+        "type": "object"
+      },
+      "WorkspaceSummaryV2": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "authority": {
+            "$ref": "#/components/schemas/WorkspaceAuthorityV2"
+          },
+          "baseCurrency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "capabilities": {
+            "$ref": "#/components/schemas/WorkspaceCapabilitiesV2"
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "counts": {
+            "additionalProperties": false,
+            "properties": {
+              "accounts": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "holdings": {
+                "const": 0
+              },
+              "pendingItems": {
+                "minimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "accounts",
+              "holdings",
+              "pendingItems"
+            ],
+            "type": "object"
+          },
+          "cursor": {
+            "maxLength": 2048,
+            "minLength": 32,
+            "type": "string"
+          },
+          "emptyState": {
+            "enum": [
+              "ready_for_first_asset",
+              "assets_present"
+            ]
+          },
+          "kind": {
+            "const": "workspace.summary.v2"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "timezone": {
+            "maxLength": 64,
+            "pattern": "^(?:UTC|[A-Za-z_]+(?:/[A-Za-z0-9_+.-]+)+)$",
+            "type": "string"
+          },
+          "workspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "workspaceVersion",
+          "asOf",
+          "authority",
+          "baseCurrency",
+          "timezone",
+          "emptyState",
+          "counts",
+          "cursor",
+          "capabilities"
+        ],
+        "type": "object"
+      }
+    },
+    "securitySchemes": {
+      "bearer": {
+        "bearerFormat": "JWT",
+        "scheme": "bearer",
+        "type": "http"
+      }
+    }
+  },
+  "info": {
+    "title": "ChooseFIRE Family Wealth v2 R2 Contract",
+    "version": "2.0.0-r2"
+  },
+  "openapi": "3.1.0",
+  "paths": {
+    "/choosefire/v2/workspace": {
+      "post": {
+        "operationId": "initializeFamilyWealthWorkspaceV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/WorkspaceInitializeCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WorkspaceInitializeSuccessV2"
+                }
+              }
+            },
+            "description": "Committed initialization receipt"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RemoteUnavailableErrorV2"
+                }
+              }
+            },
+            "description": "Runtime is disabled or caller is outside the synthetic allowlist"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Initialize the v2 workspace when the R1 runtime is enabled"
+      }
+    },
+    "/choosefire/v2/workspace/activity": {
+      "get": {
+        "operationId": "listFamilyWealthWorkspaceActivityV2",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "limit",
+            "required": true,
+            "schema": {
+              "maximum": 100,
+              "minimum": 1,
+              "type": "integer"
+            }
+          },
+          {
+            "in": "query",
+            "name": "cursor",
+            "required": false,
+            "schema": {
+              "maxLength": 2048,
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ActivityPageSuccessV2"
+                }
+              }
+            },
+            "description": "Activity page"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Read a role-bound page of v2 workspace activity"
+      }
+    },
+    "/choosefire/v2/workspace/asset-accounts": {
+      "post": {
+        "operationId": "createFamilyWealthAssetAccountV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AssetAccountCreateCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed asset account receipt"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Only the household owner can change asset accounts"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Workspace version or idempotency conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Create one simplified or detailed asset account"
+      },
+      "put": {
+        "operationId": "updateFamilyWealthAssetAccountV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AssetAccountUpdateCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed asset account update receipt"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Only the household owner can change asset accounts"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Workspace or account revision conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Replace editable metadata for one active asset account"
+      }
+    },
+    "/choosefire/v2/workspace/asset-accounts/archive": {
+      "post": {
+        "operationId": "archiveFamilyWealthAssetAccountV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AssetAccountArchiveCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed asset account archive receipt"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Only the household owner can archive asset accounts"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Workspace or account revision conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Archive one active asset account without deleting history"
+      }
+    },
+    "/choosefire/v2/workspace/classifications": {
+      "put": {
+        "operationId": "replaceFamilyWealthClassificationV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ClassificationReplaceCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed classification receipt"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Only the household owner can replace classifications"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Object revision or workspace version conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Replace account or holding asset and purpose allocations"
+      }
+    },
+    "/choosefire/v2/workspace/mcp/delegation": {
+      "post": {
+        "operationId": "issueFamilyWealthWorkspaceMcpDelegationV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/McpDelegationIssueRequestV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/McpDelegatedTokenCredentialV2"
+                }
+              }
+            },
+            "description": "Short-lived opaque MCP delegation"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Issue a short-lived read-only MCP capability for the current workspace"
+      }
+    },
+    "/choosefire/v2/workspace/mcp/delegation/revoke": {
+      "post": {
+        "operationId": "revokeFamilyWealthWorkspaceMcpDelegationV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/McpDelegationRevokeRequestV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/McpDelegationRevokeResponseV2"
+                }
+              }
+            },
+            "description": "Idempotent delegation revocation result"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Revoke one read-only MCP capability for the current workspace"
+      }
+    },
+    "/choosefire/v2/workspace/overview": {
+      "get": {
+        "operationId": "getFamilyWealthWorkspaceOverviewV2",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WorkspaceOverviewSuccessV2"
+                }
+              }
+            },
+            "description": "Role-bound wealth overview projection"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Read totals, account composition, quality and disclosures"
+      }
+    },
+    "/choosefire/v2/workspace/summary": {
+      "get": {
+        "operationId": "getFamilyWealthWorkspaceSummaryV2",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WorkspaceSummarySuccessV2"
+                }
+              }
+            },
+            "description": "Workspace summary"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Read the bounded v2 workspace metadata projection"
+      }
+    },
+    "/choosefire/v2/workspace/valuations": {
+      "post": {
+        "operationId": "appendFamilyWealthValuationSnapshotV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ValuationSnapshotAppendCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed valuation receipt"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Only the household owner can append valuations"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Workspace version or idempotency conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Append an account or holding valuation snapshot"
+      }
+    }
+  },
+  "x-choosefire-contract-id": "choosefire-family-wealth.v2",
+  "x-choosefire-contract-version": 2,
+  "x-choosefire-runtime-state": "r1-runtime-r2-contract-only"
+}